Changes

Jump to: navigation, search

Windows installer

545 bytes added, 07:47, 30 October 2020
Additional plugins
{{languages|Windows installer}}{{man warn|These are the original instructions for installation on Windows of Gramps 3.4.x and earlier|They were written when a Windows user also had to (manually) install various other programs ("dependencies") in order to get Gramps to work.<br>'''A much easier way to install Gramps on Windows is to use the "all-in-one" [[All In One Gramps Software Bundle for Windows|installer]], since it has all the needed programs ("bundled")'''. {{man menu|[[Download#MS_Windows]]}}}} {{stub}}
Because Gramps has been designed and written in multi-platform resources (including Python and GTK), we have created a Windows installer that has been reported to work without any obvious issues.
We do suggest the following:
* Work with ''a copy'' of your main database and keep regular backups in the [[GRAMPS_XML|GRAMPS Gramps XML]] format.
* Join the [https://lists.sourceforge.net/lists/listinfo/gramps-users Gramps Users mailing list] to share your experiences, especially if you are a developer able to contribute to a Windows port.
* See also [[Gramps and Windows]] for a collection of hints to run Gramps on MS Windows.
The essential dependencies that Gramps requires to run are:
* Python 2.6.x or later (Gramps trunk has not yet been ported to Python 3.xand has different dependancies)
* GTK runtime
* GTK python bindings (PyGTK, PyGObject, PyCairo)
=== Dependencies - The easy way ===
Select the correct version of Python dependent on your operating system.
{{man tip|Tip: |Currently The (2011-6-20) the minimal installer only comes in came as a '''32 bit''' version, if you are running on a 64 bit operating system '''select a 32 bit Python installer'''}}
;For Gramps 3.1.x and laterto 3.4.x
{| {{prettytable}}
!Order
'''2.''' Install the packages in the following order:
;For Gramps 3.1.x and laterto 3.4.x
{| {{prettytable}}
!Order
* The Relationship Graph reports (both graph and code output formats) need an installation of [http://www.graphviz.org Graphviz]. There is a bug in the current stable release, see this [[Howto:_Make_a_relationship_chart#Example_3.2C_Generating_the_graph_by_using_the_Graphviz_command_line_tool |example]].
* The Relationship Graph can not use PDF as output format unless there is an installation of [httphttps://pageswww.cs.wiscghostscript.edu/~ghostcom/ ghostscriptGhostscript]. After installation, if gswin32.exe or gswin32c.exe is in the path, PDF should appear as one of the formats in the graphical Relationship Graph report.
* '''Spell-checking:'''
*# For spell-checking to work you first need [httphttps://wwwabiword.abisourcegithub.com/projectsio/enchant/ Enchant library] and python bindings [httphttps://wwwpypi.rfk.idpython.auorg/softwarepypi/pyenchant/ PyEnchant]. Enchant appears to be a generic spell checking library. You can request dictionaries from it, ask if a word is correctly spelled, get corrections for a misspelled word, etc... PyEnchant is a set of language bindings and some wrapper classes to make the excellent Enchant spellchecker available as a Python module. Both are available for windows as single setup file:
*#* [http://pypi.python.org/packages/any/p/pyenchant/pyenchant-1.5.3.win32.exe pyenchant-1.5.3.win32.exe]
*# Secondly you need [http://www.pygtk.org/pygtkspell/ PyGTKSpell] from [http://www.pygtk.org/about.html gnome-python-extras] which is bindings allowing to run Python programs using the [http://gtkspell.sourceforge.net/ GtkSpell library], that extends GTK+'s GtkTextView widget with support for spell-checking. Depending of yours Python version download and install one of these:
When this minimal Windows installer was first written, there was no intent to package all the dependencies and the Gramps package into one installer. It is very complex to coordinate dependencies between Gramps and these other projects. It also means a single 30+ MB download every version change. However, later such a package was created and many people find it easier than personally installing all the dependencies; see [[All In One Gramps Software Bundle for Windows| GrampsAIO]] for more information.
There have been discussions about trying to install compiled distillations (dynamic link libraries) of these core dependencies to avoid having to install the entire Python and GTK environment, but this work never progressed beyond discussion. For more about this and other Windows issues, see the [https://lists.sourceforge.net/lists/listinfo/gramps-windows email list(List gone)] archive.
On Windows Vista you will need to save the executable using "save as" and run it as administrator, otherwise the programs will not be able to write to the registry on installation. To do that right click the saved file and choose "run as administrator".
* [[Gramps and Windows]] describes users experiences using Gramps on Windows.
* [https://lists.sourceforge.net/lists/listinfo/gramps-users Gramps users mailing list]
* [[Gramps for Windows with MSYS2]]
 
[[Category:Documentation]][[Category:Developers/Packaging]]
301
edits

Navigation menu