You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by Linda Rose <li...@cox.net> on 2004/10/27 02:16:07 UTC
Adding a new content directory
Hi,
I'm struggling trying to convert my Framemaker files to OpenOffice and build the online docs using Forrest. I set up and seeded a directory and now I want to add my OpenOffice file to a subdirectory in MyProject/src/documentation/content/xdocs/MyContent. I edited site.xml and tabs.xml but when I enter "forrest" I get an error message that it can't find the OpenOffice files. My question is: Where do I specify a new subdirectory for content.
Thanks,
Linda
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Linda Rose
Webmaster & Online Information Developer
Alexandria Digital Library
http://www.alexandria.ucsb.edu
893-8902
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Re: Adding a new content directory
Posted by Rick Tessner <ri...@onnadayr.ca>.
Linda Rose wrote:
> <site label="MyProj" href="" xmlns="http://apache.org/forrest/linkmap/1.0"
> tab="">
>
> <about label="About">
> <index label="Index" href="index.html" description="Welcome to MyProj"/>
> <changes label="Changes" href="changes.html" description="History of
> Changes" />
> <todo label="Todo" href="todo.html" description="Todo List" />
> </about>
>
> <devguide label="Developer's Guide" href="devguide/" tab="devguide">
> <index href="index.html"/>
> </devguide>
> <devguide-Intro label="Introduction to ADL" href="Intro.html"
> description="Introduction to ADL" />
> <devguide-QuickStart label="Quick Start" href="QuickStart.html"
> description="ADL Quick Start" />
<snip what="additional site.xml entries"/>
Hi Linda,
It looks like forrest is looking for the Intro and QuickStart docs right
in the "xdocs" folder and not in the "devguide" folder.
It looks like this is because the end-tag for "<devguide>" is in the
wrong place.
Move the "</devguide>" to after the "<devguide-QuickStart .../>" element
and that should get rid of 2 of the 3 problems.
Not sure where the problem with devguide/sample.html is occuring. Is
one of your other documents referencing it? I'm not seeing it in the
site.xml you provided.
Hope this helps,
--
rick@onnadayr.ca
IT Firefighting and Prevention
Re: Adding a new content directory
Posted by Ross Gardler <rg...@apache.org>.
Linda Rose wrote:
>> ----- Original Message ----- From: "Ross Gardler" <rg...@apache.org>
>>>> I'm struggling trying to convert my Framemaker files to OpenOffice
>>>> and build the online docs using Forrest. I set up and seeded a
>>>> directory and now I want to add my OpenOffice file to a subdirectory
>>>> in MyProject/src/documentation/content/xdocs/MyContent. I edited
>>>> site.xml and tabs.xml but when I enter "forrest" I get an error
>>>> message that it can't find the OpenOffice files. My question is:
>>>> Where do I specify a new subdirectory for content.
>>>
>>>
>>> See http://forrest.apache.org/docs/your-project.html#adding_content
>>>
>>> If this doesn't help post the relevant snippets of your site.xml, a
>>> description of your directory layout and the actual error message you
>>> are getting.
<snip/>
> Here's the error message. I'll paste the site.xml file and directory
> structure after this. Thanks
> for you help. Linda
<snip/>
> X [0] devguide/sample.html BROKEN:
> C:\Forrest\ADLDocs\src\documentation\content\xdocs\devgu
> ide\sample.xml (The system cannot find the file specified)
> Total time: 0 minutes 15 seconds, Site size: 79,240 Site pages: 25
>
> BUILD FAILED
> C:\Forrest\apache-forrest-0.6\src\core\targets\site.xml:43: Java
> returned: 1
I see from your site.xml file that the offending file is not found
linked to from a site.xml folder. I therefore assume that it is linked
to from another page.
Is the openOffice file you are working with called sample.sxw and is it
located in the directory you indicate below? If not, then what makes you
think it is the Open Office file that cannot be found?
> DIRECTORY STRUCTURE
>
> ADLDocs/src/documentation/content/xdocs/devguide
[OT] I note the documents you are writing are named ADL, would that be
Advanced Distributed Learning. If so, you may be interested in taking a
look at the Burrokeet project at http://www.burrokeet.org as it is
working towards building a Forrest based ELearning solution.
Ross
Re: Adding a new content directory
Posted by Linda Rose <li...@cox.net>.
> ----- Original Message -----
> From: "Ross Gardler" <rg...@apache.org>
> To: <us...@forrest.apache.org>
> Sent: Tuesday, October 26, 2004 5:39 PM
> Subject: Re: Adding a new content directory
>
>
>> Linda Rose wrote:
>>> Hi,
>>> I'm struggling trying to convert my Framemaker files to OpenOffice and
>>> build the online docs using Forrest. I set up and seeded a directory and
>>> now I want to add my OpenOffice file to a subdirectory in
>>> MyProject/src/documentation/content/xdocs/MyContent. I edited site.xml
>>> and tabs.xml but when I enter "forrest" I get an error message that it
>>> can't find the OpenOffice files. My question is: Where do I specify a
>>> new subdirectory for content.
>>
>> See http://forrest.apache.org/docs/your-project.html#adding_content
>>
>> If this doesn't help post the relevant snippets of your site.xml, a
>> description of your directory layout and the actual error message you are
>> getting.
>>
>> NB In Forrest 0.6 OpenOffice documents are only supported if you use the
>> template document provided in the samples. This is changing ion 0.7 as I
>> am working on improved OpenOffice support. Once you have this working you
>> may find you need some enhancements to the Open Office stylesheets. Feel
>> free to add them as feature requests to the bug tracker. I will keep my
>> eyes open for them.
>>
>> Ross
>>
>
>
Hi,
Here's the error message. I'll paste the site.xml file and directory
structure after this. Thanks
for you help. Linda
C:\Forrest\ADLDocs\build\tmp\brokenlinks.xml
for any broken links in the generated site.
------------------------------------------------------------------------
cocoon 2.2.0-dev
Copyright (c) 1999-2004 Apache Software Foundation. All rights reserved.
------------------------------------------------------------------------
^ devguide/
* [1/19] [19/20] 3.155s 6.5Kb linkmap.html
* [2/18] [0/0] 0.27s 1.1Kb skin/print.css
* [3/17] [0/0] 0.14s 3.8Kb skin/profile.css
* [5/19] [4/19] 0.551s 5.7Kb changes.html
X [0] QuickStart.html BROKEN:
C:\Forrest\ADLDocs\src\documentation\content\xdocs\Quick
Start.xml (The system cannot find the file specified)
* [9/15] [0/0] 2.133s 7.3Kb images/group.png
* [10/14] [0/0] 0.08s 2.6Kb skin/basic.css
* [11/13] [0/0] 1.673s 3.3Kb linkmap.pdf
* [13/23] [12/12] 0.26s 11.9Kb skin/screen.css
* [14/22] [0/0] 0.12s 215b
skin/images/rc-t-r-5-1header-2tab-selected-3tab-selected.png
* [16/20] [0/0] 0.06s 199b
skin/images/rc-t-l-5-1header-2searchbox-3searchbox.png
* [17/19] [0/0] 0.08s 199b
skin/images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png
* [19/17] [0/0] 0.151s 3.2Kb changes.pdf
X [0] Intro.html BROKEN:
C:\Forrest\ADLDocs\src\documentation\content\xdocs\Intro.xml (Th
e system cannot find the file specified)
* [21/19] [4/20] 0.421s 6.1Kb index.html
* [24/16] [0/0] 0.3s 214b
skin/images/rc-t-r-5-1header-2searchbox-3searchbox.png
* [26/14] [0/0] 0.511s 615b changes.rss
* [27/13] [0/0] 0.09s 319b
skin/images/rc-b-r-15-1body-2menu-3menu.png
* [28/12] [0/0] 0.27s 9.3Kb images/project.png
* [29/11] [0/0] 0.151s 2.9Kb index.pdf
* [33/7] [0/0] 0.07s 214b
skin/images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png
* [34/6] [0/0] 0.09s 348b
skin/images/rc-b-l-15-1body-2menu-3menu.png
* [35/6] [1/16] 0.34s 6.3Kb todo.html
* [36/5] [0/0] 0.161s 3.6Kb todo.pdf
* [37/4] [0/0] 0.07s 200b
skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png
* [38/3] [0/0] 0.06s 390b
skin/images/rc-t-r-15-1body-2menu-3menu.png
* [39/2] [0/0] 0.08s 209b
skin/images/rc-t-l-5-1header-2tab-selected-3tab-selected.png
X [0] devguide/sample.html BROKEN:
C:\Forrest\ADLDocs\src\documentation\content\xdocs\devgu
ide\sample.xml (The system cannot find the file specified)
Total time: 0 minutes 15 seconds, Site size: 79,240 Site pages: 25
BUILD FAILED
C:\Forrest\apache-forrest-0.6\src\core\targets\site.xml:43: Java returned: 1
Site.xml
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!--
Forrest site.xml
This file contains an outline of the site's information content. It is used
to:
- Generate the website menus (though these can be overridden - see docs)
- Provide semantic, location-independent aliases for internal 'site:' URIs,
eg
<link href="site:changes"> links to changes.html (or ../changes.html if in
subdir).
- Provide aliases for external URLs in the external-refs section. Eg, <link
href="ext:cocoon"> links to http://cocoon.apache.org/
See http://forrest.apache.org/docs/linking.html for more info
-->
<site label="MyProj" href="" xmlns="http://apache.org/forrest/linkmap/1.0"
tab="">
<about label="About">
<index label="Index" href="index.html" description="Welcome to MyProj"/>
<changes label="Changes" href="changes.html" description="History of
Changes" />
<todo label="Todo" href="todo.html" description="Todo List" />
</about>
<devguide label="Developer's Guide" href="devguide/" tab="devguide">
<index href="index.html"/>
</devguide>
<devguide-Intro label="Introduction to ADL" href="Intro.html"
description="Introduction to ADL" />
<devguide-QuickStart label="Quick Start" href="QuickStart.html"
description="ADL Quick Start" />
<files>
<hello_print href="hello.pdf" />
<test1 href="test1.html" />
<test3 href="samples/test3.html" />
</files>
<!--
The href must be wholesite.html/pdf You can change the labels and node
names
<all label="All">
<whole_site_html label="Whole Site HTML" href="wholesite.html"/>
<whole_site_pdf label="Whole Site PDF" href="wholesite.pdf"/>
</all>
-->
<external-refs>
<forrest href="http://forrest.apache.org/">
<linking href="docs/linking.html"/>
<validation href="docs/validation.html"/>
<webapp href="docs/your-project.html#webapp"/>
<dtd-docs href="docs/dtd-docs.html"/>
</forrest>
<cocoon href="http://cocoon.apache.org/"/>
<xml.apache.org href="http://xml.apache.org/"/>
</external-refs>
</site>
DIRECTORY STRUCTURE
ADLDocs/src/documentation/content/xdocs/devguide
Re: Adding a new content directory
Posted by Ross Gardler <rg...@apache.org>.
Linda Rose wrote:
> Hi,
>
> I'm struggling trying to convert my Framemaker files to OpenOffice and
> build the online docs using Forrest. I set up and seeded a directory and
> now I want to add my OpenOffice file to a subdirectory in
> MyProject/src/documentation/content/xdocs/MyContent. I edited site.xml
> and tabs.xml but when I enter "forrest" I get an error message that it
> can't find the OpenOffice files. My question is: Where do I specify a
> new subdirectory for content.
See http://forrest.apache.org/docs/your-project.html#adding_content
If this doesn't help post the relevant snippets of your site.xml, a
description of your directory layout and the actual error message you
are getting.
NB In Forrest 0.6 OpenOffice documents are only supported if you use the
template document provided in the samples. This is changing ion 0.7 as I
am working on improved OpenOffice support. Once you have this working
you may find you need some enhancements to the Open Office stylesheets.
Feel free to add them as feature requests to the bug tracker. I will
keep my eyes open for them.
Ross