diff options
author | Thomas Letan <lthms@soap.coffee> | 2020-02-23 15:02:58 +0100 |
---|---|---|
committer | Thomas Letan <lthms@soap.coffee> | 2020-02-23 15:02:58 +0100 |
commit | 404d05208192f83523049dabe03126ad064c3395 (patch) | |
tree | 9828cadc8c9a3224d578ea35de63343336e85474 | |
parent | Fix several typos in the posts index (diff) |
Reworking cleopatra presentation
-rw-r--r-- | .gitignore | 14 | ||||
-rw-r--r-- | Makefile | 2 | ||||
-rw-r--r-- | site/cleopatra/Bootstrap.org (renamed from site/posts/meta/Bootstrap.org) | 2 | ||||
-rw-r--r-- | site/cleopatra/Contents.org (renamed from site/posts/meta/Contents.org) | 0 | ||||
-rw-r--r-- | site/cleopatra/Contents/Coq.org (renamed from site/posts/meta/Contents/Coq.org) | 0 | ||||
-rw-r--r-- | site/cleopatra/Contents/Org.org (renamed from site/posts/meta/Contents/Org.org) | 0 | ||||
-rw-r--r-- | site/cleopatra/Soupault.org (renamed from site/posts/meta/Soupault.org) | 0 | ||||
-rw-r--r-- | site/cleopatra/Theme.org (renamed from site/posts/meta/Theme.org) | 0 | ||||
-rw-r--r-- | site/cleopatra/index.org | 42 | ||||
-rw-r--r-- | site/posts/index.org | 15 | ||||
-rw-r--r-- | site/posts/meta/index.org | 37 |
11 files changed, 58 insertions, 54 deletions
@@ -17,13 +17,13 @@ site/posts/StronglySpecifiedFunctions.html site/posts/RewritingInCoq.html site/posts/Ltac101.html site/news/ColorlessThemes-0.2.html -site/posts/meta/Contents.html -site/posts/meta/index.html -site/posts/meta/Bootstrap.html -site/posts/meta/Theme.html -site/posts/meta/Soupault.html -site/posts/meta/Contents/Org.html -site/posts/meta/Contents/Coq.html +site/cleopatra/Contents.html +site/cleopatra/index.html +site/cleopatra/Bootstrap.html +site/cleopatra/Theme.html +site/cleopatra/Soupault.html +site/cleopatra/Contents/Org.html +site/cleopatra/Contents/Coq.html site/posts/Thanks.html site/posts/index.html site/posts/DiscoveringCommonLisp.html @@ -1,5 +1,5 @@ ROOT := $(shell pwd) -CLEODIR := site/posts/meta +CLEODIR := site/cleopatra GENFILES := CONTENTS := diff --git a/site/posts/meta/Bootstrap.org b/site/cleopatra/Bootstrap.org index f80ef96..a783f8f 100644 --- a/site/posts/meta/Bootstrap.org +++ b/site/cleopatra/Bootstrap.org @@ -79,7 +79,7 @@ For this website, these constants are defined as follows. #+BEGIN_SRC makefile :tangle Makefile :noweb tangle ROOT := $(shell pwd) -CLEODIR := site/posts/meta +CLEODIR := site/cleopatra #+END_SRC We then introduce a variable that “generation” components will populate with diff --git a/site/posts/meta/Contents.org b/site/cleopatra/Contents.org index 0863709..0863709 100644 --- a/site/posts/meta/Contents.org +++ b/site/cleopatra/Contents.org diff --git a/site/posts/meta/Contents/Coq.org b/site/cleopatra/Contents/Coq.org index 6965927..6965927 100644 --- a/site/posts/meta/Contents/Coq.org +++ b/site/cleopatra/Contents/Coq.org diff --git a/site/posts/meta/Contents/Org.org b/site/cleopatra/Contents/Org.org index f28d1cc..f28d1cc 100644 --- a/site/posts/meta/Contents/Org.org +++ b/site/cleopatra/Contents/Org.org diff --git a/site/posts/meta/Soupault.org b/site/cleopatra/Soupault.org index aab5476..aab5476 100644 --- a/site/posts/meta/Soupault.org +++ b/site/cleopatra/Soupault.org diff --git a/site/posts/meta/Theme.org b/site/cleopatra/Theme.org index 5029380..5029380 100644 --- a/site/posts/meta/Theme.org +++ b/site/cleopatra/Theme.org diff --git a/site/cleopatra/index.org b/site/cleopatra/index.org new file mode 100644 index 0000000..a71b67c --- /dev/null +++ b/site/cleopatra/index.org @@ -0,0 +1,42 @@ +#+BEGIN_EXPORT html +<h1><code>cleopatra</code></h1> +#+END_EXPORT + +The generation of [[https://soap.coffee/~lthms][my personal website]] is far from being trivial, and requires a +combination of —probably 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]]! + +The document you are reading is just that: the literate program of my home-grown +build toolchain ---called *~cleopatra~*---. The motivations behind this name are +twofold. + +- I wanted to follow the example of [[https://soupault.neocities.org/][~soupault~]], named after [[https://fr.wikipedia.org/wiki/Philippe_Soupault][a famous personality]]. +- My main objective when I started working on this “project” was to be able to + easily use whatever format I wanted to author my contents. Did you know that + Cleopatra was a reputed polyglot (at least according to [[https://fr.wikipedia.org/wiki/Polyglotte][Wikipedia France]])? + +#+BEGIN_EXPORT html +<article class="index"> +#+END_EXPORT + +#+BEGIN_TODO +*~cleopatra~* is a literate program whose “program” part is working as +expected. Its “literate” part still requires some work, though. +#+END_TODO + +- [[./Bootstrap.org][Bootstrapping an Extensible Toolchain]] :: + *~cleopatra~* is an extensible toolchain that builds a static website /and/ it + is part of this very website. This means *~cleopatra~* is bootstrapped: it + generates iteself. + +- [[./Contents.org][Authoring Content and HTML Generation ~(WIP)~]] :: + +- [[./Soupault.org][Soupault Configuration ~(WIP)~]] :: + +- [[./Theme.org][Theming and Templating ~(WIP)~]] :: + +#+BEGIN_EXPORT html +</article> +#+END_EXPORT diff --git a/site/posts/index.org b/site/posts/index.org index f5a037d..1de9cba 100644 --- a/site/posts/index.org +++ b/site/posts/index.org @@ -67,16 +67,15 @@ 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. -- [[./meta/][A Series on Generating this Static Website]] :: +- [[/cleopatra/][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. [[./meta/Bootstrap.html][Bootstrapping an Extensible Toolchain]] - 2. [[./meta/Contents.html][Authoring Contents and HTML Generation ~(WIP)~]] - 3. [[./meta/Soupault.html][Configuring ~soupault~ ~(WIP)~]] - 4. [[./meta/Theme.html][Theming and Templating ~(WIP)~]] + is a literate program which build itself in addition to the HTML files + composing this corner of the Internet. This series /is/ *~cleopatra~*. + 1. [[/cleopatra/Bootstrap.html][Bootstrapping an Extensible Toolchain]] + 2. [[/cleopatra/Contents.html][Authoring Contents and HTML Generation ~(WIP)~]] + 3. [[/cleopatra/Soupault.html][Configuring ~soupault~ ~(WIP)~]] + 4. [[/cleopatra/Theme.html][Theming and Templating ~(WIP)~]] - [[./Thanks.html][Thanks!]] :: If it were not for many awesome FOSS projects, this corner of the Internet diff --git a/site/posts/meta/index.org b/site/posts/meta/index.org deleted file mode 100644 index a0df3a9..0000000 --- a/site/posts/meta/index.org +++ /dev/null @@ -1,37 +0,0 @@ -#+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 contents. Did you know that Cleopatra was a reputed polyglot (at least -according to [[https://fr.wikipedia.org/wiki/Polyglotte][Wikipedia France]])? - -#+BEGIN_EXPORT html -<article class="index"> -#+END_EXPORT - -#+BEGIN_TODO -This series is work in progress. -#+END_TODO - -- [[./Bootstrap.org][Bootstrapping an Extensible Toolchain]] :: - -- [[./Contents.org][Authoring Content and HTML Generation ~(WIP)~]] :: - -- [[./Soupault.org][Soupault Configuration ~(WIP)~]] :: - -- [[./Theme.org][Theming and Templating ~(WIP)~]] :: - -#+BEGIN_EXPORT html -</article> -#+END_EXPORT |