In this tips&tricks document, there is a suggested command line to test local documents : "xsltproc --novalid test/guide.xsl alsa-guide.xml > test/alsa-guide.html". The problem is, if you use entities defined in the guide.dtd it will generate an error because the DTD is not loaded with the "--novalid" option. Thus, this little change proposal.
Created attachment 86578 [details, diff] diff -U6 file
Comment on attachment 86578 [details, diff] diff -U6 file --- proj/en/gdp/doc/doc-tipsntricks.xml 2006-05-11 02:18:35.000000000 +0200 +++ doc-tipsntricks.xml 2006-05-11 02:22:11.000000000 +0200 @@ -17,14 +17,14 @@ Some tips & tricks that make the life for a Gentoo Documentation Developer easier (or more miserable :) </abstract> <license/> -<version>0.21</version> -<date>2006-03-28</date> +<version>0.22</version> +<date>2006-05-11</date> <chapter> <title>Setting up your local environment</title> <section> <title>Local environment for contributors</title> <body> @@ -204,13 +204,13 @@ If <c>xmllint</c> returns without showing anything, then the file is error-free (or at least concerning XML-tags). Next you need to convert it to HTML. <c>xsltproc</c> is the tool needed for that: </p> <pre caption="Converting to HTML"> -$ <i>xsltproc --novalid test/guide.xsl alsa-guide.xml > test/alsa-guide.html</i> +$ <i>xsltproc test/guide.xsl alsa-guide.xml > test/alsa-guide.html</i> </pre> <p> If no errors are displayed, you should be able to point your browser to <uri>file:///home/user/work/gentoo/doc/test/alsa-guide.html</uri> to view the resulting document. If not, fix your guide until it works.
Comment on attachment 86578 [details, diff] diff -U6 file
Created attachment 86581 [details, diff] diff -U6 file
Fixed. Thanks.