diff options
| author | Daniel Mack <github@zonque.org> | 2015-07-13 10:46:26 -0400 |
|---|---|---|
| committer | Daniel Mack <github@zonque.org> | 2015-07-13 10:46:26 -0400 |
| commit | f7c735017e97652f8ed76af2298bea23a80ac762 (patch) | |
| tree | c50734137b723e5e52069290f5efa0e471323b0e | |
| parent | e43a8393eaf058c4ecd2a5968f59d83b911d4f1f (diff) | |
| parent | d77c25b1164f55fe3f9b5ad00c47c0e01243ad53 (diff) | |
Merge pull request #573 from cmacq2/html-man-fixes
Reproducible ID/name values for auto generated anchors in HTML output
| -rw-r--r-- | man/custom-html.xsl | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/man/custom-html.xsl b/man/custom-html.xsl index f51fda77e..151276362 100644 --- a/man/custom-html.xsl +++ b/man/custom-html.xsl @@ -22,6 +22,16 @@ <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"/> +<!-- + - The docbook stylesheet injects empty anchor tags into generated HTML, identified by an auto-generated ID. + - Ask the docbook stylesheet to generate reproducible output when generating (these) ID values. + - This makes the output of this stylesheet reproducible across identical invocations on the same input, + - which is an easy and significant win for achieving reproducible builds. + - + - It may be even better to strip the empty anchors from the document output in addition to turning on consistent IDs, + - for this stylesheet contains its own custom ID logic (for generating permalinks) already. + --> +<xsl:param name="generate.consistent.ids" select="1"/> <!-- translate man page references to links to html pages --> <xsl:template match="citerefentry[not(@project)]"> |