Embedded displays in <para>s in DocBook

Subject: Embedded displays in <para>s in DocBook
From: Andrey Taranov <andrey@xxxxxxxxxxxxx>
Date: Fri, 19 Feb 1999 14:54:00 +0300
Hello Dssslist,

  What do you think of the following problem:

  I use a customized version of Norman's stylesheet to process DocBook
  texts. The standard paragraph style in my company is justified text
  with indented first line. Now consider some displayed element
  embedded in para text (e.g. <literallayout>):

  <para>Some text ...
      <literallayout>example text</>
    continuation of the preceding text.</para>

  The result of this construct is that we get an extra space at the
  beginning of continuation paragraph in RTF output. This is
  definitely not desired.

  One solution would be to glue the first word of continuation text to
  the close tag of the displayed element. This solves the problem ok,
  but does not satisfy me, because I just cannot make all the typers
  in the company follow this convention. Two alternatives remain:

  1) process the situation as it is by the stylesheet somehow; or
  2) split the <para> element in two -- preceding the display and
  following the display -- and use some role=cont attribute on the
  continuation paragraph to tell the stylesheet to suppress the
  indentation of the first line.

  The question is: which way to choose? Both require some support from
  the stylesheet, but I cannot think of a way to implement the 1) way.
  On the other hand I can implement things like way 2) quite easily.

  Which way is THE-RIGHT-THING, anyhow?

Best regards,
 Andrey                          mailto:andrey@xxxxxxxxxxxxx



 DSSSList info and archive:  http://www.mulberrytech.com/dsssl/dssslist


Current Thread