<?xml version="1.0" standalone="no"?>
+<document>
+ <header>
+ <title>Configuration</title>
+ <subtitle>Configurating FOP</subtitle>
+ <authors>
+ </authors>
+ </header>
+ <body>
<s1 title="Configuration">
<s2 title="How to configure Fop">
<p>In the directory xml-fop/conf you will find two configuration files. One of them,
to the hyphenation.dtd in the sub directory /hyph
</p>
<p>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
<jump href="http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt">ISO 639</jump>
</p>
</s2>
</s1>
+ </body>
+</document>
<!-- Embedding FOP -->
+<document>
+ <header>
+ <title>Embedding FOP</title>
+ <subtitle>Notes about embedding FOP in your Java application</subtitle>
+ <authors>
+ </authors>
+ </header>
+ <body>
<s1 title="Embedding FOP ">
<s2 title="Overview">
<p>Instantiate org.apache.fop.apps.Driver. Once this class is
</p>
</s2>
<s2 title="Using Fop in a servlet">
- <p>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:
+ <p>
+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:
</p>
<p>http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo</p>
+ <p>http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl</p>
<p>You can also find the source code there in the file FopServlet.java</p>
<p>
To compile this code you will need servlet_2_2.jar (or compatible), fop.jar and the sax api in your classpath.
</p>
+ <note><p>
+ 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.
+ </p></note>
</s2>
</s1>
-
+ </body>
+</document>
</answer>
</faq>
+<faq>
+ <question>How can I insert special character "X"?</question>
+ <answer>
+ <p>
+All the characters you need are available at
+<jump href="http://www.unicode.org/charts/">http://www.unicode.org/charts/</jump>.
+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>;.
+ </p>
+ <p>
+You must have a font that supports the character you need otherwise
+it will replace it with a "#" in the output.
+ </p>
+ </answer>
+</faq>
+
<faq>
<question>How can I see a demo?</question>
<answer>
<jump href="design/index.html">Design</jump> section.
</p>
<p>
-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.
</p>
</s2>
<p>If you want to contribute code (p.e. a bugfix), a test or documentation (p.e. an additional example), please do the following: </p>
<p>1) Make sure your code doesn't break the existing one and that Fop still compiles.</p>
<p>2) Create a file which shows the differences to the existing code.</p>
- <p>3) Send this file to <jump href="mailto:fop-dev@xml.apache.org">fop-dev@xml.apache.org.</jump></p>
+ <p>3) Send this file as an <strong>Attachment</strong> to <jump href="mailto:fop-dev@xml.apache.org">fop-dev@xml.apache.org.</jump></p>
<p>One of the committers will test your code and commit it to the code repository.</p>
<p>If you have a test or useful bug test you should <jump href="testing.html">read this page</jump>.</p>
<p>BTW: The Apache project knows different roles for contributors, namely 'users', 'developers', 'committers' and the 'Project
projects / xmlgraphics-fop.git / commitdiff