summaryrefslogtreecommitdiff
path: root/readme.md
blob: 1645cf61ca58758f1e937fc8c6ec833dc7e027e6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# Markdown course website example / template

This is an example of course website, divided into two parts: lectures and
exercises sheets.

Everything is generated from Markdown source files into static files which can
then be served through by any web server.

For convenience, the compilation and deployment can be automated through GitLab
CI or equivalent, which allows automatic publication of the latest version
after pushing the sources to a version-controlled repository for example.


## Resources and references

- [Markdown syntax](https://daringfireball.net/projects/markdown/syntax)
- [Quarto (reference)](https://quarto.org/docs/reference/index.html)
- [Pandoc (manual)](https://pandoc.org/MANUAL.html)
- [Nix guides](https://nixos.org/learn.html)
- [GitLab CI configuration reference](https://docs.gitlab.com/ee/ci/yaml/)