@@ -35,11 +35,11 @@ conditions specified in the :doc:`software license <pdfguilicense>`.
3535
3636PDFgui is distributed as a software package for
3737`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.
4040
4141As a prerequisite for PDFgui installation, download and
42- install **Anaconda for Python 2.7 ** from
42+ install **Anaconda Python ** from
4343|anaconda-download |.
4444
4545.. TODO -- remove when PDFgui is compatible with wxpython 4
@@ -52,35 +52,44 @@ install **Anaconda for Python 2.7** from
5252 <https://www.anaconda.com/why-we-removed-the-free-channel-in-conda-4-7> `__).
5353 We are working on making PDFgui compatible with the current
5454 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 ::
5757
5858 conda update -n base conda
5959 conda config --set restore_free_channel true
6060
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.
7261
7362PDFgui 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 ::
7668
7769 conda config --add channels diffpy
70+ conda create --name=py27 python=2.7
71+ conda activate py27
7872 conda install "diffpy.pdfgui>=1.1.2"
7973
8074All done. To start PDFgui enter :program: `pdfgui ` command in a
8175Terminal or use the *DiffPy * start menu on Windows. PDFgui can be
8276also started from the *Launcher * application included with Anaconda.
8377
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+
8493
8594PDFgui updates
8695==============
0 commit comments