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] section "label" attribute not producing label

Dear Brendan,

A couple of remarks:
Oxygen XML Editor's visual editing mode is based on CSS, you can right click in the Author visual editing mode and choose to use the "Inspect Styles" action to see what CSS styles are used to display the current element. Although we designed our editing CSS to be similar to how the published output looks the publishing part is totally uncoupled from the CSS used for editing so it may happen that you see things in a certain way when editing but differently when publishing. For example we did not add special selectors in our editing CSS to look at the @label value for each section. This can be done of course but it seems that also the publishing kind of ignores these @label attributes on various elements.

Coming back to your problem, in my opinion it's more flexible to use the DocBook <section> element instead of using <sectX> element. This is more flexible because it allows you to copy sections from one place to another without needing to rename the element name for example.

For the DocBook PDF output there is an XSLT stylesheet created by the DocBook XSLT project:


which matches various sections like:

<xsl:template match="d:section">


<xsl:template match="d:sect1">

which match various DocBook section elements and produce the corresponding XSL-FO content which later is converted to PDF using the Apache FOP processor bundled with Oxygen. Right now I do not see any special XSLT code in these templates which looks for the @label attribute, no matter what parameters would be set.


Radu Coravu
<oXygen/> XML Editor

On 9/25/2019 9:41 PM, Brendan Martin wrote:

I’m entirely new to DocBook and am trying to use it in Oxygen’s XML
Editor (v. 21). I’m trying to convert a client’s native XML to DocBook
for use.

I have a document with <sect1> as a root element and subsections and the
@label attribute does not work:

 1. In Oxygen Author mode section labels are prefixed with the label of
    the component that contains them (I want to turn that off), plus the
    actual @label value is ignored (autonumbering takes over), e.g.,
    <sect1 label=”Chapter 6”> appears in Oxygen as “Section 1:”
 2. In PDF the @label value is simply ignored.

Any help is appreciated. Thanks.


Brendan Martin

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