Where is Tagneto

Download

Tagneto is a SourceForge project. You can download the latest build or the source from the SourceForge project site.

Build

You can download pre-built binaries from SourceForge project site. If you would prefer to build the source, either download the src packages, or you can get the latest code from CVS:
> cvs co tagneto-head
That will grab the source from CVS HEAD.

The following modules are the top-level modules for Tagneto:
  • tagneticcore
  • tagneto
  • webapps (not needed to run the Tagneto View Assembly tool, just web application helpers, like for the DSR API)
  • website
To build Tagneto, use Ant (version 1.6.1 or later):
> cd webapps/data
> ant dist
> cd ../../tagneto
> ant dist
You will be prompted for a build number for each ant run. Enter anything you like, for example, devtest. The output of the build process will be in a top-level deliverables folder.

Tagneto is developed using the Eclipse IDE (3.1.1). The Tagneto code formatter template available here. The .project files are checked into the source, so you should be able to import the tagneticcore, tagneto and website projects into Eclipse.

Install

A Java runtime, version 1.4 or greater is required to run the View Assembly Tool. The Java VM should be accessible on the command line by typing the command:
> java -version
If that returns a version of 1.4 or greater, then you are good to go.

After downloading the build (*.tar.gz for Unix/OSX/Linux, *.zip for Windows), unpack the build in a directory of your choice. For the rest of this document, the directory that has the Tagneto build will be referred to as tagnetodir. The main batch/shell script files are located in tagnetodir/bin.

Unix/OSX/Linux

You need to define a shell environment variable called TAGNETO_HOME. It should have the value of tagnetodir. You may want to add tagnetodir/bin to your PATH, to allow easy execution, but it is not required.

You might also need to make the shell scripts executable:
> chmod ugo+rx tagnetodir/bin/tcore
> chmod ugo+rx tagnetodir/bin/tagneto

Windows

You may want to add tagnetodir/bin to your PATH, to allow easy execution, but it is not required.

Run the View Assembly Tool

Command Line

For the View Assembly Tool, you need to have a tagneticconfig file defined that tells Tagneto what files you want to have transformed, and the definitions of the tags that you want to use. Once you have that, then you can call the Tagneto shell script/batch file.

Unix/OSX/Linux

If you added tagnetodir/bin (see above) to your path, then you can run:
> tagneto YourTagneticconfigFileName.xml
otherwise:
tagnetodir/bin/tagneto YourTagneticconfigFileName.xml

Windows

If you added tagnetodir/bin (see above) to your path, then you can run:
> tagneto.bat YourTagneticconfigFileName.xml
otherwise:
tagnetodir/bin/tagneto.bat YourTagneticconfigFileName.xml

Ant Task

Tagneto comes with an Ant task that can be used to drive Tagneto's View Assembly tool from an Ant build file.

Here is the usage the Ant task. You can see it used in the Tagneto source in tagneto/build.xml.
 <path id="tagneto.classpath">
<pathelement path="${classpath}"/>
<!-- The tagnetodir mentioned below is the directory where you installed Tagneto. -->
<fileset dir="tagnetodir/lib">
<include name="**/*.jar"/>
</fileset>
</path>
<taskdef name="tctransform" classname="org.tagnetic.core.ant.TagneticCoreTask">
<classpath refid="tagneto.classpath"/>
</taskdef>
<tctransform>
<!-- Put your tagneticconfig files here. -->
<fileset dir="yoursourcedir">
<filename name="YourTagneticconfigFileName.xml"/>
</fileset>

<!-- The tagnetodir mentioned below is the directory where you installed Tagneto. -->
<!-- The inclusion of Master.xml is REQUIRED if you want to use the Tagneto tags. -->
<fileset dir="$tagnetodir/config">
<filename name="Master.xml"/>
</fileset>
</tctransform>

Use the JavaScript Libraries

The JavaScript libraries are in the js directory inside the distribution package.

Use the DSR jar file for servlet applications

The DSR JAR that helps servers implement the Dynamic Script Request API can be found in the server/dsr directory inside the distribution package. A sample WAR file that uses the jar is also included. The JAR and WAR file should run with JRE 1.4+.

Copyright © 2005 tagnetic.org.