Victor,
On 7/10/2003 11:30 AM, Victor Mote wrote:
Clay Leeds wrote (a long time ago, May 14, 2003 to be exact):I guess the age old, should SVG-specific configuration information be placed on the Configuration.html page (with a link to configuration.html#svg), or on the Graphics page? The same would hold true for FONTs...
First, I apologize for being so slow. I have now done (in CVS) most of what you have suggested here. Specifically, the configuration documentation now shows all of the configuration options, with detail where necessary (we can always add more later), and cross-references for items that are addressed in other parts of the doc (like fonts, and now, hyphenation).
Sounds good. Moving hyphenation to its own page appears to be a step in the right direction, and should make it easier for people who're interested to find the information. Great work!
NOTE to Victor/DEV: although the information is in conf/userconfig.xml, we might want to add an example XML entry showing how to add a hyphenation pattern directory. Here's example copy:
To add the hyphenation directory (filled with all sorts of hyphenation patterns such as the Klingon Hyphenation pattern) located at /java/fop-0.20.4/hyph/, enter the following in the HYPHENATION section of userconfig.xml:
<entry> <key>hyphenation-dir</key> <value>/java/fop-0.20.4/hyph</value> </entry>
What I have done with this is to show in a general way how to set the key-value items in the configuration. Since they are all the same, it doesn't seem to make sense to document all of them.
Fine with me, although since there're only 3 or 4 different possibilities (I don't recall if there are others), it makes sense (to me) to provide an example of each.
FWIW, the keys I am aware of are: baseDir, fontBaseDir, hyphenation-dir (shouldn't that be 'hyphenationDir', 'hyphDir' or 'hyphBaseDir'?). The fact that the latter is non-standard makes me think it would be better to provide an example for each. In my view, the best way to minimize the posting of FAQs to the list is to 'idiot-proof' (as much as possible) the userconfig.xml file itself, by giving as many examples as relevant. Practicing brevity in 'help' files may be counter-productive.
Look for these changes to be on the live site sometime in the next 24 hours.
Victor Mote
That's great! I'm looking forward to the magic moment when I can see all of your hard work in all its glory, LIVE. ;)
-- Clay Leeds - [EMAIL PROTECTED] Web Developer - Medata, Inc. - http://www.medata.com PGP Public Key: https://mail.medata.com/pgp/cleeds.asc
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
