| <?xml version="1.0"?> |
| <!DOCTYPE document SYSTEM "./dtd/document-v10.dtd"> |
| |
| <!-- |
| |
| Copyright 2001-2003 The Apache Software Foundation |
| |
| Licensed under the Apache License, Version 2.0 (the "License"); |
| you may not use this file except in compliance with the License. |
| You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| |
| --> |
| |
| <!-- ========================================================================= --> |
| <!-- author stephane@hillion.org --> |
| <!-- version $Id$ --> |
| <!-- ========================================================================= --> |
| |
| <document> |
| <header> |
| <title>Batik - SVG Pretty-printer</title> |
| <subtitle>A SVG Pretty-printer</subtitle> |
| <authors> |
| <person name="Stephane Hillion" email="stephane@hillion.org"/> |
| </authors> |
| </header> |
| |
| <body> |
| <s1 title="Introduction"> |
| |
| <!-- <figure src="images/svgppBanner.jpg" alt="Batik SVG Rasterizer" /> --> |
| |
| <p> |
| This page describes the features of the SVG Pretty-printer utility that |
| comes with the Batik distribution. It discusses the following:</p> |
| <ul> |
| <li><link href="#downloading">Downloading the pretty-printer</link></li> |
| <li><link href="#using">Pretty-printing an SVG file</link></li> |
| </ul> |
| <p> |
| The SVG Pretty-printer is a utility that can format SVG files. |
| The tool format an SVG document according to the arguments passed |
| on the command-line. |
| </p> |
| |
| </s1> |
| |
| <anchor id="downloading" /> |
| <s1 title="Downloading the pretty-printer"> |
| |
| <p>Refer to the <link href="install.html">install |
| page</link> and the <link |
| href="http://www.apache.org/dyn/closer.cgi/xml/batik">download |
| area</link> to find out what to download and how to |
| download it. Remember that you can get either the <link |
| href="install.html#distributions">source |
| distribution</link> or the <link |
| href="install.html#distributions">binary |
| distribution</link>.</p> |
| </s1> |
| |
| <anchor id="using" /> |
| <s1 title="Pretty-printing an SVG file"> |
| <p>The method for starting the pretty-printer depends on the distribution of Batik |
| that you chose to download. The following describes how to start the viewer |
| for each distribution.</p> |
| |
| <anchor id="usingBinary" /> |
| <s2 title="Using the binary distribution" > |
| |
| <p>If you downloaded the <link href="install.html#distributions">binary distribution</link> of Batik, you should have |
| a file called <code>batik-1.5beta3.zip</code>, and, after expanding that |
| file, a JAR (Java ARchive) file called <code>batik-svgpp.jar</code>. |
| To start the pretty-printer, open a console, go to the directory where you |
| expanded the distribution (and where <code>batik-svgpp.jar</code>. is located) and |
| simply type the following at the command prompt :</p> |
| <p><code>java -jar batik-svgpp.jar </code><em>[@options] [@files]</em></p> |
| <p>For example, if you type:</p> |
| <p><code>java -jar batik-svgpp.jar samples/batikFX.svg</code></p> |
| <p>you will see the indented document on the standard output.</p> |
| |
| <p>You can pass options to the command line:</p> |
| <ul> |
| <li><code>-newline</code> <em><cr | cr-lf | lf></em> lets you select the newline character(s) generated in the printed document. The default is 'lf' (unix style newline).</li> |
| <li><code>-tab-width</code> <em><number></em> lets you select the tabulation width. The default value is 4.</li> |
| <li><code>-doc-width</code> <em><number></em> lets you select the document preferred number of columns. The default value is 80.</li> |
| <li><code>-no-format</code> lets you preserve the current indentation. This option is useful to perform doctype or newline substitutions.</li> |
| <li><code>-xml-decl</code> <em><string></em> lets you set the XML declaration.</li> |
| <li><code>-doctype</code> <em><change | remove></em> lets you change or remove the doctype of the document.</li> |
| <li><code>-public-id</code> <em><string></em> lets you specify a public id to use when writing the document. This option is ignored unless '-doctype change' is specified.</li> |
| <li><code>-system-id</code> <em><string></em> lets you specify a system id to use when writing the document. This option is ignored unless '-doctype change' is specified.</li> |
| </ul> |
| <p>For example:</p> |
| <ul> |
| <li><code>java -jar batik-svgpp.jar -tab-width 2 -newline cr-lf src.svg dest.svg</code> will format 'src.svg' and write it to 'dest.svg' using a tabulation width of 2 and dos-style newlines.</li> |
| <li><code>java -jar batik-svgpp.jar -no-format -doctype change -public-id "-//W3C//DTD SVG 20000802//EN" -system-id "http://www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802.dtd" src.svg dest.svg</code> will format 'src.svg' and write it to 'dest.svg', unchanged except the doctype external id which will be replaced by the specified one.</li> |
| </ul> |
| </s2> |
| |
| <s2 title="Using the source distribution"> |
| |
| <p>If you downloaded the <link href="install.html#distributions">source distribution</link> of Batik, you |
| got a zip or tar file that expanded into a directory called <code>xml-batik</code>. In that directory, you |
| can find build scripts for the platform you are running on. For example, there is |
| a <code>build.bat</code> script for users of the Windows platform and there is a <code>build.sh</code> script |
| for UNIX users.</p> |
| <p>To start the pretty-printer you should:</p><ul> |
| <li>Make sure the <code>xml-batik</code> directory is in your PATH environment variable</li> |
| <li>Make sure the <code>ANT_HOME</code> environment variable is set to the xml-batik directory</li> |
| <li>Make sure that your <code>JAVA_HOME</code> environment variable is set to your JDK installation |
| directory</li> |
| <li>Open a command line window and go to the <code>xml-batik</code> directory where the Batik |
| distribution was expanded</li> |
| <li>At the command prompt, type: <br /> |
| <strong>Windows: </strong><code>build svgpp</code>.<br /> |
| <strong>UNIX: </strong><code>build.sh svgpp</code>.<br /> |
| This will printout a |
| help message for the pretty-printer</li> |
| </ul> |
| <p>You can pass options to the rasterizer as follows:</p> |
| <p><strong>Windows: </strong><code>build svgpp </code><em>[@options] [@files]</em></p> |
| <p><strong>UNIX: </strong><code>build.sh svgpp </code><em>[@options] [@files]</em></p> |
| <p>Refer to <link href="#usingBinary">"Using the binary distribution" </link>for an explanation of these |
| options</p> |
| </s2> |
| |
| </s1> |
| </body> |
| </document> |
