Post blog architecture

9 files changed, 55 insertions, 4 deletions

diff --git a/index.md.do b/index.md.do
index 933b1a8..e36b596 100644
--- a/index.md.do
+++ b/index.md.do
@@ -33,6 +33,6 @@ EOF
 for x in "${LISTS[@]}"; do
     printf "* [%s](%s)\n" "$(<$x/title)" "$x.html"
     while read -r -d $'\n'; do
-        printf "    %s" "$REPLY"
+        printf "    %s\n" "$REPLY"
     done < "$x/preview"
 done
diff --git a/lists/blog/001 b/lists/blog/001
new file mode 120000
index 0000000..0583396
--- /dev/null
+++ b/lists/blog/001
@@ -0,0 +1 @@
+../../posts/blog-architecture.md
\ No newline at end of file
diff --git a/lists/blog/title b/lists/blog/title
new file mode 100644
index 0000000..657adaa
--- /dev/null
+++ b/lists/blog/title
@@ -0,0 +1 @@
+"Blog" Documentation
diff --git a/lists/default.md.do b/lists/default.md.do
index daf7453..fffd6e2 100644
--- a/lists/default.md.do
+++ b/lists/default.md.do
@@ -28,13 +28,14 @@ for n in $(seq 0 $((${#POSTS[@]}-1))); do
     printf "* [%s](%s)\n" "${POST_TITLES[$n]}" "${POSTS[$n]%.md}.html"
 done
 
+>"$2/preview"
 prev_no=3
 if [[ ${#POSTS[@]} -gt $prev_no ]]; then
-    printf "* …\n" > "$2/preview"
+    printf "* …\n" >> "$2/preview"
 else
     prev_no=${#POSTS[@]}
 fi
 
 for n in $(seq $prev_no -1 1); do
-    printf "* [%s](%s)\n" "${POST_TITLES[-$n]}" "${POSTS[-$n]%.md}.html" >"$2/preview"
+    printf "* [%s](%s)\n" "${POST_TITLES[-$n]}" "${POSTS[-$n]%.md}.html" >>"$2/preview"
 done
diff --git a/lists/all/001 b/lists/zz_all/001
index 659bc10..659bc10 120000
--- a/lists/all/001
+++ b/lists/zz_all/001
diff --git a/lists/zz_all/002 b/lists/zz_all/002
new file mode 120000
index 0000000..0583396
--- /dev/null
+++ b/lists/zz_all/002
@@ -0,0 +1 @@
+../../posts/blog-architecture.md
\ No newline at end of file
diff --git a/lists/all/title b/lists/zz_all/title
index 73a5267..73a5267 100644
--- a/lists/all/title
+++ b/lists/zz_all/title
diff --git a/posts/blog-architecture.md b/posts/blog-architecture.md
new file mode 100644
index 0000000..be969de
--- /dev/null
+++ b/posts/blog-architecture.md
@@ -0,0 +1,47 @@
+% General Architecture of this "Blogging" System
+
+The main idea behind this system is that my site is supposed to consist of
+*posts* which are organized into *lists of posts*. This mapping is not assumed
+to be injective, i.e. a post may be a member of many lists. In fact, this is how
+the list [All Posts](/lists/zz_all.html) is made: every post is supposed to be
+linked into it.
+
+To keep order in this mess of data, I have decided to map it into the file
+system. I have a folder `posts` which contains all posts and a folder `lists`
+with all the lists. Every list is a folder with symbolic links to posts:
+
+    blog
+    ├── lists
+    │   ├── all
+    │   │   ├── 001 -> ../../posts/hello-world.md
+    │   │   └── title
+    │   ├── blog
+    │   │   └── title
+    └── posts
+        └── hello-world.md
+
+As you can see, I have added a special file to each list folder named `title`
+which contains the title of the list (as you might have guessed).
+
+Posts are written as [Markdown](http://en.wikipedia.org/wiki/Markdown) files and
+converted to HTML with [Pandoc](http://en.wikipedia.org/wiki/Pandoc). Pandoc
+handles this conversion almost perfectly, but I had one small issue with
+it. Namely, I want to be able to write mathematics and hence translate
+TeX--snippets into something that your browser can display.
+
+Pandoc has several builtin methods to do this, but most of them either rely on a
+specialised TeX--parser or JavaScript. Both were deemed too ugly to use. So I
+wrote a filter around Pandoc to extract TeX-snippets and compile them with my
+regular LaTeX distribution into SVG. This seems to work quite nicely.
+
+The next issue was keeping this mess of posts and lists and Markdown files under
+control. Traditionally, I would have used a Makefile for that but I wanted
+something a little nicer this time. I turned to an old idea of
+[Dan Bernstein's](http://cr.yp.to/djb.html):
+[Redo](http://cr.yp.to/redo.html). There are several implementations of Redo out
+there; eventually I plan to write my own, just as practice. For now, I use a
+very minimal implementation in shell script from
+<https://github.com/apenwarr/redo>.
+
+More on how exactly the conversion from Markdown to HTML and all the associated
+ecosystem works will appear in a later post.
diff --git a/style.css b/style.css
index 7158c52..ef9e2a5 100644
--- a/style.css
+++ b/style.css
@@ -2,7 +2,7 @@ body {
     margin: auto;
     padding-right: 1em;
     padding-left: 1em;
-    font: normal 1.1em/1.3em monospace;
+    font: normal 1.1em monospace;
     max-width: 60em;
     text-align: justify;
 }