This is the mail archive of the
mailing list for the DocBook project.
[docbook] Forst Attempt at Writing a Manual Not Going Well
- From: Brian Sutin <sutin at ociw dot edu>
- To: docbook at lists dot oasis-open dot org
- Date: Wed, 16 Apr 2003 17:48:18 -0700
- Subject: [docbook] Forst Attempt at Writing a Manual Not Going Well
- Organization: The Observatories of the Carnegie Institution of Washington
I am part of a team building a large astronomical spectrograph:
which requires a convenient system for writing documentation.
I initially picked DocBook as the obvious choice, but I seem
to be unable to make it do (what seems to me to be) the most
For example, the structure of the documentation is as follows.
There are two sections, a User Manual and a Technical Manual.
They should print separately as completely separate books,
but they should be able to refer to each other in HTML. How
do I do that?
Second, each of the two parts above is composed of sections
which have been written by different people. How do I make
the output give attribution? If I try:
Glorious Bits of Stuff
<firstname> Bob </firststuff>
<firstname> Bones </firststuff>
Then the output (HTML) looks like:
Glorious Bits of Stuff Bob Bones
Something like a line break would be good, but DocBook is not
supplying one. The .pdf output isn't printing the chapter
titles at all. Is that a bug?
Trying to use the <article> keyword for each section just so
the author prints in some intelligent way does not seem like
the right thing to do.
The source I am playing with and all of the resulting output
are available at:
Brian M. Sutin Instrument Scientist Pasadena, CA
The Observatories of the Carnegie Institution of Washington
To unsubscribe, e-mail: docbook-unsubscribe at lists dot oasis-open dot org
For additional commands, e-mail: docbook-help at lists dot oasis-open dot org