| commit | 102970d579b4fc30fd562a15483ff702e3aec590 | [log] [tgz] |
|---|---|---|
| author | David Griffon <dgriffon@jahia.com> | Thu Aug 17 13:27:44 2023 +0200 |
| committer | GitHub <noreply@github.com> | Thu Aug 17 13:27:44 2023 +0200 |
| tree | f0f71412a021c08e9f493c08dcf546473a98db25 | |
| parent | 161e0a4e10857f1b67d183ed25becaf2a2e9f6b8 [diff] |
UNOMI-795 : remove maven plugin to generate Jekyll site. (#30) * UNOMI-795 : remove maven plugin to generate Jekyll site. Use native (or docker) Jekyll instead.
This project contains the Apache Unomi Website. The website is generated using Jekyll framework with Liquid templates.
Can be found in _config YAML file
source: src/main/webapp destination: target/site
Can be found in _data folder This contains some variables used to replace placeholders in the site.
You need a machine with Jekyll or Docker to build the website.
Checkout the current project:
git clone https://github.com/apache/unomi-site
jekyll build
See Jekyll Docker's images documentation. The Docker image provides all Ruby and Jekyll resources to avoid to install them locally. Note that the version used of Jekyll is set to 4.2.0 as the newer images have an issue with a missing dependency.
docker run --rm \ --volume="$PWD:/srv/jekyll:Z" \ -p 4000:4000 \ jekyll/jekyll:4.2.0 \ jekyll build
The generated site will be in the folder target/site
To publish the local website to the production location (https://unomi.apache.org/), you have to use: Do not use the clean maven goal to not remove the previous generated site.
mvn install scm-publish:publish-scm -Dusername=YOUR_APACHE_USERNAME -Dpassword=YOUR_APACHE_PASSWORD
Run the following command
docker run --rm \ --volume="$PWD:/srv/jekyll:Z" \ -p 4000:4000 \ jekyll/jekyll:4.2.0 \ jekyll serve
Then access to http://localhost:4000/ to access the site. Note that source changes are detected and apply automatically.