Setting up generation of documentation files

Author: DevWurm

doc/.gitignore

@@ -0,0 +1 @@
+dist/**

doc/01_index.md

@@ -0,0 +1,3 @@
+# Building an API server with expressjs
+This document provides an introduction on how to build an (RESTful) API server with Node.js and expressjs.
+

doc/Makefile

@@ -0,0 +1,30 @@
+.PHONY: all
+all: clean simple
+
+pretty: merge
+	grip dist/doc.md --export dist/doc.html
+	rm dist/*.md
+
+simple: merge
+	pandoc dist/doc.md -s -o dist/doc.html
+
+merge: dist toc
+	pandoc dist/*.md -o dist/doc.md
+	rm dist/0*.md
+dist:
+	mkdir dist
+	cp 0*.md dist
+
+toc: headings references
+	paste -d '' dist/headings.md dist/references.md >> dist/01_index.md
+	rm dist/headings.md
+	rm dist/references.md
+
+headings:
+	cat 0*.md | grep -v "#\!"  | grep -e "\s#\|^#" | sed -E "s/#/  /g" | sed -e 's/  //' |perl -pe 's|(\w[\w ]+)|\* [\1\]|' > dist/headings.md
+
+references: 
+	cat 0*.md | grep -v "#\!"  | grep -e "\s#\|^#" | sed s/#//g | awk '{$$1=$$1};1' | tr '[:upper:]' '[:lower:]' | sed -e "s/\s/-/g" | sed -e "s/\(.*\)/\(#\1\)/" > dist/references.md
+
+clean:
+	rm -rf dist

doc/README.md

@@ -0,0 +1,17 @@
+# Documentation
+This folder contains documentation on how to build an API server with expressjs.
+
+## Building
+You can build the documentation from the source Markdown files with `make`.
+
+`make` builds a simple HTML version of the documentation.
+`make pretty` builds a nicer HTML version of the documentation.
+
+### Dependencies
+* [pandoc](https://github.com/jgm/pandoc)
+* coreutils (cat, rm, cp, paste, ...)
+* grep
+* awk
+* perl
+* sed
+* [grip](https://github.com/joeyespo/grip) (for pretty output only)