Hi Andreas and Max,
I have attached patch file which updates the 0.94 and trunk
documentation with a more detailed description of the inner workings of
font auto-detection on different plaforms.
Adrian.
Max Berger wrote:
Andreas,
Looks like there is some text missing here. It should probably be
something like:
Fonts in well-known paths are automatically detected. The paths for
Unix-Systems are:
* [ the four bullets]
For Windows Systems these are:
* [add paths for windows]
Max Berger
e-mail: [EMAIL PROTECTED]
--
PGP/GnuPG ID: E81592BC Print: F489F8759D4132923EC4 BC7E072AB73AE81592BC
For information about me or my projects please see http://max.berger.name
Am 05.09.2007 um 23:35 schrieb Andreas L Delmelle:
Hi all,
Is there a slight error on our fonts page?
see: http://xmlgraphics.apache.org/fop/0.94/fonts.html#register
What is the function/meaning of the first four bullets?
Have I missed something? Anyone know where these come from?
Cheers
Andreas
Index: src/documentation/content/xdocs/0.94/fonts.xml
===
--- src/documentation/content/xdocs/0.94/fonts.xml (revision 573533)
+++ src/documentation/content/xdocs/0.94/fonts.xml (working copy)
@@ -234,7 +234,7 @@
msmincho.ttc msminch.xml
-Register Fonts with FOP - Auto-Detect Fonts
+Register Fonts with FOP
You must tell FOP how to find and use the font metrics files by registering them in the FOP Configuration. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:
-Review the documentation for FOP Configuration for instructions on making the FOP configuration available to FOP when it runs. Otherwise, FOP has no way of finding your custom font information.
+
+
+
+
+ C:\MyFonts1
+
+
+ C:\MyFonts2
+
+
+
+]]>
+
+ Review the documentation for FOP Configuration for
+ instructions on making the FOP configuration available to FOP when it runs. Otherwise,
+ FOP has no way of finding your custom font information.
+
URLs are used to access the font metric and font files.
Relative URLs are resolved relative to the font-base property (or base) if available.
See FOP: Configuration for more information.
- The "kerning" and "embed-url" attributes are optional. Kerning is currently not used at all. If embedding is off, the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.
- When setting the embed-url attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.
+
+If relative URLs are specified, they are evaluated relative to the value of the
+"font-base" setting. If there is no "font-base" setting, the fonts are evaluated
+relative to the base directory.
+
+ Either an "embed-url" or a "metrics-url" must be specified for font tag configurations.
+ The font "kerning" attribute is optional.
+ If embedding is off, the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.
+ When setting the "embed-url" attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.
+ The fonts "directory" tag can be used to register fonts contained within a single or list of directory paths. The "recursive" attribute can be specified to recursively add fonts from all sub directories.
+ Fonts registered with "font" tag configurations override fonts found by means of "directory" tag definitions.
+ Fonts found as a result of a "directory" tag configuration override fonts found as a result of the "auto-detect" tag being specified.
+ The fonts "auto-detect" tag can be used to automatically register fonts that are found to be installed on the native operating system.
+
+On Unix platforms the autodetect feature looks in java user.home + "/.fonts", "/usr/local/fonts", "/usr/share/fonts" and "/usr/X11R6/lib/X11/fonts" for fonts it is able to use.
+On Mac platforms the autodetect feature looks in java user.home + "/Library/Fonts/, "/Library/Fonts/", "/System/Library/Fonts/" and "/Network/Library/Fonts/" for fonts it is able to use.
+On Windows platforms the autodetect feature attempts to determine the Windows fonts directory (usually C:\WINDOWS\FONTS) and also the existence of a