Return-Path: Delivered-To: apmail-forrest-svn-archive@www.apache.org Received: (qmail 6362 invoked from network); 16 Sep 2008 10:08:38 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 16 Sep 2008 10:08:38 -0000 Received: (qmail 93240 invoked by uid 500); 16 Sep 2008 10:08:34 -0000 Delivered-To: apmail-forrest-svn-archive@forrest.apache.org Received: (qmail 93178 invoked by uid 500); 16 Sep 2008 10:08:34 -0000 Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: "Forrest Developers List" List-Id: Delivered-To: mailing list svn@forrest.apache.org Received: (qmail 93169 invoked by uid 99); 16 Sep 2008 10:08:34 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 16 Sep 2008 03:08:34 -0700 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 16 Sep 2008 10:07:44 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 9C8D9238889D; Tue, 16 Sep 2008 03:07:46 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r695801 - /forrest/trunk/plugins/org.apache.forrest.plugin.output.pdf/src/documentation/content/xdocs/index.xml Date: Tue, 16 Sep 2008 10:07:45 -0000 To: svn@forrest.apache.org From: sjur@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20080916100746.9C8D9238889D@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: sjur Date: Tue Sep 16 03:07:44 2008 New Revision: 695801 URL: http://svn.apache.org/viewvc?rev=695801&view=rev Log: Added some more details to the PDF plugin documentation. Modified: forrest/trunk/plugins/org.apache.forrest.plugin.output.pdf/src/documentation/content/xdocs/index.xml Modified: forrest/trunk/plugins/org.apache.forrest.plugin.output.pdf/src/documentation/content/xdocs/index.xml URL: http://svn.apache.org/viewvc/forrest/trunk/plugins/org.apache.forrest.plugin.output.pdf/src/documentation/content/xdocs/index.xml?rev=695801&r1=695800&r2=695801&view=diff ============================================================================== --- forrest/trunk/plugins/org.apache.forrest.plugin.output.pdf/src/documentation/content/xdocs/index.xml (original) +++ forrest/trunk/plugins/org.apache.forrest.plugin.output.pdf/src/documentation/content/xdocs/index.xml Tue Sep 16 03:07:44 2008 @@ -61,7 +61,7 @@ Font Family Configuration

The font family can be specifed in different steps of granularity. As - of version 0.4 of the PDF plugin, all of the configuration can be done + 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.

@@ -75,24 +75,43 @@
  1. Follow the instructions at http://cocoon.apache.org/2.1/userdocs/pdf-serializer.html - to create a font configuration file and font metrics files at + href="http://xmlgraphics.apache.org/fop/0.95/configuration.html">http://xmlgraphics.apache.org/fop/0.95/configuration.html + to create a FOP configuration file at $PROJECT_HOME/src/documentation/resources/fonts (you - may have to create the fonts folder).
  2. + may have to create the fonts folder). The FOP + configuarion file can a.o. give you access to locally installed + fonts. -
  3. Specify the absolute path to the font configuration file you +
  4. Specify the absolute path to the FOP configuration file you created in step 1 as the value of the entity &pdf-config-file; in the project entity file. The file is located at: $PROJECT_HOME/src/documentation/resources/schema/symbols-project-v10.ent. - The result should look something like:<!ENTITY pdf-config-file "/Users/foo/forrestproject/src/documentation/resources/fonts/config.xml">(the + The result should look something like: +<!ENTITY pdf-config-file "/Users/foo/forrestproject/src/documentation/resources/fonts/config.xml"> + (the above would work for a user named foo on a typical MacOS X system - adapt to your local OS as needed, but the path needs to be absolute)
  5. - -
  6. Finally, add the necessary configuration options to your - forrest.properties.xml file, as described below.
+ +

A minimal FOP configuration file to give you access to all fonst + installed on the local OS looks like:

+ + + + + + + + + +]]> + +

See the link above for more details.

+ +

Continue with the configuration in your + forrest.properties.xml file as described below.

@@ -133,7 +152,17 @@ <property name="output.pdf.fontFamily.noticeFontFamily" value="serif" />

The given values are defaults, and should be replaced with what you - want. If you want, you can further specify the font family for + want.

+ + 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. + + If you are using Dispatcher (in the whiteboard), the property + output.pdf.fontFamily.versionFontFamily does not have any + effect. Hopefully this will be corrected in the future. + +

If you want, you can further specify the font family for variants of the output.pdf.fontFamily.headerFooterFontFamily property using the following properties instead:

@@ -185,4 +214,4 @@
- \ No newline at end of file +