You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general-cvs@xml.apache.org by br...@apache.org on 2004/03/20 03:24:35 UTC
cvs commit: xml-site/targets/forrest faq.html faq.pdf faq.xml
brondsem 2004/03/19 18:24:34
Modified: targets/forrest faq.html faq.pdf faq.xml
Log:
added one for breadcrumbs
Revision Changes Path
1.42 +61 -41 xml-site/targets/forrest/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/faq.html,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- faq.html 10 Mar 2004 16:20:27 -0000 1.41
+++ faq.html 20 Mar 2004 02:24:34 -0000 1.42
@@ -371,12 +371,12 @@
</li>
<li>
<a name="cvs-menu"></a><a href="#cvs">
- What happened to CVS?
- </a>
+ What happened to CVS?
+ </a>
</li>
<li>
<a name="svn-menu"></a><a href="#svn">
- How can I use SVN to keep up to date with the latest codebase?
+ How can I use SVN to keep up to date with the latest codebase?
</a>
</li>
<li>
@@ -446,6 +446,9 @@
<li>
<a name="xsp-menu"></a><a href="#xsp">How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</a>
</li>
+<li>
+<a name="breadcrumbs-menu"></a><a href="#breadcrumbs">How do breadcrumbs work? Why don't they work locally?</a>
+</li>
</ul>
<br>
</li>
@@ -510,13 +513,13 @@
</li>
</ol>
</div>
-<a name="N100BF"></a><a name="Answers"></a>
+<a name="N100C4"></a><a name="Answers"></a>
<h3>Answers</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100C3"></a><a name="getting_started"></a>
+<a name="N100C8"></a><a name="getting_started"></a>
<h4>1. Getting Started and Building Forrest</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100C7"></a><a name="overview"></a>
+<a name="N100CC"></a><a name="overview"></a>
<h5>1.1.
Where can i read an overview about how to work with Forrest?
<span style="float: right"><a href="#overview-menu">^</a></span>
@@ -526,7 +529,7 @@
See the <a href="your-project.html">Using Forrest</a> guide.
</p>
</div>
-<a name="N100D3"></a><a name="requirements"></a>
+<a name="N100D8"></a><a name="requirements"></a>
<h5>1.2.
What are the system requirements for Forrest?
<span style="float: right"><a href="#requirements-menu">^</a></span>
@@ -540,32 +543,32 @@
indicate that Java 1.3+ is required.
</p>
</div>
-<a name="N100DF"></a><a name="cvs"></a>
+<a name="N100E4"></a><a name="cvs"></a>
<h5>1.3.
- What happened to CVS?
- <span style="float: right"><a href="#cvs-menu">^</a></span>
+ What happened to CVS?
+ <span style="float: right"><a href="#cvs-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- Forrest switched from a CVS code repository to a SVN (subversion) code repository. The CVS repository is not kept current.
- </p>
+ Forrest switched from a CVS code repository to a SVN (subversion) code repository. The CVS
+repository is not kept current.
+ </p>
</div>
-<a name="N100E7"></a><a name="svn"></a>
+<a name="N100EC"></a><a name="svn"></a>
<h5>1.4.
- How can I use SVN to keep up to date with the latest codebase?
+ How can I use SVN to keep up to date with the latest codebase?
<span style="float: right"><a href="#svn-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- Follow these
- <a href="build.html">Building Forrest</a> notes.
- </p>
+ Follow these <a href="build.html">Building Forrest</a> notes.
+ </p>
<p>
The <a href="your-project.html">Using Forrest</a> guide provides
further step-by-step assistance in getting started with Forrest for your project.
</p>
</div>
-<a name="N100FA"></a><a name="cygwin_mutex_error"></a>
+<a name="N100FF"></a><a name="cygwin_mutex_error"></a>
<h5>1.5.
When running ./build.sh in cygwin, I get an error:
cygpath.exe: *** can't create title mutex, Win32 error 6.
@@ -577,7 +580,7 @@
to be a bug in cygwin</a>. Please use the .bat script instead.
</p>
</div>
-<a name="N1010C"></a><a name="maxmemory"></a>
+<a name="N10111"></a><a name="maxmemory"></a>
<h5>1.6.
How can i specify the amount of memory to be used by Java?
<span style="float: right"><a href="#maxmemory-menu">^</a></span>
@@ -592,10 +595,10 @@
</p>
</div>
</div>
-<a name="N1011D"></a><a name="technical"></a>
+<a name="N10122"></a><a name="technical"></a>
<h4>2. Technical</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10121"></a><a name="PDF-output"></a>
+<a name="N10126"></a><a name="PDF-output"></a>
<h5>2.1. How can I generate one pdf-file out of
the whole site or selected pages of the site?<span style="float: right"><a href="#PDF-output-menu">^</a></span>
</h5>
@@ -616,7 +619,7 @@
structure and navigation, rather than the old book.xml method.
</p>
</div>
-<a name="N10130"></a><a name="clickable-email-adress"></a>
+<a name="N10135"></a><a name="clickable-email-adress"></a>
<h5>2.2. How can I generate html-pages to show a
'clickable' email-address (of the author-element)?<span style="float: right"><a href="#clickable-email-adress-menu">^</a></span>
</h5>
@@ -626,7 +629,7 @@
and edit the "headers/authors" template.
</p>
</div>
-<a name="N1013B"></a><a name="CVS_revison_tags"></a>
+<a name="N10140"></a><a name="CVS_revison_tags"></a>
<h5>2.3. How can I generate html-pages to show the
revision tag of cvs?<span style="float: right"><a href="#CVS_revison_tags-menu">^</a></span>
</h5>
@@ -640,7 +643,7 @@
<p>This technique could also be used for a modification date with
$Date$</p>
</div>
-<a name="N1014C"></a><a name="ignoring_javadocs"></a>
+<a name="N10151"></a><a name="ignoring_javadocs"></a>
<h5>2.4.
How do I stop Forrest breaking on links to external files that may not
exist, like javadocs?
@@ -680,7 +683,7 @@
</div>
</div>
</div>
-<a name="N1017D"></a><a name="link_raw"></a>
+<a name="N10182"></a><a name="link_raw"></a>
<h5>2.5. How do I link to raw files such as config.txt and brochure.pdf?
<span style="float: right"><a href="#link_raw-menu">^</a></span>
</h5>
@@ -693,7 +696,7 @@
project for a demonstration of this ability.
</p>
</div>
-<a name="N10188"></a><a name="build_msg_a"></a>
+<a name="N1018D"></a><a name="build_msg_a"></a>
<h5>2.6. What do the symbols and numbers mean when Forrest lists each
document that it has built?
<span style="float: right"><a href="#build_msg_a-menu">^</a></span>
@@ -716,7 +719,7 @@
Column 4 is the page size.
</p>
</div>
-<a name="N10195"></a><a name="pdf_images"></a>
+<a name="N1019A"></a><a name="pdf_images"></a>
<h5>2.7. Images don't display in PDFs. How do I fix this?<span style="float: right"><a href="#pdf_images-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -756,7 +759,7 @@
Forrest</div>
</div>
</div>
-<a name="N101C7"></a><a name="index.html"></a>
+<a name="N101CC"></a><a name="index.html"></a>
<h5>2.8.
The tab link in my site incorrectly assumes that 'index.html' is present in
the linked-to directory. How do I fix this?
@@ -781,7 +784,7 @@
</map:match>
</pre>
</div>
-<a name="N101E5"></a><a name="headless_operation"></a>
+<a name="N101EA"></a><a name="headless_operation"></a>
<h5>2.9.
When generating PNG images from SVG, I get an error: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
<span style="float: right"><a href="#headless_operation-menu">^</a></span>
@@ -798,7 +801,7 @@
<a href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon FAQ</a>.
</p>
</div>
-<a name="N10202"></a><a name="catalog"></a>
+<a name="N10207"></a><a name="catalog"></a>
<h5>2.10.
How do i configure my favourite XML editor or parser to find the
local Forrest DTDs?
@@ -811,7 +814,7 @@
local DTDs</a>.
</p>
</div>
-<a name="N1020E"></a><a name="xsp"></a>
+<a name="N10213"></a><a name="xsp"></a>
<h5>2.11. How do I enable XSP processing?<span style="float: right"><a href="#xsp-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -854,11 +857,28 @@
</ol>
<p>See also the <a href="http://wiki.cocoondev.org/Wiki.jsp?page=AddingXSPToForrest">AddingXSPToForrest</a> Wiki page.</p>
</div>
+<a name="N1024A"></a><a name="breadcrumbs"></a>
+<h5>2.12. How do breadcrumbs work? Why don't they work locally?<span style="float: right"><a href="#breadcrumbs-menu">^</a></span>
+</h5>
+<div style="margin-left: 15 ; border: 2px">
+<p>Breadcrumbs begin with up to three URLs specified in <span class="codefrag">skinconf.xml</span>. Here's what the Forrest site uses:</p>
+<pre class="code">
+ <trail>
+ <link1 name="apache" href="http://www.apache.org/"/>
+ <link2 name="xml.apache" href="http://xml.apache.org/"/>
+ <link3 name="" href=""/>
+ </trail>
+</pre>
+<p>If any links are blank, they aren't used. After these first links, JavaScript looks at the URL for the current page and
+ makes a link for each directory after the domain. If you are looking at the site locally, there is no domain and so
+ there will only be the breadcrumbs specified in <span class="codefrag">skinconf.xml</span>.
+ </p>
+</div>
</div>
-<a name="N10245"></a><a name="old_faqs"></a>
+<a name="N10260"></a><a name="old_faqs"></a>
<h4>3. Older versions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10249"></a><a name="unresolved_project.home"></a>
+<a name="N10264"></a><a name="unresolved_project.home"></a>
<h5>3.1. When invoking Forrest 0.4 from the
forrest.antproxy.xml, the build fails because
${project.home} isn't resolved.
@@ -878,7 +898,7 @@
<classpath refid="forrest-classpath"/>
<jvmarg value="-Dforrest.home=${forrest.home}"/></pre>
</div>
-<a name="N1025F"></a><a name="odd_html"></a>
+<a name="N1027A"></a><a name="odd_html"></a>
<h5>3.2.
After upgrading to 0.4 my HTML looks significantly different, and table
widths are wrong. What happened?
@@ -898,7 +918,7 @@
<doctype-system>http://www.w3.org/TR/html4/loose.dtd</doctype-system>
</pre>
</div>
-<a name="N10272"></a><a name="validation_error-doctype_root_null"></a>
+<a name="N1028D"></a><a name="validation_error-doctype_root_null"></a>
<h5>3.3.
When building my project, I get an validation error: Document root
element "site", must match DOCTYPE root "null"..
@@ -919,7 +939,7 @@
listed to prevent an attempt at DTD-based validation.
</p>
</div>
-<a name="N1028F"></a><a name="building_error-custom_sitemap"></a>
+<a name="N102AA"></a><a name="building_error-custom_sitemap"></a>
<h5>3.4.
When building my project, I get any of these errors:
menu.xmap (The system cannot find the file specified)
@@ -934,10 +954,10 @@
</p>
</div>
</div>
-<a name="N102A4"></a><a name="general"></a>
+<a name="N102BF"></a><a name="general"></a>
<h4>4. General</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N102A8"></a><a name="generating_menus"></a>
+<a name="N102C3"></a><a name="generating_menus"></a>
<h5>4.1. What is the relationship between site.xml and
book.xml?
<span style="float: right"><a href="#generating_menus-menu">^</a></span>
@@ -954,7 +974,7 @@
See <a href="linking.html">Menus and Linking</a>.
</p>
</div>
-<a name="N102C3"></a><a name="docbook"></a>
+<a name="N102DE"></a><a name="docbook"></a>
<h5>4.2.
How do I use DocBook as the xml documentation format?
<span style="float: right"><a href="#docbook-menu">^</a></span>
@@ -999,7 +1019,7 @@
for configuration guidance.
</p>
</div>
-<a name="N102E1"></a><a name="version"></a>
+<a name="N102FC"></a><a name="version"></a>
<h5>4.3.
How to report which version of Forrest is being used and the
properties that are set?
@@ -1016,7 +1036,7 @@
Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages.
</p>
</div>
-<a name="N102F5"></a><a name="how_can_I_help"></a>
+<a name="N10310"></a><a name="how_can_I_help"></a>
<h5>4.4.
How can I help?
<span style="float: right"><a href="#how_can_I_help-menu">^</a></span>
1.34 +574 -700 xml-site/targets/forrest/faq.pdf
<<Binary file>>
1.9 +23 -11 xml-site/targets/forrest/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/faq.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- faq.xml 30 Jan 2004 23:04:09 -0000 1.8
+++ faq.xml 20 Mar 2004 02:24:34 -0000 1.9
@@ -5,9 +5,9 @@
</link></li><li id="requirements-menu"><link href="#requirements">
What are the system requirements for Forrest?
</link></li><li id="cvs-menu"><link href="#cvs">
- I would rather use CVS so that i can keep up-to-date. How?
- </link></li><li id="checked_out_now_what-menu"><link href="#checked_out_now_what">
- I have checked out a working copy of <code>xml-forrest</code> CVS, now what?
+ What happened to CVS?
+ </link></li><li id="svn-menu"><link href="#svn">
+ How can I use SVN to keep up to date with the latest codebase?
</link></li><li id="cygwin_mutex_error-menu"><link href="#cygwin_mutex_error">
When running <code>./build.sh</code> in cygwin, I get an error:
<code>cygpath.exe: *** can't create title mutex, Win32 error 6</code>.
@@ -30,7 +30,7 @@
</link></li><li id="catalog-menu"><link href="#catalog">
How do i configure my favourite XML editor or parser to find the
local Forrest DTDs?
- </link></li><li id="xsp-menu"><link href="#xsp">How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</link></li></ul><br/></li><li><strong>Older versions</strong><ul><li id="unresolved_project.home-menu"><link href="#unresolved_project.home">When invoking Forrest 0.4 from the
+ </link></li><li id="xsp-menu"><link href="#xsp">How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</link></li><li id="breadcrumbs-menu"><link href="#breadcrumbs">How do breadcrumbs work? Why don't they work locally?</link></li></ul><br/></li><li><strong>Older versions</strong><ul><li id="unresolved_project.home-menu"><link href="#unresolved_project.home">When invoking Forrest 0.4 from the
<code>forrest.antproxy.xml</code>, the build fails because
<code>${project.home}</code> isn't resolved.
</link></li><li id="odd_html-menu"><link href="#odd_html">
@@ -70,18 +70,17 @@
indicate that Java 1.3+ is required.
</p>
</section><section id="cvs"><title>1.3.
- I would rather use CVS so that i can keep up-to-date. How?
+ What happened to CVS?
</title>
<p>
- Follow these
- <link href="site:build">Building Forrest</link> notes.
+ Forrest switched from a CVS code repository to a SVN (subversion) code repository. The CVS
+repository is not kept current.
</p>
- </section><section id="checked_out_now_what"><title>1.4.
- I have checked out a working copy of <code>xml-forrest</code> CVS, now what?
+ </section><section id="svn"><title>1.4.
+ How can I use SVN to keep up to date with the latest codebase?
</title>
<p>
- Follow these
- <link href="site:build">Building Forrest</link> notes.
+ Follow these <link href="site:build">Building Forrest</link> notes.
</p>
<p>
The <link href="site:your-project">Using Forrest</link> guide provides
@@ -294,6 +293,19 @@
</ol>
<p>See also the <link href="http://wiki.cocoondev.org/Wiki.jsp?page=AddingXSPToForrest">AddingXSPToForrest</link> Wiki page.</p>
+ </section><section id="breadcrumbs"><title>2.12. How do breadcrumbs work? Why don't they work locally?</title>
+ <p>Breadcrumbs begin with up to three URLs specified in <code>skinconf.xml</code>. Here's what the Forrest site uses:</p>
+ <source xml:space="preserve"><![CDATA[
+ <trail>
+ <link1 name="apache" href="http://www.apache.org/"/>
+ <link2 name="xml.apache" href="http://xml.apache.org/"/>
+ <link3 name="" href=""/>
+ </trail>
+]]></source>
+ <p>If any links are blank, they aren't used. After these first links, JavaScript looks at the URL for the current page and
+ makes a link for each directory after the domain. If you are looking at the site locally, there is no domain and so
+ there will only be the breadcrumbs specified in <code>skinconf.xml</code>.
+ </p>
</section></section><section id="old_faqs"><title>3. Older versions</title><section id="unresolved_project.home"><title>3.1. When invoking Forrest 0.4 from the
<code>forrest.antproxy.xml</code>, the build fails because
<code>${project.home}</code> isn't resolved.
---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org