Getting started with <> <> could be used as * a command line tool from your preferred shell environment, * as a RESTful Webservice, * as a library. This section shows how to deal with them. Using Any23 as a command line tool Once <> has been correctly {{{install.html}installed}}, if you want to use it as a command line tool, please use the shell scripts provided in the <<"/bin">> directory of the download. These are provided both as Windows and Unix (Linux/OS X) versions. Note, you may want to add the /bin directory to your system path. The main script is <<"any23">>. The <<"any23tools">> command also provides access to some testing, debugging and analyzing utilities (sorry, we do not provide a documentation for this at the moment). * Examples We believe that any23 provides you and easy to use command line interface with self explaining optional parameters. Different usages are now described: ** Overview: +------------------------------------------- $ ./any23 usage: any23 [file|url] [-e ] [-f ] [-l ] [-o ] [-s] [-t] [-v] -e comma-separated list of extractors, e.g. rdf-xml,rdf-turtle -f,--format [turtle (default), ntriples, rdfxml,quad] -l,--log logging, please specify a file -o,--output ouput file (defaults to stdout) -s,--stats print out statistics of Any23 -t,--notrivial filter trivial statements -v,--verbose show progress and debug information +------------------------------------------- ** Extract meta information from Web documents: +----------------------------------------- $ ./any23 http://yourdomain/yourfile +----------------------------------------- ** Extract meta information from local files: +-------------------------------------- $ ./any23 /home/user/myFoaf.rdf +-------------------------------------- ** Specify the output format, use option <<"-f">> or <<"--format">>: TURTLE - default configuration, no need for specific flag +-------------------------------------- $ ./any23 foaf.rdf +-------------------------------------- N3 - <<-f ntriples>> +-------------------------------------- $ ./any23 -f ntriples foaf.rdf +-------------------------------------- Quad - <<-f quad>> (please see further information about the {{{http://sw.deri.org/2008/07/n-quads/}"quad"}} format) +-------------------------------------- $ ./any23 -f quad foaf.rdf +-------------------------------------- ** Filtering trivial statements By default, <> will extract meta information, such as links to or meta information like the author or the software used to create the . Hence, if the user is only interested in the structured content from the tag we offer a filter functionality, activated by the <<"-t">> command line argument. +------------------------- $ ./any23 -t foaf.rdf +------------------------- Using <> as a Web service <> provides a web interface that you can use to extract from Web documents. <> services can be invoked through a RESTful AP described below. * Running the server Run the <"any23server"> script from the command line in order to start up the server, then go to {{{http://localhost:8080/}}} to access the web interface. The web interface also provides a REST API for converting between formats. Documentation for the API is served up by the servlet itself at {{{http://localhost:8080/}}}. We have a demo version of the servlet running at {{{http://any23.org/}}}. You can also start the server from Java by running the {{{http://developers.any23.org/apidocs/org/deri/any23/servlet/Any23Server.html}Any23Server}} class. The Ant build can be used to create a WAR file for deployment into an existing servlet container such as {{{http://tomcat.apache.org/}Apache Tomcat}}; type to generate the file. Integrating Any23 in your Java programs See our {{{developers.html}Developers guide}} for more details.