Profouzors
/
boxespy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add installation guide for Windows (fixes #83)

This commit is contained in:
Martin Müller 2019-02-26 03:11:36 +01:00 committed by Florian Festi
parent 0ba4281d91
commit 9135486d16
1 changed files with 38 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
documentation/src/install.rst
View File

@ -94,3 +94,41 @@ Getting the Inkscape plugins to run will likely need manual
installation (see above). Note that Inkscape may come with its own
Python. If you run into trouble or have better installation
instructions please open a ticket on GitHub.
Following steps are known to work under Windows 10 (64-bit):
1. Go to https://www.python.org/downloads/windows/
and download the "Windows x86-64 executable installer" for Python 3.7
2. Install Python 3.7 and make sure to check "Add Python 3.7 to PATH"
while doing so
3. Go to https://www.lfd.uci.edu/~gohlke/pythonlibs/#cairocffi
and download :code:`cairocffi‑1.0.2‑cp37‑cp37m‑win_amd64.whl`
4. Go to https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycairo
and download `pycairo‑1.18.0‑cp37‑cp37m‑win_amd64.whl`
5. Open the Command Prompt
(i.e. via the shortcut Windows + R and then typing "cmd"
and pressing Enter)
6. Change to the folder where the .whl files from step 3 and 4 are located
(e.g. with the command :code:`cd \Users\[USERNAME]\Downloads`
where `[USERNAME]` is your username and `Downloads` the folder where
the .whl files are located)
7. Run the command :code:`pip install cairocffi‑1.0.2‑cp37‑cp37m‑win_amd64.whl
pycairo‑1.18.0‑cp37‑cp37m‑win_amd64.whl Markdown lxml`
(Note: If the command pip is not found, you probably forgot to add the
Python installation to the PATH environment variable in step 2)
8. Download Boxes.py as ZIP archive from GitHub
9. Extract the ZIP archive
(e.g. via the built-in Windows feature or other tools like 7-Zip)
10. Change into the folder for Boxes.py,
e.g. with the command :code:`cd \Users\[USERNAME]\Downloads\boxes-master`
11. Run the development server with the command
:code:`python scripts\boxesserver`
12. Open the address http://localhost:8000/ in your browser and have fun :)
Alternatively the command line version of Boxes.py can be used with
the command :code:`python scripts\boxes`.
Another way of installing Boxes.py on Windows is to use the Windows Subsystem
for Linux (WSL). This requires newer versions of Windows 10. Once it is
installed (e.g. via the Ubuntu App from the Microsoft Store), the installation
is identical to the installation on Linux systems.