File: bk01ch05s02.html

package info (click to toggle)
antelope 3.5.1-5
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid, trixie
  • size: 3,884 kB
  • sloc: java: 27,651; xml: 6,488; sh: 12; makefile: 5
file content (43 lines) | stat: -rw-r--r-- 6,598 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Antelope as a Stand-Alone Application</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="Antelope Users Guide"><link rel="up" href="bk01ch05.html" title="Chapter5.Running Antelope"><link rel="prev" href="bk01ch05.html" title="Chapter5.Running Antelope"><link rel="next" href="bk01ch05s03.html" title="Antelope as a jEdit Plugin"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Antelope as a Stand-Alone Application</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk01ch05.html">Prev</a></td><th width="60%" align="center">Chapter5.Running Antelope</th><td width="20%" align="right"><a accesskey="n" href="bk01ch05s03.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="standalone"></a>Antelope as a Stand-Alone Application</h2></div></div></div>
<STYLE TYPE="text/css"> <!-- @import url(./style.css); --> </STYLE>
<p>
Note: previous releases of Antelope recommended using Ant with the included "run.xml" to start Antelope.  This is no longer recommended.  If you have Java 1.5 and Ant 1.6 or 1.7, just run the jar file as below, or in Windows and some Linux distributions, you can double click the jar file to start Antelope.
</p><p>
Start Antelope by running:
</p><p>
</p><pre class="programlisting">

    cd AntelopeApp_3.5.1
    java -jar AntelopeApp_3.5.1.jar

</pre><p>
</p><p>
The first time you run this you will be asked to enter the location of the 'lib' directory of your Ant installation.
</p><p>
You can also install Antelope by hand. Antelope is packaged as a single jar file, Antelope.jar. Several other jar files may be necessary:
</p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>ant.jar</strong></span> Antelope requires Ant to do anything useful. Ant is available at http://ant.apache.org. Put it in your classpath.
</p></li><li><p><span class="bold"><strong>(Ant 1.5.x) optional.jar</strong></span> This is an optional library that is distributed with Ant. It has additional Ant tasks that may be useful. Put it in your classpath as required.
</p></li><li><p><span class="bold"><strong>(Ant 1.6.x) ant-launcher.jar</strong></span> Ant 1.6.0 split the main ant.jar into a number of smaller files to improve performance and managability. For Ant 1.6.x, ant-launcher.jar is the file that is used to actually start Ant. This jar must also be in your classpath.
</p></li><li><p><span class="bold"><strong>tools.jar</strong></span> This is distributed with the Java Software Development Kit. If your build file makes use of any of the JDK tools (such as javac or javadoc), put this in your classpath.
</p></li><li><p><span class="bold"><strong>An XML parser</strong></span> This can be one of several publicly available XML parsers. Ant is shipped with the Xerces parser. To use the Xerces parser shipped with Ant, add xercesImpl.jar and xml-api.jar from the ${ant.home}/lib directory to your classpath. If you have Java 1.5, it also comes with a built-in XML parser. See the <a class="link" href="">note</a> about having multiple parsers in your classpath and how to get around this problem.
</p></li></ul></div><p>
<span class="bold"><strong>Unless you are running an older version of Java and/or an older version of Ant, just running the jar file will automatically include all necessary files.</strong></span>
</p><p>
Here is Antelope running as a stand-alone application:
</p><p>
</p><div class="figure"><a name="id2494070"></a><p class="title"><b>Figure5.2.Antelope as a stand-alone application</b></p><div class="figure-contents"><img src="standalone.gif" alt="Antelope as a stand-alone application"></div></div><p><br class="figure-break">
</p><p>
Antelope as a stand-alone application provides a few features not found in the plugin version. In the plugin version, these features are provided by jEdit, so are not duplicated. The additional features are:
</p><p>
</p><div class="itemizedlist"><ul type="disc"><li><p>The "File" menu deals with the build file, providing the ability to create a new build file, open a build file and to save changes to the build file. Antelope provides some basic editing capabilities, but is not intended to be a full-featured editor. You may find other editors more suited to editing build files. </p></li><li><p>Also on the "File" menu is the list of recently opened files. This is handy for choosing a file that was previously opened without using the file chooser.</p></li><li><p>The "Output" menu provides the ability to save the Ant output to a file and to clear the 'Output' window.</p></li><li><p>The "Options" menu provides the ability to set a number of options for the application:</p><p>
</p><div class="figure"><a name="id2494132"></a><p class="title"><b>Figure5.3.Font chooser</b></p><div class="figure-contents"><img src="font_dialog.gif" alt="Font chooser"></div></div><p><br class="figure-break">
The same font will be used for both the editor and output window.
</p><p>
</p><div class="figure"><a name="id2494158"></a><p class="title"><b>Figure5.4.Editor options</b></p><div class="figure-contents"><img src="editor_options_dialog.gif" alt="Editor options"></div></div><p><br class="figure-break">
</p><p>
</p><div class="figure"><a name="id2494180"></a><p class="title"><b>Figure5.5.Syntax highlighting options</b></p><div class="figure-contents"><img src="syntax_dialog.gif" alt="Syntax highlighting options"></div></div><p><br class="figure-break">
Syntax hightlighting only applies to the editor window, not the output window.
</p></li></ul></div><p>
</p><p>
Printing is not available in this version, but is on the feature list for implementation.
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk01ch05.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="bk01ch05.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="bk01ch05s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter5.Running Antelope</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">Antelope as a jEdit Plugin</td></tr></table></div></body></html>