Everything you need to use citeproc-java has already been prepared for you in the following binary package:

Download citeproc-java 1.0.1 (binaries) JavaDoc Source code

citeproc-java requires Java 8 or higher.

Installing with Homebrew

On macOS you can install citeproc-java with the Homebrew package manager.

brew tap michel-kraemer/citeproc-java
brew install citeproc-java

Installing the library for development

You can download the citeproc-java library from Maven central to include it into your own application.

http://central.maven.org/maven2/de/undercouch/citeproc-java/1.0.1/

The library has dependencies to JBibTeX, ANTLR, and Apache Commons Lang.

I highly recommend using a build tool such as Maven or Gradle to manage your application dependencies. You can add the following snippet to your build file:

<dependencies>
  <dependency>
    <groupId>de.undercouch</groupId>
    <artifactId>citeproc-java</artifactId>
    <version>1.0.1</version>
  </dependency>
</dependencies>
repositories {
    mavenCentral()
}

dependencies {
    compile 'de.undercouch:citeproc-java:1.0.1'
}

Installing CSL Styles and locales

In order to use citeproc-java you need three things: the library itself, the Citation Style Language Styles, and the locales. The binary bundle includes all what you need. However, if you don’t use the binary package (e.g. because you’re installing citeproc-java via Maven) you will need to download the CSL styles and locales.

Please note that without these files the citeproc-java library alone will be rather useless.

You can download the styles and locales from the following GitHub repositories:

https://github.com/citation-style-language/styles

https://github.com/citation-style-language/locales

For convenience we provide them as Maven artifacts through the Sonatype OSS repository. The snapshots are updated daily, so you’ll always get the latest styles and locales.

Add the following snippet to your build file:

<repositories>
  <repository>
    <id>oss-snapshots-repo</id>
    <name>Sonatype OSS Maven Repository</name>
    <url>https://oss.sonatype.org/content/groups/public</url>
    <snapshots>
      <enabled>true</enabled>
      <updatePolicy>always</updatePolicy>
    </snapshots>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>org.citationstyles</groupId>
    <artifactId>styles</artifactId>
    <version>1.0.1-SNAPSHOT</version>
  </dependency>
  <dependency>
    <groupId>org.citationstyles</groupId>
    <artifactId>locales</artifactId>
    <version>1.0.1-SNAPSHOT</version>
  </dependency>
</dependencies>
repositories {
    maven {
        url 'https://oss.sonatype.org/content/groups/public'
    }
}

dependencies {
    compile 'org.citationstyles:styles:1.0.1-SNAPSHOT'
    compile 'org.citationstyles:locales:1.0.1-SNAPSHOT'
}

I highly recommend using the snapshots of the styles and locales as these are compiled against CSL 1.0.1 and updated daily. However, if you need a stable version you may refer to the old CSL 1.0 styles and locales. They are available at Maven central.

<dependencies>
  <dependency>
    <groupId>org.citationstyles</groupId>
    <artifactId>styles</artifactId>
    <version>1.0</version>
  </dependency>
  <dependency>
    <groupId>org.citationstyles</groupId>
    <artifactId>locales</artifactId>
    <version>1.0</version>
  </dependency>
</dependencies>
repositories {
    mavenCentral()
}

dependencies {
    compile 'org.citationstyles:styles:1.0'
    compile 'org.citationstyles:locales:1.0'
}