[[Metaware]]
Trace:
Show pageOld revisions
Recent changesIndex

Differences

This shows you the differences between two versions of the page.

metaware [2009/01/19 16:22]
randy 		metaware [2023/03/12 12:11] (current)
Line 7: Line 7:
=== Building a Doku Wiki from a DocBook XML document === === Building a Doku Wiki from a DocBook XML document ===
-I've hacked together something out of {{http://www.saxonica.com/products.html|Saxon-B}}, and {{http://en.wikipedia.org/wiki/Sed|sed}} all running on {{http://www.cygwin.com/|Cygwin}} on my PC. Don't look below if you have a weak stomach.+I've hacked together something out of {{http://www.saxonica.com/products.html|Saxon-B}}, {{http://perl.org|PERL}}, {{http://tidy.sourceforge.net|tidy}} and {{http://en.wikipedia.org/wiki/Sed|sed}} all running on {{http://www.cygwin.com/|Cygwin}} on my PC. Don't look below if you have a weak stomach.
--- Randy --- Randy
Line 13: Line 13:
=== todoku.sh === === todoku.sh ===
<code> <code>
- rm -f $1.doku +rm -f $1.doku, temp*.doku 
- cat $1 | sed -e 's/^[ \t]*//' | sed 's/<entry>/<entry align="center">/' >temp.doku +cat $1 | sed 's/†/X/g' | sed 's/—/-/g' | sed 's/…/\.\.\./g' | tidy -xml -bare -w 3000 >temp.tidy.doku 
- java -jar saxon9.jar -t -s:temp.doku -xsl:docbook2dokuwiki.xsl -o:temp2.doku +cat temp.tidy.doku | parafix.pl | sed -e 's/<entry>/<entry align="center">/g' >temp.parafix.doku 
- sed -e 's/&lt;/</' < temp2.doku | sed -e 's/&gt;/>/' | tail +2 >$1.doku +cat temp.parafix.doku | sed -e 's|\/emphasis>|\/emphasis> |g'| sed -e 's|\/emphasis>  |emphasis> |g' | sed -e 's|\/emphasis> \([^0-9a-zA-Z(]\)|\/emphasis>\1|g' >temp.emphasis.doku 
- mv $1.doku . +java -jar saxon9.jar -t -s:temp.emphasis.doku -xsl:docbook2dokuwiki.xsl -o:temp.xslt.doku 
- rm -f temp*.doku+sed -e 's/&lt;/</g' < temp.xslt.doku | sed -e 's/&gt;/>/g' | sed -e 's|figs/incoming/||' | sed -e 's/amp\;//g' | sed -e 's|#Chapter_|/doku.php?id=chapter|g' |  sed -e 's|\"#Chap_\([0-9]*\)\-|\"/doku.php?id=chapter\1#Chap_\1-|g' | tail +2 >$1.doku 
 +mv $1.doku . 
 + 
 +
</code> </code>
-The sed calls, in order: +Here's what it does 
-  * removes leading white space from every line. Dokuwiki interprets it as significant. Sigh.+  * Uses sed to translate some non-utf8 characters to plain ASCII: dagger, em-dash, and ... 
 +  * Uses tidy to reformat and suppress leading whitespace. Dokuwiki interprets it as significant. Sigh. 
 +  * This messes up trailing whitespace behind emphasis tags, so I fix that with sed.
  * I don't understand xsl: vars yet, so just add an align to every table entry that doesn't explicitly set it.   * I don't understand xsl: vars yet, so just add an align to every table entry that doesn't explicitly set it.
  * Dokuwiki plugins have their own tag parameter formatting (no equal signs) so I have to fix the longhand lt and gt.   * Dokuwiki plugins have their own tag parameter formatting (no equal signs) so I have to fix the longhand lt and gt.
 +  * I transform inter-chapter IDs into urls.
  * The tail command strips off the top xsl header added by saxon for easy cut and paste.   * The tail command strips off the top xsl header added by saxon for easy cut and paste.
 +
 +=== parafix.pl ===
 +<code>
 +#!/usr/bin/perl
 +$s = <STDIN>;
 +$inpara = 0;
 +while (chomp($s) > 0) {
 +  if (index($s,"<para>") > -1 ) {$inpara = 1;}
 +  if (index($s,"</para>") > -1 ) {$inpara = 0;}
 +  if ($inpara) {
 +    chop($s);
 +    print ($s);
 +  } else {
 +    print ($s . "\n");
 +  }
 +  $s = <STDIN>;
 +}
 +</code>
 +
 +This perl script simply joins all the lines between para tags. It is very sensitive to input and output line ending conventions. If you shorten the .sh script above, you'll likely break the behavior, so watch out.
