Update docs tools slides and demos (#211)

* Update docs tools slides and demos

* Fix md formatting

Author: uekerman

04_documentation/examples/pandoc/example.md

@@ -1,7 +1,7 @@
 ---
 title: My awesome title
 author: Firstname lastname
-date: 2023-01-13
+date: 2025-01-08
 ---
 
 # Introduction

04_documentation/examples/reStructuredText-example.rst

@@ -41,7 +41,7 @@ Code uses backticks. This can be code/variable names in text that ``appear`` in
    }
 
 ..
-    Quotations can be by indenting them more than surronding. We use an empty comment ``..`` in order to separate the code block from this quote.
+    Quotations work by indenting them more than the surrounding. We use an empty comment ``..`` in order to separate the code block from this quote.
 
 We can also have hyperlinks to other websites. We could link to the `course website`_, but separate the link and target definition.
 

04_documentation/markup_languages_slides.md

@@ -199,7 +199,6 @@ From [YAML website](https://yaml.org/)
 - Popular for configurations
 - Indentation with **two** spaces is important.
     - Tabs **not** allowed for indentation
-- Can differentiate between datatypes
 - Recommended file extension `yaml` (also `yml`)
 
 ---

04_documentation/pandoc_demo.md

@@ -28,6 +28,7 @@
 - Color link: `pandoc example.md -V colorlinks -o example.pdf`
     - Binary option, no value
     - Find `colorlinks` in `template.tex`
+    - [All variables for LaTeX](https://pandoc.org/MANUAL.html#variables-for-latex)
 
 ## Custom Templates
 

04_documentation/website_generators_demo.md

@@ -54,7 +54,7 @@ Example code is in [`04_documentation/examples/sphinx`](https://github.com/Simul
     +.. include:: ../README.rst
     ```
 
-- Look at `conf.py` and change style to `classic`
+- Look at `conf.py` and change theme to `classic`
 
 ## Code Documentation
 

04_documentation/website_generators_slides.md

@@ -61,7 +61,7 @@ slideOptions:
 ## Brief Overview of Tools
 
 - General documentation site generators
-    - [MkDocs](https://www.mkdocs.org) (md), [Sphinx](https://www.sphinx-doc.org/en/master/) (rst), [jekyll](https://jekyllrb.com/), ...
+    - [MkDocs](https://www.mkdocs.org) (md), [Sphinx](https://www.sphinx-doc.org/en/master/) (rst), [jekyll](https://jekyllrb.com/), [Hugo](https://gohugo.io/), ...
 - Code documentation site generators
     - [Doxygen](https://www.doxygen.nl) (C++, C...), Sphinx with [autodoc extension](https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html) (Python), ...
 - Publishing tools
@@ -74,6 +74,14 @@ slideOptions:
 
 ---
 
+## HIWI Wanted
+
+- Migrate preCICE website generator from jekyll to Hugo
+    - Pitfalls with current setup: [issue 471](https://github.com/precice/precice.github.io/issues/471)
+    - Migration: [issue 472](https://github.com/precice/precice.github.io/issues/472)
+
+---
+
 ## Step by Step Plan
 
 1. Document Python code: docstrings
@@ -204,8 +212,8 @@ From [project homepage](https://readthedocs.org/)
 
 ## More Optional Homework: MkDocs + GitHub Pages
 
-- Last year, we had a homework to document our *"yaml-cpp-dealii-boost code"* using MkDocs and publish on GitHub pages.
-- If you want to get a glimpse on these tools, follow the [exercise sheet](https://github.com/Simulation-Software-Engineering/Lecture-Material/blob/ab8476624c39c20198afbc5f9773775fad62785e/04_documentation/tools_exercise.md) from last year.
+- Previously, we had a homework to document our *"yaml-cpp-dealii-boost code"* using MkDocs and publish on GitHub pages.
+- If you want to get a glimpse on these tools, follow the [abandoned exercise sheet](https://github.com/Simulation-Software-Engineering/Lecture-Material/blob/ab8476624c39c20198afbc5f9773775fad62785e/04_documentation/tools_exercise.md).
 
 ---