vmote 2003/07/11 12:01:54 Modified: src/documentation/content/xdocs configuration.xml faq.xml fo.xml Log: 1. add section about external resources in fo.xml 2. update the faq regarding external resources to point to this new section 3. update configuration.xml to include additional information about the default baseDir (which information was formerly in the faq). Revision Changes Path 1.14 +2 -2 xml-fop/src/documentation/content/xdocs/configuration.xml Index: configuration.xml =================================================================== RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/configuration.xml,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- configuration.xml 10 Jul 2003 18:33:16 -0000 1.13 +++ configuration.xml 11 Jul 2003 19:01:54 -0000 1.14 @@ -45,7 +45,7 @@ <tr> <td>baseDir</td> <td>URL</td> - <td>directory containing the input FO file</td> + <td>For command-line, the directory containing the input FO or XML file. For embedded, the current working directory.</td> </tr> <tr> <td>fontBaseDir</td> @@ -53,7 +53,7 @@ <td>value of baseDir</td> </tr> <tr> - <td>hyphenation-dir</td> + <td><link href="#hyphenation-dir">hyphenation-dir</link></td> <td>URL</td> <td>None. This is for custom hyphenation patterns.</td> </tr> 1.36 +1 -16 xml-fop/src/documentation/content/xdocs/faq.xml Index: faq.xml =================================================================== RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/faq.xml,v retrieving revision 1.35 retrieving revision 1.36 diff -u -r1.35 -r1.36 --- faq.xml 21 Jun 2003 14:41:08 -0000 1.35 +++ faq.xml 11 Jul 2003 19:01:54 -0000 1.36 @@ -309,22 +309,7 @@ <faq id="cannot-find-external-graphics"> <question>FOP cannot find a file for fo:external-graphics.</question> <answer> - <p> - The src attribute of the fo:external-graphics element takes an URI, - not a file name. - </p> - <p> - Relative URLs are resolved against the baseDir property of FOP. For - the command line FOP application, the baseDir is the directory of the - input file, either the FO file or the XML source. If FOP is used - embedded in a servlet, <link href="embedding.html">baseDir can be - set explicitely</link>. If it's not set, it is usually the current - working directory of the process which runs FOP. - </p> - <!--p> - See Understanding URIs and URLs and Understanding - URL resolving. - </p--> + <p>The src attribute of the fo:external-graphics element requires a URI, not a file name. See <link href="fo.html#external-resources">External Resources</link> for more information about specifying URIs.</p> </answer> </faq> <faq id="fonts-not-found"> 1.6 +8 -0 xml-fop/src/documentation/content/xdocs/fo.xml Index: fo.xml =================================================================== RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/fo.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- fo.xml 17 Jun 2003 19:02:25 -0000 1.5 +++ fo.xml 11 Jul 2003 19:01:54 -0000 1.6 @@ -436,6 +436,14 @@ </fo:simple-page-master> </fo:layout-master-set>]]></source> </section> + <section id="external-resources"> + <title>External Resources</title> + <p>Resources needed by an XSL-FO file that are external to it (graphics, for example), are defined in the XSL-FO standard as being of type "uri-specification". This is defined in the standard at <jump href="http://www.w3.org/TR/2001/REC-xsl-20011015/slice5.html#section-N8794-Property-Datatypes">Section 5.11 Property Datatypes</jump>, which includes a link to the URI standard itself. Refer to the XSL-FO and URI standards themselves for more detailed instructions.</p> + <p>URIs may be either absolute or relative to a base URI. (See <link href="configuration.html">FOP: Configuration</link> for information on setting the base URI for a FOP session). Here is an example referencing an external-graphic that is relative to the base URI:</p> + <source><![CDATA[<fo:external-graphic src="url('images/logo.jpg')"/>]]></source> + <p>Here is an example referencing an external-graphic that is an absolute URI on a local filesystem:</p> + <source><![CDATA[fo:external-graphic src="url('file:d:///images/logo.jpg')"/>]]></source> + </section> </section> </body> </document>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]