[publican-list] [Bug 470165] incorrect page number format for parts in TOC

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.


https://bugzilla.redhat.com/show_bug.cgi?id=470165


Brian Forte <bforte at redhat.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |CLOSED
         Resolution|                            |NOTABUG




--- Comment #2 from Brian Forte <bforte at redhat.com>  2008-11-06 20:45:29 EDT ---
The behaviour ccurran describes is a consequence of the <preface> tag being
used for material that isn't part of the book's front matter. Specifically, the
Virtualization Guide's Book_Info.xml has a structure as follows:

<book>
    <xi:include href="font_matter_1_filename"></xi:include>
    <xi:include href="font_matter_2_filename"></xi:include>
    <part id="part_1_name">
        <title>part_1_title</title>
        <xi:include href="chapter_1_filename"</xi:include>
        <xi:include href="chapter_2_filename"</xi:include>
    </part>
    <part id="part_2_name">
        <title>part_2_title</title>
        <preface id="preface_2_title">
            <title>preface_2_title</title>
            <para>
                Introductory remarks about part 2.
            </para>
        </preface>
        <xi:include href="chapter_3_filename"</xi:include>
        <xi:include href="chapter_4_filename"</xi:include>
    </part>
    <part id="part_3_name">
        <title>part_3_title</title>
        <preface id="preface_3_title">
            <title>preface_3_title</title>
            <para>
                Introductory remarks about part 3.
            </para>
        </preface>
        <xi:include href="chapter_3_filename"</xi:include>
        <xi:include href="chapter_4_filename"</xi:include>
    </part>
    <!-- and so on -->
</book>

As jfearn notes above:

> This is due to the page.number.format template, the default code
> does not have any logic to differentiate the format used for a
> preface based on where the preface is located.

And it doesn't have that logic because prefaces are, by definition, front
matter. This is, then, expected behaviour and not a bug.

The solution to ccurran's problem is to replace all the <preface> tags
currently inside <part> tags in Book_Info.xml with <partintro> tags.

According to
<http://oasis-open.org/docbook/documentation/reference/html/partintro.html>
this tag 'contains introductory text, often an overview of the content of the
Part.'

It has <part> and <reference> as parents and takes <title> and <para> as
children.

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.