website

commit de1093ed541ae5743d2af83b350b881ca920ca50
parent cf8507e7c28dd32efe01ee02f637fa0bdc7eb092
Author: Sven Möller <sven-moeller@outlook.de>
Date:   Fri, 10 Dec 2021 16:24:23 +0100

Add article

Diffstat:
M
index.md
 | 
3
+--
A
static-website.md
 | 
26
++++++++++++++++++++++++++

2 files changed, 27 insertions(+), 2 deletions(-)
diff --git a/index.md b/index.md
@@ -2,5 +2,4 @@
 
 To my personal website!
 
-Expect content soon!
-- or maybe not :^)
+[Learn my workflow for building this website.](static-website.html)
diff --git a/static-website.md b/static-website.md
@@ -0,0 +1,26 @@
+# Building a static website
+
+## Source files
+
+Here I describe how I (automatically) build my website.
+
+The pages are written in `markdown` format.
+
+I have to `html` documents, `_header.html` and `_footer.html`.
+They get added at the beginning and the end of the page (respectively).
+So I can change something in the header or the footer and it will change on all pages.
+
+The style is defined in a stylesheet called `style.css`.
+
+
+## Build process
+
+I use a `Makefile` for building the website.
+The destination folder for building defaults to `./dst` but can be changed with the environment variable `DST_DIR`.
+
+The default target (`make all`) creates the destination folder
+and copies the stylesheet and all the `markdown` files (converted to `html`,
+with header and footer added) to the folder.
+I convert them to `html` using `pandoc`, but every other converter would do.
+
+`make clean` will remove the destination folder and all its contents.