summaryrefslogtreecommitdiffstats
path: root/site/posts/meta
diff options
context:
space:
mode:
authorThomas Letan <lthms@soap.coffee>2020-02-23 13:50:58 +0100
committerThomas Letan <lthms@soap.coffee>2020-02-23 14:28:42 +0100
commitfbe5ef4028dc61ce28026e66e64ddfcdfcc6f6ec (patch)
treec8f70b15ddcdce87e5742ae099debb51e79980cc /site/posts/meta
parenta85c838cb85a2600b418180396c467cbe9eeab52 (diff)
Give up on clean URLs
Diffstat (limited to 'site/posts/meta')
-rw-r--r--site/posts/meta/Bootstrap.org16
-rw-r--r--site/posts/meta/Soupault.org2
-rw-r--r--site/posts/meta/index.org36
3 files changed, 45 insertions, 9 deletions
diff --git a/site/posts/meta/Bootstrap.org b/site/posts/meta/Bootstrap.org
index 0f3a07e..8e645c7 100644
--- a/site/posts/meta/Bootstrap.org
+++ b/site/posts/meta/Bootstrap.org
@@ -90,8 +90,8 @@ their output files (using ~+=~).
List *~cleopatra~* Makefiles and scripts tangled throughout the generation
process (with the notable exception of ~Makefile~ itself).
- ~GENSASS~ ::
- List auxiliary ~sass~ files which can be imported by the main ~sass~ files
- (see [[/posts/meta/Theme/][“Theming and Templating”]]).
+ List auxiliary ~sass~ files which can later be imported by the main ~sass~
+ files (see [[./Theme.org][“Theming and Templating”]]).
- ~CONTENTS~ ::
List generated files which are part of the target website, and acts as inputs
for ~soupault~.
@@ -207,7 +207,7 @@ can insert the result of the evaluation of =extends= inside another source block
when the latter is tangled.
The twist is, we derive the rule to tangle ~bootstrap.mk~ using
-~<<extends>>~. The syntax is the following:
+=extends=. The syntax is the following:
#+BEGIN_SRC verbatim
<<extends(IN="Bootstrap.org", MK="bootstrap.mk", GF="scripts/update-gitignore.sh")>>
@@ -220,7 +220,7 @@ previous source block.
<<extends(IN="Bootstrap.org", MK="bootstrap.mk", GF="scripts/update-gitignore.sh")>>
#+END_SRC
-Beware that, as a consequence, modifying code block of ~<<extends>>~ is as
+Beware that, as a consequence, modifying code block of =extends= is as
“dangerous” as modifying ~Makefile~ itself. Keep that in mind if you start
hacking *~cleopatra~*!
@@ -231,7 +231,7 @@ modify ~bootstrap.mk~ accordingly.
* Generation Processes
-Thanks to ~<<extends>>~, *~cleopatra~* is easily extensible. In this section, we
+Thanks to =extends=, *~cleopatra~* is easily extensible. In this section, we
enumerate the generation processes that are currently used to generate the
website you are reading.
@@ -247,16 +247,16 @@ In the present website, contents can be written in the following format:
- Regular Coq files ::
Coq is a system which allows to write machine-checked proofs, and it comes
with a source “prettifier” called ~coqdoc~.
- [[/posts/meta/Contents/Coq/][Learn more about the generation process for Coq files​]]
+ [[./Contents/Coq.org][Learn more about the generation process for Coq files​]]
- Org documents ::
Emacs comes with a powerful editing mode called [[https://orgmode.org/][Org mode]], and Org documents
are really pleasant to work with.
- [[/posts/meta/Contents/Org/][Learn more about the generation process for Org documents]]
+ [[./Contents/Org.org][Learn more about the generation process for Org documents]]
If you want *~cleopatra~* to support more input formats, you have to
1. Create a org file which, once tangled, provide a dedicated makefile
-2. Edit this file (~Bootstrap.org~) here, and use ~<<extends>>~ to make sure it
+2. Edit this file (~Bootstrap.org~) here, and use =extends= to make sure it
is actually tangled when necessary
#+BEGIN_SRC makefile :tangle bootstrap.mk :noweb tangle :exports none
diff --git a/site/posts/meta/Soupault.org b/site/posts/meta/Soupault.org
index 913c8ae..aab5476 100644
--- a/site/posts/meta/Soupault.org
+++ b/site/posts/meta/Soupault.org
@@ -23,7 +23,7 @@
default_template = "templates/main.html"
content_selector = "main"
doctype = "<!DOCTYPE html>"
- clean_urls = true
+ clean_urls = false
[widgets.page-title]
widget = "title"
diff --git a/site/posts/meta/index.org b/site/posts/meta/index.org
new file mode 100644
index 0000000..db5542e
--- /dev/null
+++ b/site/posts/meta/index.org
@@ -0,0 +1,36 @@
+#+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
+<div id="history">site/posts/meta/index.org</div>
+<article class="index">
+#+END_EXPORT
+
+*Beware* this series is far from being complete.
+
+- [[./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