Author: thorsten
Date: Tue Dec  2 16:18:17 2008
New Revision: 722698

URL: http://svn.apache.org/viewvc?rev=722698&view=rev
Log:
Deployment of docs for org.apache.forrest.plugin.output.pdf plugin (deployed by 
'deploy-docs' target of plugin build script)

Added:
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/images/update.jpg
   (with props)
Modified:
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.html
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.rss
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/index.html
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/linkmap.html
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_de.xml
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_es.xml
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_fr.xml
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/basic.css
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/screen.css
    
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/todo.html

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.html
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.html?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.html
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.html
 Tue Dec  2 16:18:17 2008
@@ -123,79 +123,152 @@
                  &nbsp;<input value="+a" class="biggerfont" title="Enlarge 
text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>History of Changes </h1>
+<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
 <a href="#introduction">Introduction and explanation of symbols</a>
 </li>
 <li>
-<a href="#version_0.2-dev">Version 0.2-dev (not-released)</a>
+<a href="#version_0.3-dev">Version 0.3-dev (not-released)</a>
 <ul class="minitoc">
 <li>
 <a href="#Changes+to+the+Code+Base">Changes to the Code Base</a>
 </li>
 <li>
+<a href="#Changes+to+Documentation">Changes to Documentation</a>
+</li>
+<li>
 <a href="#Contributors+to+this+release">Contributors to this release</a>
 </li>
 </ul>
 </li>
 <li>
+<a href="#version_0.2-dev">Version 0.2-dev (not-released)</a>
+<ul class="minitoc">
+<li>
+<a href="#Changes+to+the+Code+Base-N10069">Changes to the Code Base</a>
+</li>
+<li>
+<a href="#Contributors+to+this+release-N10073">Contributors to this release</a>
+</li>
+</ul>
+</li>
+<li>
 <a href="#version_0.1">Version 0.1 (not-released)</a>
 <ul class="minitoc">
 <li>
 <a href="#Changes+to+Project+Administration">Changes to Project 
Administration</a>
 </li>
 <li>
-<a href="#Contributors+to+this+release-N1003F">Contributors to this release</a>
+<a href="#Contributors+to+this+release-N1008C">Contributors to this release</a>
 </li>
 </ul>
 </li>
+<li>
+<a href="#all-committers">All Committers</a>
+</li>
 </ul>
 </div>
+</div>
 <p>
 <a href="changes.rss"><img alt="RSS" src="images/rss.png"></a>
 </p>
-<a name="N1000D"></a><a name="introduction"></a>
+<a name="N1000E"></a><a name="introduction"></a>
 <h2 class="underlined_10">Introduction and explanation of symbols</h2>
 <div class="section">
