Hugo Themes Logo Hugo Themes
Comdev Site screenshot

Comdev Site

Author Avatar Theme by Apache
Updated: 23 May 2025
201 Stars

Website sources for the Apache Community Development Website

Github Live Preview

Overview

The Apache Community Development website is the source code for the ASF Community Development PMC website, hosted at community.apache.org. It is used to provide information and resources related to the Apache community. The website is powered by Hugo, a static website generator.

Features

  • ASF Documentation: Provides details about the publication process and project sites.
  • Jenkins Integration: Changes to the repository trigger a Jenkins job that generates and pushes the website content.
  • Staging Branches: Automatic staging of branches for previewing changes.
  • Git Synchronization: The generated content is pushed to the asf-site branch and synchronized to the live website using gitpubsub mechanism.

Installation

To install and run the Apache Community Development website, follow these steps:

  1. Ensure you have a recent version of Hugo installed. Refer to the Hugo website for installation instructions.
  2. Clone the repository to your local machine.
  3. Open a terminal and navigate to the root directory of the cloned repository.
  4. To generate the static website, execute the command hugo to generate the website in the target/content directory.
  5. To index the content for Pagefind (the search bar on the website), execute the command npx -y pagefind --source target/content.
  6. During development, you can run an incremental build by executing the command hugo server -D -d /tmp/comdev-generated-site to continuously (re)generate and serve the website on localhost:1313. Use the -D flag to include draft pages.
  7. In another terminal, execute the command npx -y pagefind --source /tmp/comdev-generated-site to index the site content for Pagefind.

Summary

The Apache Community Development website is a resourceful platform that provides information and resources for the Apache community. It is powered by Hugo, and the website content is generated and published using Jenkins. The website offers features such as automatic staging, git synchronization, and integration with Pagefind for search functionality. To install and run the website locally, users need to have Hugo installed and follow the provided instructions.