forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Web Maestro Clay <>
Subject Re: Convert xdoc v10 to v20
Date Thu, 04 May 2006 05:41:01 GMT

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
>> 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- 
- had to pepper a couple of other '-FIXME' items (faq.html, etc.)

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/ 

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  
     <wiki label="Wiki" href="ext:wiki" description="Batik - Wiki  
     <license label="License" href="license.html" description="Batik  
- License Page"/>

<?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" "">

<tabs software="Batik"
   copyright="@year@ The Apache Software Foundation"

   <tab id="" label="Batik" dir="" indexfile="index.html"/>

build/site/index.xml snippet
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE document SYSTEM  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE document SYSTEM  
    Copyright 2000-2004,2006  The Apache Software Foundation
   yata yata...

= --><!-- author                                          -- 
 ><!-- version $Id: index.xml 388441 2006-03-24 07:50:03Z cam $ -- 
= --><document>
         <title>Batik SVG Toolkit</title>
         <subtitle>SVG Tools in Java</subtitle>
             <person name="Vincent Hardy"  
             <person name="Thierry Kormann"  
             <person name="Stephane Hillion"  

Web Maestro Clay

My religion is simple. My religion is kindness.
-- HH Dalai Lama of Tibet

View raw message