Skip to content

Commit d6ff2f7

Browse files
committed
pdfgui - install to new conda environment
Avoid headaches with dependencies resolution. Drop mention of 32-bit systems. No one uses them anymore.
1 parent 2a6e033 commit d6ff2f7

File tree

1 file changed

+27
-18
lines changed

1 file changed

+27
-18
lines changed

Diff for: products/pdfgui.rst

+27-18
Original file line numberDiff line numberDiff line change
@@ -35,11 +35,11 @@ conditions specified in the :doc:`software license <pdfguilicense>`.
3535

3636
PDFgui 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

4141
As 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

7362
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 ::
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

8074
All done. To start PDFgui enter :program:`pdfgui` command in a
8175
Terminal or use the *DiffPy* start menu on Windows. PDFgui can be
8276
also 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

8594
PDFgui updates
8695
==============

0 commit comments

Comments
 (0)