|author||Bruno P. Kinoshita <email@example.com>||Sun Feb 21 10:53:52 2021 +1300|
|committer||Bruno P. Kinoshita <firstname.lastname@example.org>||Sun Feb 21 10:53:52 2021 +1300|
This is the source code for the website of Apache Jena, hosted at:
This repository uses 3 branches for building the website.
mainbranch, which contains all the sources for the website.
asf-sitebranch, which contains the generated website being used for the actual website.
javadocbranch, which has the javadoc to be published at
When contributing patches, please create pull requests for the
The website uses Hugo as static website generator. See Hugo for more info and for details how to install Hugo.
To generate the static website, execute
hugo to generate and serve the website on
During development, it may be useful to run an incremental build. For this to work, execute
hugo server -D to continuously generate and serve the website on
The ASF Jenkins Jena_Site job is used for generating the website and committing the generated site to the
Separately, javadoc for a release is committed into the
javadoc branch during the release process.
gitpubsub is used to publish the site, using the content from the
Jenkinsfile was contributed in https://github.com/apache/jena-site/pull/17 (July 2020).
Steps to do to setup the Jenkins job:
Create a new multibranch pipeline (e.g. ‘Jena_Site’).
Branch source -> git
Set the gitbox url ->
https://gitbox.apache.org/repos/asf/jena-site.git and use the jenkins (master pub key) credentials.
In the ‘Scan Multibranch Pipeline Triggers’ check the ‘Periodically if not otherwise run’ checkbox and enter a sane value (e.g. 15 minutes). This is needed because webhooks are not delivered to ci-builds (yet - 2020-07-28).
Save the job and click the ‘Scan Multibranch Pipeline Now’ button to trigger an initial scan. A first run may also happen as the SCM polls.
It is at this point that it gets the label
git-websites so the first job may have run on the wrong node.