Update brainshit

content/brainshit.md

@@ -15,13 +15,16 @@ Brainshit is now part of the [cybrecluster](cybrecluster/).
   from a PHP tutorial on the *Site du Zéro*
   ([OpenClassrooms](https://openclassrooms.com/)'s old name), and with 
   [.tk](https://dot.tk) domain name.
+
 * 2010-2012: Renamed it from my old nickname to *BubbleLand*, redesigned it by
   filling it with `<img>` tags and scanning drawings from a notebook, and moved
   to Kelio.org, a French non-profit.
+
 * 2013-2015: Made the initial design using [Amaya](https://www.w3.org/Amaya/),
   then integrated it again into the old PHP tutorial code.  Moved to Hostinger,
   another free PHP hosting thing.  Rewrote the whole admin page using jQuery UI
   once I had learned it during an internship and even tried to make a JSON API.
+
 * 2015-now: Rewrote from scratch using things I learnt from doing a PHP project
   at school and reusing that project in an internship.  Articles can have just
   a summary, or a summary and content, or a summary and chapters.  A simple
@@ -36,6 +39,43 @@ even thought about the cybrecluster.  I had written a Python exporter that took
 in a MariaDB database export and generated Markdown files and some tar.gz
 archives for the features that I would drop during the transition.
 
+I had considered at one point rewriting Brainshit in Python with Django, before
+coming up with the cybrecluster and deciding that Brainshit is simply not large
+enough to require something non-static.  While I definitely am able to pull off
+that rewrite, I don't want to host it.
+
+I am struggling to find the static site generator that will allow me to make my
+transition.  I was considering moving Brainshit further away from a blog and
+more into a wiki, but now that I have this wiki, this feels less relevant;
+these change of plans definitely slowed me down.
+
+I have considered using [Zola](https://getzola.org).  It looked like Hugo, but
+nicer to use, and I now am the maintainer of its Alpine package.  But after
+using it at work, I realized its Markdown parser is not CommonMark-compliant,
+and has many issues that are making it as uncomfortable to use as my current
+parser, PHP Markdown Extra.
+
+### Current planned design
+
+I have been using `pandoc` for this website as well as on breadpunk, and maybe
+someday I'll also use it on tilde.town, so why not use it on Brainshit as well?
+
+That is a bit more complex to do because pandoc only handles a single document
+at a time.  Existing pandoc-based static site generators feel too blog-oriented
+and not extensible enough to be interesting, so I am thinking of writing my own
+solution.  To solve the issue of being able to create an index page or filter
+by categories, I'll use `oq`, a wrapper around jq that can parse YAML, to parse
+the YAML metadata of each file and either generate the HTML directly or send
+that as more YAML metadata to pandoc with a special template.
+
+Using `pandoc` fixes the main problem that I currently have with my site: the
+Markdown support is pretty poor and I find myself needing more and more out of
+Markdown with each of my posts.  I might end up relying on pandoc privately and
+just sending its generated HTML to my blog's admin page until I do the rewrite,
+so that I can avoid the poor PHP parser.
+
+### Comments
+
 It took me a while to decide, but I chose to just not include comments at all
 in the next version of Brainshit.  It will just be articles, and that's all.
 We got very few comments, half of those were spam, and replying was hard since
@@ -48,37 +88,13 @@ have GitHub accounts, which is not acceptable considering the fact that GitHub
 is an American company, owned by Microsoft, and makes questionable choices
 regarding its clients.
 
-I had considered at one point rewriting Brainshit in Python with Django, before
-coming up with the cybrecluster and deciding that Brainshit is simply not large
-enough to require something non-static.  While I definitely am able to pull off
-that rewrite, I don't want to host it.
-
-I am struggling to find the static site generator that will allow me to make my
-transition.  I was considering moving Brainshit further away from a blog and
-more into a wiki, but now that I have this wiki, this feels less relevant;
-these change of plans definitely slowed me down.  For now, I am considering
-using [Zola](https://getzola.org).
-
 ## Article ideas
 
-* Going to a public library felt empowering
-* Coding for myself or for others
-  * Introduction on the Lua script generating SQL
-  * One-off shell scripts, immediate usage
-  * Learning can be transferred to PKM
 * Personal knowledge management
-* tilde.town
-* breadpunk.club
-* twtxt-registry-client
-* Urbex adventures in Grenoble
-* Minetest
 * A d7 throw costing 400 billion euros
-* Nomic
-* A more abstract approach to ITSB
 * On imperfection: "Le talent d'Achille"
 * How many points do we get by shooting every basketball in existence
   through a hoop at once?
-* Literate programming
 * A conclusion on my use of the [integrity report](./integrity-report.html)
   * Projects that do not follow an integrity report or that do not
     seem to matter in some kind of productivity methodology aren't always