This should fix https://issues.apache.org/jira/browse/JENA-849
The examples still needs information about adding the target/generated-sources to the compile path (as the plugin doesn't yet - JENA-731 JENA-732 are dormant since June :-/ On 26 February 2015 at 00:20, Stian Soiland-Reyes <st...@apache.org> wrote: > Clone URL (Committers only): > https://cms.apache.org/redirect?new=stain;action=diff;uri=http://jena.apache.org/documentation%2Ftools%2Fschemagen-maven.mdtext > > .. now also with <version> update links. > > Index: trunk/content/documentation/tools/schemagen-maven.mdtext > =================================================================== > --- trunk/content/documentation/tools/schemagen-maven.mdtext (revision > 1655891) > +++ trunk/content/documentation/tools/schemagen-maven.mdtext (working copy) > @@ -10,15 +10,15 @@ > constants from the ontology. > > For some projects, invoking `schemagen` from the command line, perhaps via > `ant`, > -is sufficient. For projects organised around Apache maven, it would be > convenient to integrate > -the schemagen translation step into maven's normal build process. This plugin > +is sufficient. For projects organised around Apache Maven, it would be > convenient to integrate > +the schemagen translation step into Maven's normal build process. This plugin > provides a means to do just that. > > ## Pre-requisites > > -This plugin adds a step to the maven build process to automatically > translate RDFS > +This plugin adds a step to the Maven build process to automatically > translate RDFS > and OWL files, encoded as RDF/XML, Turtle or N-triples into Java source > files. > -This plugin is designed to be used with a Java project that is already using > Apache maven to > +This plugin is designed to be used with a Java project that is already using > Apache Maven to > control the build. Non-Java projects do not need this tool. Projects that are > not using Maven should see the [schemagen documentation](schemagen.html) > for ways to run `schemagen` from the command line. > @@ -29,13 +29,34 @@ > Schemagen is available from the maven central repository. To use it, add > the following dependency to your `pom.xml`: > > - <dependency> > - <groupId>org.apache.jena.tools</groupId> > - <artifactId>schemagen</artifactId> > - <version>0.2-SNAPSHOT</version> > - <type>maven-plugin</type> > - </dependency> > + <build> > + <plugins> > + <plugin> > + <groupId>org.apache.jena</groupId> > + <artifactId>jena-maven-tools</artifactId> > + <version>0.7</version> > + <executions> > + <execution> > + <id>schemagen</id> > + <goals> > + <goal>translate</goal> > + </goals> > + </execution> > + </executions> > + </plugin> > + </plugins> > + </build> > + <dependencies> > + <dependency> > + <groupId>org.apache.jena</groupId> > + <artifactId>jena-core</artifactId> > + <version>2.12.1</version> > + </dependency> > + </dependencies> > > +Replace the `<version>` tags above with the latest versions as found by > +browsing > [jena-maven-tools](http://central.maven.org/maven2/org/apache/jena/jena-maven-tools/) > +and [jena-core](http://central.maven.org/maven2/org/apache/jena/jena-core/) > in Maven Central. > > > ## Configuration: basic principles > @@ -52,15 +73,15 @@ > * a mechanism to specify common options for all input files > * a mechanism to specify per-file unique options > > -In maven, all such configuration information is provided via the `pom.xml` > file. We tell > -maven to use the plugin via the `<build>/<plugins>` section: > +In Maven, all such configuration information is provided via the `pom.xml` > file. We tell > +Maven to use the plugin via the `<build> <plugins>` section: > > <build> > <plugins> > <plugin> > - <groupId>org.openjena.tools</groupId> > - <artifactId>schemagen</artifactId> > - <version>0.2-SNAPSHOT</version> > + <groupId>org.apache.jena</groupId> > + <artifactId>jena-maven-tools</artifactId> > + <version>0.7</version> > <configuration> > </configuration> > <executions> > @@ -75,6 +96,11 @@ > </plugins> > </build> > > +*Replace the `<version>` tags above with the latest versions as found by > +browsing > [jena-maven-tools](http://central.maven.org/maven2/org/apache/jena/jena-maven-tools/) > + in Maven Central.* > + > + > The configuration options all nest inside the `<configuration>` section. > > ### Specifying files to process > @@ -93,7 +119,7 @@ > > Options are, in general, given in the `<fileOptions>` section. A given > `<source>` refers to one input source - one file - as named by the > -`<input> name. The actual option names are taken from the RDF [config > +`<input>` name. The actual option names are taken from the RDF [config > file property > names](http://jena.apache.org/documentation/tools/schemagen.html), > omitting the namespace: > > @@ -115,38 +141,50 @@ > > ## Example configuration > > +*Note: Replace the `<version>` tags below with the latest versions as found > by > +browsing > [jena-maven-tools](http://central.maven.org/maven2/org/apache/jena/jena-maven-tools/) > +and [jena-core](http://central.maven.org/maven2/org/apache/jena/jena-core/) > in Maven Central.* > + > + > <build> > - <plugins> > - <plugin> > - <groupId>org.openjena.tools</groupId> > - <artifactId>schemagen</artifactId> > - <version>0.2-SNAPSHOT</version> > - <configuration> > - <includes> > - <include>src/main/vocabs/*.ttl</include> > - <include>src/main/vocabs/foaf.rdf</include> > - </includes> > - <fileOptions> > - <source> > - <input>default</input> > - <package-name>org.example.test</package-name> > - </source> > - <source> > - <!-- Test2.java (only) will contain OntModel declarations --> > - <input>src/main/vocabs/demo2.ttl</input> > - <ontology>true</ontology> > - </source> > - </fileOptions> > - </configuration> > - <executions> > - <execution> > - <id>schemagen</id> > - <goals> > - <goal>translate</goal> > - </goals> > - </execution> > - </executions> > - </plugin> > - </plugins> > - </build> > + <plugins> > + <plugin> > + <groupId>org.apache.jena</groupId> > + <artifactId>jena-maven-tools</artifactId> > + <version>0.7</version> > + <configuration> > + <includes> > + <include>src/main/vocabs/*.ttl</include> > + <include>src/main/vocabs/foaf.rdf</include> > + </includes> > + <fileOptions> > + <source> > + <input>default</input> > + <package-name>org.example.test</package-name> > + </source> > + <source> > + <!-- Test2.java (only) will contain OntModel declarations --> > + <input>src/main/vocabs/demo2.ttl</input> > + <ontology>true</ontology> > + </source> > + </fileOptions> > + </configuration> > + <executions> > + <execution> > + <id>schemagen</id> > + <goals> > + <goal>translate</goal> > + </goals> > + </execution> > + </executions> > + </plugin> > + </plugins> > + </build> > + <dependencies> > + <dependency> > + <groupId>org.apache.jena</groupId> > + <artifactId>jena-core</artifactId> > + <version>2.12.1</version> > + </dependency> > + </dependencies> > > -- Stian Soiland-Reyes Apache Taverna (incubating) http://orcid.org/0000-0001-9842-9718