-<p>Changes are sorted by "type" and then chronologically with the most recent 
at the top. These symbols denote the various action types:<img class="icon" 
alt="add" src="images/add.jpg">=add</p>
+<p>Changes are sorted by "type" and then chronologically with the most recent 
at the top. These symbols denote the various action types:<img class="icon" 
alt="add" src="images/add.jpg">=add, <img class="icon" alt="update" 
src="images/update.jpg">=update</p>
+</div>
+    
+<a name="N1001D"></a><a name="version_0.3-dev"></a>
+<h2 class="underlined_10">Version 0.3-dev (not-released)</h2>
+<div class="section">
+<a name="N10021"></a><a name="Changes+to+the+Code+Base"></a>
+<h3 class="underlined_5">Changes to the Code Base</h3>
+<ul>
+<li>
+<img class="icon" alt="update" src="images/update.jpg">Made font family 
specifications available for
+                user changes without changing the plugin code. Committed by 
SNM.</li>
+<li>
+<img class="icon" alt="update" src="images/update.jpg">Added support for "sub" 
and "sup"
+                tags. Committed by JM. See Issue <a 
href="http://issues.apache.org/jira/browse/FOR-1087";>FOR-1087</a>.</li>
+<li>
+<img class="icon" alt="update" src="images/update.jpg">Various bugfixes and 
improvements for the fo
+                stylesheets. See notes in FOR-1072. Committed by DC. Thanks to 
Jeremias Maerki. See Issue <a 
href="http://issues.apache.org/jira/browse/FOR-1072";>FOR-1072</a>.</li>
+<li>
+<img class="icon" alt="update" src="images/update.jpg">Encapsulated the xsl 
methods in different
+                helper stylesheet which we can import from the different
+                plugins.  Committed by TS.</li>
+<li>
+<img class="icon" alt="update" src="images/update.jpg">Moved all libraries and 
components used by
+                pdf-generation from core into this plugin.  Committed by 
FSO.</li>
+<li>
+<img class="icon" alt="update" src="images/update.jpg"> Updating the 
fop-library to fop 0.94 and
+                upgrading the stylesheets to work properly with the new and 
more
+                precise fo-interpeter.  Committed by FSO.</li>
+</ul>
+<a name="N1004C"></a><a name="Changes+to+Documentation"></a>
+<h3 class="underlined_5">Changes to Documentation</h3>
+<ul>
+<li>
+<img class="icon" alt="update" src="images/update.jpg">Updated plugin 
documentation to cover the new
+                properties settable by the user,and how to actually set
+                them. Committed by SNM.</li>
+</ul>
+<a name="N10056"></a><a name="Contributors+to+this+release"></a>
+<h3 class="underlined_5">Contributors to this release</h3>
+<p>We thank the following people for their contributions to this release.</p>
+<p>This is a list of all people who participated as committers:<br>David 
Crossley (DC), Ferdinand Soethe (FSO), Jeremias M&auml;rki (JM), Sjur 
N&oslash;rsteb&oslash; Moshagen (SNM), Thorsten Scherler (TS).</p>
+<p>This is a list of other contributors:<br>Jeremias Maerki.</p>
 </div>
     
-<a name="N10018"></a><a name="version_0.2-dev"></a>
+<a name="N10065"></a><a name="version_0.2-dev"></a>
 <h2 class="underlined_10">Version 0.2-dev (not-released)</h2>
 <div class="section">
-<a name="N1001C"></a><a name="Changes+to+the+Code+Base"></a>
+<a name="N10069"></a><a name="Changes+to+the+Code+Base-N10069"></a>
 <h3 class="underlined_5">Changes to the Code Base</h3>
 <ul>
 <li>
-<img class="icon" alt="add" src="images/add.jpg">
-        Use locationmap for resolution of resources and files. Resources are 
exposed via
-        {lm:pdf.*}
-       Committed by RDG.</li>
+<img class="icon" alt="add" src="images/add.jpg"> Use locationmap for 
resolution of resources
+                and files. Resources are exposed via {lm:pdf.*}  Committed by 
RDG.</li>
 </ul>
-<a name="N10026"></a><a name="Contributors+to+this+release"></a>
+<a name="N10073"></a><a name="Contributors+to+this+release-N10073"></a>
 <h3 class="underlined_5">Contributors to this release</h3>
 <p>We thank the following people for their contributions to this release.</p>
-<p>This is a list of all people who participated as committers:<br> (RDG).</p>
+<p>This is a list of all people who participated as committers:<br>Ross 
Gardler (RDG).</p>
 </div>
     
-<a name="N10031"></a><a name="version_0.1"></a>
+<a name="N1007E"></a><a name="version_0.1"></a>
 <h2 class="underlined_10">Version 0.1 (not-released)</h2>
 <div class="section">
-<a name="N10035"></a><a name="Changes+to+Project+Administration"></a>
+<a name="N10082"></a><a name="Changes+to+Project+Administration"></a>
 <h3 class="underlined_5">Changes to Project Administration</h3>
 <ul>
 <li>
