Skip to content

Commit 37b0277

Browse files
philwebbphilwebb
committed
Restore custom reference manual titlepage
Restore the custom title page of the reference manual in order to remove the large list of authors on the first page. Note: This change will require updating to version 0.1.7 of the docbook-reference-plugin when it is released. Issue: SPR-10008
1 parent 5a2130a commit 37b0277

File tree

3 files changed

+719
-0
lines changed

3 files changed

+719
-0
lines changed

‎src/reference/docbook/xsl/html-custom.xsl

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
3+
<!--
4+
Licensed to the Apache Software Foundation (ASF) under one
5+
or more contributor license agreements. See the NOTICE file
6+
distributed with this work for additional information
7+
regarding copyright ownership. The ASF licenses this file
8+
to you under the Apache License, Version 2.0 (the
9+
"License"); you may not use this file except in compliance
10+
with the License. You may obtain a copy of the License at
11+
12+
http://www.apache.org/licenses/LICENSE-2.0
13+
14+
Unless required by applicable law or agreed to in writing,
15+
software distributed under the License is distributed on an
16+
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17+
KIND, either express or implied. See the License for the
18+
specific language governing permissions and limitations
19+
under the License.
20+
-->
21+
22+
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
23+
xmlns:xslthl="http://xslthl.sf.net"
24+
exclude-result-prefixes="xslthl"
25+
version='1.0'>
26+
27+
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"/>
28+
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/highlight.xsl"/>
29+
<xsl:import href="titlepage/spring-html.xsl"/>
30+
31+
<xsl:param name="chunk.section.depth">'5'</xsl:param>
32+
<xsl:param name="use.id.as.filename">'1'</xsl:param>
33+
34+
<!-- Only use scaling in FO -->
35+
<xsl:param name="ignore.image.scaling">1</xsl:param>
36+
37+
<!-- Use code syntax highlighting -->
38+
<xsl:param name="highlight.source">1</xsl:param>
39+
40+
<!-- Extensions -->
41+
<xsl:param name="use.extensions">1</xsl:param>
42+
<xsl:param name="tablecolumns.extension">0</xsl:param>
43+
<xsl:param name="callout.extensions">1</xsl:param>
44+
45+
<!-- Activate Graphics -->
46+
<xsl:param name="admon.graphics" select="1"/>
47+
<xsl:param name="admon.graphics.path">images/admon/</xsl:param>
48+
<xsl:param name="admon.graphics.extension">.png</xsl:param>
49+
<xsl:param name="callout.graphics" select="1" />
50+
<xsl:param name="callout.defaultcolumn">120</xsl:param>
51+
<xsl:param name="callout.graphics.path">images/callouts/</xsl:param>
52+
<xsl:param name="callout.graphics.extension">.png</xsl:param>
53+
54+
<xsl:param name="table.borders.with.css" select="1"/>
55+
<xsl:param name="html.stylesheet">css/manual.css</xsl:param>
56+
<xsl:param name="html.stylesheet.type">text/css</xsl:param>
57+
<xsl:param name="generate.toc">book toc,title</xsl:param>
58+
59+
<xsl:param name="admonition.title.properties">text-align: left</xsl:param>
60+
61+
<!-- Leave image paths as relative when navigating XInclude -->
62+
<xsl:param name="keep.relative.image.uris" select="1"/>
63+
64+
<!-- Label Chapters and Sections (numbering) -->
65+
<xsl:param name="chapter.autolabel" select="1"/>
66+
<xsl:param name="section.autolabel" select="1"/>
67+
<xsl:param name="section.autolabel.max.depth" select="3"/>
68+
69+
<xsl:param name="section.label.includes.component.label" select="1"/>
70+
<xsl:param name="table.footnote.number.format" select="'1'"/>
71+
72+
<!-- Show only Sections up to level 3 in the TOCs -->
73+
<xsl:param name="toc.section.depth">3</xsl:param>
74+
75+
<!-- Remove "Chapter" from the Chapter titles... -->
76+
<xsl:param name="local.l10n.xml" select="document('')"/>
77+
<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
78+
<l:l10n language="en">
79+
<l:context name="title-numbered">
80+
<l:template name="chapter" text="%n.&#160;%t"/>
81+
<l:template name="section" text="%n&#160;%t"/>
82+
</l:context>
83+
</l:l10n>
84+
</l:i18n>
85+
86+
<xsl:template match='xslthl:keyword' mode="xslthl">
87+
<span class="hl-keyword"><xsl:apply-templates mode="xslthl"/></span>
88+
</xsl:template>
89+
90+
<xsl:template match='xslthl:comment' mode="xslthl">
91+
<span class="hl-comment"><xsl:apply-templates mode="xslthl"/></span>
92+
</xsl:template>
93+
94+
<xsl:template match='xslthl:oneline-comment' mode="xslthl">
95+
<span class="hl-comment"><xsl:apply-templates mode="xslthl"/></span>
96+
</xsl:template>
97+
98+
<xsl:template match='xslthl:multiline-comment' mode="xslthl">
99+
<span class="hl-multiline-comment"><xsl:apply-templates mode="xslthl"/></span>
100+
</xsl:template>
101+
102+
<xsl:template match='xslthl:tag' mode="xslthl">
103+
<span class="hl-tag"><xsl:apply-templates mode="xslthl"/></span>
104+
</xsl:template>
105+
106+
<xsl:template match='xslthl:attribute' mode="xslthl">
107+
<span class="hl-attribute"><xsl:apply-templates mode="xslthl"/></span>
108+
</xsl:template>
109+
110+
<xsl:template match='xslthl:value' mode="xslthl">
111+
<span class="hl-value"><xsl:apply-templates mode="xslthl"/></span>
112+
</xsl:template>
113+
114+
<xsl:template match='xslthl:string' mode="xslthl">
115+
<span class="hl-string"><xsl:apply-templates mode="xslthl"/></span>
116+
</xsl:template>
117+
118+
</xsl:stylesheet>

