代码拉取完成，页面将自动刷新
This repository is used for storing (some) content for Apache James website.
It’s also used to build and publish the website.
We use Antora as a tool to manage and generate the website. We use Gradle as a tool to drive / automate the tasks for generating, aggregating and publishing the website.
Antora lets us aggregate multiple documentation sources, across multiple versions and publish them as a single website. Documentation for each Apache James component is kept and versioned alongside the code for it.
Gralde allows us to autoamte the tasks that we do when publishing a website. We write gradle tasks for building and publishing the website. We can run those tasks locally and inside our CI infrastructure: Apache Builds.
More specifically, we use Gradle to:
Download and install a specific version of NodeJS using Gradle Node Plugin
Install a local version of Antora
Use a Gradle task to call build the website with Antora
By using this specific flow, you only need git, Java and shell access to build the website.
All other dependencies are installed automatically by Gradle.
Even Gradle is downloaded and installed using the Gradle wrapper script.
# To build the website run
./gradlew clean build
# The website is located here
cd doc-sites/build/site
The documentation website is based on Antora.
We have added antora-ui-default project as a git subtree under antora-ui.
./gradlew :antora-ui:build will assemble the antora-ui/build/ui-bundle.zip archive required for the website.
All the steps are automated as Gradle tasks in that project.
All you have to do is change the css and html files and then rebuild the project.
The antora-ui project has a preview mode: /.gradlew gulpPreviewTheme
# antora-ui-default was added like this. You should be able to pull some changes from upstream
git subtree add --prefix antora-ui https://gitlab.com/antora/antora-ui-default.git master --squash
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手