forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject cvs commit: xml-forrest/src/documentation/content/xdocs faq.xml
Date Sat, 22 Nov 2003 06:07:41 GMT
crossley    2003/11/21 22:07:41

  Modified:    src/documentation/content/xdocs faq.xml
  Log:
  Encourage them to read the "Using Forrest" document.
  Explain checkout CVS.
  Better explain "PDF whole site".
  Other minor text tidy-up.
  
  Revision  Changes    Path
  1.54      +40 -11    xml-forrest/src/documentation/content/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-forrest/src/documentation/content/xdocs/faq.xml,v
  retrieving revision 1.53
  retrieving revision 1.54
  diff -u -r1.53 -r1.54
  --- faq.xml	9 Nov 2003 10:21:13 -0000	1.53
  +++ faq.xml	22 Nov 2003 06:07:41 -0000	1.54
  @@ -6,7 +6,30 @@
   <faqs title="Frequently Asked Questions">
   
     <part id="getting_started">
  -    <title>Building Forrest</title>
  +    <title>Getting Started and Building Forrest</title>
  +    <faq id="overview">
  +      <question>
  +        Where can i read an overview about how to work with Forrest?
  +      </question>
  +      <answer>
  +        <p>
  +          See the <link href="site:your-project">Using Forrest</link> guide.
  +        </p>
  +      </answer>
  +    </faq>
  +
  +    <faq id="cvs">
  +      <question>
  +        I would rather use CVS so that i can keep up-to-date. How?
  +      </question>
  +      <answer>
  +        <p>
  +          Follow these
  +          <link href="site:your-project/get-cvs">Using Forrest</link> notes.
  +        </p>
  +      </answer>
  +    </faq>
  +
       <faq id="checked_out_now_what">
         <question>
           I have checked out a working copy of <code>xml-forrest</code> CVS,
now what?
  @@ -36,7 +59,7 @@
           <p>
             This <link
               href="http://issues.cocoondev.org/jira//secure/ViewIssue.jspa?key=FOR-10">appears
  -            to be a bug in cygwin</link>.  Please use the .bat script instead.
  +            to be a bug in cygwin</link>. Please use the .bat script instead.
           </p>
         </answer>
       </faq>
  @@ -61,8 +84,8 @@
     <part id="technical">
       <title>Technical</title>
       <faq id="PDF-output">
  -      <question>How can I get at it to generate one pdf-file out of
  -      the whole site or selected pages of the site ?</question>
  +      <question>How can I generate one pdf-file out of
  +      the whole site or selected pages of the site?</question>
         <answer>
         <p><![CDATA[
           <about tab="home" label="Home" href="">
  @@ -74,21 +97,26 @@
          In this case the menu labeled "About" will have 2 new items: 
          "Full PDF" and "Full HTML".
          </p>
  +       <p>
  +         This assumes that you use the
  +         <link href="site:linking">site.xml</link> method for your site
  +         structure and navigation, rather than the old book.xml method.
  +       </p>
          </answer>
       </faq>
       <faq id="clickable-email-adress">
  -      <question>How can I get at it that generated html-pages show a 
  -      'clickable' email-adress (of the author-element)</question>
  +      <question>How can I generate html-pages show a 
  +      'clickable' email-address (of the author-element)?</question>
          <answer>
  -       <p>You'd have to override <code>
  -       src/resources/skins/common/xslt/html/document2html.xsl,i</code>
  +       <p>You would override <code>
  +       src/resources/skins/common/xslt/html/document2html.xsl</code>
          and edit the "headers/authors" template.
          </p>
          </answer>
       </faq>
       <faq id="CVS_revison_tags">
  -      <question>How can I get at it that generated html-pages show the
  -      revision tag of cvs ? </question>
  +      <question>How can I generate html-pages show the
  +      revision tag of cvs?</question>
         <answer>
         <p>If you have:<code>&#60;version&#62;$Revision: 1.30
         $&#60;/version&#62;</code>The &#39;1.30&#39; will be extracted
and
  @@ -372,7 +400,7 @@
       <title>General</title>
   
       <faq id="generating_menus">
  -      <question>What is the relation between &s; and
  +      <question>What is the relationship between &s; and
           <code>book.xml</code>?
         </question>
         <answer>
  @@ -384,6 +412,7 @@
             preserved.  If a directory has a book.xml file, the book.xml will be
             used to generate the menu.  This is useful in situations where
             &s;-generated menus aren't appropriate.
  +          See <link href="site:linking">Menus and Linking</link>.
         </p>
         </answer>
       </faq>
  
  
  

Mime
View raw message