Difference between revisions of "Devhelp"

From Gramps
Jump to: navigation, search
m (Steps)
(Steps)
Line 27: Line 27:
 
1. Go to ''Gramps_SVN/docs'' folder
 
1. Go to ''Gramps_SVN/docs'' folder
  
trunk: gramps.gen modules are OK, broken relative import for specific modules and interfaces related to Gramps program.
+
2. modifiy 'update_doc.py' for generating a devhelp file via 'devhelp' key for builder:
  
2. modifiy 'makefile' for generating a devhelp file via 'devhelp' key for builder:
+
$ sphinx-build -b devhelp . _build/devhelp
  
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) _build/devhelp
+
could be:
  
3. copy the content of ''_build/devhelp'' directory into one of the [[#Paths|above paths for devhelp index]].
+
$ os.system('''%(program)s -b devhelp . _build/devhelp''' % {'program': sphinxCmd})
  
4. run a command (which one?) or wait for the next post installation (rebuild of indexes after new package)
+
in python.
 +
 
 +
3. run 'update_doc.py':
 +
 
 +
eg,
 +
 
 +
$ PYTHONPATH=/usr/local/lib/python2.7/site-packages/:/home/jerome/trunk python 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 devhelp index]].
 +
 
 +
5. run a command (which one?) or wait for the next post installation (rebuild of indexes after new package)
  
 
==See also==
 
==See also==

Revision as of 09:02, 4 December 2012

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Steps for including Gramps' API into devhelp index.

Gramps and Gtk3 APIs into devhelp browser

Devhelp

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).

Paths

According base directories from freedesktop, the working patchs should be:

  • devhelp

~/.local/share/devhelp/books/gramps/gramps.devhelp

/usr/local/share/devhelp/books/gramps/gramps.devhelp

  • gtk-doc

/usr/share/gtk-doc/html/gramps/gramps.devhelp

Steps

1. Go to Gramps_SVN/docs folder

2. modifiy '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':

eg,

$ PYTHONPATH=/usr/local/lib/python2.7/site-packages/:/home/jerome/trunk python update_doc.py 
  1. path for ppygobject 3.3.2: path to gramps dir

4. copy the content of _build/devhelp directory into one of the above paths for devhelp index.

5. run a command (which one?) or wait for the next post installation (rebuild of indexes after new package)

See also