You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-svn@forrest.apache.org by th...@apache.org on 2008/12/03 01:18:17 UTC
svn commit: r722698 - in
/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf:
./ images/ skin/
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 @@
<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ärki (JM), Sjur Nørstebø 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ørstebø 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ärki (JM)</li>
+<li>Volunteer needed (open)</li>
+</ul>
+</div>
</div>
<!--+
|end content
@@ -213,7 +286,7 @@
</div>
<div class="copyright">
Copyright ©
- 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 @@
<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">&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"><!ENTITY pdf-config-file "/Users/foo/forrestproject/src/documentation/resources/fonts/config.xml"></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"><fop>
+ <renderers>
+ <renderer mime="application/pdf">
+ <fonts>
+ <auto-detect/>
+ </fonts>
+ </renderer>
+ </renderers>
+</fop></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"> <property name="output.pdf.fontFamily.serif" value="serif"/>
+ <property name="output.pdf.fontFamily.sansSerif" value="sans-serif"/>
+ <property name="output.pdf.fontFamily.monospace" value="monospace"/></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"> <property name="output.pdf.fontFamily.rootFontFamily" value="serif" />
+ <property name="output.pdf.fontFamily.headerFooterFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.documentTitleFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.versionFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.authorsFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.TOCTitleFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.TOCFontFamily" value="serif" />
+ <property name="output.pdf.fontFamily.sectionTitleFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.sourceFontFamily" value="monospace" />
+ <property name="output.pdf.fontFamily.codeFontFamily" value="monospace" />
+ <property name="output.pdf.fontFamily.warningTitleFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.noteTitleFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.fixmeTitleFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.abstractFontFamily" value="serif" />
+ <property name="output.pdf.fontFamily.noticeFontFamily" value="serif" /></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"> <property name="output.pdf.fontFamily.firstFooterFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.evenHeaderFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.evenFooterFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.oddHeaderFontFamily" value="sans-serif" />
+ <property name="output.pdf.fontFamily.oddFooterFontFamily" value="sans-serif" /></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á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 ©
- 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 @@
<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 ©
- 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 @@
<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'.
- → RDG</li>
+<strong>[docs]</strong> Customize this template plugin with your plugin's
+ details. This TODO list is generated from 'status.xml'. → 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>
→ open</li>
</ul>
</div>
@@ -166,7 +165,7 @@
</div>
<div class="copyright">
Copyright ©
- 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
Re: deploying pdf plugin (Was: r722698 ...output.pdf)
Posted by Thorsten Scherler <th...@juntadeandalucia.es>.
El mié, 03-12-2008 a las 08:55 +0100, Thorsten Scherler escribió:
> El mié, 03-12-2008 a las 12:24 +1100, David Crossley escribió:
> > That just deployed the docs. However it refers to changes
> > to the plugin that have not yet been deployed.
> >
> > There was past discussion about this but not yet done.
> > It refers to the instructions about plugin management.
> >
> > The plugins version number would need to incremented.
> > Also the new features require 0.9 forrest version.
> > So need to deploy the old 0.8 based plugin one more time,
> > then deploy the 0.9 version.
>
> Hmm, rats I thought the 'deploy-docs' will pick up my local version and
> publish correspondingly. I will revert the commit.
Did that now
Commit de la revisión 722880.
The version of the plugin already had been changed (as I could see from
the merging div) leaves us to deploy to 0.9 and not 08, right?
- 0.3-dev
+ 0.2-dev
salu2
--
Thorsten Scherler <thorsten.at.apache.org>
Open Source Java <consulting, training and solutions>
Sociedad Andaluza para el Desarrollo de la Sociedad
de la Información, S.A.U. (SADESI)
Re: deploying pdf plugin (Was: r722698 ...output.pdf)
Posted by Thorsten Scherler <th...@juntadeandalucia.es>.
El mié, 03-12-2008 a las 12:24 +1100, David Crossley escribió:
> That just deployed the docs. However it refers to changes
> to the plugin that have not yet been deployed.
>
> There was past discussion about this but not yet done.
> It refers to the instructions about plugin management.
>
> The plugins version number would need to incremented.
> Also the new features require 0.9 forrest version.
> So need to deploy the old 0.8 based plugin one more time,
> then deploy the 0.9 version.
Hmm, rats I thought the 'deploy-docs' will pick up my local version and
publish correspondingly. I will revert the commit.
salu2
>
> -David
>
> > 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
--
Thorsten Scherler <thorsten.at.apache.org>
Open Source Java <consulting, training and solutions>
Sociedad Andaluza para el Desarrollo de la Sociedad
de la Información, S.A.U. (SADESI)
deploying pdf plugin (Was: r722698 ...output.pdf)
Posted by David Crossley <cr...@apache.org>.
That just deployed the docs. However it refers to changes
to the plugin that have not yet been deployed.
There was past discussion about this but not yet done.
It refers to the instructions about plugin management.
The plugins version number would need to incremented.
Also the new features require 0.9 forrest version.
So need to deploy the old 0.8 based plugin one more time,
then deploy the 0.9 version.
-David
> 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