forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Clay Leeds <webmaes...@mac.com>
Subject Re: Convert xdoc v10 to v20
Date Thu, 04 May 2006 13:35:00 GMT
On May 3, 2006, at 11:12 PM, David Crossley wrote:
> Web Maestro Clay wrote:
>> 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
>
> Why?

To many errors I guess... Here's one example (as you can see, I don't  
know why in this case):

validate-xdocs:

BUILD FAILED
/Users/Shared/_WebDLs/_repos/apache/forrest/trunk/main/targets/ 
validate.xml:146: Could not validate document /Users/clay/Sites/batik/ 
src/documentation/content/xdocs/architecture.xml

Here's an example when I switched back to document-v10.dtd:

validate-xdocs:
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
54:36: Element type "b" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
56:47: Element type "i" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
58:11: The content of element type "p" must match "(strong|em|code| 
sub|sup|br|img|icon|link|connect|jump|fork|anchor)".
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
59:64: Element type "form" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
61:27: Element type "select" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
63:34: Element type "option" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
65:33: Element type "option" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
67:36: Element type "option" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
70:46: Element type "input" must be declared.
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
72:10: The content of element type "s1" must match "(s2|anchor|p| 
source|note|fixme|figure|table|ol|ul|sl|dl)*".
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
73:41: Attribute "title" is required and must be specified for  
element type "s1".
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
73:41: Attribute "name" must be declared for element type "s1".
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
133:16: The content of element type "code" must match "null".
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
139:16: The content of element type "code" must match "null".
/Users/clay/Sites/batik/src/documentation/content/xdocs/download.xml: 
145:16: The content of element type "code" must match "null".

(of course download.xml isn't accessed (uses standard Apache mirror  
link)...

>> - had to skip processing faq.html page (need to manually update to
>> document-v13 or document-v20)
>
> I expected that.

Me too. Fortunately it only has 38 items. Here's what I got;

validate-xdocs:
/Users/clay/Sites/batik/src/documentation/content/xdocs/faq.xml: 
586:14: The content of element type "answer" must match "(anchor|p| 
source|note|fixme|figure|table|ol|ul|sl|dl)*".

>> - had to replace <code> with [code-FIXME] since it's not in document-
>> v10.dtd
>
> It is in our version of that old DTD.

I received a bunch of these... so I 'fixed' it...

validate-xdocs:
/Users/clay/Sites/batik/src/documentation/content/xdocs/ 
installing.xml:272:14: The content of element type "code" must match  
"null".


>> - 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.
>
> Ah, drat. The proper document type declaration with
> a Public Identifier is probably needed. Try it as described
> below by adding one Batik xdoc to a fresh seed site
> and set its Public Identifier.
> <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"  
> "document-v10.dtd">
> That will cause it to use Forrest's own DTDs.
> Try it in 'forrest run' or set the validation
> off in forrest.properties file.

I'll give it a shot.

>> 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/).
>
> Probably depends on how you referenced that from
> your source files. See examples in 'forrest seed'.

I figured it might be something like that. At present (as far as I  
know, it's only referenced from skinconf.xml in exactly the same way  
as logo.gif (which works!).

>> 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"/>
>> ====
>
> Don't know, maybe due to the above issues.
> What happens if you leave some documents from
> the 'forrest seed site'? Do they have their
> menus? You are probably better to start with a
> fresh seed site and just add one of the old
> Batik documents, i.e. don't change too much at
> one time.

I'll try that...

> Does your site.xml have a "<site>" element?
> It is missing in your snippet above.

Sorry... I should've included that... Yes it does... I pasted the  
snippet, then included the top part but omitted the <site/> element.

<site label="Batik" href="" xmlns="http://apache.org/forrest/linkmap/ 
1.0" tab="home">

   <batik label="About Batik">


>> 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">
>> <document>
>>     <header>
>>         <title>Batik SVG Toolkit</title>
>
> Two xml declarations and document type declarations
> or is that a typo in your email?

Typo.

> Also, why look at build/site/index.xml instead
> of src/documentation/content/xdocs/index.xml
>
> -David

I wanted to show what was copied to the build/site/ dir...

Clay Leeds
webmaestro@mac.com

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




Mime
View raw message