Landing page for linuxfabrik.github.io, the GitHub Pages root of the Linuxfabrik organization. Points visitors at the documentation site of every public Linuxfabrik project. • made by Linuxfabrik
GitHub serves https://linuxfabrik.github.io/ from a repository named after the organization. Without that repository the root path returns 404, while the project sites below it work. This repository fills the root with a landing page that lists every public Linuxfabrik project and links to its documentation.
The site is built with MkDocs and the Material theme, matching the look of all other Linuxfabrik documentation sites. Every push to main rebuilds and redeploys it via GitHub Actions.
One page, docs/index.md. Project documentation stays in the project repositories and is only linked from here. See CONTRIBUTING.md for what belongs on the page and how to add a project.
python3 -m venv .venv
source .venv/bin/activate
pip install --require-hashes --requirement .github/docs/requirements.txt
ln --symbolic --force ../CHANGELOG.md docs/CHANGELOG.md
ln --symbolic --force ../CODE_OF_CONDUCT.md docs/CODE_OF_CONDUCT.md
ln --symbolic --force ../CONTRIBUTING.md docs/contributing.md
ln --symbolic --force ../SECURITY.md docs/security.md
mkdocs serveThe symlinks mirror what the deployment workflow does; they are ignored by git.
Released into the public domain under the Unlicense.