@@ -14,14 +14,14 @@ Introduction
1414============
1515
1616When running :mod: `matplotlib ` in a virtual environment you may discover a
17- few issues. :mod: `matplotlib ` itself works problemless in virtual envirnments .
18- However, the GUI frameworks that :mod: `matplotlib ` depends uses for interactive
17+ few issues. :mod: `matplotlib ` itself has no issue with virtual environments .
18+ However, the GUI frameworks that :mod: `matplotlib ` uses for interactive
1919figures have some issues with virtual environments. Everything below assumes
2020some familiarity with the Matplotlib backends as found in :ref: `What is a
2121backend? <what-is-a-backend>`.
2222
2323If you only use the ``IPython/Jupyter `` inline and ``notebook/nbagg `` backends
24- and non interactive backends you can should not have any isseus and can ignore
24+ and non interactive backends you should not have any issues and can ignore
2525everything below.
2626
2727GUI Frameworks
@@ -33,7 +33,7 @@ frameworks.
3333Most GUI frameworks are not pip installable. This makes it tricky to install
3434them within a virtual environment. This problem does not exist if you use Conda
3535environments where you can install all Conda supported GUI frameworks directly
36- into tge environment. In regular virtualenv environment various workarounds
36+ into the environment. In regular virtualenv environment various workarounds
3737exist. Some of these are given here:
3838
3939The ``TKAgg `` backend doesn't require any external dependencies and is normally
@@ -49,35 +49,35 @@ an environment. This adds all system wide packages to the virtual environment.
4949However, this breaks the isolation between the virtual environment and the
5050system install. If you use `virtualenvwrapper
5151<https://virtualenvwrapper.readthedocs.org/> `_ this can be toggled with the
52- toggleglobalsitepackages command.
52+ `` toggleglobalsitepackages `` command.
5353
5454Alternatively you can manually symlink the GUI frameworks into the environment.
5555I.e. to use PyQt5 you should symlink ``PyQt5 `` and ``sip `` from your system
5656site packages directory into the environment taking care that the environment
57- and systemwide install uses the same python version.
57+ and the systemwide install use the same python version.
5858
5959OSX
6060===
6161
62- On OSX two different types of Python Builds exists. A regular build and a
62+ On OSX two different types of Python Builds exists: a regular build and a
6363framework build. In order to interact correctly with OSX through some
6464gui frameworks you need a framework build of Python.
65- At the time of writing the ``macosx ``, ``WX `` and ``WXAgg `` backends requires a
65+ At the time of writing the ``macosx ``, ``WX `` and ``WXAgg `` backends require a
6666framework build to function correctly. Unfortunately virtualenv creates a non
6767framework build even if created from a framework build of Python. From
6868Matplotlib 1.5 onwards the ``macosx `` backend checks that a framework build is
6969available and fails if a non framework build is found.
7070
71- The issue has been reported on the virualenv bug tracker `here
71+ The issue has been reported on the virtualenv bug tracker `here
7272<https://github.com/pypa/virtualenv/issues/54> `__ and `here
7373<https://github.com/pypa/virtualenv/issues/609> `__
7474
75- Until this is fixed a work around is needed. The best knows work around,
75+ Until this is fixed a work around is needed. The best known work around,
7676borrowed from the `WX wiki
7777<http://wiki.wxpython.org/wxPythonVirtualenvOnMac> `_, is to use the non
7878virualenv python along with the PYTHONHOME environmental variable. This can be
7979implemented in a script as below. To use this modify ``PYVER `` and
80- ``PATHTOPYTHON `` and put the script in the virtualenvs bin directory i.e.
80+ ``PATHTOPYTHON `` and put the script in the virtualenv bin directory i.e.
8181``PATHTOVENV/bin/frameworkpython ``
8282
8383.. code :: bash
@@ -97,7 +97,7 @@ implemented in a script as below. To use this modify ``PYVER`` and
9797 exec $PYTHON " $@ "
9898
9999
100- With this in place you can run ``frameworkpython `` to get a interactive
100+ With this in place you can run ``frameworkpython `` to get an interactive
101101framework build within the virtualenv. To run a script you can do
102102``frameworkpython test.py `` where ``test.py `` is a script that requires a
103103framework build. To run an interactive ``IPython `` session with the framework
0 commit comments