Re: Additional documentation for help.gnome.org




2013/11/19 Frederic Peters <fpeters gnome org>

With regards to application documentation, library-web (the code
running both help.gnome.org and developer.gnome.org) has support for
modules driven by gnome-doc-utils or yelp-tools, that roughly means
Docbook and Mallard.

Modules that are parts of the modulesets published by the release team
are picked up automatically but it's also possible to manually add new
modules (adding a line to data/extra-tarballs).

You point to Gnumeric documentation. The good news is it is written in
Docbook, but the bad news is it does it with its own build system. It
will therefore need hacks in a few places, from a quick glance it
would need something in src/lgo.py (in extract_modules) to consider
the tarball relevant and containing a docbook documentation, and to
src/modtypes/gnomedocbook.py to hardcode the main documentation file
(gnumeric.xml, currently hardcoded in gnumeric-doc.make).

If there are other modules, I'll be happy to look at them and provide
guidance. Do you have a timeline for those changes? (The hackfest will
be last week of January).

It would be great if we could sort this out within one or two weeks from now given pretty much all the other projects have been migrated already or the migration is going to happen soon. Do you think that would be possible by any chance?

Thanks a lot!


--
Cheers,

Andrea

Debian Developer,
Fedora / EPEL packager,
GNOME Sysadmin,
GNOME Foundation Membership & Elections Committee Chairman

Homepage: http://www.gnome.org/~av


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]