About

Language of this site¶

This site is written in English. Some posts are in Dutch, because they are about the Netherlands: Dutch policy, Dutch regulators, Dutch institutions and Dutch places. The reason is practical rather than principled. An English text on such a subject fills up with Dutch names, terms and document titles that have no natural English equivalent, and then it reads worse than the original would have. Everything that is not about the Netherlands stays in English.

Die uitzondering staat er bewust: berichten die primair over Nederland gaan kunnen in het Nederlands staan, alle andere berichten zijn Engelstalig.

Building a Markdown-Powered Website with MkDocs¶

As a Markdown enthusiast, I've grown accustomed to creating content using this versatile format. Recently, I set out to build a website that leverages Markdown's ease of use, allowing me to create pages with minimal fuss. My search led me to Static Site HTML generators, which sparked a chain reaction of discoveries: GitHub Pages, Jekyll, and eventually, MkDocs and MkDocs-Material. The latter's impressive capabilities had me hooked, and I wanted to take it to the next level by integrating Continuous Integration/Continuous Deployment (CI/CD) to automate the deployment process.

With this goal in mind, I embarked on a mission to create a seamless workflow, where changes to my Markdown files would trigger a build, followed by automatic deployment to a production environment. The thrill of the challenge was palpable, and I'm excited to share my journey with you.

Code Annotation Examples¶

Codeblocks¶

Some code goes here.

Plain codeblock¶

A plain codeblock:

Some code here
def myfunction()
// some comment

Code for a specific language¶

Some more code with the py at the start:

import tensorflow as tf
def whatever()

With a title¶

bubble_sort.py

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]

With line numbers¶

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]

Highlighting lines¶

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]

Icons and Emojs¶

Mermaid diagrams are also possible¶

graph LR
  A[Start] --> B{Error?};
  B -->|Yes| C[Hmm...];
  C --> D[Debug];
  D --> B;
  B ---->|No| E[Yay!];