Greetings,
I've attached the manual (the same one on the website) to this message.
The formatting may not be so pretty, but all of the content is there.
Cheers,
Patrick
--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups
mnemosyne-proj-users group.
To post to this group, send email to mnemosyne-proj-users@googlegroups.com
To unsubscribe from this group, send email to
mnemosyne-proj-users+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/mnemosyne-proj-users?hl=en
-~--~~~~--~~--~--~---
Title: Documentation
Documentation
Installing for the first time and upgrading from previous versions
Mnemosyne runs on Windows, Linux, and Mac OS X.
Upgrading Mnemosyne
We recommend that Windows users uninstall any old versions of Mnemosyne before installing a new version (this will keep your revision data intact.)
Installation on Windows
A standard binary executable (.exe) is provided for Windows users.
Download Mnemosyne here.
Installation on Mac OS X
A standard disk image (.dmg) is provided for Mac users. Mnemosyne for Mac currently only supports Intel Macs (those sold from 2006- on).
Download Mnemosyne for Intel Macs here.
PowerPC Mac users can consult this guide to compiling the dependencies for Mnemosyne on Mac OS X.
Installation on Linux
Install the following dependencies:
Python 2.4 or later
Qt 3.x and PyQt 3.x
PyXML
pygame and its dependencies
If you want to be able to enter formulas using latex syntax, make sure that
LaTeX and dvipng are installed.
Type 'python setup.py install' as root.
Run the application by typing 'mnemosyne'.
Note: in order to install these packages easily on Debian based systems, i.e. Ubuntu, Knopix, Debian, etc., enable the
downloading of non-free software via the etc/apt/sources.list configuration file. See http://www.debian.org/doc/manuals/debian-tutorial/ch-dpkg.html for more details.
Download Mnemosyne here.
Hacking on Mnemosyne
If you want to contribute to Mnemosyne or want to make any local changes, you will additionally need the following tools:
Qt-Designer: Useful to modify the .ui xml-files.
pyuic: required to convert the .ui files to python code.
If you check out the source from subversion, you have to install it by typing 'make' rather than 'python setup.py install'
Compiling Dependencies for Mnemosyne 1.0.x on Mac OS X 10.4 and 10.5
Since it can get a little difficult, here we will list the steps to compile Mnemosyne on Mac OS X.
We're looking for someone to help us build a standalone installer; if you can be of assistance, please contact us.
Compiling yourself -the steps
Install Apple's Developer tools. The Developer tools can be found on any OS X system install disk, or downloaded from the Apple Developer Connection (free registration required).
Install Python 2.4.
Download qt-mac-free-3.3.8.tar.gz from Trolltech. Leopard users will need to apply this patch.
Install SIP.
Install PyQt3 for Mac.
Install PyXML, PyGame, and PyObjC.
Install Mnemosyne.
Alternate option- Using Fink (works on 10.4 or earlier, not 10.5/Leopard)
Rich shares the following:
I've had a lot of success using Fink to install various command line
tools into OS X 10.4.11, including newer Python and gcc versions than
Apple provides; X11 applications have been more of a mixed bag, but
the Mnemosyne install went well with just a couple of tricks.
For any who might not know, Fink is a port of the Debian packaging
system to OS X.
http://finkproject.org/
There's a GUI, Fink Commander, which makes dealing with the thousands
of packages available a little easier. The GUI isn't very Mac-like and
it still helps to know a little bit about how apt-get works; the
various functions in the GUI seem a little thrown together and
confusing. You also need to enable use of the "unstable" repositories
- lots of perfectly usable and stable programs there.
Fink puts everything it installs in its own tree under /sw so it
doesn't clobber anything else you have. The tricks involve getting
Mnemosyne installed and running correctly from there also.
I'm just running a G4 so all the compiling took several hours. Also,
I'll note that I've read that getting X11 and Fink running correctly
on Leopard currently requires some patching. I'm staying with Tiger
for a little while yet.
That said, I used Fink to install the latest versions of the various
Mnemosyne dependencies listed above.
Specifically, I used Fink to install from source these packages:
python25 1.2.5.2-1
qt3mac 3.3.8-12
sip-py25 4.7.4-1
pyqt-py25 3.17.4-2
pyxml-py25 0.8.4-1
pygame-py25 1.7.1release-1005
pyobc-py25 1.4-2
These brought a number of their own dependencies along, which I just
let Fink handle; Fink tends to handle dependencies quite
intelligently, which is one of the reasons it's such a useful tool.
The first thing was to get Mnemosyne to install into /sw/bin. I had to