Add install instructions

This commit is contained in:
Alex Xu 2021-03-27 19:05:53 -07:00
parent 13de820e34
commit b0dffdefba
3 changed files with 76 additions and 3 deletions

6
.gitignore vendored
View File

@ -32,4 +32,8 @@ Icon
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk
.apdisk
venv
mangle.spec
PyQt4-4.11.4-cp27-cp27m-win32.whl

View File

@ -78,3 +78,72 @@ from source.
* [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)
### 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
```
#### 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

@ -43,8 +43,8 @@ setup(
options={'py2exe': {
'bundle_files': 1,
'includes': ['sip'],
'packages': ['reportlab.pdfbase'],
'dll_excludes': ['w9xpopen.exe']
'packages': ['reportlab.pdfbase', 'reportlab.rl_settings'],
'dll_excludes': ['MSVCP90.dll', 'w9xpopen.exe']
}},
zipfile=None
)