Name the toolchain and provide some context about its series

3 files changed, 45 insertions, 6 deletions

diff --git a/.gitignore b/.gitignore
index fbeb2b6..c7d1179 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,7 @@ site/news/ColorlessThemes-0.2.html
 site/posts/meta/Contents.html
 site/posts/meta/Soupault.html
 site/posts/Thanks.html
+site/posts/meta.html
 site/posts/DiscoveringCommonLisp.html
 site/posts/ExtensibleTypeSafeErrorHandling.html
 site/posts/MonadTransformers.html
diff --git a/site/posts.org b/site/posts.org
index 940e0f1..a8abe84 100644
--- a/site/posts.org
+++ b/site/posts.org
@@ -67,17 +67,20 @@ One of my goal with this website is for it to /feel/ simple, but the truth is
 under the hood it is generated from a bunch of files using a not-that-simple
 process.
 
-- A Series on Generating this Static Website ::
-  This website uses a literate programming approach, where most of the pieces
-  used to build it are documented and actually part of its content.
+- [[/posts/meta/][A Series on Generating this Static Website]] ::
+  The toolchain behind the generation of this website ---called *~cleopatra~*---
+  is a literate programming document which build itself in addition to the HTML
+  files composing this corner of the Internet.
 
-  1. [[/posts/meta/Contents][Authoring Contents and HTML Generation ~(WIP)~]]
-  2. [[/posts/meta/Soupault/][Configuring ~soupault~ ~(WIP)~]]
+  1. Bootstrapping an Extensible Toolchain ~(TODO)~
+  2. [[/posts/meta/Contents][Authoring Contents and HTML Generation ~(WIP)~]]
+  3. [[/posts/meta/Soupault/][Configuring ~soupault~ ~(WIP)~]]
 
 
 - [[/posts/Thanks/][Thanks!]] ::
   If it were not for many awesome FOSS projects, this corner of the Internet
-  would not exists. This is my attempt to
+  would not exists. This is my attempt to give well-deserved credit to them and
+  their creators.
 
 #+BEGIN_EXPORT html
 </article>
diff --git a/site/posts/meta.org b/site/posts/meta.org
new file mode 100644
index 0000000..b229fff
--- /dev/null
+++ b/site/posts/meta.org
@@ -0,0 +1,35 @@
+#+BEGIN_EXPORT html
+<h1>A Series on Generating this Static Website</h1>
+#+END_EXPORT
+
+The generation of this humble static website is far from being trivial, and
+require a combination of —too— many tools. It turned out that some choices I
+have made early on gave to the build toolchain I ended up writing a pretty nice
+property: I could easily integrate its code to the very website it was conceived
+to build, by means of [[http://www.literateprogramming.com/][literate programming]]!
+
+This series is just that: the literate programming document of my home-grown
+build toolchain, called *~cleopatra~*. The motivations behind this name are
+twofold. First, I wanted to follow the example of [[https://soupault.neocities.org/][~soupault~]], named after [[https://fr.wikipedia.org/wiki/Philippe_Soupault][a
+famous personality]]. Secondly, one of my main objective when I started working on
+this “project” was to be able to easily use whatever format I wanted to author
+my content. Did you know that Cleopatra was a reputed polyglot (at least
+according to [[https://fr.wikipedia.org/wiki/Polyglotte][Wikipedia France]])?
+
+
+#+BEGIN_EXPORT html
+<div id="history">site/posts/meta.org</div>
+<article class="index">
+#+END_EXPORT
+
+*Beware* this series is far from being complete.
+
+- Bootstrapping an Extensible Toolchain ~(TODO)~ ::
+
+- [[/posts/meta/Contents][Authoring Content and HTML Generation ~(WIP)~]] ::
+
+- [[/posts/meta/Soupault/][Soupault Configuration ~(WIP)~]] ::
+
+#+BEGIN_EXPORT html
+</article>
+#+END_EXPORT