From 0749847aeab2dcaab43f50956f9cf0b21c31943b Mon Sep 17 00:00:00 2001
From: pacien
Date: Wed, 30 Nov 2022 21:38:44 +0100
Subject: add example content, compile to site and pdf

---
 readme.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 readme.md

(limited to 'readme.md')

diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..1645cf6
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,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/)
-- 
cgit v1.2.3