-<img class="icon" alt="add" src="images/add.jpg">
-        Extracted code from core of Forrest and placed in a plugin
-       Committed by RDG.</li>
+<img class="icon" alt="add" src="images/add.jpg"> Extracted code from core of 
Forrest and placed
+                in a plugin  Committed by RDG.</li>
 </ul>
-<a name="N1003F"></a><a name="Contributors+to+this+release-N1003F"></a>
+<a name="N1008C"></a><a name="Contributors+to+this+release-N1008C"></a>
 <h3 class="underlined_5">Contributors to this release</h3>
 <p>We thank the following people for their contributions to this release.</p>
-<p>This is a list of all people who participated as committers:<br> (RDG).</p>
+<p>This is a list of all people who participated as committers:<br>Ross 
Gardler (RDG).</p>
 </div>
   
+<a name="N10097"></a><a name="all-committers"></a>
+<h2 class="underlined_10">All Committers</h2>
+<div class="section">
+<p>This is a list of all people who have ever participated
+           as committers on this project.</p>
+<ul>
+<li>Sjur N&oslash;rsteb&oslash; Moshagen (SNM)</li>
+<li>Ross Gardler (RDG)</li>
+<li>Thorsten Scherler (TS)</li>
+<li>Ferdinand Soethe (FSO)</li>
+<li>David Crossley (DC)</li>
+<li>Jeremias M&auml;rki (JM)</li>
+<li>Volunteer needed (open)</li>
+</ul>
+</div>
 </div>
 <!--+
     |end content
@@ -213,7 +286,7 @@
 </div>
 <div class="copyright">
         Copyright &copy;
-         2004-2007 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
+         2004-2008 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.rss
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.rss?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.rss
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/changes.rss
 Tue Dec  2 16:18:17 2008
@@ -1,9 +1,19 @@
 <?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE rss PUBLIC "-//Netscape 
Communications//DTD RSS 0.91//EN" 
"http://my.netscape.com/publish/formats/rss-0.91.dtd";>
-<rss version="0.91"><channel><title>Plugin: PDF output (0.2-dev) 
Changes</title><link>changes.html</link><description>Plugin: PDF output
+<rss version="0.91"><channel><title>MyProject (0.3-dev) 
Changes</title><link>http://example.org/myproj//changes.html</link><description>MyProject
               (
-              0.2-dev
+              0.3-dev
               ) Changes
             </description><language>en-us</language>
+  
+
+    
+    
+    
+    
+    
+    
+    
+  
 
   
     
@@ -14,31 +24,122 @@
   
   
     
-      <item><title>code add</title><link>changes.html</link><description>code 
add
+      <item><title>MyProject docs 
update</title><link>http://example.org/myproj//changes.html</link><description>docs
 update
         by
-        RDG
+        SNM
         :
+        Updated plugin documentation to cover the new
+                properties settable by the user,and how to actually set
+                them.</description></item>
+      <item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        SNM
+        :
+        Made font family specifications available for
+                user changes without changing the plugin 
code.</description></item>
+      <item><title>MyProject code update
+          (bug FOR-1087)
+        
</title><link>http://example.org/myproj//changes.html</link><description>code 
update
+        by
+        JM
+          (fixes bug FOR-1087)
+        
+        :
+        Added support for "sub" and "sup"
+                tags.</description></item>
+      <item><title>MyProject code update
+          (bug FOR-1072)
+        
</title><link>http://example.org/myproj//changes.html</link><description>code 
update
+        by
+        DC
+          (fixes bug FOR-1072)
         
-        Use locationmap for resolution of resources and files. Resources are 
exposed via
-        {lm:pdf.*}
-      </description></item>
+        :
+        Various bugfixes and improvements for the fo
+                stylesheets. See notes in FOR-1072. Thanks to Jeremias 
Maerki.</description></item>
+      <item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        TS
+        :
+        Encapsulated the xsl methods in different
+                helper stylesheet which we can import from the different
+                plugins. </description></item>
+      <item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        FSO
+        :
+        Moved all libraries and components used by
+                pdf-generation from core into this plugin. 
</description></item>
+      <item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        FSO
+        :
+         Updating the fop-library to fop 0.94 and
+                upgrading the stylesheets to work properly with the new and 
more
+                precise fo-interpeter. </description></item>
     
     
-      <item><title>admin 
add</title><link>changes.html</link><description>admin add
+      <item><title>MyProject code 
add</title><link>http://example.org/myproj//changes.html</link><description>code
 add
         by
         RDG
         :
