Website sources for the Apache Celix website

Clone this repo:
  1. 0a7bff6 Merge pull request #25 from apache/PengZheng-patch-1 by PengZheng · 6 months ago master
  2. 531c7f2 Update by PengZheng · 6 months ago
  3. ecd0aa7 Merge pull request #19 from apache/feature/update_after_release by Roy Lenferink · 11 months ago
  4. b096bd2 Merge pull request #24 from apache/remove-unused-file by Roy Lenferink · 11 months ago
  5. 0413724 Merge pull request #21 from apache/improve-release-steps by Roy Lenferink · 11 months ago

Apache Celix website

This is the source code for the website of Apache Celix, hosted at:

Repository structure

This repository uses 2 branches for serving the website.

  • The master branch, which contains all the sources for the website.
  • The asf-site branch, which contains the generated website being used for the Celix website.

When contributing patches, apply them to the master branch. Jenkins will then regenerate the website and commit the changes to the asf-site branch.

Content Management System

The Celix website uses Hugo as static website generator. See Hugo for more info and for details how to install Hugo.

Generate the website

Copy documentation dir from celix repo

  • Run git submodule init and git submodule update to retrieve the Celix sources.
  • Run ./ "<version number>" to copy the markdown files from the Celix main repository to the site repository.

Doxygen documentation

  • Run ./ "<version number>" to generate the Doxygen pages for the specified Celix release.

Generate the static website

To generate the static website, execute hugo to generate and serve the website on localhost:1313.

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 localhost:1313.

Publish the website

Jenkins is used for generating the website and committing the generated site to the asf-site branch.