https://github.com/jetty/jetty.website
Antora-based jetty.org website.
https://github.com/jetty/jetty.website
Last synced: 3 months ago
JSON representation
Antora-based jetty.org website.
- Host: GitHub
- URL: https://github.com/jetty/jetty.website
- Owner: jetty
- License: epl-2.0
- Created: 2023-11-17T10:41:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-13T13:46:19.000Z (3 months ago)
- Last Synced: 2026-04-13T15:29:57.065Z (3 months ago)
- Language: JavaScript
- Homepage: https://jetty.org/
- Size: 3.02 MB
- Stars: 1
- Watchers: 7
- Forks: 12
- Open Issues: 8
-
Metadata Files:
- Readme: README.adoc
- License: LICENSE
Awesome Lists containing this project
README
= Eclipse Jetty Website Playbook
This repository is for the development of the new jetty.org website.
The staged site is available at the following URL:
* https://jetty.github.io/jetty.website/
== Prerequisites
The site is built using Antora.
This directory contains a Maven project that uses the Antora Maven plugin.
This plugin allows you to run Antora through Maven.
The only prerequisite is that you have Maven installed on your machine.
You do not need to have Node.js or npm installed.
You also don't need to run `npm install`.
The Antora Maven plugin handles all this.
== Usage
To build the site quickly, use:
$ mvn antora
Antora will print the location of the generated site in the Maven log.
To ensure everyone is using the same environment, you may want to use the Maven wrapper, `mvnw` to invoke Maven instead:
$ ./mvnw antora
On the first run, this command will set up Node.js (in [.path]_target/node_) and install the project dependencies (npm packages) (into [.path]_node_modules_).
[NOTE]
====
The previous command is roughly equivalent to the following low-level `npx` command:
$ npx antora --clean --fetch antora-playbook.yml
In order to use `npx` directly, you must have Node.js preinstalled.
====
You can pass options directly to Antora by defining user properties that start with `antora.option.`.
For example, you can enable the jetty-downloads extension as follows:
$ mvn antora -Dantora.option.extension[1]=jetty-download
Antora is configured to fetch the remote repositories on each run.
If you want to work offline after the first run, you can unset the `fetch` option:
$ mvn antora -Dantora.option.fetch?=false
You can accomplish the same thing by enabling the `cached` execution profile, which overrides options passed to Antora.
$ mvn antora:antora@cached
To activate the diagram generator (Kroki), enable the `kroki` execution profile.
$ mvn antora:antora@kroki
If you want to run the full production build, enable the `full` execution profile.
$ mvn antora:antora@full
The full production build is equivalent to the following `npm` and `npx` command:
$ npm i --package-lock false
ANTORA_CACHE_DIR=$PWD/.cache/antora npx --offline antora --clean --fetch --extension @antora/collector-extension --extension @antora/lunr-extension --extension jetty-downloads --extension register-asciidoctor-kroki --extension ./lib/router-extension.js --log-failure-level warn --stacktrace antora-playbook.yml
The Maven plugin also prints the `npx` command before running it for informational purposes and to help you debug the configuration.
//To learn more about how to use the Antora Maven plugin, refer to the docs.