Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ksclarke/jiiify-presentation
A Java IIIF Presentation library
https://github.com/ksclarke/jiiify-presentation
code4lib iiif iiif-presentation java
Last synced: about 2 months ago
JSON representation
A Java IIIF Presentation library
- Host: GitHub
- URL: https://github.com/ksclarke/jiiify-presentation
- Owner: ksclarke
- License: bsd-3-clause
- Created: 2017-08-17T01:32:30.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-30T04:55:39.000Z (2 months ago)
- Last Synced: 2024-10-30T07:17:21.817Z (2 months ago)
- Topics: code4lib, iiif, iiif-presentation, java
- Homepage:
- Size: 4.2 MB
- Stars: 12
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-iiif - jiiify-presentation - A Java IIIF Presentation library. (Presentation API Libraries / Image viewers (Image API only))
README
# jiiify-presentation
Jiiify Presentation is a [IIIF Presentation](http://iiif.io/api/presentation) library for Java. It does not contain a server. It just provides an object model to assist in the creation and manipulation of presentation manifests and collections.
There are two versions of the project: one for version 2 of the IIIF Presentation specification and one for version 3. Each is kept on its own branch (named for the version of the specification it supports: "v2" or "v3"). For information about a particular version, consult the README on branch [v2](https://github.com/ksclarke/jiiify-presentation/tree/v2) or [v3](https://github.com/ksclarke/jiiify-presentation/tree/v3).
### Getting Started
To start working with the library, you can either include it as a dependency in your project's POM or clone the project's GitHub repository and select the branch (i.e. version) that you're interested in using.
To include the pre-compiled jiiify-presentation Jar as a dependency in your project, use one of the following elements in your POM file's `dependencies` section:
```
info.freelibrary
jiiify-presentation-v2
0.5.10
```
or
```
info.freelibrary
jiiify-presentation-v3
0.12.4
```
If you're looking for a v3 uber-jar that you can use with a Ruby or Python script, you can [download that](https://repo1.maven.org/maven2/info/freelibrary/jiiify-presentation-v3/0.12.2/jiiify-presentation-v3-0.12.3-uber.jar) directly from the Central Maven repository.
_Note: You might want to replace the version number above with the most recent from [Maven Central](https://search.maven.org/search?q=%22jiiify-presentation%22). I'll try to keep this README up to date, but it never hurts to go to the source._
### Compiling from Source
To build a particular version from this project's GitHub repository, consult the README on the [v2](https://github.com/ksclarke/jiiify-presentation/tree/v2) or [v3](https://github.com/ksclarke/jiiify-presentation/tree/v3) branch. Each has branch-specific instructions on building and using jiiify-presentation.
### Contact
If you encounter a problem or would like to make a suggestion, feel free to open a ticket in the project's [issues queue](https://github.com/ksclarke/jiiify-presentation/issues "GitHub Issue Queue"). Please specify which branch or version you're using.