diff options
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | site/posts.org | 15 | ||||
-rw-r--r-- | site/posts/meta.org | 35 |
3 files changed, 45 insertions, 6 deletions
@@ -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 |