Documentation: hot-link references from help to guide - how?

[Yawar Amin]

Hi Alex,

On 2010-10-29, at 19:50, J. Alex Aycinena wrote:

> In the Help Manual, section 9.4.1, there is a text reference to
> 'Section 8.7, Selling Shares, of the GnuCash Tutorial and Concepts
> Guide' which is written in plain text. Does anyone know if it is
> possible to make this a hot-link across documents, and, if so, can you
> tell me how to do it?

There are several places where we’d definitely benefit from linking across the documents. That said, I mentioned the DocBook 5 ‘set’ method in [1], but as of now I’ve had a chance to try out the idea, so am attaching a test set here. You can generate the HTML with the following:

xsltproc -o html/ /usr/local/Cellar/docbook/5.0/docbook/xsl/1.75.2/html/chunk.xsl test-set.xml

Substituting, of course, wherever you have the ‘chunk.xsl’ file. In a modern Linux distro it should be somewhere in /usr/share/xml.

This will put the HTML files in the ‘html/’  subdirectory.

Implementing this in the current GC docs would force quite a bit of rearranging files and directories. What do you think?

Regards,

Yawar

[1] https://bugzilla.gnome.org/show_bug.cgi?id=632244#c4

-------------- next part --------------
A non-text attachment was scrubbed...
Name: PGP.sig
Type: application/pgp-signature
Size: 194 bytes
Desc: This is a digitally signed message part
URL: <http://lists.gnucash.org/pipermail/gnucash-devel/attachments/20101030/7f6036d3/attachment.bin>