[PATCH xorg-sgml-doctools] ToC on separate page in pdfs.
marcoz at osource.org
Sun Jan 1 13:16:59 PST 2012
On 12/31/2011 06:28 PM, Gaetan Nadon wrote:
> On 11-12-31 04:37 PM, Matt Dew wrote:
>> In the PDFs and postscript files docs, the Table of Contents should be on its own page if the
>> doctype='article'. This matches the behavior with doctype='book' documents.
>> xorg-fo.xsl | 7 +++++++
>> 1 files changed, 7 insertions(+), 0 deletions(-)
>> diff --git a/xorg-fo.xsl b/xorg-fo.xsl
>> index d57f7ac..4ce8acd 100644
>> --- a/xorg-fo.xsl
>> +++ b/xorg-fo.xsl
>> @@ -84,4 +84,11 @@
>> <xsl:param name="body.font.family">DejaVu Serif</xsl:param>
>> <xsl:param name="symbol.font.family">serif,Symbol,AR PL UMing CN,AR PL ShanHeiSun Uni,GNU Unifont</xsl:param>
>> +<!-- put page breaks before and after the Table of Contents,
>> + so that the ToC is on a page by itself -->
>> +<xsl:attribute-set name="toc.margin.properties">
>> +<xsl:attribute name="break-before">page</xsl:attribute>
>> +<xsl:attribute name="break-after">page</xsl:attribute>
> It works for me as well. A couple of things to do:
> The attribute names are not listed in
> http://docbook.sourceforge.net/release/xsl/current/doc/fo/ listed at the
> top of the xorg-fo.xsl.
> Where were these documented?
I found them on the sagehill site:
> Does it prereq a certain version of docbook xsl?
Not that I can determine. To be safe I installed 1.70.1 and tried it.
(XML_DEBUG_CATALOG=1 showed it was being picked up as expected.)
> Rather than appending the new code at the end of the file, which would
> break the current style, could you move it under a new heading called
> "ToC/LoT/Index Generation" at line 34?
> I don't know if you have noticed, I wrote the xsl file by following the
> "Part 2. FO Parameter Reference" classification so a reader can easily
> put the code in context of the documentation.
I noticed a while back that you'd been grouping things but it didn't
dawn on me that it belonged under "Pagination and General Styles FO
Parameters". It's good there's a review process, it's there now.
More information about the xorg-devel