=== docbook2dokuwiki.xsl === === docbook2dokuwiki.xsl ===
Line 31: Line 57:
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="2.0"> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="2.0">
 +
 +<xsl:template match="sect1|sect2|sect3|sect4|example|varlistentry"><xsl:if test="@id"><html>&lt;a name='<xsl:value-of select="@id"/>'&gt;&lt;/a&gt;</html></xsl:if><xsl:apply-templates/></xsl:template>
<xsl:template match="sect1/title"> <xsl:template match="sect1/title">
Line 44: Line 72:
</xsl:template> </xsl:template>
-<xsl:template match="title">+<xsl:template match="chapter/title">
===== <xsl:apply-templates/> ===== ===== <xsl:apply-templates/> =====
</xsl:template> </xsl:template>
 +
 +<xsl:template match="title">
 +** <xsl:apply-templates/><xsl:text> **
 +
 +</xsl:text></xsl:template>
 +
<xsl:template match="para"> <xsl:template match="para">
Line 54: Line 88:
</xsl:template> </xsl:template>
 +<xsl:template match="indexterm"></xsl:template>
 +
 +<xsl:template match="xref"><html><a href="#{@linkend}"><xsl:value-of select="@linkend"/></a>&amp;nbsp;</html></xsl:template>
<xsl:template match="emphasis">//<xsl:apply-templates/>//</xsl:template> <xsl:template match="emphasis">//<xsl:apply-templates/>//</xsl:template>
 +<xsl:template match="code">''<xsl:apply-templates/>'' </xsl:template>
 +<xsl:template match="citetitle">//<xsl:apply-templates/>//</xsl:template>
 +<xsl:template match="citation">//<xsl:apply-templates/>//</xsl:template>
<xsl:template match="itemizedlist/listitem">  * <xsl:apply-templates/></xsl:template> <xsl:template match="itemizedlist/listitem">  * <xsl:apply-templates/></xsl:template>
- +<xsl:template match="listitem/itemizedlist/listitem">   * <xsl:apply-templates/></xsl:template> 
- +<xsl:template match="orderedlist/listitem"> - <xsl:apply-templates/></xsl:template> 
-<xsl:template match="sidebar"> +<xsl:template match="listitem/para"><xsl:apply-templates/><xsl:text> 
-<xsl:text>&lt;box center blue 75%</xsl:text> <xsl:apply-templates/> +</xsl:text></xsl:template>
-</xsl:template> +
- +
-<xsl:template match="sidebar/title">| <xsl:apply-templates/><xsl:text>&gt;</xsl:text></xsl:template> +
- +
-<xsl:template match="sidebar/para"> +
-<xsl:apply-templates/><xsl:text>&lt;/box&gt; +
-</xsl:text> +
-</xsl:template> +
- +
-<xsl:template match="sidebar/variablelist"> +
-<xsl:apply-templates/><xsl:text&gt;&lt;/box&gt; +
-</xsl:text> +
-</xsl:template>+
<xsl:template match="variablelist"><xsl:apply-templates/></xsl:template> <xsl:template match="variablelist"><xsl:apply-templates/></xsl:template>
- 
-<xsl:template match="varlistentry"><xsl:apply-templates/></xsl:template> 
<xsl:template match="varlistentry/term"> <xsl:template match="varlistentry/term">
Line 89: Line 114:
<xsl:template match="figure"> <xsl:template match="figure">
-== Figure: <xsl:value-of select="title"/> ==+<html><a name="{@id}"><center>&lt;/html&gt;// <xsl:value-of select="@id"/>: <xsl:value-of select="title"/> //&lt;html&gt;</center></a></html><xsl:text> 
 +</xsl:text>
