Difference between revisions of "Devhelp"
m (→Updated APIs) |
|||
(4 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | + | [[File:Devhelp-gramps-api-5.png|450px|right|thumb|Gramps and Gtk3 APIs into devhelp browser]] | |
− | |||
− | |||
[http://live.gnome.org/devhelp Devhelp] is a Gtk+/Gnome browser for API documentation; it works natively with [http://www.gtk.org/gtk-doc/ gtk-doc] (which is the API reference format for Gtk+/Gnome documentation). | [http://live.gnome.org/devhelp Devhelp] is a Gtk+/Gnome browser for API documentation; it works natively with [http://www.gtk.org/gtk-doc/ gtk-doc] (which is the API reference format for Gtk+/Gnome documentation). | ||
− | + | How to include [https://gramps-project.org/docs/ Gramps API] into the Devhelp index. | |
− | |||
− | |||
− | |||
− | |||
==Paths== | ==Paths== | ||
Line 55: | Line 49: | ||
cd ~/.local/share/devhelp/books | cd ~/.local/share/devhelp/books | ||
git pull | git pull | ||
− | |||
− | |||
{{-}} | {{-}} | ||
Line 65: | Line 57: | ||
* [https://gramps-project.org/docs/ Gramps API] | * [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/General]] | ||
[[Category:Developers/Tutorials]] | [[Category:Developers/Tutorials]] | ||
[[Category:GEPS]] | [[Category:GEPS]] |
Revision as of 09:21, 20 April 2020
Devhelp is a Gtk+/Gnome browser for API documentation; it works natively with gtk-doc (which is the API reference format for Gtk+/Gnome documentation).
How to include Gramps API into the Devhelp index.
Contents
Paths
According to base directories from freedesktop, the working paths could be:
$XDG_DATA_DIRS/devhelp/books $XDG_DATA_DIRS/gtk-doc/html
Steps
1. Go to Gramps/docs folder
2. modify 'update_doc.py' for generating a devhelp file via 'devhelp' key for builder:
$ sphinx-build -b devhelp . _build/devhelp
could be:
$ os.system(' ' '%(program)s -b devhelp . _build/devhelp' ' ' % {'program': sphinxCmd})
in python.
3. run 'update_doc.py':
e.g.,
$ cd docs $ python3 update_doc.py
4. copy the content of _build/devhelp directory into:
~/.local/share/devhelp/books
Need to use the same name for the devhelp file and the top directory (e.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