Many thanks for the feedback Ann,
>> - having an index/toc, perhaps with 'links' to the sections
>> described in docbook and where appropriate in the output format.
>> Docbook can do this automatically. Read up on the stylesheets to
> determine how you'd like this handled. It will also do all your intra
> and inter document linking.
Cheers, I will look into this
> Other issues I have encountered which include:
>> - There is a learning curve to write proper docbook xml.
> - People *still* focus too much on what they want things to look like
> and don't pay attention to appropriate markup options.
> - People confuse the version control systems for the xml files with
> the document publishing systems.
> - It becomes increasingly slow to render the docs tree, the more
> documentation gets added. On the original machine we installed it,
> documentation docs suggested you go get a cup of coffee while it parsed.
Thanks again, you're feedback was very useful to me in raising some
points I had not thought of and demonstrating that it is do-able.
> I suppose if you had the time to put into it you could restrict tags
> accepted by your parser, basically customising your own simplified
> docbook to reduce some of these risks.
Ah, time, the biggest issue I have at the minute.
If I every get around to having something working I'll be glad to
feedback on the experience is anyone else is interested.
Maintained by the ILUG website team. The aim of Linux.ie is to
support and help commercial and private users of Linux in Ireland. You can
display ILUG news in your own webpages, read backend
information to find out how. Networking services kindly provided by HEAnet, server kindly donated by
Dell. Linux is a trademark of Linus Torvalds,
used with permission. No penguins were harmed in the production or maintenance
of this highly praised website. Looking for the
Indian Linux Users' Group? Try here. If you've read all this and aren't a lawyer: you should be!