4,609
edits
Changes
m
→Building Gramps from Scratch: minor grammar
Being able to building Gramps from scratch (from the fundamental Python scripts) is useful to produce a version not currently available as a binary for your particular OS platform or version. Or, to produce a complete environment for debugging and further development, including debugging of all the C libraries Gramps uses... like [https://www.gtk.org/ GTK].
This is a "[https://www.cybrary.it/blog/0p3n/command-line -interface-cli-vs-graphical-user-interface-gui/ command line interface]" process. It's not too difficult, but you'll be using [https://wikipedia.org/wiki/Terminal_(macOS) Terminal.app] and, not the [https://wikipedia.org/wiki/Xcode XCode] integrated development environment.
If you're not familiar with using the unix command line, you might find the frequent use of "~" ([https://www.dictionary.com/browse/tilde?s=t tilde]) below puzzling. It refers to the user's home directory (mine is /Users/john; if your name is John, then yours probably is too.) You can use it that way in commands if your current directory is somewhere else.
==== .jhbuildrc-custom ====
It's annoying tedious and error-prone to type the long list of modules every time you want to build gramps, so . So you may want to modify <tt>~/.jhbuildrc-custom</tt> to declare the <tt>moduleset</tt> and <tt>modules</tt> variables. Note that <tt>.jhbuildrc-custom</tt> is a Python file that is loaded and executed by <tt>jhbuild</tt>, so you can make it quite complex. Do beware be aware that defining new global variables will elicit a warning from <tt>jhbuild</tt> so be sure careful to prefix any top-level variables with '_' ([https://www.dictionary.com/browse/underscore?s=t underscore]).
=== Webkit ===
Gramps has an optional dependency on [https://webkit.org/ WebKit], which is used for the <tt>html-renderer</tt> add-on. If for some reason you want to use this add-on, add <tt>WebKit</tt> to your list of dependencies but be aware that it may take a long time to build.
== Bundling ==