On May 2, 2006, at 8:14 PM, Web Maestro Clay wrote:
On May 2, 2006, at 6:52 PM, David Crossley wrote:
Edit src/documentation/skinconf.xml to temporarily set
disable-xml-link=false. This will cause Forrest to
generate an xml version of each document in document-v13
format (which is still Forrest's internal format) into
build/site/*.xml
There are only a few changes between document-v13 and
document-v20 so you could manually edit them to change
<link> to <a> etc. and change the document type declarations.
See http://forrest.apache.org/dtdx/document-v20.html#changes-20
Hope that helps.
-David
It helps immensely. Thanks for the help! I'll report back my
findings...
Responding to my post...
Here's the feedback I promised. I was able to get it working but I
had to do the following:
- had to retain document-v10.dtd files
- had to skip processing faq.html page (need to manually update to
document-v13 or document-v20)
- had to replace <code> with [code-FIXME] since it's not in document-
v10.dtd
- had to pepper a couple of other '-FIXME' items (faq.html, etc.)
PROBLEMS
==========
1. Unfortunately it appears document-v13 files were *not* generated
in build/site.xml (it looks like it merely passed the document-
v10.xml versions across). It'd be great to get v13 files, so I can
move forward with better compatibility.
2. I get an error that 'images/splash.png' not found, although
'images/logo.gif' is found (and both files are in the same path: src/
documentation/content/xdocs/images/).
3. I don't have navigation down the left. Here's a snipped of my
site.xml file:
site.xml snippet
<batik label="About Batik">
<index label="Introduction" href="index.html"
description="Welcome to Batik"/>
<!--
<faqs label="FAQs" href="faq.html" description="Batik - FAQs
Page"/>
-->
<!--
<wiki label="Wiki" href="ext:wiki" description="Batik - Wiki
Page"/>
-->
<license label="License" href="license.html" description="Batik
- License Page"/>
====
tabs.xml
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 1999-2006 The Apache Software Foundation
yata yata...
-->
<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//
EN" "http://forrest.apache.org/dtd/tab-cocoon-v11.dtd";>
<tabs software="Batik"
title="Batik"
copyright="@year@ The Apache Software Foundation"
xmlns:xlink="http://www.w3.org/1999/xlink";>
<tab id="" label="Batik" dir="" indexfile="index.html"/>
</tabs>
<..>
====
build/site/index.xml snippet
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE document SYSTEM
"./dtd/document-v10.dtd">
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE document SYSTEM
"./dtd/document-v10.dtd">
<!--
Copyright 2000-2004,2006 The Apache Software Foundation
yata yata...
--><!--
========================================================================
= --><!-- author
[EMAIL PROTECTED] --
><!-- version $Id: index.xml 388441 2006-03-24 07:50:03Z cam $ --
><!--
========================================================================
= --><document>
<header>
<title>Batik SVG Toolkit</title>
<subtitle>SVG Tools in Java</subtitle>
<authors>
<person name="Vincent Hardy"
email="[EMAIL PROTECTED]"/>
<person name="Thierry Kormann"
email="[EMAIL PROTECTED]"/>
<person name="Stephane Hillion"
email="[EMAIL PROTECTED]"/>
</authors>
</header>
<..>
====
Web Maestro Clay
[EMAIL PROTECTED]
My religion is simple. My religion is kindness.
-- HH Dalai Lama of Tibet
