The site is currently in static HTML hosted out of the content/
directory.
Any pre-generated/rendered content or documentation should be added to additional folders in the root of this repo.
The asf-site
branch gets published to an Apache HTTPD static hosting environment run by the Apache infrastructure team.
To update the demo, update the submodule (git submodule update --remote
), rebuild (yarn build
; in this repo, not inside the submodule), and commit the changes it made in content/
.
To add documentation add Markdown to the docs/
folder. Further templating and build configuration of the docs/
content can be done in the .eleventy.js
file (since it's built with 11ty.dev).
This website repository contains the main project repository as a git submodule, in order to build its demo without duplicating the code.
Run git submodule init && git submodule update --remote
to pull in the submodule.
Run yarn install
to install development dependencies.
Run yarn build
to build the demo code and docs content (it will overwrite content/demo
and content/docs
).
Run yarn serve
to build the demo and docs as well as serve and watch (with live reload on changes to the src/
directory only).
Note: if you receive a ERR_OSSL_EVP_UNSUPPORTED
error, you can resolve this by using the legacy SSL provider: export NODE_OPTIONS=--openssl-legacy-provider
We also use the Milestones for this repo on GitHub to track our quarterly board reports.
Web site issues and PRs are still more than welcome, though!
Apache License 2.0 (obviously...:wink:)