Changes

Jump to: navigation, search

Devhelp

102 bytes added, 01:31, 29 January 2017
no edit summary
{{stub}}[[File:Devhelp-gramps-api-5.png|800px|right|Gramps and Gtk3 APIs into devhelp browser]]
Steps [http://live.gnome.org/devhelp Devhelp] is a Gtk+/Gnome browser for including Gramps' API into devhelp index. [documentation; it works natively with [Filehttp:devhelp//www.gtk.png|600px|thumb|center|Gramps and Gtk3 APIs into devhelp browserorg/gtk-doc/ gtk-doc]] ==Devhelp==(which is the API reference format for Gtk+/Gnome documentation).
How to include [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/devhelp/books/gramps/gramps.devhelp''
* gtk-doc '' $XDG_DATA_DIRS/usrdevhelp/sharebooks $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 pygobject 3.3.2 (trunk): 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==
* [http://sphinx-doc.org/man/sphinx-build.html Sphinx-build]
 
* [https://gramps-project.org/docs/ Gramps API]
* [https://github.com/gramps-project/gramps/tree/master/docs Instructions to build the Gramps API Doc's]
[[Category:Developers/General]]
[[Category:Developers/Tutorials]]
[[Category:GEPS]]

Navigation menu