-        
-        Extracted code from core of Forrest and placed in a plugin
-      </description></item>
+         Use locationmap for resolution of resources
+                and files. Resources are exposed via {lm:pdf.*} 
</description></item>
+    
+    
+      <item><title>MyProject admin 
add</title><link>http://example.org/myproj//changes.html</link><description>admin
 add
+        by
+        RDG
+        :
+         Extracted code from core of Forrest and placed
+                in a plugin </description></item>
     
   
   
-<item><title>code add</title><link>changes.html</link><description>code add
+<item><title>MyProject docs 
update</title><link>http://example.org/myproj//changes.html</link><description>docs
 update
         by
-        RDG
+        SNM
+        :
+        Updated plugin documentation to cover the new
+                properties settable by the user,and how to actually set
+                them.</description></item><item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        SNM
         :
+        Made font family specifications available for
+                user changes without changing the plugin 
code.</description></item><item><title>MyProject code update
+          (bug FOR-1087)
+        
</title><link>http://example.org/myproj//changes.html</link><description>code 
update
+        by
+        JM
+          (fixes bug FOR-1087)
+        
+        :
+        Added support for "sub" and "sup"
+                tags.</description></item><item><title>MyProject code update
+          (bug FOR-1072)
+        
</title><link>http://example.org/myproj//changes.html</link><description>code 
update
+        by
+        DC
+          (fixes bug FOR-1072)
         
-        Use locationmap for resolution of resources and files. Resources are 
exposed via
-        {lm:pdf.*}
-      </description></item></channel></rss>
\ No newline at end of file
+        :
+        Various bugfixes and improvements for the fo
+                stylesheets. See notes in FOR-1072. Thanks to Jeremias 
Maerki.</description></item><item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        TS
+        :
+        Encapsulated the xsl methods in different
+                helper stylesheet which we can import from the different
+                plugins. </description></item><item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        FSO
+        :
+        Moved all libraries and components used by
+                pdf-generation from core into this plugin. 
</description></item><item><title>MyProject code 
update</title><link>http://example.org/myproj//changes.html</link><description>code
 update
+        by
+        FSO
+        :
+         Updating the fop-library to fop 0.94 and
+                upgrading the stylesheets to work properly with the new and 
more
+                precise fo-interpeter. </description></item></channel></rss>
\ No newline at end of file

Added: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/images/update.jpg
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/images/update.jpg?rev=722698&view=auto
==============================================================================
Binary file - no diff available.

Propchange: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/images/update.jpg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/index.html
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/index.html?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/index.html
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/index.html
 Tue Dec  2 16:18:17 2008
@@ -123,22 +123,53 @@
                  &nbsp;<input value="+a" class="biggerfont" title="Enlarge 
text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Welcome to the org.apache.forrest.plugin.output.pdf Plugin</h1>
+<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
 <a href="#Apache+Forrest+-+org.apache.forrest.plugin.output.pdf+Plugin">Apache 
Forrest - org.apache.forrest.plugin.output.pdf Plugin</a>
 </li>
+<li>
+<a href="#Configuration+options">Configuration options</a>
+</li>
+<li>
+<a href="#Font+Family+Configuration">Font Family Configuration</a>
+<ul class="minitoc">
+<li>
+<a href="#Preparations">Preparations</a>
+</li>
+<li>
+<a href="#Font+family+overrides%2Fspecifications">Font family 
overrides/specifications</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Other+presentation+options">Other presentation options</a>
+</li>
+<li>
+<a href="#I18n+Configuration">I18n Configuration</a>
+<ul class="minitoc">
+<li>
+<a href="#Font+Family+Configuration-N100DC">Font Family Configuration</a>
+</li>
+<li>
+<a href="#L10n+of+label+text">L10n of label text</a>
+</li>
+</ul>
+</li>
 </ul>
 </div>
