@@ -35,11 +35,11 @@ conditions specified in the :doc:`software license <pdfguilicense>`.
35
35
36
36
PDFgui is distributed as a software package for
37
37
`Anaconda Python <https://www.continuum.io >`__. PDFgui is available
38
- for all operating systems supported by Anaconda, namely for 32 and
39
- 64-bit Linux, Mac OS X, and 32 and 64-bit Windows.
38
+ for all operating systems supported by Anaconda, namely for
39
+ Linux, Mac OS X, and Windows.
40
40
41
41
As a prerequisite for PDFgui installation, download and
42
- install **Anaconda for Python 2.7 ** from
42
+ install **Anaconda Python ** from
43
43
|anaconda-download |.
44
44
45
45
.. TODO -- remove when PDFgui is compatible with wxpython 4
@@ -52,35 +52,44 @@ install **Anaconda for Python 2.7** from
52
52
<https://www.anaconda.com/why-we-removed-the-free-channel-in-conda-4-7> `__).
53
53
We are working on making PDFgui compatible with the current
54
54
set of Anaconda packages.
55
- In the meantime to install PDFgui you must
56
- re-activate the old Anaconda packages as follows ::
55
+ In the meantime you must re-activate the old packages
56
+ as follows ::
57
57
58
58
conda update -n base conda
59
59
conda config --set restore_free_channel true
60
60
61
- .. note ::
62
- If you already use Anaconda for Python 3.7, create a separate
63
- Anaconda environment *py27 * which will provide Python 2.7
64
- instead of 3.7. ::
65
-
66
- conda create --name=py27 python=2.7
67
- source activate py27
68
-
69
- On Windows use just ``activate py27 ``. Make sure that *py27 *
70
- environment is activated in your shell prior to running
71
- the "install" or "update" commands below.
72
61
73
62
PDFgui is available from the "diffpy" channel of Anaconda packages.
74
- Open a *Terminal * window or *Anaconda Command Prompt * on Windows
75
- and install PDFgui using the :program: `conda ` command ::
63
+ Because PDFgui requires Python 2.7 and wxpython 3,
64
+ it is strongly recommended to install it in a dedicated
65
+ Anaconda environment *py27 *.
66
+ To do so open a *Terminal * window or *Anaconda Command Prompt * on Windows
67
+ and use the :program: `conda ` command as follows ::
76
68
77
69
conda config --add channels diffpy
70
+ conda create --name=py27 python=2.7
71
+ conda activate py27
78
72
conda install "diffpy.pdfgui>=1.1.2"
79
73
80
74
All done. To start PDFgui enter :program: `pdfgui ` command in a
81
75
Terminal or use the *DiffPy * start menu on Windows. PDFgui can be
82
76
also started from the *Launcher * application included with Anaconda.
83
77
78
+ .. note ::
79
+ To start PDFgui from a Terminal make sure *py27 * is
80
+ the active Anaconda environment::
81
+
82
+ conda activate py27
83
+
84
+ Alternatively you can add the following line to your shell startup
85
+ file :file: `.bashrc ` to define an alias which will work in
86
+ any Anaconda environment ::
87
+
88
+ alias pdfgui="/path/to/py27/bin/pdfgui"
89
+
90
+ where ``/path/to `` needs to be adjusted according to the output of
91
+ ``which pdfgui `` command.
92
+
84
93
85
94
PDFgui updates
86
95
==============
0 commit comments