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 
>This is a listing.

So which is preferred out of:

<para>In this example:

blah blah

<para>In this example:</para>

blah blah

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.


<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"

<para>this example consists of:


Gets transformed to:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<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">

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

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
イェルーン ラウフロック ヴァン デル ウェルヴェン
If you would thoroughly know anything, teach it to others...

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