+</div>
     
-<a name="N1000D"></a><a 
name="Apache+Forrest+-+org.apache.forrest.plugin.output.pdf+Plugin"></a>
+<a name="N1000E"></a><a 
name="Apache+Forrest+-+org.apache.forrest.plugin.output.pdf+Plugin"></a>
 <h2 class="underlined_10">Apache Forrest - 
org.apache.forrest.plugin.output.pdf Plugin</h2>
 <div class="section">
 <p>
-        This plugin enables any Forrest page to be output as a PDF document.
+        This plugin (hereafter just called the PDF plugin) enables any
+        Forrest page to be output as a PDF document.
       </p>
 <p>
-        To use it simply request a page with the <span 
class="codefrag">pdf</span> extension
+        To use it simply request a page with the <span 
class="codefrag">pdf</span> extension.
       </p>
 <div class="note">
 <div class="label">Note</div>
@@ -149,6 +180,174 @@
       </div>
 </div>
 </div>
+
+    
+<a name="N10021"></a><a name="Configuration+options"></a>
+<h2 class="underlined_10">Configuration options</h2>
+<div class="section">
+<p>The PDF plugin can be configured in several ways:</p>
+<ul>
+        
+<li>font family configuration</li>
+
+        
+<li>other presentation changes: page size, copyright notes, etc.</li>
+
+        
+<li>i18n configuarion, which is actually two subtopics:<ul>
+            
+<li>font family configuration</li>
+
+            
+<li>l10n of label text</li>
+          
+</ul>
+</li>
+      
+</ul>
+<p>Each of these points will be covered in separate sections below.</p>
+</div>
+
+    
+<a name="N10042"></a><a name="Font+Family+Configuration"></a>
+<h2 class="underlined_10">Font Family Configuration</h2>
+<div class="section">
+<p>The font family can be specifed in different steps of granularity. As
+      of the svn version of the PDF plugin, all of the configuration can be 
done
+      on a per project basis. There is no need to touch the plugin itself, as
+      it used to be.</p>
+<a name="N1004B"></a><a name="Preparations"></a>
+<h3 class="underlined_5">Preparations</h3>
+<p>If you want to change the actual font family, not only where to use
+        the generic <span class="codefrag">serif</span>, <span 
class="codefrag">sans-serif</span> and
+        <span class="codefrag">monospace</span> families, then you also need 
to take these
+        preparatory steps:</p>
+<ol>
+          
+<li>Follow the instructions at <a 
href="http://xmlgraphics.apache.org/fop/0.95/configuration.html";>http://xmlgraphics.apache.org/fop/0.95/configuration.html</a>
+          to create a FOP configuration file at
+          <span 
class="codefrag">$PROJECT_HOME/src/documentation/resources/fonts</span> (you
+          may have to create the <span class="codefrag">fonts</span> folder). 
The FOP
+          configuarion file can a.o. give you access to locally installed
+          fonts.</li>
+
+          
+<li>Specify the absolute path to the FOP configuration file you
+          created in step 1 as the value of the entity
+          <span class="codefrag">&amp;pdf-config-file;</span> in the project 
entity file. The
+          file is located at:
+          <span 
class="codefrag">$PROJECT_HOME/src/documentation/resources/schema/symbols-project-v10.ent</span>.
+          The result should look something like:
+<pre class="code">&lt;!ENTITY pdf-config-file 
"/Users/foo/forrestproject/src/documentation/resources/fonts/config.xml"&gt;</pre>
+          (the
+          above would work for a user named <span class="codefrag">foo</span> 
on a typical
+          MacOS X system - adapt to your local OS as needed, but the path
+          needs to be absolute)</li>
+        
+</ol>
+<p>A minimal FOP configuration file to give you access to all fonst
+        installed on the local OS looks like:</p>
+<pre class="code">&lt;fop&gt;
+ &lt;renderers&gt;
+   &lt;renderer mime="application/pdf"&gt;
+     &lt;fonts&gt;
+       &lt;auto-detect/&gt;
+     &lt;/fonts&gt;
+   &lt;/renderer&gt;
+ &lt;/renderers&gt;
+&lt;/fop&gt;</pre>
+<p>See the link above for more details.</p>
+<p>Continue with the configuration in your
+        <span class="codefrag">forrest.properties.xml</span> file as described 
below.</p>
+<a name="N1008E"></a><a name="Font+family+overrides%2Fspecifications"></a>
+<h3 class="underlined_5">Font family overrides/specifications</h3>
+<p>For the easiest type of changing the font family, add the following
+        lines to your <span class="codefrag">forrest.properties.xml</span> 
file:</p>
+<pre class="code">  &lt;property name="output.pdf.fontFamily.serif"     
value="serif"/&gt;
+  &lt;property name="output.pdf.fontFamily.sansSerif" value="sans-serif"/&gt;
+  &lt;property name="output.pdf.fontFamily.monospace" 
value="monospace"/&gt;</pre>
+<p>and replace the default values above with your preferred font
+        family, e.g. <span class="codefrag">DejaVuSans</span>, etc. Using 
these properties, you
+        will change the font family of whole classes of text types at once. If
+        you need proper i18n support for your language (more below) in the pdf
+        files, this is usually the easiest way to go - just replace the
+        generic families with your chosen font families.</p>
+<p>If you need to override or specify the font family for a certain
+        text type, add one or more of the following properties to your
+        <span class="codefrag">forrest.properties.xml</span> file:</p>
+<pre class="code">  &lt;property name="output.pdf.fontFamily.rootFontFamily"   
       value="serif"      /&gt;
