Re: section "label" attribute not producing label

Radu Coravu <[email protected]>
Newsgroups gmane.text.docbook.apps
Message-ID <[email protected]>
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:

OXYGEN_INSTALL_DIR/frameworks/docbook/xsl/fo/sections.xsl

which matches various sections like:

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

or:

> <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.

Regards,
Radu

Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

On 9/25/2019 9:41 PM, Brendan Martin wrote:
> Hi,
>
>
>
> 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.
>
>
>
> Regards,
>
> Brendan Martin
>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.