olink-maven-plugin

Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/

License

License

Categories

Categories

Maven Build Tools
GroupId

GroupId

com.rackspace.cloud.api
ArtifactId

ArtifactId

olink-maven-plugin
Last Version

Last Version

1.2.6
Release Date

Release Date

Type

Type

maven-plugin
Description

Description

olink-maven-plugin
Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
Project URL

Project URL

https://github.com/rackerlabs/olink-maven-plugin
Source Code Management

Source Code Management

https://github.com/rackerlabs/olink-maven-plugin/tree/master

Download olink-maven-plugin

How to add to project

<plugin>
    <groupId>com.rackspace.cloud.api</groupId>
    <artifactId>olink-maven-plugin</artifactId>
    <version>1.2.6</version>
</plugin>

Dependencies

compile (6)

Group / Artifact Type Version
org.apache.maven : maven-core jar 3.0
org.apache.maven : maven-plugin-api jar 3.0
com.rackspace.xmlcalabash : xmlcalabash-saxon94 jar 1.0.16
com.rabbitmq : amqp-client jar 3.0.4
net.sf.saxon » saxon-ee jar 9.4.0.6
net.sf.saxon : Saxon-HE jar 9.4.0.6

Project Modules

There are no modules declared in this project.

olink-maven-plugin

This Maven plugin generates an olink target database file to be used when processing DocBook documents with DocBook xslts. For detailed information about the olink mechanism in the DocBook xslt stylesheets, see Olinking between documents in Bob Stayton's book, DocBook XSL: The Complete Guide.

This plugin takes as input a file named olink.xml in the same directory as your project's pom.xml file that lists the files to include in the olink data file. The olink.xml file should be in the following format. The path attribute on each book element is the relative path to the book to include in the olink database file. The target data file is generated as target/olink.db:

 <books xmlns="http://docs.rackspace.com/olink">
        <book path="src/docbkx/cf-intro.xml"/>
        <book path="src/docbkx/cf-devguide.xml"/>
        <book path="src/docbkx/cf-releasenotes.xml"/>
 </books>

In your project's pom, include the following in the section of your pom.xml (where 1.2.6 is the latest release version of the olink-maven-plugin):

  <plugin>
    <groupId>com.rackspace.cloud.api</groupId>
    <artifactId>olink-maven-plugin</artifactId>
    <version>1.2.6</version>
    <executions>
      <execution>
        <phase>initialize</phase>
        <goals>
          <goal>olink</goal>
        </goals>
      </execution>
    </executions>
  </plugin>

In addition you should include the following profile as a direct child of the element:

<profiles>
    <profile>
        <id>Rackspace Research Repositories</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <repositories>
            <repository>
                <id>rackspace-research</id>
                <name>Rackspace Research Repository</name>
                <url>http://maven.research.rackspacecloud.com/content/groups/public/</url>
            </repository>
        </repositories>
        <pluginRepositories>
            <pluginRepository>
                <id>rackspace-research</id>
                <name>Rackspace Research Repository</name>
                <url>http://maven.research.rackspacecloud.com/content/groups/public/</url>
            </pluginRepository>
        </pluginRepositories>
    </profile>
</profiles>

Limitations

This plugin currently does not support controlling the relative path to other documents in the collection, but I do plan to add support for that in the future.

License

Copyright © 2013 Rackspace Hosting under the Apache 2 license. See the LICENSE file for more information.

Note: This plugin is based on Bert Frees' xproc-maven-plugin, Copyright © 2013 Bert Frees released under theApache 2 license.

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.

com.rackspace.cloud.api

rackspace

Rackspace public git repositories

Versions

Version
1.2.6
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.0