Apache Unomi Website source repository

This project contains the Apache Unomi Website. The website is generated using Jekyll framework with Liquid templates.

Configuration

Jekyll Config

Can be found in _config YAML file

source: src/main/webapp
destination: target/site

Data config

Can be found in _data folder This contains some variables used to replace placeholders in the site.

Build

You need a machine with Jekyll or Docker to build the website.

Checkout the current project:

git clone https://github.com/apache/unomi-site

Build with Jekyll

jekyll build

Build with Docker

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

Publish

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

Local build with local server

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.