From 2198b4395c27f3ba3fa6688e316eb246c5c08e73 Mon Sep 17 00:00:00 2001 From: Simon Pepping Date: Sat, 6 Jan 2007 11:07:37 +0000 Subject: [PATCH] Added to the documentation of FOP's classpath and jar features git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@493445 13f79535-47bb-0310-9956-ffa450edef68 --- .../content/xdocs/trunk/running.xml | 126 ++++++++++++------ 1 file changed, 85 insertions(+), 41 deletions(-) diff --git a/src/documentation/content/xdocs/trunk/running.xml b/src/documentation/content/xdocs/trunk/running.xml index ec82feb72..4b488ef12 100644 --- a/src/documentation/content/xdocs/trunk/running.xml +++ b/src/documentation/content/xdocs/trunk/running.xml @@ -105,60 +105,73 @@

- [OPTIONS] - -d debug mode - -x dump configuration settings - -q quiet mode - -c cfg.xml use additional configuration file cfg.xml - -l lang the language to use for user information - -r relaxed/less strict validation (where available) - -dpi xxx target resolution in dots per inch (dpi) where xxx is a number - -s for area tree XML, down to block areas only - -v to show FOP version being used +Fop [options] [-fo|-xml] infile [-xsl file] [-awt|-pdf|-mif|-rtf|-tiff|-png|-pcl|-ps|-txt|-at [mime]|-print] + [OPTIONS] + -d debug mode + -x dump configuration settings + -q quiet mode + -c cfg.xml use additional configuration file cfg.xml + -l lang the language to use for user information + -r relaxed/less strict validation (where available) + -dpi xxx target resolution in dots per inch (dpi) where xxx is a number + -s for area tree XML, down to block areas only + -v to show FOP version being used - [INPUT] - infile xsl:fo input file (the same as the next) - -fo infile xsl:fo input file - -xml infile xml input file, must be used together with -xsl - -xsl stylesheet xslt stylesheet - -atin infile area tree input file + -o [password] PDF file will be encrypted with option owner password + -u [password] PDF file will be encrypted with option user password + -noprint PDF file will be encrypted without printing permission + -nocopy PDF file will be encrypted without copy content permission + -noedit PDF file will be encrypted without edit content permission + -noannotations PDF file will be encrypted without edit annotation permission + -pdfprofile prof PDF file will be generated with the specified profile + (Examples for prof: PDF/A-1b or PDF/X-3:2003) + + [INPUT] + infile xsl:fo input file (the same as the next) + -fo infile xsl:fo input file + -xml infile xml input file, must be used together with -xsl + -atin infile area tree input file + -xsl stylesheet xslt stylesheet + -param name value to use for parameter in xslt stylesheet (repeat '-param name value' for each parameter) - - [OUTPUT] - outfile input will be rendered as pdf file into outfile - -pdf outfile input will be rendered as pdf file (outfile req'd) - -awt input will be displayed on screen - -mif outfile input will be rendered as mif file (outfile req'd) - -rtf outfile input will be rendered as rtf file (outfile req'd) - -tiff outfile input will be rendered as tiff file (outfile req'd) - -png outfile input will be rendered as png file (outfile req'd) - -pcl outfile input will be rendered as pcl file (outfile req'd) - -ps outfile input will be rendered as PostScript file (outfile req'd) - -txt outfile input will be rendered as text file (outfile req'd) - -svg outfile input will be rendered as an svg slides file (outfile req'd) - -at [mime] out representation of area tree as XML (outfile req'd) + + [OUTPUT] + outfile input will be rendered as PDF into outfile + -pdf outfile input will be rendered as PDF (outfile req'd) + -pdfa1b outfile input will be rendered as PDF/A-1b compliant PDF + (outfile req'd, same as "-pdf outfile -pdfprofile PDF/A-1b") + -awt input will be displayed on screen + -mif outfile input will be rendered as MIF (FrameMaker) (outfile req'd) + -rtf outfile input will be rendered as RTF (outfile req'd) + -tiff outfile input will be rendered as TIFF (outfile req'd) + -png outfile input will be rendered as PNG (outfile req'd) + -pcl outfile input will be rendered as PCL (outfile req'd) + -ps outfile input will be rendered as PostScript (outfile req'd) + -txt outfile input will be rendered as plain text (outfile req'd) + -svg outfile input will be rendered as an SVG slides file (outfile req'd) + -at [mime] out representation of area tree as XML (outfile req'd) specify optional mime output to allow AT to be converted to final format later - -print input file will be rendered and sent to the printer - see options with "-print help" + -print input file will be rendered and sent to the printer + see options with "-print help" -out mime outfile input will be rendered using the given MIME type (outfile req'd) Example: "-out application/pdf D:\out.pdf" (Tip: "-out list" prints the list of supported MIME types) - - -foout outfile input will only be XSL transformed. The intermediate - XSL-FO file is saved and no rendering is performed. + + -foout outfile input will only be XSL transformed. The intermediate + XSL-FO file is saved and no rendering is performed. (Only available if you use -xml and -xsl parameters) + [Examples] - Fop foo.fo foo.pdf + Fop foo.fo foo.pdf Fop -fo foo.fo -pdf foo.pdf (does the same as the previous line) Fop -xml foo.xml -xsl foo.xsl -pdf foo.pdf Fop -xml foo.xml -xsl foo.xsl -foout foo.fo Fop foo.fo -mif foo.mif Fop foo.fo -rtf foo.rtf - Fop foo.fo -print or Fop -print foo.fo + Fop foo.fo -print or Fop -print foo.fo Fop foo.fo -awt]]>

PDF encryption is only available if FOP was compiled with encryption support @@ -177,12 +190,43 @@ Fop [options] [-fo|-xml] infile [-xsl file] [-awt|-pdf|-mif|-rtf|-tiff|-png|-pcl the standard scripts to make sure that you get your environment properly configured.

+ +
+ Running with java's <code>-jar</code> option

- As an alternative to the start scripts you can run "java -jar build/fop.jar" in which case - FOP tries to build the classpath for running FOP dynamically. Please note, that this might - not always work as expected. + As an alternative to the start scripts you can run java + -jar build/fop.jar from the FOP_HOME directory. In this + case FOP tries to build the classpath for running FOP + dynamically, see below. If + you use hyphenation, you must put fop-hyph.jar in + the lib directory.

+

You can also run java -jar fop.jar from any + other working directory. This only works if you put + fop.jar and all jar files from the lib + directory in a single directory. See the Class-Path + entry in the manifest file. If you use hyphenation, you + must also put fop-hyph.jar in that directory.

+
+ FOP's dynamical classpath construction + +

If FOP is started without a proper classpath, it tries to + add its dependencies dynamically. FOP expects to find + fop.jar in the build directory, + which is either the current working directory or one of its + subdirectories. Then FOP adds all jar files in + the lib directory to the classpath. The + lib directory is a sibling directory of the + build directory, or, if that does not exist, the + parent directory of the build directory. If the + system property fop.optional.lib contains the + name of a directory, then all jar files in that + directory are also added to the classpath. See the methods + getJARList and checkDependencies in + org.apache.fop.cli.Main.

+ +
Using Xalan to Check XSL-FO Input -- 2.39.5