summaryrefslogtreecommitdiffstats
path: root/site/posts
diff options
context:
space:
mode:
authorThomas Letan <lthms@soap.coffee>2020-02-19 23:17:39 +0100
committerThomas Letan <lthms@soap.coffee>2020-02-19 23:30:43 +0100
commit45aaa238f938d8c93ad11e1322d41c3f84e5d266 (patch)
treedf0420742a067469c8c805f61dd2a408979897e7 /site/posts
parentUse the correct font for interfaces in the titles (diff)
Name the toolchain and provide some context about its series
Diffstat (limited to 'site/posts')
-rw-r--r--site/posts/meta.org35
1 files changed, 35 insertions, 0 deletions
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