/comdev-site

Website sources for the Apache Community Development Website

Primary LanguageHTMLApache License 2.0Apache-2.0

Apache Community Development website

This is the source code for the website of the Apache Community Development PMC website, hosted at:

https://community.apache.org/

To get in touch with that PMC please use the dev@community.apache.org mailing list.

The repository for the events.apache.org website, which is also managed by the Community Development PMC, is at https://github.com/apache/comdev-events-site

How to publish the website

Changes to the master branch of this repository trigger the comdev-site Jenkins Job, which generates the website content and commits it to the asf-site branch of this repository. There's currently (April 2020) a lag of about ten minutes for the Jenkins job to start, if you commit directly to the GitHub repository.

The ASF's gitpubsub mechanism then synchronizes that content to https://community.apache.org/, usually within a few seconds. More details about the publication process can be found in the ASF Documentation about Project sites. If for some reason this process fails, you can use the self-service page from ASF Infra to trigger a resync of the git repo.

Powered by Hugo!

The website uses Hugo as static website generator, see their 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

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 (re)generate and serve the website on localhost:1313.