diff --git a/INSTALL b/INSTALL index cf91613..b425347 100644 --- a/INSTALL +++ b/INSTALL @@ -13,7 +13,7 @@ computer without an internet connection. First, install the prerequisites: * Python 2.4 to 2.5 - * CherryPy 2.2 + * CherryPy 2.3 * pysqlite 2.3 to 2.4 * simplejson 1.3 to 2.0 * pytz 2006p to 2008c @@ -63,8 +63,80 @@ of your notes and notebooks, will be stored on the USB drive instead of on the computer itself. Then, anytime you want to start Luminotes on the USB drive, run usb_luminotes.sh from it. -If you're only interested in Luminotes Desktop, you can stop reading here. The -rest of this document describes Luminotes Server. +If you're only interested in running Luminotes Desktop, you can stop reading +here. + + +building Luminotes Desktop +-------------------------- + +If you'd like to build your own Luminotes installer for Windows, follow these +steps. You should only need to do this if you are a Luminotes developer. +Otherwise you can completely skip this section. + +First, install the prerequisites: + + * Python 2.4 to 2.6 + * setuptools 0.x + * CherryPy 2.3 + * pysqlite 2.x (which wraps SQLite 3.x) + * simplejson 1.3 + * pytz 2006p to 2008c + * Python Imaging Library 1.1 + * Python Universal Encoding Detector 1.0 + * Microsoft Visual C++ 2008 SP1 Redistributable Package + (You do not need Visual Studio itself.) + * py2exe 0.x + * Inno Setup Unicode 5.x + * Luminotes source code + +The recommended way to do this on Windows is as follows: + + 1. Log into Windows as the Administrator. + + 2. Install Python via the official Windows installer. + + 3. Install setuptools by downloading and running ez_setup.py. + + 4. Install CherryPy. Since Luminotes currently requires an ancient version of + CherryPy, install it manually by downloading the correct version and + running: python.exe setup.py install within CherryPy's unzipped directory. + + Note: python.exe is usually found in C:\Python*\ + + 5. Install other packages with easy_install (or pip, if you prefer): + + * easy_install.exe install pysqlite + * easy_install.exe install simplejson + * easy_install.exe install pytz + * easy_install.exe install pil + * easy_install.exe install chardet + + Note: easy_install.exe is usually found in C:\Python*\Scripts\ + + 7. Install Visual C++ 2008 SP1 Redistributable Package via its installer. + + 8. Install py2exe via its installer. + + 9. Install Inno Setup Unicode via its installer. + + 10. Download and unpack the Luminotes source code. + +To actually build the Luminotes Desktop installer, cd to the Luminotes source +directory and run: + + python.exe setup.py py2exe + ISCC.exe dist\luminotes.iss + + Note: ISCC.exe is usually found in C:\Program Files\Inno Setup 5\ + +If py2exe has problems importing certain packages that are installed as eggs, +then try unzipping the eggs into directories of the same name. The eggs are +usually found in C:\Python*\Lib\site-packages\ + +The commands above should produces a Luminotes Desktop setup.exe installer +within the dist\Output\ directory. You can the run setup.exe on any Windows +computer to install Luminotes Desktop. Luminotes Server @@ -76,7 +148,7 @@ like at luminotes.com. First, install the prerequisites: * Python 2.4 to 2.5 - * CherryPy 2.2 + * CherryPy 2.3 * PostgreSQL 8.1 * psycopg 2.0 * simplejson 1.3 diff --git a/NEWS b/NEWS index 03f1e76..2d33990 100644 --- a/NEWS +++ b/NEWS @@ -1,6 +1,8 @@ 1.6.18: * Fixed a bug that prevented use of the AltGr key on Polish and other keyboards. + * Added a section in the INSTALL file for developers building their own + Luminotes Desktop installer. 1.6.17: July 26, 2009 * Fixed a bug that caused ever-growing notes in Internet Explorer 8.