forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Web Maestro Clay <the.webmaes...@gmail.com>
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 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  
vincent.hardy@eng.sun.com                                          -- 
 ><!-- 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="vincent.hardy@eng.sun.com"/>
             <person name="Thierry Kormann"  
email="tkormann@apache.org"/>
             <person name="Stephane Hillion"  
email="stephane@hillion.org"/>
         </authors>
     </header>
<..>
====

Web Maestro Clay
the.webmaestro@gmail.com

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




Mime
View raw message