This project contains the sources and content for the C2 Platform website.

GitLab: c2platform/website 

Pipeline Status Latest Release

Welcome to the repository for the C2 Platform website, available at  . This site is built using Hugo  , a powerful static site generator, and styled with the with the Docsy Theme  , a documentation theme for technical documentation sites.

Development Workflow

CI/CD Pipeline

Our CI/CD pipeline facilitates automatic builds and deployments:

  1. Production Build: Commits to the master branch trigger a build and deployment to the main website at  .
  2. Development Build: Commits to the development branch generate a preview version accessible at  .

Getting Started


Ensure you have the following installed:

  • Hugo (Extended Version): Required for local development.
  • Node.js: Necessary for managing JavaScript dependencies.
  • Git: For version control.

Local Development

To set up your environment and start contributing:

  1. Install Dependencies: Make sure you have snapd and podman installed.

    sudo apt install snapd podman -y
    sudo snap install hugo
  2. Clone the Repository:

    git clone
    cd website
  3. Install Node Version Manager ( NVM ) and NodeJS:

    curl -o- 
     | bash
    nano ~/.bashrc
    source ~/.bashrc
    nvm install 18
    npm install
  4. Install JavaScript Dependencies:

    npm install
  5. Start the Hugo Server:

    hugo server

Now, you can access the site at http://localhost:1313  and see your changes in real-time.

Advanced Setup

PlantUML Server

To use or view PlantUML diagrams locally, start a PlantUML server:

podman run -d -p 8080:8080

Hugo in Podman Container

Run the website in a Docker container without installing dependencies:

sudo apt install podman -y
podman run --rm -it -v $(pwd):/src -p 1313:1313 server


After starting the Hugo server or Docker container, visit http://localhost:1313 to view the site. Live reload is enabled, so changes you make will automatically reflect in the browser.

PlantUML support

This site supports PlantUML and Mermaid diagrams through Docsy. Note that for reliability, PlantUML diagrams are pre-rendered to PNG files during the CI/CD process. For more information about PlantUML and other diagrams, visit the Docsy documentation on diagrams  .

Pre-commit Hook

rm -rf public || true
python3 scripts/htmldataproofer/
python3 scripts/htmldataproofer/
cd public
htmlproofer --allow-missing-href --ignore-empty-alt --ignore-missing-alt --no-enforce-https  2>&1 | tee ../htmlproofer.log
if grep -q "following failures were found" ../htmlproofer.log; then
    echo "Failures found. Exiting."
    exit 1


If you encounter issues, consult the Docsy Example  project for common troubleshooting tips.

Last modified February 20, 2024: project update RWS-628 (531032b)