|
|
||
|---|---|---|
| .github | ||
| .well-known | ||
| content | ||
| partials | ||
| sass | ||
| static | ||
| templates | ||
| .editorconfig | ||
| .gitignore | ||
| .typos.toml | ||
| build.sh | ||
| config.toml | ||
| CONTENT.md | ||
| CONTRIBUTING.md | ||
| LICENSE-Apache-2.0 | ||
| LICENSE-CC-BY-SA | ||
| LICENSE.md | ||
| navigation.toml | ||
| README.md | ||
| taxonomy.toml | ||
Matrix.org Website
If you want to contribute to the website, make sure the problem you're trying to fix or the feature you want to implement has been discussed in our issue tracker and that we are interested in reviewing and merging such a contribution.
We are self-documenting our processes in CONTRIBUTING.md and how to write content for the website in CONTENT.md.
To discuss maintenance of this site, please come talk to us, the Website & Content Working Group, in #matrix.org-website:matrix.org.
Cloning the Repository
Due to historic growth and media the repository is quite large. Therefor we
suggest the usage of --filter=blob:none when doing a fresh clone:
git clone --filter=blob:none git@github.com:matrix-org/matrix.org.git
This allows to only fetch the actually needed things from the git repository instead of all of the (at the time of writing) 1.18GiB of data. With this command at the time of writing this reduces the downloaded data to just 612MiB.
For more information on this please check out these 2 articles which also
explain why --depth=1 is not ideal and which implications this has:
- https://github.blog/open-source/git/get-up-to-speed-with-partial-clone-and-shallow-clone/
- https://web.archive.org/web/20241001150554/https://nayak.io/posts/git-clone-optimizations/
Building the website
Install the latest version of Zola, clone the repo, and from the root of the repo type
zola serve
Zola will build the website and start a web server, usually at http://127.0.0.1:1111