It’s about time that I redo the way I put together my website of project logs. At last: gone are the days of static html pages and ugly file structures. With a big thanks to Matt Keeter, this new workflow should make project documentation much faster.
The core idea is that the underlying content should be easy to type up, and the page typesetting should be handled automatically (a la: a LaTeX mindset). From now on, page layout is defined once in two html files called header.hmtl and footer.html, and page content is documented in a markdown (*.md) file. From there, a modified version of Matt’s Makefile converts the content file in markdown to html and then concatenates header.html, the converted content file, and the footer.html together into one html file. Woohoo! (Markdown conversion is handled with multimarkdown.)
From this point on, tweaking header.html and footer.html is all it takes to adjust the site layout. Overall, this workflow makes content much faster to push up to the site.
Thanks Matt!