15,536
edits
Changes
no edit summary
This page provides information how to run Gramps 4.0.x to 4.1.x from source on a Microsoft Windows system with a 32 bit Python 2.7.6 (and Python 3.2 or greater).
The principles are still OK. For a time without an AIO package that was a good way to have a running Gramps for Windows using Phyton 2.7.3. But the now available AIO package has a better usability. To prevent two different versions no further actions where done since the beginning of 2014.
{{man menu|Please note: Gramps 4.2.x and newer only work with Python 3.2 or greater.}}
There are some parts marked as :* "TODO ISSUE" because of known issues.* "TODO WORK" because it's not done yet done (work in progress).
====Gtk, pyobject====
Requirements from README:
* GTK 3.0 8.7+ or greater
* pygobject 3.3.2 or greater
* cairo, pango, pangocairo with instrospection introspection bindings (the gi packages)
* librsvg2 (svg icon view)
* xdg-utils
Checking the state of the pygi-aio package can be done confirmed by:* start starting Python (e. g.: C:\Python27>python)
* and than call the functions as follows. There should be the same results.
Python 2.7.6 (default, Nov 10 2013, 19:24:18) [MSC v.1500 32 bit (Intel)] on win
10L
>>> Gtk.get_micro_version()
>>> from gi.repository import GObject
>>> GObject.pygobject_version
(3, 10, 2)
===ICU/PyICU===This package is a "must be". 02.12.2013: Download http://dl.dropbox.com/u/81888101/Gramps/PYICU_py27_win32.zip.* Copy all files from PYICU_py27_win32.zip\lib\site-packages to "C:\Python27\Lib\site-packages"* Now we have to place the binaries from PYICU_py27_win32.zip\bin to a folder found by Python / Gramps:** First Option: Somewhere on hard disc e.g. "C:\icu". In this case we have to add this path to the environment variable PATH.** Second Option: Into the same folder as python.exe. That's a good solution for a package, because we don't need any changes for the environment variable PATH. To check ICU/PyICU just try it in Python (don't forget the environment variable PATH): Python 2.7.6 (default, Nov 10 2013, 19:24:18) [MSC v.1500 32 bit (Intel)] on win 32 Type "help", "copyright", "credits" or "license" for more information. >>> import icu >>> print icu.ICU_VERSION 50.1.2 >>> print icu.VERSION 1.5 ===language-pack-gnome-xx====
Requirements from README (*STRONGLY RECOMMENDED*):
* Translation of GTK elements to your language, with xx your language code eg for Dutch you need language-pack-gnome-nl. The translation of the Gramps strings is included with the source code.
The necessary package related to our GTK package will be provided also by the programmer of the GTK package (see above).
* 0219.1201.20132014: No further actions necessary, because this GTK package contains also these components.* 11.03.2013 (Deprecated): <strike>from http://code.google.com/p/osspack32/downloads/detail?name=pygi-aio-3.4.2rev10-opt.7z&can=2&q=pygi-aio-3.4.2rev10.7z download pygi-aio-3.4.2rev10-opt.7z** Copy the folder "pygi-aio-3.4.2rev?-opt.7z\gtk\share\locale" into the related Gtk folder "..\site-packages\gtk\share\locale". For our example this would be: "C:\Python27\Lib\site-packages\gtk\share\locale".</strike>
* Deprecated versions before 11.03.2013 see history
====osmgpsmap====
Requirements from README (*STRONGLY RECOMMENDED*):
* Used to show maps in the geography view. Without this the GeoView will not be active, see http://gramps-project.org/wiki/index.php?title=[[Gramps_4.0_Wiki_Manual_1_Wiki_Manual_-_Main_Window_Categories#Geography_Category]]
* The package is named osmgpsmap, osm-gps-map or python-osmgpsmap. Or obtain it from: http://nzjrs.github.com/osm-gps-map/ (Comment: There is no direct download from this web page)
Add this package:
* 0219.1201.20132014: osmgpsmap is integrated part of the GTK3 GTK package. * 07.03.2013 (Deprecated): <strike>From http://code.google.com/p/osspack32/downloads/detail?name=osm-gps-map-git.7z&can=2&q= download osm-gps-map-git.7z. For our example copy the content to "C:\Python27\Lib\site-packages".</strike>
Comments:
* There is a warning from the provider of this package: "window resizing crashed". But it seems this doesn't happens for Gramps - may be in rare cases only.
====GExiv2====Is an optional package.19.01.2014: GExiv2 is integrated part of the GTK package. Because the EditExifMetadata add-on isn't currently available this package is tested for reading exif data only using the "image metadata" gramplet. ====gtkspell====Requirements from README (optional package):* Enable spell checking in the notes. * Gtkspell depends on enchant. * A version of gtkspell with gobject introspection is needed, so minimally version 3.0.0. 19.01.2014: The basics to use a spell are already included in the here used GTK package. {{man warn| At least the content of pygi-aio-3.10.2-win32_rev15-setup.exe used by Gramps forces an crash if libenchant_voikko.dll is available!<br/>It is strongly requested to delete ...\Lib\site-packages\gnome\lib\enchant\libenchant_voikko.dll.}} The only missed things may be special myspell dictionaries (comment: Gramps uses myspell only!) . These can be found here:* from http://extensions.openoffice.org/ download the language packages of your choice. Included in the there provided .oxt files one can extract by using a program like 7-Zip the necessary .aff and .dic files.* alternate [http://extensions.libreoffice.org/extension-center?getCategories=Dictionary&getCompatibility=any extensions.libreoffice.org/]* Or you may find these files (.aff and .dic) as part of any GrampsAIO installation in "..\share\enchant\myspell" For our example all files *.aff *.dic have to be stored into "C:\Python27\Lib\site-packages\gnome\share\enchant\myspell". TODO ISSUE/WORK There are still some issues using spell (as per 019.01.2014):* Open the note editor having spell activated slows down the os extremely as longer as larger the text. This may cost more than 45 seconds for a text having 400 lines and 17000 characters. So it's strongly suggested to don't global activate "Enable spelling checker" in Preferences!* Up to Gramps 4.0.2 there is a spell related issue [https://www.gramps-project.org/bugs/view.php?id=7339 #7339] which has to be prevented by the there provided patch! ====gir-webkit====Information from README:* GObject introspection data of WebKit is required for the hidden view 'Htmlview', which allows websites to be opened in Gramps. * Users can unhide the view in the plugin manager. * A html renderer must be installed to use the view.* !! PACKAGERS, Test if on your distribution webkit and Gramps is stable. If you obtain crashes, patch src/plugins/view/htmlrenderer.py and src/plugins/view/geoview.gpr.py, so as to remove: from gi.repository import WebKit as webkit 19.01.2014: Webkit is an integrated part of the GTK package. ====goocanvas====Information from README:* Required for the Graphview plugin 19.01.2014: It's is part of the current GTK package === Not Provided by GTK-AIO package === ====ICU/PyICU====Requirements from README (*STRONGLY RECOMMENDED*): 19.01.2014: Download http://dl.dropbox.com/u/81888101/Gramps/PYICU_py27_win32.zip (This zip provides ICU/PyICU version 1.5 (for current version information see https://pypi.python.org/pypi/PyICU ) * Copy all files from PYICU_py27_win32.zip\lib\site-packages to "C:\Python27\Lib\site-packages"* Now we have to place the binaries from PYICU_py27_win32.zip\bin to a folder found by Python / Gramps:** First Option: Somewhere on hard disc e.g. "C:\icu". In this case we have to add this path to the environment variable PATH.** Second Option: Into the same folder as python.exe. That's a good solution for a package, because we don't need any changes for the environment variable PATH. ''If you don't know, where to put dll (you get an "ImportError: DLL load failed" error), put a *.dll in a "C:\Python27\Lib\site-packages" (without a bin subfolder).'' To check ICU/PyICU just try it in Python (don't forget the environment variable PATH): Python 2.7.6 (default, Nov 10 2013, 19:24:18) [MSC v.1500 32 bit (Intel)] on win 32 Type "help", "copyright", "credits" or "license" for more information. >>> import icu >>> print icu.ICU_VERSION 50.1.2 >>> print icu.VERSION 1.5 Comment (19.01.2014): There are other unofficial PyICU versions available some where in the web. But be careful to use other than the one above. Unexpected issues may be caused. ====GraphViz====
Requirements from README (*STRONGLY RECOMMENDED*):
* Enable creation of graphs using GraphViz engine.
* Obtain it from: http://www.graphviz.org
19.01.2014: Following the information on http://www.graphviz.org we get the current package graphviz-2.34.zip from http://www.graphviz.org/Download_windows.php: graphviz-2.36.zip
For the examples we copy the complete content to "C:\Program Files (x86)\Graphviz2.3436\".
To give Gramps the access to this software we have to add the directory of the related binaries to the PATH environment variable. But to prevent trouble with the used dll versions between GraphViz and Gramps it's strongly recommended to add this at the end of PATH
SET PATH=%PATH%;C:\Program Files (x86)\Graphviz2.3430\bin\
{{man warn| Using "Graph View" GraphViz 2.34 or higher forces an error (#{{bug|7109}} Fixed in Gramps 4.2.0). At #{{bug|7109}} you will find a patch to solve the issue for older versions of Gramps.<br>Without this patch and a still unsolved issue one should use graphviz-2.30.1.zip from http://www.graphviz.org/pub/graphviz/stable/windows/. The handling is the same as above}}<br>Comments: GraphViz will be used e. g. for any report in Reports --> Graphs. Without GraphViz there is only one output format "Graphvi File". If all is OK there are several output formats available (e. g. "PDF (Graphviz)", "JPEG image" etc.).
* alternate http://portableapps.com/node/38245 '''GVEdit (Graphviz) Portable''' ====pyexiv2===='''24.02.2013: Will not be used any more, replaced by [[Run_Gramps40_for_Windows_from_source_using_Python_2.7.3#GExiv2 |GExiv2]]''' ====ghostscript ghostview====
Optional packages
* From http://www.ghostscript.com/download/gsdnld.html download the "Ghostscript GPL Release" for "Ghostscript 9.10 for Windows (32 bit)" and run the downloaded file gs910w32.exe. For the example we again use the default installation.
** Python / Gramps needs to know the folder where the binaries are stored (default: "C:\Program Files (x86)\gs\gs9.10\bin") by defining the environment variable PATH.<code>SET PATH=%PATH%;C:\Program Files (x86)\gs\gs9.10\bin\</code>
** As option it's possible to place the content of the binary folder (default: "C:\Program Files (x86)\gs\gs9.10\bin") into the same folder as python.exe to prevent any changes of the environment variable PATH.
* From http://pages.cs.wisc.edu/~ghost/gsview/get50.htm download and run gsv50w32.exe (e. g. into the default install folder: C:\Program Files (x86)\Ghostgum).
** Python / Gramps needs to know the folder where the binaries are stored (default: "C:\Program Files (x86)\Ghostgum\gsview") by defining the environment variable PATH.<br>Comment: This tool will be used to display .ps files as optional result of reports. So at least it's like e.g. any a .pdf viewer or .rtf viewer. It would be possible to include it into any Gramps package. But as normally nobody would include a .pdf viewer or .rtf viewer into a Gramps package I won't suggest to do that for a .ps viewer.
** alternate http://portableapps.com/apps/utilities/ghostscript_portable
===GExiv2=rcs==Is an optional package.02.12.2013: GExiv2 is integrated part of the GTK3 package. Because the EditExifMetadata add-on isn't currently available this package is tested for reading exif data only using the "image metadata" gramplet. ===gtkspell===
Requirements from README (optional package):
* Enable spell checking in the notes. * Gtkspell depends on enchant. * A version of gtkspell with gobject introspection is needed, so minimally version 3.0.0. The basics to use a spell are already included in the here used GTK3 package. The only missed things are myspell dictionaries. These can be found:* from [http://extensionsen.openofficewikipedia.org/ download the language packages of your choice. Included in the there provided .oxt files one can extract by using a program like 7-Zip the necessary .aff and .dic files. * Or you may find these files (.aff and .dic) as part of any GrampsAOI installation in "..\share\enchant\myspell" For our example all files *.aff *.dic have to be stored into "C:\Python27\Lib\site-packages\gnome\share\enchant\myspell". TODO ISSUEwiki/WORK There are still some issues using spell (as per 03.12.2013):* Open the note editor having spell activated slows down the os extremely as longer as larger the text.* The spell settings will not be stored. ===rcs===Requirements from README (optional package):* The Revision_Control_System GNU Revision Control System (RCS) ] can be used to manage multiple revisions of your family trees. * See info at http://www.gramps-project.org/wiki/index.php?title=[[Gramps_4.0_Wiki_Manual_1_Wiki_Manual_-_Manage_Family_Trees#Archiving_a_Family_Tree]]
* Only rcs is needed, NO python bindings are required
It seems to be working but the reload from an archived database doesn't run.
Finally it doesn't matter to install rcs.
====PIL====
Requirements from README (optional package):
* Python Image Library is needed to convert non jpg images to jpg so as to include them in LaTeX output
From http://www.pythonware.com/products/pil/ download PIL-1.1.7.win32-py2.7.exe. Run this installation to add PIL to the used Python version.
* alternate: http://python-pillow.github.io/ ====ttf-freefont====
Information from README: More font support in the reports
07.03.2013 TODO WORK: How to use for the Windows environment. It's assumed that the fonts should be added to the Graphviz environment, but not yet tested. ===gir-webkit===Information from README:* GObject introspection data of WebKit is required for the hidden view 'Htmlview', which allows websites to be opened in Gramps. * Users can unhide the view in the plugin manager. * A html renderer must be installed to use the view.* !! PACKAGERS, Test if on your distribution webkit and Gramps is stable. If you obtain crashes, patch src/plugins/view/htmlrenderer.py and src/plugins/view/geoview.gpr.py, so as to remove: from gi.repository import WebKit as webkit 07.03.2013: Webkit is an integrated part of the GTK3 package. ===goocanvas===Information from README:* Required for the Graphview plugin 03.12.13: It's is part of the current gtk package
==Debug Environment==
==Start Gramps 4.0.x==
===Get Gramps sources===
For all examples it's assumed that the Gramps source (e.g. from the GIT repository httphttps://gitgithub.code.sf.netcom/pgramps-project/gramps/source/ or the .tar.gz from from http://sourceforge.net/projects/gramps/files/Stable/../) will be stored into "C:\Gramps4.0".
It's helpful to use a special client for Windows to get these sources. Also if one gets sources only such a tool provides the possibility of history search and or compare and also to mark differences between the current version on the computer and the repository.
[Changed 03.12.2013]
To run setup.py we need the translation tool msgfmt.exe having a proper version. The installer for poedit (http://sourceforge.net/projects/poedit/files/poedit/1.5/poedit-1.5.7-setup.exe/download) provides msgfmt.exe in version 0.18.1.0.
Latest version of poedit available from https://poedit.net/download
For all examples we assume poedit to be installed to: "C:\Program Files (x86)\Poedit" (The default path of the installer).
Here is an example batch file to run this:
The result should look like this:
running build
Possible exception:<br> * setup.py stops because of a missing "intltool-merge". <br>* setup.py assumes for Windows to have either non installed "intltools" or complete installed "intltools". In some rare situations it could be possible to have an incomplete installation of these tools. But because we don't need these tools to run Gramps itself it's necessary to edit setup.py in such cases: Insert "return (0, 0, 0)" direct behind "if sys.platform == 'win32':" in "def intltool_version():".
...
cmd = ["perl", "-e print qx(intltool-update --version) =~ m/(\d+.\d+.\d+)/;"]
...
Comments:
* After running this it would be possible to run Gramps from "C:\Gramps4.0" or from some where "C:\Gramps4.0\build\...".
TODO ISSUE: Each work around to be removed if not necessary any more
===Overall appearance===
At this point we have a basically running Gramps.
Because we didn't add all packages suggested by the README we didn't have the full functionality. Especially some output formats and the geographic view are not available yet (TODO WORK: Add the missing packages having a usable version.)
To run Gramps a batch seems to be helpful:
"Gramps -v" should show this information now if one uses the gramps-4.0.2.tar.gz from http://sourceforge.net/projects/gramps/files/Stable/4.0.2/:
Gramps Settings:
----------------
python : 2.7.6
gramps : 4.0.2
gtk++ : 3.10.46
pygobject : 3.10.2
pango : 1.36.1
Non-python dependencies:
------------------------
Graphviz : 2.3436
Ghostscr. : 9.10
==Known Major Issues==
As known per 04.2013-12.2013-16* GraphViz 2.34 and later causes an error in Graph View: <strike>see http://www.gramps-project.org/bugs/view.php?id={{bug|7277 }} for more details</strike>('''It's solved with the AIO for Gramps 4.1.1''')
* no Django
* Spell[[Run_Gramps40_for_Windows_from_source_using_Python_2.7.3#gtkspell |gtkspell]]:
** Opening the note editor having spell activated or activating the spell within the note editor blocks Python / the application for a while (as longer as larger the text). Therefore it's suggested to deactivate the spell checker in Preferences. But it's the same if one toggles this feature or changes the spell language interactive using the right mouse context menu in the Note Editor.
** The spell settings will not be stored.
==See also==