+  &lt;property name="output.pdf.fontFamily.headerFooterFontFamily"  
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.documentTitleFontFamily" 
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.versionFontFamily"       
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.authorsFontFamily"       
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.TOCTitleFontFamily"      
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.TOCFontFamily"           
value="serif"      /&gt;
+  &lt;property name="output.pdf.fontFamily.sectionTitleFontFamily"  
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.sourceFontFamily"        
value="monospace"  /&gt;
+  &lt;property name="output.pdf.fontFamily.codeFontFamily"          
value="monospace"  /&gt;
+  &lt;property name="output.pdf.fontFamily.warningTitleFontFamily"  
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.noteTitleFontFamily"     
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.fixmeTitleFontFamily"    
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.abstractFontFamily"      
value="serif"      /&gt;
+  &lt;property name="output.pdf.fontFamily.noticeFontFamily"        
value="serif"      /&gt;</pre>
+<p>The given values are defaults, and should be replaced with what you
+        want.</p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">The value specified for the properties should be the font 
family
+        name. If the font family name contains spaces, enclose the name in
+        single quotes.</div>
+</div>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">If you are using Dispatcher (in the whiteboard), the 
property
+        <span class="codefrag">output.pdf.fontFamily.versionFontFamily</span> 
does not have any
+        effect. Hopefully this will be corrected in the future.</div>
+</div>
+<p>If you want, you can further specify the font family for
+        variants of the
+        <span 
class="codefrag">output.pdf.fontFamily.headerFooterFontFamily</span> property
+        using the following properties instead:</p>
+<pre class="code">  &lt;property 
name="output.pdf.fontFamily.firstFooterFontFamily"   value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.evenHeaderFontFamily"    
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.evenFooterFontFamily"    
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.oddHeaderFontFamily"     
value="sans-serif" /&gt;
+  &lt;property name="output.pdf.fontFamily.oddFooterFontFamily"     
value="sans-serif" /&gt;</pre>
+<p>It is possible to do further customisations of the pdf rendering by
+        editing the stylesheets found in ...</p>
+</div>
+
+    
+<a name="N100C9"></a><a name="Other+presentation+options"></a>
+<h2 class="underlined_10">Other presentation options</h2>
+<div class="section">
+<p>
+        Presentation changes like page size, copyright notes, etc. are 
presently
+        specified in the <span class="codefrag">skinconfig.xml</span> file. 
See separate documentation for
+        further info.
+      </p>
+</div>
+
+    
+<a name="N100D6"></a><a name="I18n+Configuration"></a>
+<h2 class="underlined_10">I18n Configuration</h2>
+<div class="section">
+<a name="N100DC"></a><a name="Font+Family+Configuration-N100DC"></a>
+<h3 class="underlined_5">Font Family Configuration</h3>
+<p>For some languages, the default font families (<span 
class="codefrag">serif</span>,
+        <span class="codefrag">sans-serif</span>, <span 
class="codefrag">monospace</span>) do not render all
+        characters, giving squares, question marks or nothing instead in the
+        rendered pdf document. This is known to be an issue with CJK
+        languages, as well as with lesser used languages such as S&aacute;mi. 
If this
+        is the case for your language(s), please follow the steps above to
+        configure the pdf plugin to use a font family known to contain all
+        characters needed. For many alphabetic languages, the free and open
+        source <a 
href="http://dejavu.sourceforge.net/wiki/index.php/Main_Page";>DejaVu
+        font family</a> nowadays has quite good coverage.</p>
+<a name="N100F3"></a><a name="L10n+of+label+text"></a>
+<h3 class="underlined_5">L10n of label text</h3>
+<p>[TO BE WRITTEN]</p>
+</div>
   
 </div>
 <!--+
