Move install instructions to own file

This commit is contained in:
Alex Xu 2021-03-27 19:52:02 -07:00
parent 5731ffdb01
commit 319e2816c1
2 changed files with 82 additions and 77 deletions

81
INSTALL.md Normal file
View File

@ -0,0 +1,81 @@
# Install Instructions
For local development / building stand-alone binaries
## Windows
You need Python
[2.7 32 bit](https://www.python.org/downloads/release/python-2718/).
Download the `Windows x86 MSI installer`
and be sure to add `python` to `PATH` during installation.
You can run `mangle` using 64 bit Python 2.7,
but won't be able to build a binary with `py2exe`,
and any performance difference is negligible.
Install virtualenv globally, if you don't already have it.
```
> pip install virtualenv
```
and install all dependencies in a venv in the mangle directory, e.g.
```
...\mangle> virtualenv venv
> venv\Scripts\activate
(venv) > pip install Pillow
(venv) > pip install reportlab
```
It can be pretty difficult to install PyQT4 from source,
so prebuilt binaries are available at
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyqt4
You need
`PyQt4-4.11.4-cp27-cp27m-win32.whl`
which you can install after placing the file
in the `mangle` folder via
```
(venv) > pip install PyQt4-4.11.4-cp27-cp27m-win32.whl
```
So your final `pip freeze` can look like:
```
(venv) > pip freeze
Pillow==6.2.2
PyQt4 @ file:///.../mangle/PyQt4-4.11.4-cp27-cp27m-win32.whl
reportlab==3.5.59
```
You can run the GUI via
```
(venv) > python mangle.pyw
```
Optionally, you can install all the dependencies globally
so you can simply click on the `mangle.pyw` file to run it.
### Optional
To actually build a stand-alone `.exe`, install
```
(venv) > pip install py2exe_py2
```
and install
[Microsoft Visual C++ Compiler for Python 2.7](https://www.microsoft.com/en-us/download/details.aspx?id=44266)
A standalone binary can be created in the `dist` folder via
```
(venv) > python setup.py install
```
You may get an error which can be solved by looking at
https://stackoverflow.com/questions/38444230/error-converting-gui-to-standalone-executable-using-py2exe

View File

@ -79,80 +79,4 @@ from source.
* [mangle\_win.zip](https://foosoft.net/projects/mangle/dl/mangle_win.zip) * [mangle\_win.zip](https://foosoft.net/projects/mangle/dl/mangle_win.zip)
* [mangle\_osx.zip](https://foosoft.net/projects/mangle/dl/mangle_osx.zip) (quite old) * [mangle\_osx.zip](https://foosoft.net/projects/mangle/dl/mangle_osx.zip) (quite old)
### Windows Check [INSTALL.md](INSTALL.md) for build instructions.
You need Python
[2.7 32 bit](https://www.python.org/downloads/release/python-2718/).
Download the `Windows x86 MSI installer`
and be sure to add `python` to `PATH` during installation.
You can run `mangle` using 64 bit Python 2.7,
but won't be able to build a binary with `py2exe`,
and any performance difference is negligible.
Install virtualenv globally, if you don't already have it.
```
> pip install virtualenv
```
and install all dependencies in a venv in the mangle directory, e.g.
```
...\mangle> virtualenv venv
> venv\Scripts\activate
(venv) > pip install Pillow
(venv) > pip install reportlab
```
It can be pretty difficult to install PyQT4 from source,
so prebuilt binaries are available at
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyqt4
You need
`PyQt4-4.11.4-cp27-cp27m-win32.whl`
which you can install after placing the file
in the `mangle` folder via
```
(venv) > pip install PyQt4-4.11.4-cp27-cp27m-win32.whl
```
So your final `pip freeze` can look like:
```
(venv) > pip freeze
Pillow==6.2.2
PyQt4 @ file:///.../mangle/PyQt4-4.11.4-cp27-cp27m-win32.whl
reportlab==3.5.59
```
You can run the GUI via
```
(venv) > python mangle.pyw
```
Optionally, you can install all the dependencies globally
so you can simply click on the `mangle.pyw` file to run it.
#### Optional
To actually build a stand-alone `.exe`, install
```
(venv) > pip install py2exe_py2
```
and install
[Microsoft Visual C++ Compiler for Python 2.7](https://www.microsoft.com/en-us/download/details.aspx?id=44266)
A standalone binary can be created in the `dist` folder via
```
(venv) > python setup.py install
```
You may get an error which can be solved by looking at
https://stackoverflow.com/questions/38444230/error-converting-gui-to-standalone-executable-using-py2exe