Code

Properly render asciidoc "callouts" in git man pages.
authorSean Estabrooks <seanlkml@sympatico.ca>
Fri, 28 Apr 2006 13:15:06 +0000 (09:15 -0400)
committerJunio C Hamano <junkio@cox.net>
Fri, 28 Apr 2006 21:31:51 +0000 (14:31 -0700)
Adds an xsl fragment to render docbook callouts when
converting to man page format.  Update the Makefile
to have "xmlto" use it when generating man pages.

Signed-off-by: Sean Estabrooks <seanlkml@sympatico.ca>
Documentation/Makefile
Documentation/callouts.xsl [new file with mode: 0644]

index f4cbf7e159be721bf17625b07c1d7b4f36c60f78..c1af22ce04f71fe2d4a49a908e10878f7b5e0bcf 100644 (file)
@@ -79,7 +79,7 @@ clean:
        asciidoc -b xhtml11 -d manpage -f asciidoc.conf $<
 
 %.1 %.7 : %.xml
-       xmlto man $<
+       xmlto -m callouts.xsl man $<
 
 %.xml : %.txt
        asciidoc -b docbook -d manpage -f asciidoc.conf $<
diff --git a/Documentation/callouts.xsl b/Documentation/callouts.xsl
new file mode 100644 (file)
index 0000000..ad03755
--- /dev/null
@@ -0,0 +1,16 @@
+<!-- callout.xsl: converts asciidoc callouts to man page format -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<xsl:template match="co">
+       <xsl:value-of select="concat('\fB(',substring-after(@id,'-'),')\fR')"/>
+</xsl:template>
+<xsl:template match="calloutlist">
+       <xsl:text>.sp&#10;</xsl:text>
+       <xsl:apply-templates/>
+       <xsl:text>&#10;</xsl:text>
+</xsl:template>
+<xsl:template match="callout">
+       <xsl:value-of select="concat('\fB',substring-after(@arearefs,'-'),'. \fR')"/>
+       <xsl:apply-templates/>
+       <xsl:text>.br&#10;</xsl:text>
+</xsl:template>
+</xsl:stylesheet>