[GNC-dev] Register Documentation Improvements (was Re: [GNC] Column widths again)

[John Ralls]

> On Aug 23, 2018, at 12:45 AM, Geert Janssens <geert.gnucash at kobaltwit.be> wrote:
> 
> It would be nice if our html version of the docs would get some css love in 
> that case though. Wading through plain rendered html is an equally 2000'ish 
> experience.

I just had a look at https://github.com/Gnucash/gnucash-docs/tree/master/xsl <https://github.com/Gnucash/gnucash-docs/tree/master/xsl>. It’s pretty old, the docbook part is 1.75.2 from 2010 and the rest was lifted from an early Gnome docs beta and never updated. No wonder it looks like 2000’ish html, it *is* 2000’ish html!

We could go Gnome [1] or we could just use the latest stylesheets [2] from DocBook itself (tutorial [3]). Or we could do something else. 

Regards,
John Ralls

[1] https://gitlab.gnome.org/GNOME/gnome-doc-utils <https://gitlab.gnome.org/GNOME/gnome-doc-utils>
[2] https://github.com/docbook/xslt10-stylesheets/ <https://github.com/docbook/xslt10-stylesheets/>, reference docs https://github.com/docbook/xslt10-stylesheets/tree/master/xsl/doc <https://github.com/docbook/xslt10-stylesheets/tree/master/xsl/doc>
[3] http://www.sagehill.net/docbookxsl/ <http://www.sagehill.net/docbookxsl/>