css4j - dom4j module

Subclasses several dom4j classes and provides CSS functionality to it.

License is BSD 3-clause.

Java™ Runtime Environment requirements

All the classes in the binary package have been compiled with a Java compiler set to 1.8 compiler compliance level, except the module-info.java file.

Building the library requires JDK 11 or higher.

Build from source

To build css4j-dom4j from the code that is currently at the Git repository, Java 11 or later is needed, although the resulting jar files can be run with a 1.8 JRE.

You can run a variety of Gradle tasks with the Gradle wrapper (on Windows shells you can omit the ./):

./gradlew build (normal build)
./gradlew build publishToMavenLocal (to install in local Maven repository)
./gradlew copyJars (to copy jar files into a top-level jar directory)
./gradlew lineEndingConversion (to convert line endings of top-level text files to CRLF)
./gradlew publish (to deploy to a Maven repository, as described in the publishing.repositories.maven block of build.gradle)

Usage from a Gradle project

If your Gradle project depends on css4j-dom4j, you can use this project's own Maven repository in a repositories section of your build file:

repositories {
    maven {
        url "https://css4j.github.io/maven/"
        mavenContent {
            releasesOnly()
        }
        content {
            includeGroupByRegex 'io\\.sf\\..*'

            // Alternative to the regex:
            //includeGroup 'io.sf.carte'
            //includeGroup 'io.sf.jclf'
            //includeGroup 'io.sf.w3'

            includeGroup 'xmlpull'
            includeGroup 'xpp3'
        }
    }
}

please use this repository only for the artifact groups listed in the includeGroup statements.

Then, in your build.gradle file:

dependencies {
    api "io.sf.carte:css4j-dom4j:${css4jDom4jVersion}"
}

where css4jDom4jVersion would be defined in a gradle.properties file.

Software dependencies

In case that you do not use a Gradle or Maven build (which would manage the dependencies according to the relevant .module or .pom files), the required and optional library packages are the following:

Compile-time dependencies

The css4j library (and its transitive dependencies); version 4.0 or higher is recommended (compatibility with 5.0 or higher is not guaranteed).
The css4j-agent library; version 4.0 or higher is recommended (compatibility with 5.0 or higher is not guaranteed). It is optional at runtime.
The dom4j JAR package (tested with 2.1.4). Requires at least version 2.1.4 to compile and run the tests, but you should be able to run the resulting jar file with dom4j 1.6 if you are stuck with it.
The XPP3 Pull Parser (which can be used with this library but beware that it does not support character entities). It is optional at runtime.

Test dependencies

A recent version of JUnit 5.
Jaxen, this software was tested with version 1.2.0.
SLF4J, which is a logging package.

Website

For more information please visit https://css4j.github.io/

css4j / css4j-dom4j

readme