From 71d1f294f4248dc88e26be721d3b18ebdeef591d Mon Sep 17 00:00:00 2001 From: Keiron Liddle Date: Wed, 6 Feb 2002 09:57:17 +0000 Subject: [PATCH] some minor updates to info git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@194629 13f79535-47bb-0310-9956-ffa450edef68 --- docs/xml-docs/fop/configuration.xml | 12 +++++++++++- docs/xml-docs/fop/embedding.xml | 24 ++++++++++++++++++++---- docs/xml-docs/fop/faq.xml | 18 ++++++++++++++++++ docs/xml-docs/fop/involved.xml | 4 ++-- 4 files changed, 51 insertions(+), 7 deletions(-) diff --git a/docs/xml-docs/fop/configuration.xml b/docs/xml-docs/fop/configuration.xml index 48f3863ba..4d8583546 100644 --- a/docs/xml-docs/fop/configuration.xml +++ b/docs/xml-docs/fop/configuration.xml @@ -1,6 +1,14 @@ + +
+ Configuration + Configurating FOP + + +
+

In the directory xml-fop/conf you will find two configuration files. One of them, @@ -24,7 +32,7 @@ to the hyphenation.dtd in the sub directory /hyph

2. name this new file following this schema: languageCode_countryCode.xml. If you don't need - a country code, leave it away, p.e. the file name for an American english hyphenation pattern + a country code, leave it out, e.g the file name for an American english hyphenation pattern would look like this: en_US.xml. For an Italian file: it.xml. Language and country codes must be the same as in xsl:fo, that is follow ISO 639 @@ -43,4 +51,6 @@

+ + diff --git a/docs/xml-docs/fop/embedding.xml b/docs/xml-docs/fop/embedding.xml index 6435311f0..536dd9ba2 100644 --- a/docs/xml-docs/fop/embedding.xml +++ b/docs/xml-docs/fop/embedding.xml @@ -2,7 +2,15 @@ + +
+ Embedding FOP + Notes about embedding FOP in your Java application + + +
+

Instantiate org.apache.fop.apps.Driver. Once this class is @@ -108,16 +116,24 @@ IntputStream and renderer.

-

In the directory xml-fop/docs/examples/embedding you can find a working example how to use - Fop in a servlet. You can drop the fop.war into the webapps directory of Tomcat, then - go to a URL like this: +

+In the directory xml-fop/docs/examples/embedding you can find a working +example how to use Fop in a servlet. You can drop the fop.war into the +webapps directory of Tomcat, then go to a URL like this:

http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo

+

http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl

You can also find the source code there in the file FopServlet.java

To compile this code you will need servlet_2_2.jar (or compatible), fop.jar and the sax api in your classpath.

+

+ Some browsers have problems handling the PDF result sent back to + the browser. IE is particularly bad and different versions behave + differently. Having a ".pdf" on the end of the url may help. +

- + + diff --git a/docs/xml-docs/fop/faq.xml b/docs/xml-docs/fop/faq.xml index b9fa59aad..767cdd78b 100644 --- a/docs/xml-docs/fop/faq.xml +++ b/docs/xml-docs/fop/faq.xml @@ -100,6 +100,24 @@ author XSL FO documents or the XML and XSLT documents. + + How can I insert special character "X"? + +

+All the characters you need are available at +http://www.unicode.org/charts/. +If you need a character it will be there. Once you have found the hex +or decimal code for the character then you can use this in you xml +document. It will be in the form &#<decimal value>; or +&#x<hex value>;. +

+

+You must have a font that supports the character you need otherwise +it will replace it with a "#" in the output. +

+ + + How can I see a demo? diff --git a/docs/xml-docs/fop/involved.xml b/docs/xml-docs/fop/involved.xml index 6f52297f3..bd57ed503 100644 --- a/docs/xml-docs/fop/involved.xml +++ b/docs/xml-docs/fop/involved.xml @@ -33,7 +33,7 @@ The design for FOP is specified under the Design section.

-This is where the information on how FOP is development and designed +This is where the information on how FOP is developed and designed internally will be kept.

@@ -61,7 +61,7 @@ internally will be kept.

If you want to contribute code (p.e. a bugfix), a test or documentation (p.e. an additional example), please do the following:

1) Make sure your code doesn't break the existing one and that Fop still compiles.

2) Create a file which shows the differences to the existing code.

-

3) Send this file to fop-dev@xml.apache.org.

+

3) Send this file as an Attachment to fop-dev@xml.apache.org.

One of the committers will test your code and commit it to the code repository.

If you have a test or useful bug test you should read this page.

BTW: The Apache project knows different roles for contributors, namely 'users', 'developers', 'committers' and the 'Project -- 2.39.5