OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Suggested Writing Style

Hi Bob,

-On [20060813 21:39], Bob Stayton (bobs@sagehill.net) wrote:
>As others have pointed out, this is even more noticeable in 
><programlisting>:
>
><programlisting>
>This is a listing.
></programlisting>

So which is preferred out of:

<para>In this example:

  <programlisting>
blah blah
  </programlisting>
</para>

<para>In this example:</para>

<programlisting>
blah blah
</programlisting>

In a sense I would personally say the first one groups the programlisting into
the paragraph, of which it is effectively a part. Unfortunately, using this
method tidy will come up with a lot of "Warning: trimming empty <p>" messages.

Example:

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd";>

<para>this example consists of:

  <programlisting>
testing
  </programlisting>
</para>

Gets transformed to:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
<html xmlns="http://www.w3.org/1999/xhtml";>
  <head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title></title><link rel="stylesheet" href
="docstyle.css" type="text/css" /><meta name="generator" content="DocBook XSL St
ylesheets V1.70.1" /></head><body><p>this example consists of:

  </p><pre class="programlisting">
testing
  </pre><p>
</p></body></html>

The other one doesn't display this 'problem'. So my question is whether my
style is just wrong in this sense or whether it is a problem with the
stylesheets.

Also, with regard to the <para> question, I think that the documentation @
http://www.docbook.org/tdg/en/html/para.html needs to be changed as well then,
since it separates the <para> from the text.

-- 
Jeroen Ruigrok van der Werven <asmodai(-at-)in-nomine.org> / asmodai
イェルーン ラウフロック ヴァン デル ウェルヴェン
http://www.in-nomine.org/
If you would thoroughly know anything, teach it to others...

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]