Yuriko N. wrote:
The only other issue seems to be fonts.
1. About FOP.pdfFonts
I need to set Japanese fonts for FOP output.
I used [Options]-[Preferences Add-on FOP] and set Japanese fonts.
Then the setting appears in preferences.properties as following.
FOP.pdfFonts=C\:\\Windows\\Fonts\\meiryo.ttc Meiryo NORMAL NORMAL sans-serif NORMAL NORMAL\nC\:\\Windows\\Fonts\\meiryo.ttc
"Meiryo Italic" NORMAL ITALIC sans-serif NORMAL ITALIC\nC\:\\Windows\\Fonts\\meiryob.ttc "Meiryo Bold" BOLD
NORMAL sans-serif BOLD NORMAL\nC\:\\Windows\\Fonts\\meiryob.ttc "Meiryo Bold Italic" BOLD ITALIC serif BOLD
ITALIC\nC\:\\Windows\\Fonts\\msgoth90.ttc "MS Gothic" NORMAL NORMAL monospace NORMAL NORMAL monospace BOLD NORMAL
monospace NORMAL ITALIC monospace BOLD ITALIC\nC\:\\Windows\\Fonts\\msmin90.ttc "MS Mincho" NORMAL NORMAL serif NORMAL
NORMAL serif BOLD NORMAL serif NORMAL ITALIC serif BOLD ITALIC
I was not able to newly set the above using XXE commandline -putpref.
The value of FOP.pdfFonts contains spaces and newlines. Hence it must be
properly quoted and some characters escaped.
The simplest and safest is add to this line as is (and also all your
other user preferences like activeInputMethodClient=true) to a
"common_prefs.properties" file and use -putprefs (with an ending "S")
-putprefs common_prefs.properties
See
http://www.xmlmind.com/xmleditor/_distrib/doc/help/command_line_usage.html
But see below because setting FOP.pdfFonts is *not* *really* *needed*.
(nor remove existing by "-delpref FOP.pdfFonts")
Will you please explain how to pre-set FOP fonts like above ?
FOP.pdfFonts is a user preference which is just used to quickly
initialize this screen of the Preferences dialog box:
http://www.xmlmind.com/xmleditor/_distrib/doc/help/addonOptions.html#fopOptions
However, it's not the FOP.pdfFonts user preference which is used to
actually configure FOP fonts.
In a nutshell, setting FOP.pdfFonts is *not* *important*. If this
FOP.pdfFonts is missing, it is restored from the contents of
"XXE_user_preferences_dir/fop/fop.conf". It is "fop.conf", a FOP
configuration file, which is important to have.
Example of fop.conf automatically generated by XXE by using
"Options|Preferences", "Add-on|FOP"
(http://www.xmlmind.com/xmleditor/_distrib/doc/help/addonOptions.html#fopOptions):
---
<fop>
<renderers>
<renderer mime="application/pdf">
<fonts>
<font embed-url="file:/usr/share/fonts/truetype/comic.ttf"
kerning="yes">
<font-triplet name="Comic Sans MS" style="normal"
weight="normal"/>
<font-triplet name="serif" style="normal" weight="normal"/>
</font>
<font embed-url="file:/usr/share/fonts/truetype/comicbd.ttf"
kerning="yes">
<font-triplet name="Comic Sans MS" style="normal" weight="bold"/>
<font-triplet name="serif" style="normal" weight="bold"/>
</font>
</fonts>
</renderer>
</renderers>
</fop>
---
--> Procedure:
1) Use XXE's "Options|Preferences", "Add-on|FOP" screen to specify which
fonts you want FOP to use.
2) In the add-on directory where you are creating your "customize.xxe"
file, copy "XXE_user_preferences_dir/fop/fop.conf".
3) Add this property to "customize.xxe":
---
<property name="XXE_FOP_CONFIG" url="true">fop.conf</property>
---
(References:
* http://www.xmlmind.com/xmleditor/_distrib/doc/configure/property.html
*
http://www.xmlmind.com/xmleditor/_distrib/doc/help/system_properties.html#XXE_FOP_CONFIG
)
4) Delete folder "XXE_user_preferences_dir/fop/" as it is no longer
needed (and as it now gets in the way).
If you deploy your "customize.xxe" in a corporate add-on, FOP will use
the fonts you have specified. (And without having to explicitly force
user preference FOP.pdfFonts, the "Add-on|FOP" screen will look good!)
Additional question.
I assume when using FOP add-on, there is no XXE interface to specify which
western fonts to fall back on for non-Japanese characters. Am I correct in my
understanding that we cannot have different western fonts for non-Japanese
characters with this interface?
Yes that's right. This would not be useful because this is not how FOP
works.
FOP expects input XSL-FO like this:
<fo:inline font-family="Times New Roman" language="en">Word "cat" is
translated to</fo:inline><fo:inline font-family="MS Mincho"
language="ja">ネコ</fo:inline>.
That is, FOP expects you 1) to explicitly specify which font to use
depending on the text being rendered 2) to declare all the fonts other
that the 14 standard PDF fonts being used by your XSL-FO in a "fop.conf"
file.
(This, in constrast with XMLmind XSL-FO Converter. XMLmind XSL-FO
Converter targeting MS-Word and not PDF, has special settings for
rendering CJK characters.)
2. About Font Family Preference keys
There are three Font Family Preference keys, sansSerifFontFamily,
serifFontFamily and monospaceFontFamily
If I specify Japanese font family for each of them, which western fonts will be
selected for non-Japanese characters?
Example
sansSerifFontFamily=MS Gothic
serifFontFamily=MS Mincho
monospaceFontFamily=MS Gothic
No western fonts at all will be selected for non-Japanese characters.
"MS Gothic" and "MS Mincho" will be used for *all* characters, whether
Western or Japanese.
In practice, you must specify here font families having glyphs for all
Unicode characters, e.g. the stock Java 1.8 fonts or "Arial Unicode MS".
There are probably ways to get exactly what you want but this involves
configuring the Java runtime itself, which is out of the scope of this
XXE support.
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
