Open main menu

Gramps β

Changes

Devhelp

387 bytes added, 17:40, 15 November 2024
m
See also: adding sphinx snippets
{{stub}}[[File:Devhelp-gramps-api-5.png|450px|right|thumb|Gramps and Gtk3 APIs into devhelp browser]]
Steps [https://wiki.gnome.org/Apps/Devhelp Devhelp] is a Gtk+/Gnome browser for including Gramps' API into devhelp indexdocumentation; it works natively with [https://wiki.gnome.org/DocumentationProject/GtkDoc gtk-doc] (which is the API reference format for Gtk+/Gnome documentation).
How to include [[File:devhelp.png|600px|thumb|center|Gramps and Gtk3 APIs into devhelp browser]] ==Devhelp== [httphttps://live.gnomegramps-project.org/devhelp Devhelp] is a Gtk+docs/Gnome browser for Gramps API documentation; it works natively with [http://www.gtk.org/gtk-doc/ gtk-doc] (which is into the API reference format for Gtk+/Gnome documentation)Devhelp index.
==Paths==
According to [http://standards.freedesktop.org/basedir-spec/latest/ base directories from freedesktop], the working patchs should paths could be: * devhelp
''~/.local/share/devhelp/books/gramps/gramps.devhelp'' ''/usr/local/share $XDG_DATA_DIRS/devhelp/books/gramps/gramps.devhelp'' * gtk-doc ''/usr/share $XDG_DATA_DIRS/gtk-doc/html/gramps/gramps.devhelp''
==Steps==
1. Go to ''Gramps_SVNGramps/docs'' folder
2. modifiy modify 'update_doc.py' for generating a devhelp file via 'devhelp' key for builder:
$ sphinx-build -b devhelp . _build/devhelp
3. run 'update_doc.py':
ege.g.,
$ PYTHONPATH=/usr/local/lib/python2.7/site-packages/:/home/jerome/trunk python cd docs $ python3 update_doc.py path for ppygobject 3.3.2: path to gramps dir
4. copy the content of ''_build/devhelp'' directory into one of the [[#Paths|above paths for : ~/.local/share/devhelp index]]./books
5. run a command (which one?) or wait Need to use the '''same name''' for the next post installation devhelp file and the top directory (rebuild of indexes after new packagee.g., Gramps==Updated python APIs== Give a try to:  git clone https://github.com/lazka/pgi-docs-devhelp.git ~/.local/share/devhelp/books devhelp To update:  cd ~/.local/share/devhelp/books git pull {{-}}
==See also==
* [https://gramps-project.org/docs/ Gramps API] in Sphinx* [https://github.com/gramps-project/gramps/tree/master/docs Instructions to build the Gramps API Doc's] in Sphinx using GitHub* [http://sphinx-doc.org/man/sphinx-build.html Sphinx-build] on sphinx-doc.org* [https://gramps.discourse.group/t/how-can-useful-snippets-be-proposed-for-the-sphinx-developer-docs/5740 How can "Useful Snippets" be proposed for the Sphinx developer docs]
[[Category:Developers/General]]
[[Category:Developers/Tutorials]]
[[Category:GEPS]]
5,421
edits