@@ -167,7 +366,7 @@
 </div>
 <div class="copyright">
         Copyright &copy;
-         2004-2007 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
+         2004-2008 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
 </div>
 <div id="logos">
 <a href="http://validator.w3.org/check/referer";><img style="height: 31px; 
width: 88px;" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" 
src="skin/images/valid-html401.png" class="logoImage"></a><a 
href="http://jigsaw.w3.org/css-validator/check/referer";><img style="height: 
31px; width: 88px;" title="Valid CSS!" alt="Valid CSS!" 
src="skin/images/vcss.png" class="logoImage"></a><a 
href="http://forrest.apache.org/";><img border="0" title="Built with Apache 
Forrest" alt="Built with Apache Forrest - logo" 
src="images/built-with-forrest-button.png" style="width: 88px;height: 
31px;"></a>

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/linkmap.html
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/linkmap.html?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/linkmap.html
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/linkmap.html
 Tue Dec  2 16:18:17 2008
@@ -123,6 +123,7 @@
                  &nbsp;<input value="+a" class="biggerfont" title="Enlarge 
text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Site Linkmap Table of Contents</h1>
+<div id="front-matter"></div>
 <p>
           This is a map of the complete site and its structure.
         </p>
@@ -182,7 +183,7 @@
 </div>
 <div class="copyright">
         Copyright &copy;
-         2004-2007 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
+         2004-2008 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_de.xml
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_de.xml?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_de.xml
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_de.xml
 Tue Dec  2 16:18:17 2008
@@ -16,8 +16,8 @@
   limitations under the License.
 -->
 <catalogue>
-  <message key="Font size:">Schriftgrösse:</message>
-  <message key="Last Published:">Zuletzt veröffentlicht:</message>
+  <message key="Font size:">Schriftgr�sse:</message>
+  <message key="Last Published:">Zuletzt ver�ffentlicht:</message>
   <message key="Search">Suche:</message>
   <message key="Search the site with">Suche auf der Seite mit</message>
 </catalogue>

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_es.xml
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_es.xml?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_es.xml
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_es.xml
 Tue Dec  2 16:18:17 2008
