|author||Andrew Wetmore <firstname.lastname@example.org>||Thu Oct 14 10:44:54 2021 -0300|
|committer||GitHub <email@example.com>||Thu Oct 14 10:44:54 2021 -0300|
Update index.md added a link to mirror-history.html
We are now in production
This repository provides the source for the main website of The Apache Software Foundation.
Markdown (.md) files appear in the preview pane of the editor approximately as they will appear in the generated website. This is convenient for reviewing changes, but means that linking to the source requires a bit more work compared with other files. If you want to create a permalink or raise an issue that relates to a particular Markdown source line, proceed as follows:
Read the Getting started guide and the pages it links to.
The website is built with Pelican.
The infrastructure-pelican Dockerfile can be used to build the website locally, for testing.
The svn history was not migrated and remains available.
Also the board calendar - calendar.md is maintained in SVN by Whimsy. It is copied into content/foundation/board at the start of each build by the get_calendar.sh script which is initiated by a setup entry in pelicanconf.yaml Changes to the file do not automatically trigger a build, but the file changes rarely (about once a month) and there are regular builds which will pick up changes within an hour or so.
If you wish to update and test the site locally, there is a Docker build script you can use. You will also need Git, and familiarity with working in a command-line shell. [The following instructions should work for Unix and macOS, but will need adjustment for Windows.]
git clone https://github.com/apache/infrastructure-pelican
docker build -t pelican-asf. This will take a while the first time.
git clone https://github.com/apache/www-site
docker run -it -p8000:8000 -v $PWD:/site pelican-asf
If you make changes to the local copy of www-site, these will be automatically built, and should appear in the browser when the page is refreshed.