docbook: Thread: Wrong tags?

I am a Debian user, and so experienced some confusion when I
began writing my HOWTO.  The Author Guide indicates that the
correct docbook dtd was in X and I found mine, after much
agonizing, in Y.  I can now successfully compile my XML document,
but it does not come out the way I would expect it to.  A
<programlisting> is not displayed over a grey background, and a
<command> is listed in boldface, where I would imagine it to be
in courier or some other monospaced font.  The command I'm
running to compile is this:

jade -t sgml -i html -d
/usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
/usr/share/sgml/declaration/xml.dcl filename.xml

Am I using the wrong *.dsl file, the wrong tags, or the wrong
something else?

--
Rachel Collins

On Sep 20,  6:07am, Rachel Collins wrote:
> Subject: Wrong tags?
> I am a Debian user, and so experienced some confusion when I
> began writing my HOWTO.  The Author Guide indicates that the
> correct docbook dtd was in X and I found mine, after much
> agonizing, in Y.  I can now successfully compile my XML document,
> but it does not come out the way I would expect it to.  A
> <programlisting> is not displayed over a grey background, and a
> <command> is listed in boldface, where I would imagine it to be
> in courier or some other monospaced font.  The command I'm
> running to compile is this:
>
> jade -t sgml -i html -d
> /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
> /usr/share/sgml/declaration/xml.dcl filename.xml
>
> Am I using the wrong *.dsl file, the wrong tags, or the wrong
> something else?

Wrong syntax. Try:

  jade -t sgml -i html -d
    /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl#html
    /usr/share/sgml/declaration/xml.dcl filename.xml

Also, is your top-level element "book" or "article"? I'd recommend
you use "article", although it's not a requirement:

  <?xml version="1.0" encoding="ISO-8859-1"?>
  <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
       "http://docbook.org/xml/4.1.2/docbookx.dtd" []>

  <article>
    <articleinfo>
    ...


regards,

-- 
Greg Ferguson    * SGI principal engr / LDP contributor
SGI Tech Pubs    * http://techpubs.sgi.com/ | gferg(at)sgi.com
Linux Doc Project* http://tldp.org/         | gferg(at)metalab.unc.edu

Check http://www.jimweller.net/jim/dbxmlqs/ for details

But you need a #html after the dsl because the ldp.dsl is for both 
print and html. You need to specify which you want. This threw me off 
to.

should be

jade -t sgml -i html -d 
/usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl#html 
/usr/share/sgml/declaration/xml.dcl filename.xml

I do all my doctypes as book and they seem to come out nicely. I'll 
have to mess with article sometime.
Jim

On Friday, September 20, 2002, at 03:07  AM, Rachel Collins wrote:

> I am a Debian user, and so experienced some confusion when I
> began writing my HOWTO.  The Author Guide indicates that the
> correct docbook dtd was in X and I found mine, after much
> agonizing, in Y.  I can now successfully compile my XML document,
> but it does not come out the way I would expect it to.  A
> <programlisting> is not displayed over a grey background, and a
> <command> is listed in boldface, where I would imagine it to be
> in courier or some other monospaced font.  The command I'm
> running to compile is this:
>
> jade -t sgml -i html -d
> /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
> /usr/share/sgml/declaration/xml.dcl filename.xml
>
> Am I using the wrong *.dsl file, the wrong tags, or the wrong
> something else?
>
> --
> Rachel Collins
>
> ______________________
> http://lists.tldp.org/
>

On Fri, 20 Sep 2002 09:09:51 -0400
"Greg Ferguson" ####@####.#### wrote:

> Wrong syntax. Try:
> 
>   jade -t sgml -i html -d
>     /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl#html
>     /usr/share/sgml/declaration/xml.dcl filename.xml

Hmm... I don't recall seeing that in the Author Guide.  I
probably missed it.  Thank you.  That works wonderfully, and
fixed another oddity, so that I don't have to ask the next
question:  How do I make it create a file called 'index.html'
instead of 't1.html'.

Oddly, I can run the command specified above if I run it from a
terminal, but if I run it in nedit, it gives a series of errors
("X20AC" is not a function name...) and fails.

> Also, is your top-level element "book" or "article"? I'd
> recommend you use "article", although it's not a requirement:
> 
>   <?xml version="1.0" encoding="ISO-8859-1"?>
>   <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML
>   V4.1.2//EN"
>        "http://docbook.org/xml/4.1.2/docbookx.dtd" []>

I am using article, thank you.  Mine looks exactly like the
listing above (I copied it from the sample file ;-).

--
Rachel Collins

On Sep 20, 12:05pm, Rachel Collins wrote:
> Subject: Re: Wrong tags?
> On Fri, 20 Sep 2002 09:09:51 -0400
>  ...
> Oddly, I can run the command specified above if I run it from a
> terminal, but if I run it in nedit, it gives a series of errors
> ("X20AC" is not a function name...) and fails.

You can ignore those (safely). I found a fix (there may be more
than way to fix this) to get around the warnings; it involves entity
files. I can post the steps I did, if folks are interested.




-- 
Greg Ferguson    * SGI principal engr / LDP contributor
SGI Tech Pubs    * http://techpubs.sgi.com/ | gferg(at)sgi.com
Linux Doc Project* http://tldp.org/         | gferg(at)metalab.unc.edu