@@ -16,8 +16,8 @@
   limitations under the License.
 -->
 <catalogue>
-  <message key="Font size:">Tamaño del texto:</message>
-  <message key="Last Published:">Fecha de publicación:</message>
+  <message key="Font size:">Tama�o del texto:</message>
+  <message key="Last Published:">Fecha de publicaci�n:</message>
   <message key="Search">Buscar</message>
   <message key="Search the site with">Buscar en</message>
 </catalogue>

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_fr.xml
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_fr.xml?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_fr.xml
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/CommonMessages_fr.xml
 Tue Dec  2 16:18:17 2008
@@ -17,7 +17,7 @@
 -->
 <catalogue>
   <message key="Font size:">Taille :</message>
-  <message key="Last Published:">Dernière publication :</message>
+  <message key="Last Published:">Derni�re publication :</message>
   <message key="Search">Rechercher</message>
   <message key="Search the site with">Rechercher sur le site avec</message>
 </catalogue>

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/basic.css
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/basic.css?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/basic.css
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/basic.css
 Tue Dec  2 16:18:17 2008
@@ -39,6 +39,7 @@
 }
 
 .note, .warning, .fixme {
+  clear:right;
   border: solid black 1px;
   margin: 1em 3em;
 }

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/screen.css
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/screen.css?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/screen.css
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/skin/screen.css
 Tue Dec  2 16:18:17 2008
@@ -455,17 +455,13 @@
 }
 
 #motd-area {
-    position: relative; /* IE bugfix cont'd */
-    float: right;
+    position:relative;
+    float:right;
     width: 35%;
     background-color: #f0f0ff;
-    border-top: solid 1px #4C6C8F;
-    border-bottom: solid 1px #4C6C8F;
-    margin-bottom: 15px;
-    margin-left: 15px;
-    margin-right: 10%;
-    padding-bottom: 5px;
-    padding-top: 5px;
+    border: solid 1px #4C6C8F;
+    margin: 0px 0px 10px 10px;
+    padding: 5px;
 }
 
 #minitoc-area {
@@ -483,6 +479,10 @@
     font-weight: normal;
 }
 
+.abstract{
+    text-align:justify;
+    }
+
 li p {
     margin: 0;
     padding: 0;

Modified: 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/todo.html
URL: 
http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/todo.html?rev=722698&r1=722697&r2=722698&view=diff
==============================================================================
--- 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/todo.html
 (original)
+++ 
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf/todo.html
 Tue Dec  2 16:18:17 2008
@@ -123,6 +123,7 @@
                  &nbsp;<input value="+a" class="biggerfont" title="Enlarge 
text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>Todo List</h1>
+<div id="front-matter">
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -130,21 +131,19 @@
 </li>
 </ul>
 </div>
+</div>
     
 <a name="N10008"></a><a name="high"></a>
 <h2 class="underlined_10">high</h2>
 <div class="section">
 <ul>
 <li>
-<strong>[docs]</strong> 
-        Customize this template plugin with your plugin's details.  This
-        TODO list is generated from 'status.xml'.
-       &rarr; RDG</li>
+<strong>[docs]</strong>  Customize this template plugin with your plugin's
+                details. This TODO list is generated from 'status.xml'.  
&rarr; RDG</li>
 <li>
-<strong>[docs]</strong> 
-        Create the documentation with lots of examples and samples.  
-        XML content goes in
-        <span class="codefrag">src/documentation/content/xdocs</span>
+<strong>[docs]</strong>  Create the documentation with lots of examples and
+                samples. XML content goes in
+                <span class="codefrag">src/documentation/content/xdocs</span>
        &rarr; open</li>
 </ul>
 </div>
@@ -166,7 +165,7 @@
 </div>
 <div class="copyright">
         Copyright &copy;
-         2004-2007 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
+         2004-2008 <a href="http://www.apache.org/licenses/";>The Apache 
Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip


Reply via email to