summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThomas Letan <lthms@soap.coffee>2020-02-23 15:02:58 +0100
committerThomas Letan <lthms@soap.coffee>2020-02-23 15:02:58 +0100
commit404d05208192f83523049dabe03126ad064c3395 (patch)
tree9828cadc8c9a3224d578ea35de63343336e85474
parentFix several typos in the posts index (diff)
Reworking cleopatra presentation
-rw-r--r--.gitignore14
-rw-r--r--Makefile2
-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.org42
-rw-r--r--site/posts/index.org15
-rw-r--r--site/posts/meta/index.org37
11 files changed, 58 insertions, 54 deletions
diff --git a/.gitignore b/.gitignore
index 55a021d..8a40b13 100644
--- a/.gitignore
+++ b/.gitignore
@@ -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
diff --git a/Makefile b/Makefile
index 31fe106..364a8f2 100644
--- a/Makefile
+++ b/Makefile
@@ -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