‎src/reference/docbook/xsl/html-single-custom.xsl

Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
3+
<!--
4+
Licensed to the Apache Software Foundation (ASF) under one
5+
or more contributor license agreements. See the NOTICE file
6+
distributed with this work for additional information
7+
regarding copyright ownership. The ASF licenses this file
8+
to you under the Apache License, Version 2.0 (the
9+
"License"); you may not use this file except in compliance
10+
with the License. You may obtain a copy of the License at
11+
12+
http://www.apache.org/licenses/LICENSE-2.0
13+
14+
Unless required by applicable law or agreed to in writing,
15+
software distributed under the License is distributed on an
16+
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17+
KIND, either express or implied. See the License for the
18+
specific language governing permissions and limitations
19+
under the License.
20+
-->
21+
22+
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
23+
xmlns:xslthl="http://xslthl.sf.net"
24+
exclude-result-prefixes="xslthl"
25+
version='1.0'>
26+
27+
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>
28+
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/highlight.xsl"/>
29+
<xsl:import href="titlepage/spring-html.xsl"/>
30+
31+
<!-- Only use scaling in FO -->
32+
<xsl:param name="ignore.image.scaling">1</xsl:param>
33+
34+
<!-- Use code syntax highlighting -->
35+
<xsl:param name="highlight.source">1</xsl:param>
36+
37+
<!-- Extensions -->
38+
<xsl:param name="use.extensions">1</xsl:param>
39+
<xsl:param name="tablecolumns.extension">0</xsl:param>
40+
<xsl:param name="callout.extensions">1</xsl:param>
41+
42+
<!-- Activate Graphics -->
43+
<xsl:param name="admon.graphics" select="1"/>
44+
<xsl:param name="admon.graphics.path">images/admon/</xsl:param>
45+
<xsl:param name="admon.graphics.extension">.png</xsl:param>
46+
<xsl:param name="callout.graphics" select="1" />
47+
<xsl:param name="callout.defaultcolumn">120</xsl:param>
48+
<xsl:param name="callout.graphics.path">images/callouts/</xsl:param>
49+
<xsl:param name="callout.graphics.extension">.png</xsl:param>
50+
51+
<xsl:param name="table.borders.with.css" select="1"/>
52+
<xsl:param name="html.stylesheet">css/manual.css</xsl:param>
53+
<xsl:param name="html.stylesheet.type">text/css</xsl:param>
54+
<xsl:param name="generate.toc">book toc,title</xsl:param>
55+
56+
<xsl:param name="admonition.title.properties">text-align: left</xsl:param>
57+
58+
<!-- Leave image paths as relative when navigating XInclude -->
59+
<xsl:param name="keep.relative.image.uris" select="1"/>
60+
61+
<!-- Label Chapters and Sections (numbering) -->
62+
<xsl:param name="chapter.autolabel" select="1"/>
63+
<xsl:param name="section.autolabel" select="1"/>
64+
<xsl:param name="section.autolabel.max.depth" select="3"/>
65+
66+
<xsl:param name="section.label.includes.component.label" select="1"/>
67+
<xsl:param name="table.footnote.number.format" select="'1'"/>
68+
69+
<!-- Show only Sections up to level 3 in the TOCs -->
70+
<xsl:param name="toc.section.depth">3</xsl:param>
71+
72+
<!-- Remove "Chapter" from the Chapter titles... -->
73+
<xsl:param name="local.l10n.xml" select="document('')"/>
74+
<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
75+
<l:l10n language="en">
76+
<l:context name="title-numbered">
77+
<l:template name="chapter" text="%n.&#160;%t"/>
78+
<l:template name="section" text="%n&#160;%t"/>
79+
</l:context>
80+
</l:l10n>
81+
</l:i18n>
82+
83+
<xsl:template match='xslthl:keyword' mode="xslthl">
84+
<span class="hl-keyword"><xsl:apply-templates mode="xslthl"/></span>
85+
</xsl:template>
86+
87+
<xsl:template match='xslthl:comment' mode="xslthl">
88+
<span class="hl-comment"><xsl:apply-templates mode="xslthl"/></span>
89+
</xsl:template>
90+
91+
<xsl:template match='xslthl:oneline-comment' mode="xslthl">
92+
<span class="hl-comment"><xsl:apply-templates mode="xslthl"/></span>
93+
</xsl:template>
94+
95+
<xsl:template match='xslthl:multiline-comment' mode="xslthl">
96+
<span class="hl-multiline-comment"><xsl:apply-templates mode="xslthl"/></span>
97+
</xsl:template>
98+
99+
<xsl:template match='xslthl:tag' mode="xslthl">
100+
<span class="hl-tag"><xsl:apply-templates mode="xslthl"/></span>
101+
</xsl:template>
102+
103+
<xsl:template match='xslthl:attribute' mode="xslthl">
104+
<span class="hl-attribute"><xsl:apply-templates mode="xslthl"/></span>
105+
</xsl:template>
106+
107+
<xsl:template match='xslthl:value' mode="xslthl">
108+
<span class="hl-value"><xsl:apply-templates mode="xslthl"/></span>
109+
</xsl:template>
110+
111+
<xsl:template match='xslthl:string' mode="xslthl">
112+
<span class="hl-string"><xsl:apply-templates mode="xslthl"/></span>
113+
</xsl:template>
114+
115+
</xsl:stylesheet>

0 commit comments

Comments
 (0)