You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by "Springer, Ian P." <ia...@hp.com> on 2004/11/29 23:59:24 UTC

non-doc20 xml files under content/, but not under content/xdocs/, causing generation errors

When I have files with an xml extension (e.g. build.xml) located under
src/documentation/content/ (not under xdocs/) and then try to link to
those files from doc20 xml files located below
src/documentation/content/xdocs/, I get errors like the following when I
run Forrest:

    [java]      [java] * [56/6]    [6/28]    5.281s 14.7Kb
tutorial/template/index.html
    [java]      [java] X [0]
tutorial/template/src/webapp/discovery-agent-registry.xml      BROKEN:
C:\P
rojects\Apache\muse\trunk\src\documentation\content\xdocs\tutorial\templ
ate\src\webapp\discovery-agent-registry.xml (The system cannot find the
path
specified)
    [java]      [java] X [0]
tutorial/template/src/wsdl/metrics.xml BROKEN:
C:\Projects\Apache\muse\trun
k\src\documentation\content\xdocs\tutorial\template\src\wsdl\metrics.xml
(The system cannot find the path specified)
    [java]      [java] Total time: 0 minutes 20 seconds,  Site size:
141,418 Site pages: 23
    [java]
    [java] BUILD FAILED

This seems like a bug to me. It's my understanding that files with an
xml extension that are not under xdocs/ should not be treated any
differently than any other type of file.

Any help is greatly appreciated.

Ian

Re: non-doc20 xml files under content/, but not under content/xdocs/, causing generation errors

Posted by Ross Gardler <rg...@apache.org>.
I've copied this mail to the dev list as it is applicable to a current 
discussion regarding RAW content.

I'll reply with a solution on the user list in a moment.

Ross

Springer, Ian P. wrote:
> When I have files with an xml extension (e.g. build.xml) located under
> src/documentation/content/ (not under xdocs/) and then try to link to
> those files from doc20 xml files located below
> src/documentation/content/xdocs/, I get errors like the following when I
> run Forrest:
> 
>     [java]      [java] * [56/6]    [6/28]    5.281s 14.7Kb
> tutorial/template/index.html
>     [java]      [java] X [0]
> tutorial/template/src/webapp/discovery-agent-registry.xml      BROKEN:
> C:\P
> rojects\Apache\muse\trunk\src\documentation\content\xdocs\tutorial\templ
> ate\src\webapp\discovery-agent-registry.xml (The system cannot find the
> path
> specified)
>     [java]      [java] X [0]
> tutorial/template/src/wsdl/metrics.xml BROKEN:
> C:\Projects\Apache\muse\trun
> k\src\documentation\content\xdocs\tutorial\template\src\wsdl\metrics.xml
> (The system cannot find the path specified)
>     [java]      [java] Total time: 0 minutes 20 seconds,  Site size:
> 141,418 Site pages: 23
>     [java]
>     [java] BUILD FAILED
> 
> This seems like a bug to me. It's my understanding that files with an
> xml extension that are not under xdocs/ should not be treated any
> differently than any other type of file.
> 
> Any help is greatly appreciated.
> 
> Ian
> 
> 

Re: non-doc20 xml files under content/, but not under content/xdocs/, causing generation errors

Posted by Ross Gardler <rg...@apache.org>.
I've copied this mail to the dev list as it is applicable to a current 
discussion regarding RAW content.

I'll reply with a solution on the user list in a moment.

Ross

Springer, Ian P. wrote:
> When I have files with an xml extension (e.g. build.xml) located under
> src/documentation/content/ (not under xdocs/) and then try to link to
> those files from doc20 xml files located below
> src/documentation/content/xdocs/, I get errors like the following when I
> run Forrest:
> 
>     [java]      [java] * [56/6]    [6/28]    5.281s 14.7Kb
> tutorial/template/index.html
>     [java]      [java] X [0]
> tutorial/template/src/webapp/discovery-agent-registry.xml      BROKEN:
> C:\P
> rojects\Apache\muse\trunk\src\documentation\content\xdocs\tutorial\templ
> ate\src\webapp\discovery-agent-registry.xml (The system cannot find the
> path
> specified)
>     [java]      [java] X [0]
> tutorial/template/src/wsdl/metrics.xml BROKEN:
> C:\Projects\Apache\muse\trun
> k\src\documentation\content\xdocs\tutorial\template\src\wsdl\metrics.xml
> (The system cannot find the path specified)
>     [java]      [java] Total time: 0 minutes 20 seconds,  Site size:
> 141,418 Site pages: 23
>     [java]
>     [java] BUILD FAILED
> 
> This seems like a bug to me. It's my understanding that files with an
> xml extension that are not under xdocs/ should not be treated any
> differently than any other type of file.
> 
> Any help is greatly appreciated.
> 
> Ian
> 
> 

Re: non-doc20 xml files under content/, but not under content/xdocs/, causing generation errors

Posted by Ross Gardler <rg...@apache.org>.
Springer, Ian P. wrote:
> When I have files with an xml extension (e.g. build.xml) located under
> src/documentation/content/ (not under xdocs/) and then try to link to
> those files from doc20 xml files located below
> src/documentation/content/xdocs/, I get errors like the following when I
> run Forrest:
> 
>     [java]      [java] * [56/6]    [6/28]    5.281s 14.7Kb
> tutorial/template/index.html
>     [java]      [java] X [0]
> tutorial/template/src/webapp/discovery-agent-registry.xml      BROKEN:
> C:\P
> rojects\Apache\muse\trunk\src\documentation\content\xdocs\tutorial\templ
> ate\src\webapp\discovery-agent-registry.xml (The system cannot find the
> path
> specified)
>     [java]      [java] X [0]
> tutorial/template/src/wsdl/metrics.xml BROKEN:
> C:\Projects\Apache\muse\trun
> k\src\documentation\content\xdocs\tutorial\template\src\wsdl\metrics.xml
> (The system cannot find the path specified)
>     [java]      [java] Total time: 0 minutes 20 seconds,  Site size:
> 141,418 Site pages: 23
>     [java]
>     [java] BUILD FAILED
> 
> This seems like a bug to me. It's my understanding that files with an
> xml extension that are not under xdocs/ should not be treated any
> differently than any other type of file.
> 
> Any help is greatly appreciated.

I'm guessing you are working with 0.7-dev A recent change to the way we 
are working with RAW content has caused some problems like this. To be 
honest we did not consider that anyone would be using XML outside the 
xdocs directory - daft oversight on our part really.

As you see on a previous mail I have copied your issue to the dev list 
so we can create a more permanent solution. However, here is a 
workaround for you in the meantime:

Create a project sitemap to handle these files for you see 
http://forrest.apache.org/docs/project-sitemap.html

Your sitemap should include a match like this:

<map:match pattern="path/to/raw/**.xml">
   <map:read src="{0}"/>
</map:match>

Ross