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
[EMAIL PROTECTED]
My religion is simple. My religion is kindness.
-- HH Dalai Lama of Tibet
