apache /comdev-site

Website sources for the Apache Community Development Website

★ 299⑂ 214👁 74⑃ 244● 8▤ 0
HTMLApache-2.0Created 2018-04-21community.apache.org
+0
Daily
299
stars
214
forks
74
watchers
244
prs
8
issues
0
releases

README

Apache Community Development website

This is the source code for the ASF Community Development PMC website, hosted at
community.apache.org

To get in touch with that PMC please use the [email protected] mailing list.

The events.apache.org website is also managed by the Community Development PMC
but managed in the comdev-events-site repository.

 Automated website publishing and staging

Changes to the main or preview/ branches of this repository trigger the comdev-site Jenkins Job, which generates and pushes the website content.

There's currently (April 2020) a lag of about ten minutes for the corresponding Jenkins job to start, if you commit directly to the GitHub repository, but you can also start the job manually if you have the required Jenkins access rights.

For the main branch, the generated content is pushed to the asf-site branch, and
the ASF's gitpubsub mechanism then synchronizes that content to the live community.apache.org website, usually within a few seconds.

 Preview branches
Branches named preview/ are staged automatically, a branch named 
preview/pmc-members
for example gets staged at
https://comdev-pmc-members.staged.apache.org/
as per INFRA-26845

More details about the publication process can be found in the ASF Documentation about Project sites. If for some reason this process fails, try making a dummy commit.

 Powered by Hugo!

The website uses Hugo as static website generator, see the Hugo website for more information
and for how to install and run it if needed.

Other Apache websites that are built with Hugo should be listed by this GitHub query for the 'hugo' tag.

 How to test the website and changes on your own computer

You need a recent version of hugo, to find out which one is used to deploy this site
look at the Jenkins build output, linked above.

To generate the static website, execute hugo to generate the website under target/content and execute
npx -y pagefind --site target/content to index the content for Pagefind (the search bar on the website).

During development, it may be useful to run an incremental build. For this to work, execute
hugo server -D -d /tmp/comdev-generated-site to continuously (re)generate and serve the website on localhost:1313
(-D means include draft pages). In another terminal, execute npx -y pagefind --site /tmp/comdev-generated-site to
index the site content for Pagefind (the search bar on the website).

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON