mirror of https://github.com/ilri/cgspace-java-helpers.git synced 2024-11-17 04:17:06 +01:00

Curation tasks and helper scripts for the CGSpace institutional repository.

Go to file

Alan Orth 0c35e81362 pom.xml: compile for Java 11 New as of JDK 9: > The --release option ensures that the code is compiled following the rules of the programming language of the specified release, and that generated classes target the release as well as the public API of that release. This means that, unlike the -source and -target options, the compiler will detect and generate an error when using APIs that don't exist in previous releases of Java SE. Also, as of DSpace 7 we the minimum JDK is 11 anyway. See: https://maven.apache.org/plugins/maven-compiler-plugin/examples/set-compiler-release.html		2024-04-23 08:05:59 +03:00
.github/workflows	.github/workflows/maven.yml: update setup actions	2023-12-28 10:37:55 +03:00
.idea	.idea/misc.xml: use Java 17	2023-12-28 10:49:42 +03:00
src/main	Fix license headers	2024-04-22 16:59:12 +03:00
.gitignore	.gitignore: update ignores	2022-10-05 15:25:53 +03:00
CHANGELOG.md	Bump version to 7.6.1	2024-01-02 20:34:14 +03:00
COPYING	Initial commit	2020-07-31 21:40:15 +03:00
pom.xml	pom.xml: compile for Java 11	2024-04-23 08:05:59 +03:00
README.md	Bump version to 7.6.1	2024-01-02 20:34:14 +03:00

README.md

CGSpace Java Helpers

DSpace curation tasks and other Java-based helpers used on the CGSpace institutional repository:

CountryCodeTagger: add ISO 3166-1 Alpha2 country codes to items based on their existing country metadata
FixJpgJpgThumbnails: fix low-quality ".jpg.jpg" thumbnails by replacing them with their originals
FixLowQualityThumbnails: remove low-quality thumbnails when PDF bitstreams are present

Tested on DSpace 7.6. Read more about the DSpace curation system.

Build and Install

Integrate into DSpace Build

To use these curation tasks in a DSpace project add the following dependency to dspace/modules/additions/pom.xml:

<dependency>
  <groupId>io.github.ilri.cgspace</groupId>
  <artifactId>cgspace-java-helpers</artifactId>
  <version>7.6.1-SNAPSHOT</version>
</dependency>

The jar will be copied to all DSpace applications.

Manual Build and Install

To build the standalone jar:

$ mvn package

Copy the resulting jar to the DSpace lib directory:

$ cp target/cgspace-java-helpers-7.6.1-SNAPSHOT.jar ~/dspace/lib/

Configuration

Please refer to the appropriate README.md file:

Curation Tasks: src/main/java/io/github/ilri/cgspace/ctasks/README.md
Scripts: src/main/java/io/github/ilri/cgspace/scripts/README.md

TODO

Add a curation task to normalize DOIs to "https://doi.org" format
Migrate from maven-deploy-plugin to nexus-staging-maven-plugin, see: https://central.sonatype.org/publish/publish-maven/#nexus-staging-maven-plugin-for-deployment-and-release
Stop using oss-parent, see: https://central.sonatype.org/publish/publish-maven/#create-a-ticket-with-sonatype

Notes

This project was initially created according to the Maven Getting Started Guide:

$ mvn -B archetype:generate -DgroupId=io.github.ilri.cgspace -DartifactId=cgspace-java-helpers -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4

To deploy a new -SNAPSHOT release to Maven Central (make sure OSSHRH credentials are in ~/.m2/settings.xml):

$ mvn clean deploy

See: Performing a Snapshot Deployment

License

This work is licensed under the GPLv3.

This repository contains data from the Debian iso-codes project project, which is licensed under the GNU Lesser General Public License v2.1.