add example content, compile to site and pdf

8 files changed, 199 insertions, 13 deletions

diff --git a/.gitignore b/.gitignore
index 368c110..db28229 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,6 @@
 # Nix
-result/
-result-*/
+result
+result-*
 
 # Quarto compiled output.
 # Rebuilding from scratch is cheap enough, so no need to track this in git.
diff --git a/_quarto.yml b/_quarto.yml
new file mode 100644
index 0000000..889818f
--- /dev/null
+++ b/_quarto.yml
@@ -0,0 +1,25 @@
+book:
+  title: "MD-SITE-101"
+  chapters:
+    - index.md
+    - part: "Lectures"
+      chapters:
+        - ./lectures/01-first-lecture.md
+    - part: "Exercises"
+      chapters:
+        - ./exercises/01-first-exercise-sheet.md
+
+project:
+  type: book
+  preview:
+    port: 4200
+    browser: false
+
+format:
+  html:
+    theme: cosmo
+    number-sections: false
+    shift-heading-level-by: 1
+
+filters:
+  - ./filters/strip-solutions.lua
diff --git a/exercises/01-first-exercise-sheet.md b/exercises/01-first-exercise-sheet.md
new file mode 100644
index 0000000..a83a83e
--- /dev/null
+++ b/exercises/01-first-exercise-sheet.md
@@ -0,0 +1,24 @@
+---
+title: "First exercises sheet"
+documentclass: scrartcl
+---
+
+# Intro
+
+This exercise sheet is compiled into:
+
+* This HTML page on the course's website, for people having a tablet.
+* A PDF for printing.
+
+Versions with solutions are also generated but kept private for the teaching
+assistants.
+
+
+# Exercise 1
+
+1. Prove either $P = NP$ or $P \neq NP$.
+
+::: solution
+$P = 0$ or $N = 1$.
+Quite Easily Done. Or maybe not.
+:::
diff --git a/filters/strip-solutions.lua b/filters/strip-solutions.lua
new file mode 100644
index 0000000..2bba42f
--- /dev/null
+++ b/filters/strip-solutions.lua
@@ -0,0 +1,24 @@
+-- Pandoc filter which strips "solution" blocks when the environment variable
+-- "STRIP_SOLUTIONS" is set, or wrap them in a block quote otherwise.
+-- Useful to generate public and private handouts from the same source.
+--
+-- Author: Pacien TRAN-GIRARD
+-- Licence: EUPL-1.2
+
+strip_solutions = os.getenv('STRIP_SOLUTIONS')
+
+return {
+  {
+    Div = function(elem)
+      if elem.classes[1] == 'solution' then
+        if strip_solutions then
+          return pandoc.Null()
+        else
+          return pandoc.BlockQuote(elem.content)
+        end
+      else
+        return elem
+      end
+    end,
+  }
+}
diff --git a/flake.nix b/flake.nix
index e465964..aa5c073 100644
--- a/flake.nix
+++ b/flake.nix
@@ -1,3 +1,5 @@
+# Build environment and recipe for the Markdown course website example.
+#
 # Author: Pacien TRAN-GIRARD
 # Licence: EUPL-1.2
 
@@ -14,19 +16,65 @@
   flake-utils.lib.eachDefaultSystem (system:
   with nixpkgs.legacyPackages.${system};
   let
+    texliveDist = texlive.combined.scheme-full;
+    solutionsSecret = "topsecret";
 
-    tools = [
-      pandoc
-      quarto
-    ];
+    compileQuarto = options: stdenv.mkDerivation {
+      name = "quarto-book";
+      src = ./.;
+      nativeBuildInputs = [ quarto ];
+      buildPhase = ''
+        export HOME=/build
+        ${options} quarto render
+      '';
+      installPhase = ''
+        mkdir -p "$out"
+        cp -r _book/* "$out/"
+      '';
+    };
 
-  in lib.fold lib.recursiveUpdate { } [
+    compilePandoc = src: to: options: stdenv.mkDerivation {
+      name = "pandoc-output";
+      inherit src;
+      nativeBuildInputs = [ pandoc texliveDist ];
+      installPhase = ''
+        mkdir -p "$out"
+        for f in *.md; do
+          ${options} pandoc $f \
+            --lua-filter ${./filters/strip-solutions.lua} \
+            --output "$out"/$(basename $f .md).pdf \
+            --to ${to}
+        done
+      '';
+    };
 
-    {
-      devShell = flaky-utils.lib.mkDevShell {
-        inherit pkgs tools;
-      };
-    }
+  in {
 
-  ]);
+    devShell = flaky-utils.lib.mkDevShell {
+      inherit pkgs;
+      tools = [ quarto pandoc texlive ];
+    };
+
+    packages = rec {
+      website-public = compileQuarto "STRIP_SOLUTIONS=1";
+      website-private = compileQuarto "";
+      website = runCommand "website-combined" { } ''
+        mkdir -p "$out"
+        cp -r "${website-public}"/* "$out/"
+        mkdir -p "$out/${solutionsSecret}"
+        cp -r "${website-private}"/* "$out/${solutionsSecret}"
+      '';
+
+      pdf-slides = compilePandoc ./lectures "beamer" "";
+      pdf-exercises = compilePandoc ./exercises "pdf" "STRIP_SOLUTIONS=1";
+      pdf-solutions = compilePandoc ./exercises "pdf" "";
+      pdf = runCommand "pdf-combined" { } ''
+        mkdir -p "$out"
+        ln -s ${pdf-slides} "$out/slides"
+        ln -s ${pdf-exercises} "$out/exercises"
+        ln -s ${pdf-solutions} "$out/solutions"
+      '';
+    };
+
+  });
 }
diff --git a/index.md b/index.md
new file mode 100644
index 0000000..9bff6df
--- /dev/null
+++ b/index.md
@@ -0,0 +1,13 @@
+---
+title: "About"
+---
+
+# About this site
+
+This is an example of course website, divided into two parts: lectures and
+exercises sheets.
+
+
+# Course plan
+
+* First lecture on the first day.
diff --git a/lectures/01-first-lecture.md b/lectures/01-first-lecture.md
new file mode 100644
index 0000000..59d6aa2
--- /dev/null
+++ b/lectures/01-first-lecture.md
@@ -0,0 +1,32 @@
+---
+title: "First lecture"
+theme: metropolis
+---
+
+# First chapter
+
+## Intro
+
+This document is compiled into:
+
+* Beamer slides (PDF) for the actual lecture, and
+* An HTML page on the course's website for easy access during exercise
+  sessions.
+
+
+# Second chapter
+
+## Math
+
+LaTeX math expressions can be used here:
+
+$$ f(x)=\sum_{n=0}^\infty\frac{f^{(n)}(a)}{n!}(x-a)^n $$
+
+## Code listing
+
+An example of code listing with syntax highlighting:
+
+```python
+def hello():
+    print('hello world')
+```
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