docbook: Re: How to create a HOWTO on Red Hat Linux 9?
Subject:
Re: How to create a HOWTO on Red Hat Linux 9?
From:
"Martin A. Brown" ####@####.####
Date:
21 Oct 2003 02:41:47 -0000
Message-Id: <Pine.LNX.4.58.0310202127180.15235@copula.wonderfrog.net>
: 1. Where I present something the user should type in, I
: have used the COMPUTEROUTPUT tag to show the shell prompt so it's
: not displayed in bold, and then the USERINPUT tag to show what
: the user actually types. However, it is then showing the output
: on two separate lines; is there a way I can tell it not to do
: this?
Try:
<programlisting>
<prompt>[root@example]# </prompt><userinput>echo text</userinput>
<computeroutput>text</computeroutput>
</programlisting>
This should give you the sort of spacing you desire.
[ I snipped questions 2 and 3. I'll leave them for somebody else. ]
: 4. If I try to create multiple HTML pages instead of
: just one, the filenames are "t1.html" and "x76.html" which seems
: very odd to me. Is there no way to suggest "howto-1.html" and
: "howto-2.html" names? I remember the old sgml-tools used to name
: them this way, and it seemed a much more intuitive method to me.
I, too, stumbled over this, and find that it's annoying and also
somewhat non-intuitive, however, the fix isn't too hard.
It's the famous "use-id-as-filename" flag, which is available with
different syntax in either a DSSSL or XSL processor. Since you are
using Jade (correct?), you should add the following option to your
jade command:
-V %use-id-as-filename%
http://docbook.sourceforge.net/release/dsssl/current/doc/html/use-id-as-filename.html
[ I snipped your last question, too. ]
Good luck!
-Martin