This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[docbook] Re: Question about prettyprinting Docbook documents and characterentities


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

/ Taro Ikai <tikai@ABINITIO.COM> was heard to say:
| I am having a few problems prettyprinting my Docbook documents. I am using 
| Cygwin distribution of Tidy.

Beyond the fact that tidy is not designed to pretty print anything but HTML,
it is very, very hard to pretty print DocBook.

It is semantically *wrong* and *in error* to introduce whitespace (or
delete whitespace) from any element that contains mixed content. In
DocBook, that means a whole lot of elements.

As a specific example, given:

<chapter><title>Some title</title>
<para>Some
paragraph
</para><para>Some other
para</para>
</chapter>

It could be pretty printed this way:

<chapter>
  <title>Some title</title>
  <para>Some
paragraph
</para>
  <para>Some other
para</para>
</chapter>

But it would be an error to touch any of the text inside the para elements.

                                        Be seeing you,
                                          norm

- -- 
Norman Walsh <ndw@nwalsh.com>      | In the bathtub of history the
http://www.oasis-open.org/docbook/ | truth is harder to hold than the
Chair, DocBook Technical Committee | soap, and much more difficult to
                                   | find.--Terry Pratchett
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE/FzOSOyltUcwYWjsRAp/BAKCsMG6d5Jww9BASfm+/arbIEhl8CgCfWjik
8GsSzR00LuZKJlqnobaKQx8=
=8MG/
-----END PGP SIGNATURE-----

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]