<xsl:apply-templates/></xsl:template> <xsl:apply-templates/></xsl:template>
Line 99: Line 125:
<xsl:template match="imagedata"> <xsl:template match="imagedata">
-<html> +<html><center><img width="{@srccredit}" src="http://buildingreputation.com/lib/exe/fetch.php?media={@fileref}"/><xsl:value-of select="."/></center></html><xsl:text> 
-<center> + 
-<img src="http://buildingreputation.com/lib/exe/fetch.php?media={@fileref}"/><xsl:value-of select="."/> +</xsl:text>
-</center> +
-</html>+
</xsl:template> </xsl:template>
Line 109: Line 133:
</xsl:text></xsl:template> </xsl:text></xsl:template>
-<xsl:template match="table"> +<xsl:template match="table|informaltable"> 
-=== <xsl:value-of select="title"/> === +<html><xsl:if test="@id"><a name="{@id}"><center>&lt;/html&gt;// <xsl:value-of select="@id"/>: <xsl:value-of select="title"/> //&amp;lt;html&gt;</center></a></xsl:if>
-<html>+
<table align="center" border="1"> <table align="center" border="1">
<xsl:apply-templates/> <xsl:apply-templates/>
Line 139: Line 162:
</xsl:template> </xsl:template>
-<xsl:template match="entry"><td align="{@align}"><xsl:value-of select="."/></td></xsl:template>+<xsl:template match="ulink">[[<xsl:value-of select="@url"/>|<xsl:apply-templates/>]]</xsl:template>
-<xsl:template match="remark"> +<xsl:template match="entry"><td align="{@align}"><xsl:apply-templates/></td></xsl:template> 
-&amp;lt;color gray&amp;gt;[Author's comment:<xsl:apply-templates/>]&amp;lt;/color&amp;gt;<xsl:text>+&lt;xsl:template match="entry/itemizedlist">&lt;ul&gt;<xsl:apply-templates/&gt;</ul></xsl:template> 
 +<xsl:template match="entry/itemizedlist/listitem"><li><xsl:apply-templates/>&lt;/li>&lt;/xsl:template&gt; 
 +<xsl:template match="entry/itemizedlist/listitem/para"&gt;<xsl:apply-templates/></xsl:template>
 +<xsl:template match="remark"><xsl:text>
 +</xsl:text><html>&lt;!-- <xsl:apply-templates/> --&gt;</html><xsl:text>
</xsl:text> </xsl:text>
</xsl:template> </xsl:template>
 +
 +<xsl:template match="blockquote/attribution"><xsl:text>&lt;blockquote </xsl:text><xsl:apply-templates/><xsl:text>&gt;
 +</xsl:text></xsl:template>
 +<xsl:template match="blockquote/para"><xsl:apply-templates/><xsl:text>
 +&lt;/blockquote&gt;
 +</xsl:text></xsl:template>
 +
 +<xsl:template match="sidebar">
 +<xsl:text>&lt;note tip&gt;</xsl:text><xsl:apply-templates/><xsl:text>&lt;/note&gt;
 +</xsl:text></xsl:template>
 +
 +<xsl:template match="caution">
 +<xsl:text>&lt;note caution&gt;</xsl:text><xsl:apply-templates/><xsl:text>&lt;/note&gt;
 +</xsl:text></xsl:template>
 +
 +<xsl:template match="warning">
 +<xsl:text>&lt;note warning&gt;</xsl:text><xsl:apply-templates/><xsl:text>&lt;/note&gt;
 +</xsl:text></xsl:template>
 +
 +<xsl:template match="tip">
 +<xsl:text>&lt;note tip&gt;</xsl:text><xsl:apply-templates/><xsl:text>&lt;/note&gt;
 +</xsl:text></xsl:template>
 +
 +<xsl:template match="note">
 +<xsl:text>&lt;note&gt;</xsl:text><xsl:apply-templates/><xsl:text>&lt;/note&gt;
 +</xsl:text></xsl:template>
 +
 +<xsl:template match="important">
 +<xsl:text>&lt;note important&gt;</xsl:text><xsl:apply-templates/><xsl:text>&lt;/note&gt;
 +</xsl:text></xsl:template>
</xsl:stylesheet> </xsl:stylesheet>
Line 151: Line 208:
</code> </code>
-This is oversimplified. Don't use it. Really. I can't believe I'm using it, but I am in a hurry at the moment.+This is oversimplified. Don't use it. Really. I can't believe I'm using it, but I am in a hurry at the moment. You'll need the box dokuwiki plugin and the art for the annotation such as Tip and Caution - I've got scalable versions of the O'Reilly animal traps and tracks - don't forget those...
metaware.1232410964.txt.gz · Last modified: 2023/03/12 12:11 (external edit)
Show pageOld revisions
Back to top
www.chimeric.de Creative Commons License Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0