summaryrefslogtreecommitdiff
path: root/doc/docbook.xsl
blob: 2235be2e37a8f9d7bd37e49bf6b94c23ba87b3f4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
<!-- This custom XSL tweaks the DocBook XML -> HTML settings to produce
     an OK-looking manual.  -->
<!DOCTYPE xsl:stylesheet [
<!ENTITY css SYSTEM "style.css">
]>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
		version='1.0'>
  <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>

  <!-- Embed our stylesheet as the user-provided <head> content. -->
  <xsl:template name="user.head.content"><style>&css;</style></xsl:template>

  <!-- Remove the body.attributes block, which specifies a bunch of
       useless bgcolor etc. attrs on the <body> tag. -->
  <xsl:template name="body.attributes"></xsl:template>

  <!-- Specify that in "book" form (which we're using), we only want a
       single table of contents at the beginning of the document. -->
  <xsl:param name="generate.toc">book toc</xsl:param>

  <!-- Don't put the "Chapter 1." prefix on the "chapters". -->
  <xsl:param name="chapter.autolabel">0</xsl:param>

  <!-- Make builds reproducible by generating the same IDs from the same inputs -->
  <xsl:param name="generate.consistent.ids">1</xsl:param>

  <!-- Use <ul> for the table of contents.  By default DocBook uses a
       <dl>, which makes no semantic sense.  I imagine they just did
       it because it looks nice? -->
  <xsl:param name="toc.list.type">ul</xsl:param>

  <xsl:output method="html" encoding="utf-8" indent="no"
              doctype-public=""/>
</xsl:stylesheet>