Merge pull request 'Add "GPTar update" article' (#22 ) from gptar-update into main

Reviewed-on: robur/blog.robur.coop#22
Merge pull request 'Add article about elit/ptt' (#21 ) from elit into main
2024-10-29 11:12:06 +00:00 · 2024-10-29 11:01:31 +00:00 · 2024-10-29 12:01:17 +01:00 · 2024-10-29 09:21:56 +01:00 · 2024-10-29 09:05:15 +01:00 · 2024-10-28 18:55:57 +01:00
47 changed files with 2244 additions and 1002 deletions
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,3 @@
 _build/
 _site/
 _cache
--- a/README.md
+++ b/README.md
@ -10,25 +10,26 @@ $ git clone git@git.robur.coop:robur/blog.robur.coop
 $ cd blog.robur.coop/
 $ opam pin add -yn .
 $ opam install --deps-only blogger
-$ dune exec src/blogger.exe -- watch
+$ dune exec bin/watch.exe --
 ```
-A little server run on `http://localhost:8888`.
+A little server run on `http://localhost:8000`.
 The user can add an article into the `articles/` directory. The format is easy.
 A simple header which starts with `---` and finish with `---`. Inside, you have
 a YAML description of the article where some fields are required:
 - `date`
- `article.title`
+- `title`
- `article.description`
+- `description`
 - `tags`
 You can specify an `author` (with its `name`, `email` and `link`) or not. By
 default, we use `team@robur.coop`. If everything looks good, you can generate
 via the `blogger.exe` tool the generated website via:
 ```shell-session
-$ dune exec src/blogger.exe -- push \
+$ dune exec bin/push.exe -- push \
-  -r git@git.robur.coop:robur/blog.robur.coop.git#gh-pages
+  -r git@git.robur.coop:robur/blog.robur.coop.git#gh-pages \
  --host https://blog.robur.coop
  [--name "The Robur team"] \
  [--email team@robur.coop]
 ```
@ -37,7 +38,7 @@ An SSH communication will starts. If you already registered your private key
 with `ssh-agent` and your `.ssh/config` is configured to take this one if you
 communicate with with `git@git.robur.coop`, everything will be smooth! Et voilà!
 At the end, an HTTP request will be send to `https://blog.robur.coop` (via
-Gitea) to update the unikernel with the last version of the blog.
+Forgejo) to update the unikernel with the last version of the blog.
 You can also use the `update.sh` script to update the blog with the builder user
 on the server machine.
--- a/articles/2024-02-03-python-str-repr.md
+++ b/articles/2024-02-03-python-str-repr.md
@ -1,7 +1,7 @@
 ---
 date: 2024-02-03
-article.title: Python's `str.__repr__()`
+title: Python's `str.__repr__()`
-article.description: Reimplementing Python string escaping in OCaml
+description: Reimplementing Python string escaping in OCaml
 tags:
  - OCaml
  - Python
--- a/articles/2024-08-21-OpenVPN-and-MirageVPN.markdown
+++ b/articles/2024-08-21-OpenVPN-and-MirageVPN.markdown
@ -1,7 +1,7 @@
 ---
 date: 2024-08-21
-article.title: MirageVPN and OpenVPN
+title: MirageVPN and OpenVPN
-article.description: Discoveries made implementing MirageVPN, a OpenVPN-compatible VPN library
+description: Discoveries made implementing MirageVPN, a OpenVPN-compatible VPN library
 tags:
  - MirageVPN
  - OpenVPN
@ -236,7 +236,7 @@ This work was funded by [the EU NGI Assure Fund through NLnet](https://nlnet.nl/
 In my opinion, this shows that funding one open source project can have a positive impact on other open source projects, too.
 [robur]: https://robur.coop/
-[miragevpn-server]: https://blog.robur.coop/articles/miragevpn-server.html
+[miragevpn-server]: miragevpn-server.html
 [contact]: https://reyn.ir/contact.html
 [^openvpn-tls]: This is not always the case. It is possible to use static shared secret keys, but it is mostly considered deprecated.
--- a/articles/2024-10-29-ptt.md
+++ b/articles/2024-10-29-ptt.md
@ -0,0 +1,221 @@
 ---
 date: 2024-10-29
 title: Postes, télégraphes et téléphones, next steps
 description: An update of our email stack
 tags:
  - SMTP
  - emails
  - mailing-lists
 author:
  name: Romain Calascibetta
  email: romain.calascibetta@gmail.com
  link: https://blog.osau.re/
 breaks: false
 ---
 As you know from [our article on Robur's
 finances](https://blog.robur.coop/articles/finances.html), we've just received
 [funding for our email project](https://nlnet.nl/project/PTT). This project
 started when I was doing my internship in Cambridge and it's great to see that
 it's been able to evolve over time and remain functional. This article will
 introduce you to the latest changes to [our PTT
 project](https://github.com/mirage/ptt) and how far we've got towards providing
 an OCaml mailing list service.
 ## A Git repository or a simple block device as a database?
 One issue that came up quickly in our latest experiments with our SMTP stack was
 the database of users with an email address. Since we had decided to ‘break
 down’ the various stages of an email submission to offer simple unikernels, we
 ended up having to deploy 4 unikernels to have a service that worked.
 - a unikernel for authentication
 - a unikernel DKIM-signing the incoming email
 - one unikernel as primary DNS server
 - one unikernel sending the signed email to its real destination
 And we're only talking here about the submission of an email, the reception
 concerns another ‘pipe’.
 The problem with such an architecture is that some unikernels need to have the
 same data: the users. In this case, the first unikernel needs to know the user's
 password in order to verify authentication. The final unikernel needs to know
 the real destinations of the users.
 Let's take the example of two users: foo@robur.coop and bar@robur.coop. The
 first points to hannes@foo.org and the second to reynir@example.com.
 If Hannes wants to send a message to bar@robur.coop under the identity of
 foo@robur.coop, he will need to authenticate himself to our first unikernel.
 This first unikernel must therefore:
 1) check that the user `foo` exists
 2) the hashed password used by Hannes is the same as the one in the database
 Next, the email will be signed by our second unikernel. It will then forward the
 email to the last unikernel, which will do the actual translation of the
 recipients and DNS resolution. In other words:
 1) it will see that one (the only) recipient is bar@robur.coop
 2) check that bar@robur.coop exists and obtain its real address
 3) it will obtain reynir@example.com and perform DNS resolution on
   `example.com` to find out the email server for this domain
 4) finally send the email signed by foo@robur.coop to reynir@example.com!
 So the first and last unikernels need to have the same information about our
 users. One for the passwords, the second for the real email addresses.
 But as you know, we're talking about unikernels that exist independently of each
 other. What's more, they can't share files and the possibility of them sharing
 block-devices remains an open question (and a complex one where parallel access
 may be involved). In short, the only way to ‘synchronise’ these unikernels in
 relation to common data is with a Git repository.
 [Git][git-kv] has the advantage of being widely used for our unikernels
 ([primary-git][primary-git], [pasteur][pasteur], [unipi][unipi] and
 [contruno][contruno]). The advantage is that you can track changes, modify
 files and notify the unikernel to update itself (using nsupdate, a simple ping
 or an http request to the unikernel).
 The problem is that this requires certain skills. Even if it's ‘simple’ to set
 up a Git server and then deploy our unikernels, we can restructure our
 architecture and simplify the deployment of an SMTP stack!
 ## Elit and OneFFS
 We have therefore decided to merge the email exchange service and email
 submission into a unikernel so that this is the only user information requester.
 So we decided to use [OneFFS][oneffs] as the file system for our database,
 which will be a plain JSON file. This is perhaps one of the advantages of
 MirageOS, which is that you can decide exactly what you need to implement
 specific objectives.
 In this case, those with experience of Postfix, LDAP or MariaDB could confirm
 that configuring an email service should be ‘simpler’ than implementing a
 multitude of pipes between different applications and authentication methods.
 The JSON file is therefore very simple and so is the creation of an OneFFS
 image:
 ```sh
 $ cat >database.json<<EOF
 > [ { "name": "din"
 >   , "password": "xxxxxx"
 >   , "mailboxes": [ "romain.calascibetta@gmail.com" ] } ]
 > EOF
 $ opam install oneffs
 $ oneffs create -i database.json -o database.img
 ```
 All you have to do is register this image as a block with [albatross][albatross] and launch
 our Elit unikernel with this block-device.
 ```sh
 $ albatross-client create-block --data=database.img database 1024
 $ albatross-client create --net=service:br0 --block=database:database \
    elit elit.hvt \
    --arg=...
 ```
 At this stage, and if we add our unikernel signing incoming emails, we have more
 or less the same thing as what I've described in [my previous articles][smtp_1] on
 [deploying][smtp_2] an [email service][smtp_3].
 ## Multiplex receiving & sending emails
 The PTT project is a toolkit for implementing SMTP servers. It gives developers
 the choice of implementing their logic as they see fit:
 * sign an email
 * resolve destinations according to a database
 * check SPF information
 * annotate the email as spam or not
 * etc.
 Previously, PTT was split into 2 parts:
 1) management of incoming clients/emails
 2) the logic to be applied to incoming emails and their delivery
 The second point was becoming increasingly complex, however, and errors in
 sending emails are legion (DMARC non-alignment, the email is too big for the
 destination, the destination doesn't exist, etc.). All the more so since, up to
 now, PTT could only report these errors via the logs...
 Hannes immediately mentioned the possibility of separating the logic of the
 unikernel from the delivery. This will allow us to deal with temporary failures
 (greylisting) as well. So a fundamental change was made:
 - improve the [sendmail][sendmail] and `sendmail-lwt` packages (as well as proposing
 `sendmail-miou`!) when sending or submitting an email
 - improve PTT so that there are now 3 distinct jobs: receiving, what to do with
 incoming emails and sending emails
 ![SMTP](../images/smtp.jpg)
 This finally allows us to describe a clearer error management policy that is
 independent of what we want to do with incoming emails. At this stage, we can
 look for the `Return-Path` in emails that we haven't managed to send and notify
 the senders!
 All this is still in the experimental stage and practical cases are needed to
 observe how we should handle errors and how others do.
 ## Insights & Next goals
 We're already starting to have a bit of fun with email and we can start sending
 and receiving emails right away.
 We're also already seeing hacking attempts on our unikernel:
 - people trying to authenticate themselves without `STARTTLS` (or with it,
 depending on how clever the bot is)
 - people trying to send emails as non-existent users in our database
 - we're also seeing content that has nothing to do with SMTP
 Above all, this shows that, very early on, bots try to usurp the identity linked
 to your server (in our case, osau.re) in order to send spam, authenticate
 themselves or simply send ‘stuff’ and observe what happens. In this case, for
 all the cases mentioned, Elit (and PTT) reacts well: in other words, it simply
 cuts off the connection.
 We were also able to observe how services such as gmail work. In addition, for
 the purposes of a mailing list, email forwarding distorts DMARC verification
 (specifically, SPF verification). The case is very simple:
 foo@gmail.com tries to reply to robur@osau.re. robur@osau.re is a mailing list
 to several addresses (one of them is bar@gmail.com). The unikernel will receive
 the email and send it to bar@gmail.com. The problem is the alignment between
 the `From` field (which corresponds to foo@gmail.com) and our osau.re server.
 From gmail.com's point of view, there is a misalignment between these two
 pieces of information and it therefore refuses to receive the email.
 This is where our next objectives come in:
 - finish our DMARC implementation
 - implement ARC so that our server notifies us that, on our side, the DMARC
  check went well and that gmail.com should trust us on this.
 There is another way of solving the problem, perhaps a little more problematic,
 modify the incoming email and in particular the `From` field. Although this
 could be done quite simply with [mrmime][mrmime], it's better to concentrate on
 DMARC and ARC so that we can send our emails as they are and never alter them
 (especially as this will invalidate previous DKIM signatures!).
 ## Conclusion
 It's always satisfying to see your projects working ‘more or less’ correctly.
 This article will surely be the start of a series on the intricacies of email
 and the difficulty of deploying such a service at home.
 We hope that this NLnet-funded work will enable us to replace our current email
 system with unikernels. We're already past the stage where we can, more or less
 (without DMARC checking), send emails to each other, which is a big step!
 So follow our work on our blog and if you like what we're producing (which
 involves a whole bunch of protocols and formats - much more than just SMTP), you
 can make [a donation here](https://robur.coop/Donate)!
 [mrmime]: https://github.com/mirage/mrmime
 [smtp_1]: https://blog.osau.re/articles/smtp_1.html
 [smtp_2]: https://blog.osau.re/articles/smtp_2.html
 [smtp_3]: https://blog.osau.re/articles/smtp_3.html
 [oneffs]: https://github.com/robur-coop/oneffs
 [albatross]: https://github.com/robur-coop/albatross
 [git-kv]: https://github.com/robur-coop/git-kv
 [primary-git]: https://github.com/robur-coop/dns-primary-git/
 [contruno]: https://github.com/dinosaure/contruno
 [pasteur]: https://github.com/dinosaure/pasteur
 [unipi]: https://github.com/robur-coop/unipi
 [sendmail]: https://github.com/mirage/colombe
--- a/articles/arguments.md
+++ b/articles/arguments.md
@ -0,0 +1,538 @@
 ---
 date: 2024-10-22
 title: Runtime arguments in MirageOS
 description:
  The history of runtime arguments to a MirageOS unikernel
 tags:
  - OCaml
  - MirageOS
 author:
  name: Hannes Mehnert
  email: hannes@mehnert.org
  link: https://hannes.robur.coop
 ---
 TL;DR: Passing runtime arguments around is tricky, and prone to change every other month.
 ## Motivation
 Sometimes, as an unikernel developer and also as operator, it's nice to have
 some runtime arguments passed to an unikernel. Now, if you're into OCaml,
 command-line parsing - together with error messages, man page generation, ... -
 can be done by the amazing [cmdliner](https://erratique.ch/software/cmdliner)
 package from Daniel Bünzli.
 MirageOS uses cmdliner for command line argument passing. This also enabled
 us from the early days to have nice man pages for unikernels (see
 `my-unikernel-binary --help`). There are two kinds
 of arguments: those at configuration time (`mirage configure`), such as the
 target to compile for, and those at runtime - when the unikernel is executed.
 In Mirage 4.8.1 and 4.8.0 (released October 2024) there have been some changes
 to command-line arguments, which were motivated by 4.5.0 (released April 2024)
 and user feedback.
 First of all, our current way to pass a custom runtime argument to a unikernel
 (`unikernel.ml`):
 ```OCaml
 open Lwt.Infix
 open Cmdliner
 let hello =
  let doc = Arg.info ~doc:"How to say hello." [ "hello" ] in
  let term = Arg.(value & opt string "Hello World!" doc) in
  Mirage_runtime.register_arg term
 module Hello (Time : Mirage_time.S) = struct
  let start _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
          Logs.info (fun f -> f "%s" (hello ()));
          Time.sleep_ns (Duration.of_sec 1) >>= fun () -> loop (n - 1)
    in
    loop 4
 end
 ```
 We define the [Cmdliner.Term.t](https://erratique.ch/software/cmdliner/doc/Cmdliner/Term/index.html#type-t)
 in line 6 (`let term = ..`) - which provides documentation ("How to say hello."), the option to
 use (`["hello"]` - which is then translated to `--hello=`), that it is optional,
 of type `string` (cmdliner allows you to convert the incoming strings to more
 complex (or more narrow) data types, with decent error handling).
 The defined argument is directly passed to [`Mirage_runtime.register_arg`](https://ocaml.org/p/mirage-runtime/4.8.1/doc/Mirage_runtime/index.html#val-register_arg),
 (in line 7) so our binding `hello` is of type `unit -> string`.
 In line 14, the value of the runtime argument is used (`hello ()`) for printing
 a log message.
 The nice property is that it is all local in `unikernel.ml`, there are no other
 parts involved. It is just a bunch of API calls. The downside is that `hello ()`
 should only be evaluated after the function `start` was called - since the
 `Mirage_runtime` needs to parse and fill in the command line arguments. If you
 call `hello ()` earlier, you'll get an exception "Called too early. Please delay
 this call to after the start function of the unikernel.". Also, since
 Mirage_runtime needs to collect and evaluate the command line arguments, the
 `Mirage_runtime.register_arg` may only be called at top-level, otherwise you'll
 get another exception "The function register_arg was called to late. Please call
 register_arg before the start function is executed (e.g. in a top-level binding).".
 Another advantage is, having it all in unikernel.ml means adding and removing
 arguments doesn't need another execution of `mirage configure`. Also, any
 type can be used that the unikernel depends on - the config.ml is compiled only
 with a small set of dependencies (mirage itself) - and we don't want to impose a
 large dependency cone for mirage just because someone may like to use
 X509.Key_type.t as argument type.
 Earlier, before mirage 4.5.0, we had runtime and configure arguments mixed
 together. And code was generated when `mirage configure` was executed to
 deal with these arguments. The downsides included: we needed serialization for
 all command-line arguments (at configure time you could fill the argument, which
 was then serialized, and deserialized at runtime and used unless the argument
 was provided explicitly), they had to appear in `config.ml` (which also means
 changing any would need an execution of `mirage configure`), since they generated code
 potential errors were in code that the developer didn't write (though we had
 some `__POS__` arguments to provide error locations in the developer code).
 Related recent changes are:
 - in mirage 4.8.1, the runtime arguments to configure the OCaml runtime system
  (such as GC settings, randomization of hashtables, recording of backtraces)
  are now provided using the [cmdliner-stdlib](https://ocaml.org/p/cmdliner-stdlib)
  package.
 - in mirage 4.8.0, for git, dns-client, and happy-eyeballs devices the optional
  arguments are generated by default - so they are always available and don't
  need to be manually done by the unikernel developer.
 Let's dive a bit deeper into the history.
 ## History
 In MirageOS, since the early stages (I'll go back to 2.7.0 (February 2016) where
 functoria was introduced) used an embedded fork of `cmdliner` to handle command
 line arguments.
 [![Animated changes to the hello world unikernel](https://asciinema.org/a/ruHoadi2oZGOzgzMKk5ZYoFgf.svg)](https://asciinema.org/a/ruHoadi2oZGOzgzMKk5ZYoFgf)
 ### February 2016 (Mirage 2.7.0)
 When looking into the MirageOS 2.x series, here's the code for our hello world
 unikernel:
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt string "Hello World!" doc))
 let main =
  foreign
    ~keys:[Key.abstract hello]
    "Unikernel.Hello" (console @-> job)
 let () = register "hello-key" [main $ default_console]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (C: V1_LWT.CONSOLE) = struct
  let start c =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        C.log c (Key_gen.hello ());
        OS.Time.sleep 1.0 >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 As you can see, the cmdliner term was provided in `config.ml`, and in
 `unikernel.ml` the expression `Key_gen.hello ()` was used - `Key_gen` was
 a module generated by the `mirage configure` invocation.
 You can as well see that the term was wrapped in `Key.create "hello"` - where
 this string was used as the identifier for the code generation.
 As mentioned above, a change needed to be done in `config.ml` and a
 `mirage configure` to take effect.
 ### July 2016 (Mirage 2.9.1)
 The `OS.Time` was functorized with a `Time` functor:
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt string "Hello World!" doc))
 let main =
  foreign
    ~keys:[Key.abstract hello]
    "Unikernel.Hello" (console @-> time @-> job)
 let () = register "hello-key" [main $ default_console $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (C: V1_LWT.CONSOLE) (Time : V1_LWT.TIME) = struct
  let start c _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        C.log c (Key_gen.hello ());
        Time.sleep 1.0 >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### February 2017 (Mirage pre3)
 The `Time` signature changed, now the `sleep_ns` function sleeps in nanoseconds.
 This avoids floating point numbers at the core of MirageOS. The helper package
 `duration` is used to avoid manual conversions.
 Also, the console signature changed - and `log` is now inside the Lwt monad.
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt string "Hello World!" doc))
 let main =
  foreign
    ~keys:[Key.abstract hello]
    ~packages:[package "duration"]
    "Unikernel.Hello" (console @-> time @-> job)
 let () = register "hello-key" [main $ default_console $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (C: V1_LWT.CONSOLE) (Time : V1_LWT.TIME) = struct
  let start c _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        C.log c (Key_gen.hello ()) >>= fun () ->
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### February 2017 (Mirage 3)
 Another big change is that now console is not used anymore, but
 [logs](https://erratique.ch/software/logs).
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt string "Hello World!" doc))
 let main =
  foreign
    ~keys:[Key.abstract hello]
    ~packages:[package "duration"]
    "Unikernel.Hello" (time @-> job)
 let () = register "hello-key" [main $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (Time : Mirage_time_lwt.S) = struct
  let start _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        Logs.info (fun f -> f "%s" (Key_gen.hello ()));
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### January 2020 (Mirage 3.7.0)
 The `_lwt` is dropped from the interfaces (we used to have Mirage_time and
 Mirage_time_lwt - where the latter was instantiating the former with concrete
 types: `type 'a io = Lwt.t` and `type buffer = Cstruct.t` -- in a cleanup
 session we dropped the `_lwt` interfaces and opam packages. The reasoning was
 that when we'll get around to move to another IO system, we'll move everything
 at once anyways. No need to have `lwt` and something else (`async`, or nowadays
 `miou` or `eio`) in a single unikernel.
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt string "Hello World!" doc))
 let main =
  foreign
    ~keys:[Key.abstract hello]
    ~packages:[package "duration"]
    "Unikernel.Hello" (time @-> job)
 let () = register "hello-key" [main $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (Time : Mirage_time.S) = struct
  let start _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        Logs.info (fun f -> f "%s" (Key_gen.hello ()));
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### October 2021 (Mirage 3.10)
 Some renamings to fix warnings. Only `config.ml` changed.
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt string "Hello World!" doc))
 let main =
  main
    ~keys:[key hello]
    ~packages:[package "duration"]
    "Unikernel.Hello" (time @-> job)
 let () = register "hello-key" [main $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (Time : Mirage_time.S) = struct
  let start _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        Logs.info (fun f -> f "%s" (Key_gen.hello ()));
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### June 2023 (Mirage 4.4)
 The argument was moved to runtime.
 `config.ml`
 ```OCaml
 open Mirage
 let hello =
  let doc = Key.Arg.info ~doc:"How to say hello." ["hello"] in
  Key.(create "hello" Arg.(opt ~stage:`Run string "Hello World!" doc))
 let main =
  main
    ~keys:[key hello]
    ~packages:[package "duration"]
    "Unikernel.Hello" (time @-> job)
 let () = register "hello-key" [main $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 module Hello (Time : Mirage_time.S) = struct
  let start _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        Logs.info (fun f -> f "%s" (Key_gen.hello ());
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### March 2024 (Mirage 4.5)
 The runtime argument is in `config.ml` refering to the argument as string
 ("Unikernel.hello"), and being passed to the `start` function as argument.
 `config.ml`
 ```OCaml
 open Mirage
 let runtime_args = [ runtime_arg ~pos:__POS__ "Unikernel.hello" ]
 let main =
  main
    ~runtime_args
    ~packages:[package "duration"]
    "Unikernel.Hello" (time @-> job)
 let () = register "hello-key" [main $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 open Cmdliner
 let hello =
  let doc = Arg.info ~doc:"How to say hello." [ "hello" ] in
  Arg.(value & opt string "Hello World!" doc)
 module Hello (Time : Mirage_time.S) = struct
  let start _time hello =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        Logs.info (fun f -> f "%s" hello);
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### October 2024 (Mirage 4.8)
 Again, moved out of `config.ml`.
 `config.ml`
 ```OCaml
 open Mirage
 let main =
  main
    ~packages:[package "duration"]
    "Unikernel.Hello" (time @-> job)
 let () = register "hello-key" [main $ default_time]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 open Cmdliner
 let hello =
  let doc = Arg.info ~doc:"How to say hello." [ "hello" ] in
  Mirage_runtime.register_arg Arg.(value & opt string "Hello World!" doc)
 module Hello (Time : Mirage_time.S) = struct
  let start _time =
    let rec loop = function
      | 0 -> Lwt.return_unit
      | n ->
        Logs.info (fun f -> f "%s" (hello ()));
        Time.sleep_ns (Duration.of_sec 1) >>= fun () ->
        loop (n-1)
    in
    loop 4
 end
 ```
 ### 2024 (Not yet released)
 This is the future with time defunctorized. Read more in the [discussion](https://github.com/mirage/mirage/issues/1513).
 To delay the start function, a `dep` of `noop` is introduced.
 `config.ml`
 ```OCaml
 open Mirage
 let main =
  main
    ~packages:[package "duration"]
    ~dep:[dep noop]
    "Unikernel" job
 let () = register "hello-key" [main]
 ```
 and `unikernel.ml`
 ```OCaml
 open Lwt.Infix
 open Cmdliner
 let hello =
  let doc = Arg.info ~doc:"How to say hello." [ "hello" ] in
  Mirage_runtime.register_arg Arg.(value & opt string "Hello World!" doc)
 let start () =
  let rec loop = function
    | 0 -> Lwt.return_unit
    | n ->
      Logs.info (fun f -> f "%s" (hello ()));
      Mirage_timer.sleep_ns (Duration.of_sec 1) >>= fun () ->
      loop (n-1)
  in
  loop 4
 ```
 ## Conclusion
 The history of hello world shows that over time we slowly improve the developer
 experience, and removing the boilerplate needed to get MirageOS unikernels up
 and running. This is work over a decade including lots of other (here invisible)
 improvements to the mirage utility.
 Our current goal is to minimize the code generated by mirage, since code
 generation has lots of issues (e.g. error locations, naming, binary size). It
 is a long journey. At the same time, we are working on improving the performance
 of MirageOS unikernels, developing unikernels that are useful in the real
 world ([VPN endpoint](https://github.com/robur-coop/miragevpn), [DNSmasq replacement](https://github.com/robur-coop/dnsvizor), ...), and also [simplifying the
 deployment of MirageOS unikernels](https://github.com/robur-coop/mollymawk).
 If you're interested in MirageOS and using it in your domain, don't hesitate
 to reach out to us (via eMail: team@robur.coop) - we're keen to deploy MirageOS
 and find more domains where it is useful. If you can spare a dime, we're a
 registered non-profit in Germany - and can provide tax-deductable receipts for
 donations ([more information](https://robur.coop/Donate)).
--- a/articles/dnsvizor01.md
+++ b/articles/dnsvizor01.md
@ -0,0 +1,107 @@
 ---
 date: 2024-10-25
 title: "Meet DNSvizor: run your own DHCP and DNS MirageOS unikernel"
 description:
  The NGI-funded DNSvizor provides core network services on your network; DNS resolution and DHCP.
 tags:
  - OCaml
  - MirageOS
  - DNSvizor
 author:
  name: Hannes Mehnert
  email: hannes@mehnert.org
  link: https://hannes.robur.coop
 ---
 TL;DR: We got [NGI0 Entrust (via NLnet)](https://nlnet.nl/entrust/) funding for developing
 [DNSvizor](https://nlnet.nl/project/DNSvizor/) - a DNS resolver and
 DHCP server. Please help us by [sharing with us your dnsmasq
 configuration](https://github.com/robur-coop/dnsvizor/issues/new), so we can
 prioritize the configuration options to support.
 ## Introduction
 The [dynamic host configuration protocol (DHCP)](https://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol)
 is fundamental in today's Internet and local networks. It usually runs on your
 router (or as a dedicated independent service) and automatically configures
 computers that join your network (for example wireless laptops, smartphones)
 with an IP address, routing information, a DNS resolver, etc. No manual
 configuration is needed once your friends' smartphone got the password of your
 wireless network \o/
 The [domain name system (DNS)](https://en.wikipedia.org/wiki/Domain_Name_System)
 is responsible for translating domain names (such as "robur.coop", "nlnet.nl")
 to IP addresses (such as 193.30.40.138 or 2a0f:7cc7:7cc7:7c40::138) - used by
 computers to talk to each other. Humans can remember domain names instead of
 memorizing IP addresses. Computers then use DNS to translate these domain names
 to IP addresses to communicate with. DNS is a hierarchic, distributed,
 faul-tolerant service.
 These two protocols are fundamental to today's Internet: without them it would
 be much harder for humans to use it.
 ## DNSvizor
 We at [robur](https://robur.coop) got funding (from
 [NGI0 Entrust via NLnet](https://nlnet.nl/project/DNSvizor/)) to continue our work on
 [DNSvizor](https://github.com/robur-coop/dnsvizor) - a
 [MirageOS unikernel](https://mirageos.org) that provides DNS resolution and
 DHCP service for a network. This is fully implemented in
 [OCaml](https://ocaml.org).
 Already at our [MirageOS retreats](https://retreat.mirageos.org) we deployed
 such unikernel, to test our [DHCP implementation](https://github.com/mirage/charrua)
 and our [DNS resolver](https://github.com/mirage/ocaml-dns) - and found and
 fixed issues on-site. At the retreats we have a very limited Internet uplink,
 thus caching DNS queries and answers is great for reducing the load on the
 uplink.
 Thanks to the funding we received, we'll be able to work on improving the
 performance, but also to finish our DNSSec implementation, provide DNS-over-TLS
 and DNS-over-HTTPS services, and also a web interface. DNSvizor will use the
 existing [dnsmasq](https://thekelleys.org.uk/dnsmasq/doc.html) configuration
 syntax, and provide lots of features from dnsmasq, and also provide features
 such as block lists from [pi-hole](https://pi-hole.net/).
 We are at a point where the [basic unikernel (our MVP)](https://github.com/robur-coop/dnsvizor)
 - providing DNS and DHCP services - is ready, and we provide
 [reproducible binary builds](https://builds.robur.coop/job/dnsvizor). Phew. This
 means that the first step is done. The `--dhcp-range` from dnsmasq is already
 being parsed.
 We are now curious on concrete usages of dnsmasq and the configurations you use.
 If you're interested in dnsvizor, please [open an issue at our repository](https://github.com/robur-coop/dnsvizor/issues/new)
 with your dnsmasq configuration. This will help us to guide which parts of the configuration to prioritize.
 ## Usages of DNSvizor
 We have several use cases for DNSvizor:
 - at your home router to provide DNS resolution and DHCP service, filtering ads,
 - in the datacenter auto-configuring your machine park,
 - when running your unikernel swarm to auto-configure them.
 The first one is where pi-hole as well fits into, and where dnsmasq is used quite
 a lot. The second one is also a domain where dnsmasq is used. The third one is
 from our experience that lots of people struggle with deploying MirageOS
 unikernels since they have to manually do IP configuration etc. We ourselves
 also pass additional information to the unikernels, such as syslog host,
 monitoring sink, X.509 certificates or host names, do some DNS provisioning, ...
 With DNSvizor we will leverage the common configuration options of all
 unikernels (reducing the need for boot arguments), and also go a bit further
 and make deployment seamless (including adding hostnames to DNS, forwarding
 from our reverse TLS proxy, etc.).
 ## Conclusion
 [DNSvizor](https://github.com/robur-coop/dnsvizor) provides DNS resolution and
 DHCP service for your network, and [already exists](https://builds.robur.coop/job/dnsvizor) :).
 Please [report issues](https://github.com/robur-coop/dnsvizor/issues/) you
 encounter and questions you may have. Also, if you use dnsmasq, please
 [show us your configuration](https://github.com/robur-coop/dnsvizor/issues/new).
 If you're interested in MirageOS and using it in your domain, don't hesitate
 to reach out to us (via eMail: team@robur.coop) - we're keen to deploy MirageOS
 and find more domains where it is useful. If you can
 [spare a dime](https://robur.coop/Donate), we're a registered non-profit in
 Germany - and can provide tax-deductable receipts in Europe.
--- a/articles/finances.md
+++ b/articles/finances.md
@ -0,0 +1,302 @@
 ---
 date: 2024-10-21
 title: How has robur financially been doing since 2018?
 description: How we organise as a collective, and why we're doing that.
 tags:
  - finances
  - cooperative
 author:
  name: Hannes Mehnert
  email: hannes@mehnert.org
  link: https://hannes.robur.coop
 ---
 Since the beginning, robur has been working on MirageOS unikernels and getting
 them deployed. Due to our experience in hierarchical companies, we wanted to
 create something different - a workplace without bosses and management. Instead,
 we are a collective where everybody has a say on what we do, and who gets how
 much money at the end of the month. This means nobody has to write report and
 meet any goals - there's no KPI involved. We strive to be a bunch of people
 working together nicely and projects that we own and want to bring forward. If
 we discover lack of funding, we reach out to (potential) customers to fill our
 cash register. Or reach out to people to donate money.
 Since our mission is fulfilling and already complex - organising ourselves in a
 hierarchy-free environment, including the payment, and work on software in a
 niche market - we decided from the early days that bookeeping and invoicing
 should not be part of our collective. Especially since we want to be free in
 what kind of funding we accept - donations, commercial contracts, public
 funding. In the books, robur is part of the non-profit company
 [Änderwerk](https://aenderwerk.de) in Germany - and friends of ours run that
 company. They get a cut on each income we generate.
 To be inclusive and enable everyone to participate in decisions, we are 100%
 transparent in our books - every collective member has access to the financial
 spreadsheets, contracts, etc. We use a needs-based payment model, so we talk
 about the needs everyone has on a regular basis and adjust the salary, everyone
 agreeing to all the numbers.
 ## 2018
 We started operations in 2018. In late 2017, we got donations (in the form of
 bitcoins) by friends who were convinced of our mission. This was 54,194.91 €.
 So, in 2018 we started with that money, and tried to find a mission, and
 generate income to sustain our salaries.
 Also, already in 2017, we applied for funding from
 [Prototypefund](https://prototypefund.de) on a [CalDAV server](https://prototypefund.de/project/robur-io/),
 and we received the grant in early 2018. This was another 48,500 €, paid to
 individuals (due to reasons, Prototype fund can't cash out to the non-profit -
 this put us into some struggle, since we needed some double bookkeeping and
 individuals had to dig into health care etc.).
 We also did in the second half of 2018 a security audit for
 [Least Authority](https://leastauthority.com/blog/audits/five-security-audits-for-the-tezos-foundation/)
 (invoicing 19,600 €).
 And later in 2018 we started on what is now called NetHSM with an initial
 design workshop (5,000 €).
 And lastly, we started to work on a grant to implement [TLS 1.3](https://datatracker.ietf.org/doc/html/rfc8446),
 funded by Jane Street (via OCaml Labs Consulting). In 2018, we received 12,741.71 €
 We applied at NLNet for improving the QubesOS firewall developed in MirageOS
 (without success), tried to get the IT security prize in Germany (without
 success), and to DIAL OSC (without success).
 | Project         |    Amount |
 |-----------------|----------:|
 | Donation        |  54,194.91 |
 | Prototypefund   |  48,500.00 |
 | Least Authority |  19,600.00 |
 | TLS 1.3         |  12,741.71 |
 | Nitrokey        |   5,000.00 |
 | __Total__           | __140,036.62__ |
 ## 2019
 We were keen to finish the CalDAV implementation (and start a CardDAV
 implementation), and received some financial support from Tarides for it
 (15,000 €).
 The TLS 1.3 work continued, we got in total 68,887.53 €.
 We also applied to (and got funding from) Prototypefund, once with an [OpenVPN-compatible
 MirageOS unikernel](https://prototypefund.de/en/project/robust-openvpn-client-with-low-use-of-resources/),
 and once with [improving the QubesOS firewall developed as MirageOS unikernel](https://prototypefund.de/project/portable-firewall-fuer-qubesos/).
 This means again twice 48,500 €.
 We also started the implementation work of NetHSM - which still included a lot
 of design work - in total the contract was over 82,500 €. In 2019, we invoiced
 Nitrokey in 2019 in total 40,500 €.
 We also received a total of 516.48 € as donations from source unknown to us.
 We also applied to NLnet with [DNSvizor](https://nlnet.nl/project/Robur/), and
 got a grant, but due to buerocratic reasons they couldn't transfer the money to
 our non-profit (which was involved with NLnet in some EU grants), and we didn't
 get any money in the end.
 | Project  |    Amount |
 |----------|----------:|
 | CardDAV  |  15,000.00 |
 | TLS 1.3  |  68,887.53 |
 | OpenVPN  |  48,500.00 |
 | QubesOS  |  48,500.00 |
 | Donation |    516.48 |
 | Nitrokey |  40,500.00 |
 | __Total__    | __221,904.01__ |
 ## 2020
 In 2020, we agreed with OCaml Labs Consulting to work on maintenance of OCaml
 packages in the MirageOS ecosystem. This was a contract where at the end of the
 month, we reported on which PRs and issues we spent how much time. For us, this
 was great to have the freedom to work on which OCaml packages we were keen to
 get up to speed. In 2020, we received 45,000 € for this maintenance.
 We finished the TLS 1.3 work (18,659.01 €)
 We continued to work on the NetHSM project, and invoiced 55,500 €.
 We received a total of 255 € in donations from sources unknown to us.
 We applied at reset.tech again with DNSvizor, unfortunately without success.
 We also applied at [NGI pointer](https://pointer.ngi.eu) to work on reproducible
 builds for MirageOS, and a web frontend. Here we got the grant of 200,000 €,
 which we worked on in 2021 and 2022.
 | Project   |    Amount |
 |-----------|----------:|
 | OCLC      |  45,000.00 |
 | TLS 1.3   |  18,659.01 |
 | Nitrokey  |  55,500.00 |
 | Donations |    255.00 |
 | __Total__     | __119,414.01__ |
 ## 2021
 As outlined, we worked on reproducible builds of unikernels - rethinking the way
 how a unikernel is configured: no more compiled-in secrets, but instead using
 boot parameters. We setup the infrastructure for doing daily reproducible
 builds, serving system packages via a package repository, and a
 [web frontend](https://builds.robur.coop) hosting the reproducible builds.
 We received in total 120,000 € from NGI Pointer in 2021.
 Our work on NetHSM continued, including the introduction of elliptic curves
 in mirage-crypto (using [fiat](https://github.com/mit-plv/fiat-crypto/)). The
 invoices to Nitrokey summed up to 26,000 € in 2021.
 We developed in a short timeframe two packages, [u2f](https://github.com/robur-coop/u2f)
 and later [webauthn](https://git.robur.coop/robur/webauthn) for Skolem Labs based
 on [gift economy](https://en.wikipedia.org/wiki/Gift_economy). This resulted in
 donations of 18,976 €.
 We agreed with [OCSF](https://ocaml-sf.org/) to work on
 [conex](https://github.com/hannesm/conex), which we have not delivered yet
 (lots of other things had to be cleared first: we did a security review of opam
 (leading to [a security advisory](https://opam.ocaml.org/blog/opam-2-1-5-local-cache/)),
 we got rid of [`extra-files`](https://discuss.ocaml.org/t/ann-opam-repository-policy-change-checksums-no-md5-and-no-extra-files)
 in the opam-repository, and we [removed the weak hash md5](https://discuss.ocaml.org/t/ann-opam-repository-policy-change-checksums-no-md5-and-no-extra-files)
 from the opam-repository.
 | Customer    |    Amount |
 |-------------|----------:|
 | NGI Pointer | 120,000.00 |
 | Nitrokey    |  26,000.00 |
 | Skolem      |  18,976.00 |
 | __Total__       | __164,976.00__ |
 ## 2022
 We finished our NGI pointer project, and received another 80,000 €.
 We also did some minor maintenance for Nitrokey, and invoiced 4,500 €.
 For Tarides, we started another maintaining MirageOS packages (and continuing
 [our TCP/IP stack](https://github.com/robur-coop/utcp)), and invoiced in
 total 22,500 €.
 A grant application for [bob](https://github.com/dinosaure/bob/) was rejected,
 but a grant application for [MirageVPN](https://github.com/robur-coop/miragevpn)
 got accepted. Both at NLnet within the EU NGI project.
 | Project     |   Amount |
 |-------------|---------:|
 | NGI Pointer | 80,000.00 |
 | Nitrokey    |  4,500.00 |
 | Tarides     | 22,500.00 |
 | __Total__       | __107,000.00__ |
 ## 2023
 We finished the NetHSM project, and had a final invoice over 2,500 €.
 We started a collaboration for [semgrep](https://semgrep.dev), porting some of
 their Python code to OCaml. We received in total 37,500 €.
 We continued the MirageOS opam package maintenance and invoiced in total
 89,250 € to Tarides.
 A grant application on [MirageVPN](https://nlnet.nl/project/MirageVPN/) got
 accepted (NGI Assure), and we received in total 12,000 € for our work on it.
 This is a continuation of our 2019 work funded by Prototypefund.
 We also wrote various funding applications, including one for
 [DNSvizor](https://github.com/robur-coop/dnsvizor) that was
 [accepted](https://nlnet.nl/project/DNSvizor/) (NGI0 Entrust).
 | Customer  |   Amount |
 |-----------|---------:|
 | Nitrokey  |  2,500.00 |
 | semgrep   | 37,500.00 |
 | Tarides   | 89,250.00 |
 | MirageVPN | 12,000.00 |
 | __Total__     | __141,250.00__ |
 ## 2024
 We're still in the middle of it, but so far we continued the Tarides maintenance
 contract (54,937.50 €).
 We also finished the MirageVPN work, and received another 45,000 €.
 We had a contract with Semgrep again on porting Python code to OCaml and received 18,559.40 €.
 We again worked on several successful funding applications, one on
 [PTT](https://nlnet.nl/project/PTT/) (NGI Zero Core), a continuation of the
 [NGI DAPSI](https://www.ngi.eu/funded_solution/ngi-dapsiproject-24/) project -
 now realizing mailing lists with our SMTP stack.
 We also got [MTE](https://nlnet.nl/project/MTE/) (NGI Taler) accepted.
 The below table is until end of September 2024.
 | Project   |    Amount |
 |-----------|----------:|
 | Semgrep   |  18,559.40 |
 | Tarides   |  62,812.50 |
 | MirageVPN |  45,000.00 |
 | __Total__     | __126,371.90__ |
 ## Total
 In a single table, here's our income since robur started.
 |  Year |     Amount |
 |-------|-----------:|
 |  2018 |  140,036.62 |
 |  2019 |  221,904.01 |
 |  2020 |  119,414.01 |
 |  2021 |  164,976.00 |
 |  2022 |  107,000.00 |
 |  2023 |  141,250.00 |
 |  2024 |  126,371.90 |
 | __Total__ | __1,020,952.54__ |
 ![Plot of above income table](../images/finances.png)
 As you can spot, it varies quite a bit. In some years we have fewer money
 available than in other years.
 ## Expenses
 As mentioned, the non-profit company [Änderwerk](https://aenderwerk.de) running
 the bookkeeping and legal stuff (invoices, tax statements, contracts, etc.) gets
 a cut on each income we produce. They are doing amazing work and are very
 quick responding to our queries.
 We spend most of our income on salary. Some money we spend on travel. We also
 pay monthly for our server (plus some extra for hardware, and in June 2024 a
 huge amount for trying to recover data from failed SSDs).
 ## Conclusion
 We have provided an overview of our income, we were three to five people working
 at robur over the entire time. As written at the beginning, we use needs-based
 payment. Our experience with this is great! It provides a lot of trust into each
 other.
 Our funding is diverse from multiple sources - donations, commercial work,
 public funding. This was our initial goal, and we're very happy that it works
 fine over the last five years.
 Taking the numbers into account, we are not paying ourselves "industry standard"
 rates - but we really love what we do - and sometimes we just take some time off.
 We do work on various projects that we really really enjoy - but where (at the
 moment) no funding is available for.
 We are always happy to discuss how our collective operates. If you're
 interested, please drop us a message.
 Of course, if we receive donations, we use them wisely - mainly for working on
 the currently not funded projects (bob, albatross, miou, mollymawk - to name a few). If you
 can spare a dime or two, don't hesitate to [donate](https://robur.coop/Donate).
 Donations are tax-deductable in Germany (and should be in Europe) since we're a
 registered non-profit.
 If you're interested in MirageOS and using it in your domain, don't hesitate
 to reach out to us (via eMail: team@robur.coop) so we can start to chat - we're keen to deploy MirageOS
 and find more domains where it is useful.
--- a/articles/gptar-update.md
+++ b/articles/gptar-update.md
@ -0,0 +1,110 @@
 ---
 title: GPTar (update)
 date: 2024-10-28
 description: libarchive vs hybrid GUID partition table and GNU tar volume header
 tags:
  - OCaml
  - gpt
  - tar
  - mbr
  - persistent storage
 author:
  name: Reynir Björnsson
  email: reynir@reynir.dk
  link: https://reyn.ir/
 ---
 In a [previous post][gptar-post] I describe how I craft a hybrid GUID partition table (GPT) and tar archive by exploiting that there are disjoint areas of a 512 byte *block* that are important to tar headers and *protective* master boot records used in GPT respectively.
 I recommend reading it first if you haven't already for context.
 After writing the above post I read an excellent and fun *and totally normal* article by Emily on how [she created **executable** tar archives][tar-executable].
 Therein I learned a clever hack:
 GNU tar has a tar extension for *volume headers*.
 These are essentially labels for your tape archives when you're forced to split an archive across multiple tapes.
 They can (seemingly) hold any text as label including shell scripts.
 What's more is GNU tar and bsdtar **does not** extract these as files!
 This is excellent, because I don't actually want to extract or list the GPT header when using GNU tar or bsdtar.
 This prompted me to [use a different link indicator](https://github.com/reynir/gptar/pull/1).
 This worked pretty great.
 Listing the archive using GNU tar I still get `GPTAR`, but with verbose listing it's displayed as a `--Volume Header--`:
 ```shell
 $ tar -tvf disk.img
 Vr-------- 0/0           16896 1970-01-01 01:00 GPTAR--Volume Header--
 -rw-r--r-- 0/0              14 1970-01-01 01:00 test.txt
 ```
 And more importantly the `GPTAR` entry is ignored when extracting:
 ```shell
 $ mkdir tmp
 $ cd tmp/
 $ tar -xf ../disk.img
 $ ls
 test.txt
 ```
 ## BSD tar / libarchive
 Unfortunately, this broke bsdtar!
 ```shell
 $ bsdtar -tf disk.img
 bsdtar: Damaged tar archive
 bsdtar: Error exit delayed from previous errors.
 ```
 This is annoying because we run FreeBSD on the host for [opam.robur.coop](https://opam.robur.coop), our instance of [opam-mirror][opam-mirror].
 This Autumn we updated [opam-mirror][opam-mirror] to use the hybrid GPT+tar GPTar *tartition table*[^tartition] instead of hard coded or boot parameter specified disk offsets for the different partitions - which was extremely brittle!
 So we were no longer able to inspect the contents of the tar partition from the host!
 Unacceptable!
 So I started to dig into libarchive where bsdtar comes from.
 To my surprise, after building bsdtar from the git clone of the source code it ran perfectly fine!
 ```shell
 $ ./bsdtar -tf ../gptar/disk.img
 test.txt
 ```
 I eventually figure out [this change][libarchive-pr] fixed it for me.
 I got in touch with Emily to let her know that bsdtar recently fixed this (ab)use of GNU volume headers.
 Her reply was basically "as of when I wrote the article, I was pretty sure bsdtar ignored it."
 And indeed it did.
 Examining the diff further revealed that it ignored the GNU volume header - just not "correctly" when the GNU volume header was abused to carry file content as I did:
 ```diff
 /*
  * Interpret 'V' GNU tar volume header.
  */
 static int
 header_volume(struct archive_read *a, struct tar *tar,
     struct archive_entry *entry, const void *h, size_t *unconsumed)
 {
 -       (void)h;
 +       const struct archive_entry_header_ustar *header;
 +       int64_t size, to_consume;
 +
 +       (void)a; /* UNUSED */
 +       (void)tar; /* UNUSED */
 +       (void)entry; /* UNUSED */
 -       /* Just skip this and read the next header. */
 -       return (tar_read_header(a, tar, entry, unconsumed));
 +       header = (const struct archive_entry_header_ustar *)h;
 +       size = tar_atol(header->size, sizeof(header->size));
 +       to_consume = ((size + 511) & ~511);
 +       *unconsumed += to_consume;
 +       return (ARCHIVE_OK);
 }
 ```
 So thanks to the above change we can expect a release of libarchive supporting further flavors of abuse of GNU volume headers!
 🥳
 [gptar-post]: gptar.html
 [tar-executable]: https://uni.horse/executable-tarballs.html
 [opam-mirror]: https://git.robur.coop/robur/opam-mirror/
 [libarchive-pr]: https://github.com/libarchive/libarchive/pull/2127
 [^tartition]: Emily came up with the much better term "tartition table" than what I had come up with - "GPTar".
--- a/articles/gptar.md
+++ b/articles/gptar.md
@ -1,7 +1,7 @@
 ---
 date: 2024-02-21
-article.title: GPTar
+title: GPTar
-article.description: Hybrid GUID partition table and tar archive
+description: Hybrid GUID partition table and tar archive
 tags:
  - OCaml
  - gpt
--- a/articles/lwt_pause.md
+++ b/articles/lwt_pause.md
@ -1,7 +1,7 @@
 ---
 date: 2024-02-11
-article.title: Cooperation and Lwt.pause
+title: Cooperation and Lwt.pause
-article.description:
+description:
  A disgression about Lwt and Miou
 tags:
  - OCaml
@ -9,6 +9,10 @@ tags:
  - Community
  - Unikernel
  - Git
 author:
  name: Romain Calascibetta
  email: romain.calascibetta@gmail.com
  link: https://blog.osau.re/
 breaks: false
 ---
--- a/articles/miragevpn-ncp.md
+++ b/articles/miragevpn-ncp.md
@ -1,7 +1,7 @@
 ---
 date: 2023-11-20
-article.title: MirageVPN updated (AEAD, NCP)
+title: MirageVPN updated (AEAD, NCP)
-article.description:
+description:
  How we resurrected MirageVPN from its bitrot state
 tags:
  - OCaml
@ -16,7 +16,7 @@ author:
 ## Updating MirageVPN
-As announced [earlier this month](https://blog.robur.coop/articles/miragevpn.html), we've been working hard over the last months on MirageVPN (initially developed in 2019, targeting OpenVPN™ 2.4.7, now 2.6.6). We managed to receive funding from [NGI Assure](https://www.assure.ngi.eu/) call (via [NLnet](https://nlnet.nl)). We've made over 250 commits with more than 10k lines added, and 18k lines removed. We closed nearly all old issues, and opened 100 fresh ones, of which we already closed more than half of them. :D
+As announced [earlier this month](miragevpn.html), we've been working hard over the last months on MirageVPN (initially developed in 2019, targeting OpenVPN™ 2.4.7, now 2.6.6). We managed to receive funding from [NGI Assure](https://www.assure.ngi.eu/) call (via [NLnet](https://nlnet.nl)). We've made over 250 commits with more than 10k lines added, and 18k lines removed. We closed nearly all old issues, and opened 100 fresh ones, of which we already closed more than half of them. :D
 ### Actual bugs fixed (that were leading to non-working MirageVPN applications)
@ -29,7 +29,7 @@ To avoid any future breakage while revising the code (cleaning it up, extending
 ### New features: AEAD ciphers, supporting more configuration primitives
-We added various configuration primitives, amongst them configuratble tls ciphersuites, minimal and maximal tls version to use, [tls-crypt-v2](https://blog.robur.coop/articles/miragevpn.html), verify-x509-name, cipher,  remote-random, ...
+We added various configuration primitives, amongst them configuratble tls ciphersuites, minimal and maximal tls version to use, [tls-crypt-v2](miragevpn.html), verify-x509-name, cipher,  remote-random, ...
 From a cryptographic point of view, we are now supporting more [authentication hashes](https://github.com/robur-coop/miragevpn/pull/108) via the configuration directive `auth`, namely the SHA2 family - previously, only SHA1 was supported, [AEAD ciphers](https://github.com/robur-coop/miragevpn/pull/125) (AES-128-GCM, AES-256-GCM, CHACHA20-POLY1305) - previously only AES-256-CBC was supported.
--- a/articles/miragevpn-performance.md
+++ b/articles/miragevpn-performance.md
@ -1,7 +1,7 @@
 ---
 date: 2024-04-16
-article.title: Speeding up MirageVPN and use it in the wild
+title: Speeding up MirageVPN and use it in the wild
-article.description:
+description:
  Performance engineering of MirageVPN, speeding it up by a factor of 25.
 tags:
  - OCaml
@ -19,10 +19,9 @@ coauthors:
      name: Reynir Björnsson
      email: reynir@reynir.dk
      link: https://reyn.ir/
    contribution: What is this field used for?
 ---
-As we were busy continuing to work on [MirageVPN](https://github.com/robur-coop/miragevpn), we got in touch with [eduVPN](https://eduvpn.org), who are interested about deploying MirageVPN. We got example configuration from their side, and [fixed](https://github.com/robur-coop/miragevpn/pull/201) [some](https://github.com/robur-coop/miragevpn/pull/168) [issues](https://github.com/robur-coop/miragevpn/pull/202), and also implemented [tls-crypt](https://github.com/robur-coop/miragevpn/pull/169) - which was straightforward since we earlier spend time to implement [tls-crypt-v2](https://blog.robur.coop/articles/miragevpn.html).
+As we were busy continuing to work on [MirageVPN](https://github.com/robur-coop/miragevpn), we got in touch with [eduVPN](https://eduvpn.org), who are interested about deploying MirageVPN. We got example configuration from their side, and [fixed](https://github.com/robur-coop/miragevpn/pull/201) [some](https://github.com/robur-coop/miragevpn/pull/168) [issues](https://github.com/robur-coop/miragevpn/pull/202), and also implemented [tls-crypt](https://github.com/robur-coop/miragevpn/pull/169) - which was straightforward since we earlier spend time to implement [tls-crypt-v2](miragevpn.html).
 In January, they gave MirageVPN another try, and [measured the performance](https://github.com/robur-coop/miragevpn/issues/206) -- which was very poor -- MirageVPN (run as a Unix binary) provided a bandwith of 9.3Mb/s, while OpenVPN provided a bandwidth of 360Mb/s (using a VPN tunnel over TCP).
@ -46,7 +45,7 @@ The learnings of our performance engineering are in three areas:
 ## Conclusion
-To conclude: we already achieved a factor of 25 in performance by adapting the code in various ways. We have ideas to improve the performance even more in the future - we also work on using OCaml string and bytes, instead of off-the-OCaml-heap-allocated bigarrays (see [our previous article](https://blog.robur.coop/articles/speeding-ec-string.html), which provided some speedups).
+To conclude: we already achieved a factor of 25 in performance by adapting the code in various ways. We have ideas to improve the performance even more in the future - we also work on using OCaml string and bytes, instead of off-the-OCaml-heap-allocated bigarrays (see [our previous article](speeding-ec-string.html), which provided some speedups).
 Don't hesitate to reach out to us on [GitHub](https://github.com/robur-coop/miragevpn/issues), or [by mail](https://robur.coop/Contact) if you're stuck.
--- a/articles/miragevpn-server.md
+++ b/articles/miragevpn-server.md
@ -1,7 +1,7 @@
 ---
 date: 2024-06-17
-article.title: MirageVPN server
+title: MirageVPN server
-article.description:
+description:
  Announcement of our MirageVPN server.
 tags:
  - OCaml
@ -18,12 +18,11 @@ coauthors:
      name: Reynir Björnsson
      email: reynir@reynir.dk
      link: https://reyn.ir/
    contribution: What is this field used for?
 ---
 It is a great pleasure to finally announce that we have finished a server implementation for MirageVPN (OpenVPN™-compatible). This allows to setup a very robust VPN network on both the client and the server side.
-As announced last year, [MirageVPN](https://blog.robur.coop/articles/miragevpn.html) is a reimplemtation of OpenVPN™ in OCaml, with [MirageOS](https://mirage.io) unikernels.
+As announced last year, [MirageVPN](miragevpn.html) is a reimplemtation of OpenVPN™ in OCaml, with [MirageOS](https://mirage.io) unikernels.
 ## Why a MirageVPN server?
--- a/articles/miragevpn-testing.md
+++ b/articles/miragevpn-testing.md
@ -0,0 +1,54 @@
 ---
 date: 2024-06-26
 title: Testing MirageVPN against OpenVPN™
 description: Some notes about how we test MirageVPN against OpenVPN™
 tags:
  - OCaml
  - MirageOS
  - cryptography
  - security
  - testing
  - vpn
 author:
  name: Reynir Björnsson
  email: reynir@reynir.dk
  link: https://reyn.ir/
 ---
 As our last milestone for the [EU NGI Assure](https://www.assure.ngi.eu/) funded MirageVPN project (for now) we have been working on testing MirageVPN, our OpenVPN™-compatible VPN implementation against the upstream OpenVPN™.
 During the development we have conducted many manual tests.
 However, this scales poorly and it is easy to forget testing certain cases.
 Therefore, we designed and implemented interoperability testing, driving the C implementation on the one side, and our OCaml implementation on the other side. The input for such a test is a configuration file that both implementations can use.
 Thus we test establishment of the tunnel as well as the tunnel itself.
 While conducting the tests, our instrumented binaries expose code coverage information. We use that to guide ourselves which other configurations are worth testing. Our goal is to achieve a high code coverage rate while using a small amount of different configurations. These interoperability tests are running fast enough, so they are executed on each commit by CI.
 A nice property of this test setup is that it runs with an unmodified OpenVPN binary.
 This means we can use an off-the-shelf OpenVPN binary from the package repository and does not entail further maintenance of an OpenVPN fork.
 Testing against a future version of OpenVPN becomes trivial.
 We do not just test a single part of our implementation but achieve an end-to-end test.
 The same configuration files are used for both our implementation and the C implementation, and each configuration is used twice, once our implementation acts as the client, once as the server.
 We added a flag to our client and our [recently finished server](miragevpn-server) applications, `--test`, which make them to exit once a tunnel is established and an ICMP echo request from the client has been replied to by the server.
 Our client and server can be run without a tun device which otherwise would require elevated privileges.
 Unfortunately, OpenVPN requires privileges to at least configure a tun device.
 Our MirageVPN implementation does IP packet parsing in userspace.
 We test our protocol implementation, not the entire unikernel - but the unikernel code is a tiny layer on top of the purely functional protocol implementation.
 We explored unit testing the packet decoding and decryption with our implementation and the C implementation.
 Specifically, we encountered a packet whose message authentication code (MAC) was deemed invalid by the C implementation.
 It helped us discover the MAC computation was correct but the packet encoding was truncated - both implementations agreed that the MAC was bad.
 The test was very tedious to write and would not easily scale to cover a large portion of the code.
 If of interest, take a look into our [modifications to OpenVPN](https://github.com/reynir/openvpn/tree/badmac-test) and [modifications to MirageVPN](https://github.com/robur-coop/miragevpn/tree/badmac-test).
 The end-to-end testing is in addition to our unit tests and fuzz testing; and to our [benchmarking](miragevpn-performance.html) binary.
 Our results are that with 4 configurations we achieve above 75% code coverage in MirageVPN.
 While investigating the code coverage results, we found various pieces of code that were never executed, and we were able to remove them.
 Code that does not exist is bug-free :D
 With these tests in place future maintenance is less daunting as they will help us guard us from breaking the code.
 At the moment we do not exercise the error paths very well in the code.
 This is much less straightforward to test in this manner, and is important future work.
 We plan to develop a client and server that injects faults at various stages of the protocol to test these error paths.
 OpenVPN built with debugging enabled also comes with a `--gremlin` mode that injects faults, and would be interesting to investigate.
--- a/articles/miragevpn.md
+++ b/articles/miragevpn.md
@ -1,7 +1,7 @@
 ---
 date: 2023-11-14
-article.title: MirageVPN & tls-crypt-v2
+title: MirageVPN & tls-crypt-v2
-article.description:
+description:
  How we implementated tls-crypt-v2 for miragevpn
 tags:
  - OCaml
--- a/articles/qubes-miragevpn.md
+++ b/articles/qubes-miragevpn.md
@ -1,7 +1,7 @@
 ---
 date: 2024-06-24
-article.title: qubes-miragevpn, a MirageVPN client for QubesOS
+title: qubes-miragevpn, a MirageVPN client for QubesOS
-article.description: A new OpenVPN client for QubesOS
+description: A new OpenVPN client for QubesOS
 tags:
  - OCaml
  - vpn
--- a/articles/speeding-ec-string.md
+++ b/articles/speeding-ec-string.md
@ -1,7 +1,7 @@
 ---
 date: 2024-02-13
-article.title: Speeding elliptic curve cryptography
+title: Speeding elliptic curve cryptography
-article.description:
+description:
  How we improved the performance of elliptic curves by only modifying the underlying byte array
 tags:
  - OCaml
@ -93,6 +93,6 @@ As a spoiler, for P-256 sign there's another improvement of around 4.5 with [Vir
 Remove all cstruct, everywhere, apart from in mirage-block-xen and mirage-net-xen ;). It was a fine decision in the early MirageOS days, but from a performance point of view, and for making our packages more broadly usable without many dependencies, it is time to remove cstruct. Earlier this year we already [removed cstruct from ocaml-tar](https://github.com/mirage/ocaml-tar/pull/137) for similar reasons.
-Our MirageOS work is only partially funded, we cross-fund our work by commercial contracts and public (EU) funding. We are part of a non-profit company, you can make a (tax-deducable - at least in the EU) [donation](https://aenderwerk.de/donate/) (select "DONATION robur" in the dropdown menu).
+Our MirageOS work is only partially funded, we cross-fund our work by commercial contracts and public (EU) funding. We are part of a non-profit company, you can make a (tax-deductable - at least in the EU) [donation](https://aenderwerk.de/donate/) (select "DONATION robur" in the dropdown menu).
 We're keen to get MirageOS deployed in production - if you would like to do that, don't hesitate to reach out to us via eMail team at robur.coop
--- a/articles/tar-release.md
+++ b/articles/tar-release.md
@ -1,7 +1,7 @@
 ---
 date: 2024-08-15
-article.title: The new Tar release, a retrospective
+title: The new Tar release, a retrospective
-article.description: A little retrospective to the new Tar release and changes
+description: A little retrospective to the new Tar release and changes
 tags:
  - OCaml
  - Cstruct
--- a/bin/blog.ml
+++ b/bin/blog.ml
@ -0,0 +1,681 @@
 open Yocaml
 module SM = Map.Make(String)
 let is_empty_list = function [] -> true | _ -> false
 module Date = struct
  type month =
    | Jan
    | Feb
    | Mar
    | Apr
    | May
    | Jun
    | Jul
    | Aug
    | Sep
    | Oct
    | Nov
    | Dec
  type day_of_week = Mon | Tue | Wed | Thu | Fri | Sat | Sun
  type year = int
  type day = int
  type hour = int
  type min = int
  type sec = int
  type t = {
      year : year
    ; month : month
    ; day : day
    ; hour : hour
    ; min : min
    ; sec : sec
  }
  let invalid_int x message =
    Data.Validation.fail_with ~given:(string_of_int x) message
  let month_from_int x =
    if x > 0 && x <= 12 then
      Result.ok
        [| Jan; Feb; Mar; Apr; May; Jun; Jul; Aug; Sep; Oct; Nov; Dec |].(x - 1)
    else invalid_int x "Invalid month value"
  let year_from_int x =
    if x >= 0 then Result.ok x else invalid_int x "Invalid year value"
  let is_leap year =
    if year mod 100 = 0 then year mod 400 = 0 else year mod 4 = 0
  let days_in_month year month =
    match month with
    | Jan | Mar | May | Jul | Aug | Oct | Dec -> 31
    | Feb -> if is_leap year then 29 else 28
    | _ -> 30
  let day_from_int year month x =
    let dim = days_in_month year month in
    if x >= 1 && x <= dim then Result.ok x
    else invalid_int x "Invalid day value"
  let hour_from_int x =
    if x >= 0 && x < 24 then Result.ok x else invalid_int x "Invalid hour value"
  let min_from_int x =
    if x >= 0 && x < 60 then Result.ok x else invalid_int x "Invalid min value"
  let sec_from_int x =
    if x >= 0 && x < 60 then Result.ok x else invalid_int x "Invalid sec value"
  let ( let* ) = Result.bind
  let make ?(time = (0, 0, 0)) ~year ~month ~day () =
    let hour, min, sec = time in
    let* year = year_from_int year in
    let* month = month_from_int month in
    let* day = day_from_int year month day in
    let* hour = hour_from_int hour in
    let* min = min_from_int min in
    let* sec = sec_from_int sec in
    Result.ok { year; month; day; hour; min; sec }
  let validate_from_datetime_str str =
    let str = String.trim str in
    match
      Scanf.sscanf_opt str "%04d%c%02d%c%02d%c%02d%c%02d%c%02d"
        (fun year _ month _ day _ hour _ min _ sec ->
          ((hour, min, sec), year, month, day))
    with
    | None -> Data.Validation.fail_with ~given:str "Invalid date format"
    | Some (time, year, month, day) -> make ~time ~year ~month ~day ()
  let validate_from_date_str str =
    let str = String.trim str in
    match
      Scanf.sscanf_opt str "%04d%c%02d%c%02d" (fun year _ month _ day ->
          (year, month, day))
    with
    | None -> Data.Validation.fail_with ~given:str "Invalid date format"
    | Some (year, month, day) -> make ~year ~month ~day ()
  let validate =
    let open Data.Validation in
    string & (validate_from_datetime_str / validate_from_date_str)
  let month_to_int = function
    | Jan -> 1
    | Feb -> 2
    | Mar -> 3
    | Apr -> 4
    | May -> 5
    | Jun -> 6
    | Jul -> 7
    | Aug -> 8
    | Sep -> 9
    | Oct -> 10
    | Nov -> 11
    | Dec -> 12
  let dow_to_int = function
    | Mon -> 0
    | Tue -> 1
    | Wed -> 2
    | Thu -> 3
    | Fri -> 4
    | Sat -> 5
    | Sun -> 6
  let compare_date a b =
    let cmp = Int.compare a.year b.year in
    if Int.equal cmp 0 then
      let cmp = Int.compare (month_to_int a.month) (month_to_int b.month) in
      if Int.equal cmp 0 then Int.compare a.day b.day else cmp
    else cmp
  let compare_time a b =
    let cmp = Int.compare a.hour b.hour in
    if Int.equal cmp 0 then
      let cmp = Int.compare a.min b.min in
      if Int.equal cmp 0 then Int.compare a.sec b.sec else cmp
    else cmp
  let compare a b =
    let cmp = compare_date a b in
    if Int.equal cmp 0 then compare_time a b else cmp
  let pp_date ppf { year; month; day; _ } =
    Format.fprintf ppf "%04d-%02d-%02d" year (month_to_int month) day
  let month_value = function
    | Jan -> 0
    | Feb -> 3
    | Mar -> 3
    | Apr -> 6
    | May -> 1
    | Jun -> 4
    | Jul -> 6
    | Aug -> 2
    | Sep -> 5
    | Oct -> 0
    | Nov -> 3
    | Dec -> 5
  let day_of_week { year; month; day; _ } =
    let yy = year mod 100 in
    let cc = (year - yy) / 100 in
    let c_code = [| 6; 4; 2; 0 |].(cc mod 4) in
    let y_code = (yy + (yy / 4)) mod 7 in
    let m_code =
      let v = month_value month in
      if is_leap year && (month = Jan || month = Feb) then v - 1 else v
    in
    let index = (c_code + y_code + m_code + day) mod 7 in
    [| Sun; Mon; Tue; Wed; Thu; Fri; Sat |].(index)
  let normalize ({ year; month; day; hour; min; sec } as dt) =
    let day_of_week = day_of_week dt in
    let open Data in
    record
      [
        ("year", int year); ("month", int (month_to_int month)); ("day", int day)
      ; ("hour", int hour); ("min", int min); ("sec", int sec)
      ; ("day_of_week", int (dow_to_int day_of_week))
      ; ("human", string (Format.asprintf "%a" pp_date dt))
      ]
  let to_archetype_date_time { year; month; day; hour; min; sec } =
    let time = (hour, min, sec) in
    let month = month_to_int month in
    Result.get_ok (Archetype.Datetime.make ~time ~year ~month ~day ())
 end
 module Page = struct
  let entity_name = "Page"
  class type t = object ('self)
    method title : string option
    method charset : string option
    method description : string option
    method tags : string list
    method with_host : string -> 'self
    method get_host : string option
  end
  class page ?title ?description ?charset ?(tags = []) () =
    object (_ : #t)
      method title = title
      method charset = charset
      method description = description
      method tags = tags
      val host = None
      method with_host v = {< host = Some v >}
      method get_host = host
    end
  let neutral = Result.ok @@ new page ()
  let validate fields =
    let open Data.Validation in
    let+ title = optional fields "title" string
    and+ description = optional fields "description" string
    and+ charset = optional fields "charset" string
    and+ tags = optional_or fields ~default:[] "tags" (list_of string) in
    new page ?title ?description ?charset ~tags ()
  let validate =
    let open Data.Validation in
    record validate
 end
 module Author = struct
  class type t = object
    method name : string
    method link : string
    method email : string
    method avatar : string option
  end
  let gravatar email =
    let tk = String.(lowercase_ascii (trim email)) in
    let hs = Digest.(to_hex (string tk)) in
    "https://www.gravatar.com/avatar/" ^ hs
  class author ~name ~link ~email ?(avatar = gravatar email) () =
    object (_ : #t)
      method name = name
      method link = link
      method email = email
      method avatar = Some avatar
    end
  let validate fields =
    let open Data.Validation in
    let+ name = required fields "name" string
    and+ link = required fields "link" string
    and+ email = required fields "email" string
    and+ avatar = optional fields "avatar" string in
    match avatar with
    | None -> new author ~name ~link ~email ()
    | Some avatar -> new author ~name ~link ~email ~avatar ()
  let validate =
    let open Data.Validation in
    record validate
  let normalize obj =
    let open Data in
    record
      [
        ("name", string obj#name); ("link", string obj#link)
      ; ("email", string obj#email); ("avatar", option string obj#avatar)
      ]
 end
 let robur_coop =
  new Author.author
    ~name:"The Robur Team" ~link:"https://robur.coop/"
    ~email:"team@robur.coop" ()
 module Article = struct
  let entity_name = "Article"
  class type t = object ('self)
    method title : string
    method description : string
    method charset : string option
    method tags : string list
    method date : Date.t
    method author : Author.t
    method co_authors : Author.t list
    method with_host : string -> 'self
    method get_host : string option
  end
  class article ~title ~description ?charset ?(tags = []) ~date ~author
    ?(co_authors = []) () =
    object (_ : #t)
      method title = title
      method description = description
      method charset = charset
      method tags = tags
      method date = date
      method author = author
      method co_authors = co_authors
      val host = None
      method with_host v = {< host = Some v >}
      method get_host = host
    end
  let title p = p#title
  let description p = p#description
  let date p = p#date
  let neutral =
    Data.Validation.fail_with ~given:"null" "Cannot be null"
    |> Result.map_error (fun error ->
           Required.Validation_error { entity = entity_name; error })
  let validate fields =
    let open Data.Validation in
    let+ title = required fields "title" string
    and+ description = required fields "description" string
    and+ charset = optional fields "charset" string
    and+ tags = optional_or fields ~default:[] "tags" (list_of string)
    and+ date = required fields "date" Date.validate
    and+ author =
      optional_or fields ~default:robur_coop "author" Author.validate
    and+ co_authors =
      optional_or fields ~default:[] "co-authors" (list_of Author.validate)
    in
    new article ~title ~description ?charset ~tags ~date ~author ~co_authors ()
  let validate =
    let open Data.Validation in
    record validate
  let normalize obj =
    Data.
      [
        ("title", string obj#title); ("description", string obj#description)
      ; ("date", Date.normalize obj#date); ("charset", option string obj#charset)
      ; ("tags", list_of string obj#tags)
      ; ("author", Author.normalize obj#author)
      ; ("co-authors", list_of Author.normalize obj#co_authors)
      ; ("host", option string obj#get_host)
      ]
 end
 module Articles = struct
  class type t = object ('self)
    method title : string option
    method description : string option
    method articles : (Path.t * Article.t) list
    method with_host : string -> 'self
    method get_host : string option
  end
  class articles ?title ?description articles =
    object (_ : #t)
      method title = title
      method description = description
      method articles = articles
      val host = None
      method with_host v = {< host = Some v >}
      method get_host = host
    end
  let sort_by_date ?(increasing = false) articles =
    List.sort
      (fun (_, articleA) (_, articleB) ->
        let r = Date.compare articleA#date articleB#date in
        if increasing then r else ~-r)
      articles
  let fetch (module P : Required.DATA_PROVIDER) ?increasing
      ?(filter = fun x -> x) ?(on = `Source) ~where ~compute_link path =
    Task.from_effect begin fun () ->
        let open Eff in
        let* files = read_directory ~on ~only:`Files ~where path in
        let+ articles =
          List.traverse
            (fun file ->
              let url = compute_link file in
              let+ metadata, _content =
                Eff.read_file_with_metadata (module P) (module Article) ~on file
              in
              (url, metadata))
            files
        in
        articles |> sort_by_date ?increasing |> filter end
  let compute_index (module P : Required.DATA_PROVIDER) ?increasing
      ?(filter = fun x -> x) ?(on = `Source) ~where ~compute_link path =
    let open Task in
    (fun x -> (x, ()))
    |>> second
          (fetch (module P) ?increasing ~filter ~on ~where ~compute_link path)
    >>> lift (fun (v, articles) ->
            new articles ?title:v#title ?description:v#description articles)
  let normalize (ident, article) =
    let open Data in
    record (("url", string @@ Path.to_string ident) :: Article.normalize article)
  let normalize obj =
    let open Data in
    [
      ("articles", list_of normalize obj#articles)
    ; ("has_articles", bool @@ is_empty_list obj#articles)
    ; ("title", option string obj#title)
    ; ("description", option string obj#description)
    ; ("host", option string obj#get_host)
    ]
 end
 module Tag = struct
  type t = {
    name : string;
    articles : (Path.t * Article.t) list;
  }
  let make ~name ~articles =
    { name; articles }
  let normalize_article (ident, article) =
    let open Data in
    record (("url", string @@ Path.to_string ident) :: Article.normalize article)
  let normalize { name; articles } =
    let open Data in
    [
      ("name", string name);
      ("articles", (list_of normalize_article) articles);
    ]
 end
 module Tags = struct
  class type t = object ('self)
    inherit Articles.t
    method tags : Tag.t list
  end
  class tags ?title ?description articles =
    object
      inherit Articles.articles ?title ?description articles as super
      method! title = Some "Tags"
      method tags =
        let tags =
          let update article sm tag =
            SM.update tag
              (function
                | None -> Some [article]
                | Some urls -> Some (article :: urls))
              sm
          in
          List.fold_left
            (fun sm (url, article) ->
               List.fold_left (update (url, article)) sm article#tags)
            SM.empty
            super#articles
          |> SM.bindings
        in
        List.map (fun (tag, articles) ->
            Tag.make ~name:tag ~articles)
          tags
    end
  let of_articles articles =
    new tags ?title:articles#title ?description:articles#description articles#articles
  let normalize_tag tag =
    let open Data in
    record (Tag.normalize tag)
  let normalize tags =
    let open Data in
    ("all_tags", (list_of normalize_tag tags#tags)) :: Articles.normalize tags
 end
 module Make_with_target (S : sig
  val source : Path.t
  val target : Path.t
 end) =
 struct
  let source_root = S.source
  module Source = struct
    let css = Path.(source_root / "css")
    let js = Path.(source_root / "js")
    let images = Path.(source_root / "images")
    let articles = Path.(source_root / "articles")
    let index = Path.(source_root / "pages" / "index.md")
    let tags = Path.(source_root / "pages" / "tags.md")
    let templates = Path.(source_root / "templates")
    let template file = Path.(templates / file)
    let binary = Path.rel [ Sys.argv.(0) ]
    let cache = Path.(source_root / "_cache")
  end
  module Target = struct
    let target_root = S.target
    let pages = target_root
    let articles = Path.(target_root / "articles")
    let rss2 = Path.(target_root / "feed.xml")
    let as_html into file =
      file |> Path.move ~into |> Path.change_extension "html"
  end
  let target = Target.target_root
  let process_css_files =
    Action.copy_directory ~into:Target.target_root Source.css
  let process_js_files =
    Action.copy_directory ~into:Target.target_root Source.js
  let process_images_files =
    Action.copy_directory ~into:Target.target_root Source.images
  let process_article ~host file =
    let file_target = Target.(as_html articles file) in
    let open Task in
    Action.write_static_file file_target
      begin
        Pipeline.track_file Source.binary
        >>> Yocaml_yaml.Pipeline.read_file_with_metadata (module Article) file
        >>* (fun (obj, str) -> Eff.return (obj#with_host host, str))
        >>> Yocaml_cmarkit.content_to_html ~strict:false ()
        >>> Yocaml_jingoo.Pipeline.as_template
              (module Article)
              (Source.template "article.html")
        >>> Yocaml_jingoo.Pipeline.as_template
              (module Article)
              (Source.template "layout.html")
        >>> drop_first ()
      end
  let process_articles ~host =
    Action.batch ~only:`Files ~where:(Path.has_extension "md") Source.articles
      (process_article ~host)
  let process_index ~host =
    let file = Source.index in
    let file_target = Target.(as_html pages file) in
    let open Task in
    let compute_index =
      Articles.compute_index
        (module Yocaml_yaml)
        ~where:(Path.has_extension "md")
        ~compute_link:(Target.as_html @@ Path.abs [ "articles" ])
        Source.articles
    in
    Action.write_static_file file_target
      begin
        Pipeline.track_files [ Source.binary; Source.articles ]
        >>> Yocaml_yaml.Pipeline.read_file_with_metadata (module Page) file
        >>> Yocaml_cmarkit.content_to_html ~strict:false ()
        >>> first compute_index
        >>* (fun (obj, str) -> Eff.return (obj#with_host host, str))
        >>> Yocaml_jingoo.Pipeline.as_template ~strict:true
              (module Articles)
              (Source.template "index.html")
        >>> Yocaml_jingoo.Pipeline.as_template ~strict:true
              (module Articles)
              (Source.template "layout.html")
        >>> drop_first ()
      end
  let process_tags ~host =
    let file = Source.tags in
    let file_target = Target.(as_html pages file) in
    let open Task in
    let compute_index =
      Articles.compute_index
        (module Yocaml_yaml)
        ~where:(Path.has_extension "md")
        ~compute_link:(Target.as_html @@ Path.abs [ "articles" ])
        Source.articles
    in
    Action.write_static_file file_target
      begin
        Pipeline.track_files [ Source.binary; Source.articles ]
        >>> Yocaml_yaml.Pipeline.read_file_with_metadata (module Page) file
        >>> Yocaml_cmarkit.content_to_html ~strict:false ()
        >>> first compute_index
        >>* (fun (obj, str) -> Eff.return (Tags.of_articles (obj#with_host host), str))
        >>> Yocaml_jingoo.Pipeline.as_template ~strict:true
          (module Tags)
          (Source.template "tags.html")
        >>> Yocaml_jingoo.Pipeline.as_template ~strict:true
          (module Tags)
          (Source.template "layout.html")
        >>> drop_first ()
      end
  let feed_title = "The Robur's blog"
  let site_url = "https://blog.robur.coop"
  let feed_description = "The Robur cooperative blog"
  let fetch_articles =
    let open Task in
    Pipeline.track_files [ Source.binary; Source.articles ]
    >>> Articles.fetch
          (module Yocaml_yaml)
          ~where:(Path.has_extension "md")
          ~compute_link:(Target.as_html @@ Path.abs [ "articles" ])
          Source.articles
  let rss2 =
    let open Task in
    let from_articles ~title ~site_url ~description ~feed_url () =
      let open Yocaml_syndication in
      lift
        begin
          fun articles ->
            let last_build_date =
              List.fold_left
                begin
                  fun acc (_, elt) ->
                    let v = Date.to_archetype_date_time (Article.date elt) in
                    match acc with
                    | None -> Some v
                    | Some a ->
                        if Archetype.Datetime.compare a v > 0 then Some a
                        else Some v
                end
                None articles
              |> Option.map Datetime.make
            in
            let feed =
              Rss2.feed ?last_build_date ~title ~link:site_url ~url:feed_url
                ~description
                begin
                  fun (path, article) ->
                    let title = Article.title article in
                    let link = site_url ^ Path.to_string path in
                    let guid = Rss2.guid_from_link in
                    let description = Article.description article in
                    let pub_date =
                      Datetime.make
                        (Date.to_archetype_date_time (Article.date article))
                    in
                    Rss2.item ~title ~link ~guid ~description ~pub_date ()
                end
                articles
            in
            Xml.to_string feed
        end
    in
    Action.write_static_file Target.rss2
      begin
        fetch_articles
        >>> from_articles ~title:feed_title ~site_url
              ~description:feed_description
              ~feed_url:"https://blog.robur.coop/feed.xml" ()
      end
  let process_all ~host =
    let open Eff in
    Action.restore_cache ~on:`Source Source.cache
    >>= process_css_files >>= process_js_files >>= process_images_files
    >>= process_tags ~host
    >>= process_articles ~host >>= process_index ~host >>= rss2
    >>= Action.store_cache ~on:`Source Source.cache
 end
 module Make (S : sig
  val source : Path.t
 end) =
 Make_with_target (struct
  include S
  let target = Path.(source / "_site")
 end)
--- a/bin/blog.mli
+++ b/bin/blog.mli
@ -0,0 +1,14 @@
 module Make_with_target (_ : sig
  val source : Yocaml.Path.t
  val target : Yocaml.Path.t
 end) : sig
  val target : Yocaml.Path.t
  val process_all : host:string -> unit Yocaml.Eff.t
 end
 module Make (_ : sig
  val source : Yocaml.Path.t
 end) : sig
  val target : Yocaml.Path.t
  val process_all : host:string -> unit Yocaml.Eff.t
 end
--- a/bin/dune
+++ b/bin/dune
@ -0,0 +1,24 @@
 (executable
 (name watch)
 (libraries
  yocaml
  yocaml_syndication
  yocaml_yaml
  yocaml_jingoo
  yocaml_cmarkit
  yocaml_unix))
 (executable
 (name push)
 (libraries
  fmt.tty
  logs.fmt
  git-unix
  bos
  yocaml
  yocaml_git
  yocaml_syndication
  yocaml_yaml
  yocaml_jingoo
  yocaml_cmarkit
  yocaml_unix))
--- a/bin/push.ml
+++ b/bin/push.ml
@ -0,0 +1,82 @@
 let reporter ppf =
  let report src level ~over k msgf =
    let k _ =
      over ();
      k ()
    in
    let with_metadata header _tags k ppf fmt =
      Format.kfprintf k ppf
        ("%a[%a]: " ^^ fmt ^^ "\n%!")
        Logs_fmt.pp_header (level, header)
        Fmt.(styled `Magenta string)
        (Logs.Src.name src)
    in
    msgf @@ fun ?header ?tags fmt -> with_metadata header tags k ppf fmt
  in
  { Logs.report }
 let run_git_rev_parse () =
  let open Bos in
  let value = OS.Cmd.run_out
      Cmd.(v "git" % "describe" % "--always" % "--dirty"
           % "--exclude=*" % "--abbrev=0")
  in
  match OS.Cmd.out_string value with
  | Ok (value, (_, `Exited 0)) -> Some value
  | Ok (value, (run_info, _)) ->
    Logs.warn (fun m -> m "Failed to get commit id: %a: %s"
                  Cmd.pp (OS.Cmd.run_info_cmd run_info)
                  value);
    None
  | Error `Msg e ->
    Logs.warn (fun m -> m "Failed to get commit id: %s" e);
    None
 let message () =
  match run_git_rev_parse () with
  | Some hash -> Fmt.str "Pushed by YOCaml 2 from %s" hash
  | None -> Fmt.str "Pushed by YOCaml 2"
 let () = Fmt_tty.setup_std_outputs ~style_renderer:`Ansi_tty ~utf_8:true ()
 let () = Logs.set_reporter (reporter Fmt.stdout)
 (* let () = Logs.set_level ~all:true (Some Logs.Debug) *)
 let author = ref "The Robur Team"
 let email = ref "team@robur.coop"
 let message = ref (message ())
 let remote = ref "git@git.robur.coop:robur/blog.robur.coop.git#gh-pages"
 let host = ref "https://blog.robur.coop"
 module Source = Yocaml_git.From_identity (Yocaml_unix.Runtime)
 let usage =
  Fmt.str
    "%s [--message <message>] [--author <author>] [--email <email>] -r \
     <repository>#<branch>"
    Sys.argv.(0)
 let specification =
  [
    ("--message", Arg.Set_string message, "The commit message")
  ; ("--email", Arg.Set_string email, "The email used to craft the commit")
  ; ("-r", Arg.Set_string remote, "The Git repository including #branch, e.g. " ^ !remote)
  ; ("--author", Arg.Set_string author, "The Git commit author")
  ; ("--host", Arg.Set_string host, "The host where the blog is available")
  ]
 let () =
  Arg.parse specification ignore usage;
  let author = !author
  and email = !email
  and message = !message
  and remote = !remote in
  let module Blog = Blog.Make_with_target (struct
    let source = Yocaml.Path.rel []
    let target = Yocaml.Path.rel []
  end) in
  Yocaml_git.run
    (module Source)
    (module Pclock)
    ~context:`SSH ~author ~email ~message ~remote
    (fun () -> Blog.process_all ~host:!host)
  |> Lwt_main.run
  |> Result.iter_error (fun (`Msg err) -> invalid_arg err)
--- a/bin/watch.ml
+++ b/bin/watch.ml
@ -0,0 +1,15 @@
 let port = ref 8000
 let usage = Fmt.str "%s [--port <port>]" Sys.argv.(0)
 let specification =
  [ ("--port", Arg.Set_int port, "The port where we serve the website") ]
 module Dest = Blog.Make (struct
  let source = Yocaml.Path.rel []
 end)
 let () =
  Arg.parse specification ignore usage;
  let host = Fmt.str "http://localhost:%d" !port in
  Yocaml_unix.serve ~level:`Info ~target:Dest.target ~port:!port
  @@ fun () -> Dest.process_all ~host
--- a/blogger.opam
+++ b/blogger.opam
@ -5,7 +5,7 @@ maintainer: "romain.calascibetta@gmail.com"
 authors: [ "The XHTMLBoy <xhtmlboi@gmail.com>" ]
 build: [
-  [ "dune" "subst" ]
+  [ "dune" "subst" ] {dev}
  [ "dune" "build" "-p" name "-j" jobs ]
  [ "dune" "runtest" "-p" name ] {with-test}
  [ "dune" "build" "@doc" "-p" name ] {with-doc}
@ -18,16 +18,18 @@ dev-repo: "git://github.com/dinosaure/blogger.git"
 bug-reports: "https://github.com/dinosaure/blogger/issues"
 depends: [
-  "ocaml" { >= "4.11.1" }
+  "ocaml" { >= "5.1.0" }
-  "dune" { >= "2.8" }
+  "dune" { >= "3.16.0" }
  "preface" { >= "0.1.0" }
  "logs" {>= "0.7.0" }
  "cmdliner" { >= "1.0.0"}
  "http-lwt-client"
-  "yocaml"
+  "bos"
  "yocaml" {>= "2.0.1"}
  "yocaml_unix"
  "yocaml_yaml"
-  "yocaml_cmark"
+  "yocaml_cmarkit"
  "yocaml_git"
  "yocaml_jingoo"
  "yocaml_syndication"
 ]
--- a/css/style.css
+++ b/css/style.css
@ -197,6 +197,10 @@ article code {
  color: #fff;
 }
 .tag-box:target > h3 > span {
  background-color: #c2410c;
 }
 .tag-box > h3 > span::before {
  content: "#";
 }
--- a/2
+++ b/2
@ -1,2 +1,2 @@
-(lang dune 2.8)
+(lang dune 3.16)
 (name blogger)
--- a/images/finances.png
+++ b/images/finances.png
--- a/images/smtp.jpg
+++ b/images/smtp.jpg
--- a/src/blogger.ml
+++ b/src/blogger.ml
@ -1,332 +0,0 @@
 let caller = Sys.argv.(0)
 let version = "%%VERSION%%"
 let default_port = 8888
 let default_target = Fpath.v "_site"
 let program ~target =
  let open Yocaml in
  let* () = Task.move_javascript target in
  let* () = Task.move_css target in
  let* () = Task.move_images target in
  let* () = Task.process_articles target in
  let* () = Task.generate_feed target in
  let* () = Task.generate_tags target in
  Task.generate_index target
 let local_build _quiet target =
  Yocaml_unix.execute (program ~target:(Fpath.to_string target))
 module SSH = struct
  open Lwt.Infix
  type error = Unix.error * string * string
  type write_error = [ `Closed | `Error of Unix.error * string * string ]
  let pp_error ppf (err, f, v) =
    Fmt.pf ppf "%s(%s): %s" f v (Unix.error_message err)
  let pp_write_error ppf = function
    | `Closed -> Fmt.pf ppf "Connection closed by peer"
    | `Error (err, f, v) -> Fmt.pf ppf "%s(%s): %s" f v (Unix.error_message err)
  type flow = { ic : in_channel; oc : out_channel }
  type endpoint = {
    user : string;
    path : string;
    host : Unix.inet_addr;
    port : int;
    capabilities : [ `Rd | `Wr ];
  }
  let pp_inet_addr ppf inet_addr =
    Fmt.string ppf (Unix.string_of_inet_addr inet_addr)
  let connect { user; path; host; port; capabilities } =
    let edn = Fmt.str "%s@%a" user pp_inet_addr host in
    let cmd =
      match capabilities with
      | `Wr -> Fmt.str {sh|git-receive-pack '%s'|sh} path
      | `Rd -> Fmt.str {sh|git-upload-pack '%s'|sh} path
    in
    let cmd = Fmt.str "ssh -p %d %s %a" port edn Fmt.(quote string) cmd in
    try
      let ic, oc = Unix.open_process cmd in
      Lwt.return_ok { ic; oc }
    with Unix.Unix_error (err, f, v) -> Lwt.return_error (`Error (err, f, v))
  let read t =
    let tmp = Bytes.create 0x1000 in
    try
      let len = input t.ic tmp 0 0x1000 in
      if len = 0 then Lwt.return_ok `Eof
      else Lwt.return_ok (`Data (Cstruct.of_bytes tmp ~off:0 ~len))
    with Unix.Unix_error (err, f, v) -> Lwt.return_error (err, f, v)
  let write t cs =
    let str = Cstruct.to_string cs in
    try
      output_string t.oc str;
      flush t.oc;
      Lwt.return_ok ()
    with Unix.Unix_error (err, f, v) -> Lwt.return_error (`Error (err, f, v))
  let writev t css =
    let rec go t = function
      | [] -> Lwt.return_ok ()
      | x :: r -> (
          write t x >>= function
          | Ok () -> go t r
          | Error _ as err -> Lwt.return err)
    in
    go t css
  let close t =
    close_in t.ic;
    close_out t.oc;
    Lwt.return_unit
  let shutdown t mode =
    match mode with
    | `read -> close_in t.ic ; Lwt.return_unit
    | `write -> close_out t.oc ; Lwt.return_unit
    | `read_write -> close t
 end
 let ssh_edn, ssh_protocol = Mimic.register ~name:"ssh" (module SSH)
 let unix_ctx_with_ssh () =
  let open Lwt.Infix in
  Git_unix.ctx (Happy_eyeballs_lwt.create ()) >|= fun ctx ->
  let open Mimic in
  let k0 scheme user path host port capabilities =
    match (scheme, Unix.gethostbyname host) with
    | `SSH, { Unix.h_addr_list; _ } when Array.length h_addr_list > 0 ->
        Lwt.return_some
          { SSH.user; path; host = h_addr_list.(0); port; capabilities }
    | _ -> Lwt.return_none
  in
  ctx
  |> Mimic.fold Smart_git.git_transmission
       Fun.[ req Smart_git.git_scheme ]
       ~k:(function `SSH -> Lwt.return_some `Exec | _ -> Lwt.return_none)
  |> Mimic.fold ssh_edn
       Fun.
         [
           req Smart_git.git_scheme;
           req Smart_git.git_ssh_user;
           req Smart_git.git_path;
           req Smart_git.git_hostname;
           dft Smart_git.git_port 22;
           req Smart_git.git_capabilities;
         ]
       ~k:k0
 let run_git_config key = function
  | Some value -> Some value
  | None -> (
      let open Bos in
      let value = OS.Cmd.run_out Cmd.(v "git" % "config" % "--global" % key) in
      match OS.Cmd.out_string value with
      | Ok (value, _) -> Some value
      | Error _ -> None)
 let run_git_rev_parse default =
  let open Bos in
  let value = OS.Cmd.run_out
      Cmd.(v "git" % "describe" % "--always" % "--dirty"
           % "--exclude=*" % "--abbrev=0")
  in
  match OS.Cmd.out_string value with
  | Ok (value, (_, `Exited 0)) -> value
  | Ok (value, (run_info, _)) ->
    Logs.warn (fun m -> m "Failed to get commit id: %a: %s"
                  Cmd.pp (OS.Cmd.run_info_cmd run_info)
                  value);
    default
  | Error `Msg e ->
    Logs.warn (fun m -> m "Failed to get commit id: %s" e);
    default
 let get_name_and_email name email =
  let name = run_git_config "user.name" name in
  let email = run_git_config "user.email" email in
  (name, email)
 let name_and_email =
  let name_arg =
    let doc = "Name of the committer." in
    Cmdliner.Arg.(value & opt (some string) None & info [ "name" ] ~doc)
  in
  let email_arg =
    let doc = "Email of the committer." in
    Cmdliner.Arg.(value & opt (some string) None & info [ "email" ] ~doc)
  in
  Cmdliner.Term.(const get_name_and_email $ name_arg $ email_arg)
 let build_and_push _quiet remote (author, email) hook =
  let fiber () =
    let open Lwt.Syntax in
    let commit_id = run_git_rev_parse "an unknown state" in
    let comment = Printf.sprintf "Built from %s" commit_id in
    let* ctx = unix_ctx_with_ssh () in
    let* res =
      Yocaml_git.execute
        (module Yocaml_unix)
        (module Pclock)
        ~ctx ?author ?email ~comment remote (program ~target:"")
    in
    match res with
    | Error (`Msg err) -> Fmt.failwith "build-and-push: %s." err
    | Ok () -> (
        match hook with
        | None -> Lwt.return_unit
        | Some hook -> (
            let open Lwt.Infix in
            Http_lwt_client.request ~config:(`HTTP_1_1 Httpaf.Config.default)
              ~meth:`GET (Uri.to_string hook)
              (fun _ () _ -> Lwt.return_unit)
              ()
            >>= function
            | Ok (_response, ()) -> Lwt.return_unit
            | Error (`Msg err) -> failwith err))
  in
  Lwt_main.run (fiber ())
 let watch quiet target potential_port =
  let port = Option.value ~default:default_port potential_port in
  let () = local_build quiet target in
  let target = Fpath.to_string target in
  let server = Yocaml_unix.serve ~filepath:target ~port (program ~target) in
  Lwt_main.run server
 let common_options = "COMMON OPTIONS"
 let verbosity =
  let open Cmdliner in
  let env = Cmd.Env.info "BLOGGER_LOGS" in
  Logs_cli.level ~docs:common_options ~env ()
 let renderer =
  let open Cmdliner in
  let env = Cmd.Env.info "BLOGGER_FMT" in
  Fmt_cli.style_renderer ~docs:common_options ~env ()
 let utf_8 =
  let open Cmdliner in
  let doc = "Allow binaries to emit UTF-8 characters." in
  let env = Cmd.Env.info "BLOGGER_UTF_8" in
  Arg.(value & opt bool true & info [ "with-utf-8" ] ~doc ~env)
 let reporter ppf =
  let report src level ~over k msgf =
    let k _ =
      over ();
      k ()
    in
    let with_metadata header _tags k ppf fmt =
      Fmt.kpf k ppf
        ("%a[%a]: " ^^ fmt ^^ "\n%!")
        Logs_fmt.pp_header (level, header)
        Fmt.(styled `Magenta string)
        (Logs.Src.name src)
    in
    msgf @@ fun ?header ?tags fmt -> with_metadata header tags k ppf fmt
  in
  { Logs.report }
 let setup_logs utf_8 style_renderer level =
  Fmt_tty.setup_std_outputs ~utf_8 ?style_renderer ();
  Logs.set_level level;
  Logs.set_reporter (reporter Fmt.stderr);
  Option.is_none level
 let setup_logs = Cmdliner.Term.(const setup_logs $ utf_8 $ renderer $ verbosity)
 let man =
  let open Cmdliner in
  [ `S Manpage.s_authors; `P "blog.robur.coop" ]
 let build_cmd =
  let open Cmdliner in
  let doc = Format.asprintf "Build the blog into the specified directory" in
  let exits = Cmd.Exit.defaults in
  let info = Cmd.info "build" ~version ~doc ~exits ~man in
  let path_arg =
    let doc =
      Format.asprintf "Specify where we build the website (default: %a)"
        Fpath.pp default_target
    in
    let arg = Arg.info ~doc [ "destination" ] in
    Arg.(value & opt (conv (Fpath.of_string, Fpath.pp)) default_target & arg)
  in
  Cmd.v info Term.(const local_build $ setup_logs $ path_arg)
 let watch_cmd =
  let open Cmdliner in
  let doc =
    Format.asprintf
      "Serve from the specified directory as an HTTP server and rebuild \
       website on demand"
  in
  let exits = Cmd.Exit.defaults in
  let path_arg =
    let doc =
      Format.asprintf "Specify where we build the website (default: %a)"
        Fpath.pp default_target
    in
    let arg = Arg.info ~doc [ "destination" ] in
    Arg.(value & opt (conv (Fpath.of_string, Fpath.pp)) default_target & arg)
  in
  let port_arg =
    let doc = Format.asprintf "The port (default: %d)" default_port in
    let arg = Arg.info ~doc [ "port"; "P"; "p" ] in
    Arg.(value & opt (some int) None & arg)
  in
  let info = Cmd.info "watch" ~version ~doc ~exits ~man in
  Cmd.v info Term.(const watch $ setup_logs $ path_arg $ port_arg)
 let push_cmd =
  let open Cmdliner in
  let doc =
    Format.asprintf
      "Push the blog (from the specified directory) into a Git repository"
  in
  let exits = Cmd.Exit.defaults in
  let remote_arg =
    let remote =
      let parser str =
        match Smart_git.Endpoint.of_string str with
        | Ok _ -> Ok str
        | Error _ as err -> err
      in
      Arg.conv (parser, Fmt.string)
    in
    let doc = "The remote Git repository" in
    let arg = Arg.info ~doc [ "r"; "remote" ] in
    Arg.(required & opt (some remote) None & arg)
  in
  let hook_arg =
    let doc = "The URL of the hook to update the unikernel" in
    let arg = Arg.info ~doc [ "h"; "hook" ] in
    let of_string str =
      match Uri.of_string str with
      | v -> Ok v
      | exception _ -> Rresult.R.error_msgf "Invalid URI: %s" str
    in
    Arg.(value & opt (some (conv (of_string, Uri.pp))) None & arg)
  in
  let info = Cmd.info "push" ~version ~doc ~exits ~man in
  Cmd.v info
    Term.(
      const build_and_push $ setup_logs $ remote_arg $ name_and_email $ hook_arg)
 let cmd =
  let open Cmdliner in
  let sdocs = Manpage.s_common_options in
  let doc = "Build, push or serve my personal website" in
  let default_info = Cmd.info caller ~version ~doc ~sdocs ~man in
  let default = Term.(ret (const (`Help (`Pager, None)))) in
  Cmd.group ~default default_info [ build_cmd; watch_cmd; push_cmd ]
 let () = exit @@ Cmdliner.Cmd.eval cmd
--- a/src/collection.ml
+++ b/src/collection.ml
@ -1,64 +0,0 @@
 open Yocaml
 let get_article (module V : Metadata.VALIDABLE) article_file =
  let arr =
    Build.read_file_with_metadata
      (module V)
      (module Model.Article)
      article_file
  in
  let deps = Build.get_dependencies arr in
  let task = Build.get_task arr in
  let+ meta, _ = task () in
  deps, (meta, Model.article_path article_file)
 ;;
 let get_articles (module V : Metadata.VALIDABLE) path =
  let* files = read_child_files path File.is_markdown in
  let+ articles = Traverse.traverse (get_article (module V)) files in
  let deps, effects = List.split articles in
  Deps.Monoid.reduce deps, effects
 ;;
 module Articles = struct
  type t = (Model.Article.t * Filepath.t) list
  let get_all (module V : Metadata.VALIDABLE) ?(decreasing = true) path =
    let+ deps, articles = get_articles (module V) path in
    let sorted_article = Model.Articles.sort ~decreasing articles in
    Build.make deps (fun x -> return (x, sorted_article))
  ;;
 end
 module Tags = struct
  module M = Map.Make (String)
  let by_quantity ?(decreasing = true) (_, a) (_, b) =
    let r = Int.compare $ List.length a $ List.length b in
    if decreasing then ~-r else r
  ;;
  let group metas =
    List.fold_left
      (fun accumulator (article, path) ->
        List.fold_left
          (fun map tag ->
            match M.find_opt tag map with
            | Some articles -> M.add tag ((article, path) :: articles) map
            | None -> M.add tag [ article, path ] map)
          accumulator
          (Model.Article.tags article))
      M.empty
      metas
    |> M.map
         (List.sort (fun (a, _) (b, _) -> Model.Article.compare_by_date a b))
    |> M.to_seq
    |> List.of_seq
    |> List.sort by_quantity
  ;;
  let compute (module V : Metadata.VALIDABLE) path =
    let+ deps, articles = get_articles (module V) path in
    deps, group articles
  ;;
 end
--- a/src/collection.mli
+++ b/src/collection.mli
@ -1,18 +0,0 @@
 open Yocaml
 module Articles : sig
  type t = (Model.Article.t * Filepath.t) list
  val get_all
    :  (module Metadata.VALIDABLE)
    -> ?decreasing:bool
    -> Filepath.t
    -> ('a, 'a * t) Build.t Effect.t
 end
 module Tags : sig
  val compute
    :  (module Metadata.VALIDABLE)
    -> Filepath.t
    -> (Deps.t * (string * (Model.Article.t * string) list) list) Effect.t
 end
--- a/src/dune
+++ b/src/dune
@ -1,21 +0,0 @@
 (executable
 (name blogger)
 (libraries
  logs
  logs.fmt
  logs.cli
  fmt
  fmt.tty
  fmt.cli
  cmdliner
  preface
  mirage-clock-unix
  http-lwt-client
  git-unix
  cmarkit
  yocaml
  yocaml_yaml
  yocaml_cmark
  yocaml_unix
  yocaml_git
  yocaml_jingoo))
--- a/src/feed.ml
+++ b/src/feed.ml
@ -1,15 +0,0 @@
 open Yocaml
 let domain = "https://blog.robur.coop"
 let feed_url = into domain "feed.xml"
 let articles_to_items articles =
  List.map
    (fun (article, url) -> Model.Article.to_rss_item (into domain url) article)
    articles
 let make ((), articles) =
  Yocaml.Rss.Channel.make ~title:"Robur's blog" ~link:domain ~feed_link:feed_url
    ~description:"The Robur cooperative blog" ~generator:"yocaml"
    ~webmaster:"team@robur.coop"
    (articles_to_items articles)
--- a/src/feed.mli
+++ b/src/feed.mli
@ -1 +0,0 @@
 val make : unit * Collection.Articles.t -> Yocaml.Rss.Channel.t
--- a/src/file.ml
+++ b/src/file.ml
@ -1,18 +0,0 @@
 open Yocaml
 let is_css = with_extension "css"
 let is_javascript = with_extension "js"
 let is_image =
  let open Preface.Predicate in
  with_extension "png"
  || with_extension "svg"
  || with_extension "jpg"
  || with_extension "jpeg"
  || with_extension "gif"
 ;;
 let is_markdown =
  let open Preface.Predicate in
  with_extension "md" || with_extension "markdown"
 ;;
--- a/src/file.mli
+++ b/src/file.mli
@ -1,6 +0,0 @@
 open Yocaml
 val is_css : Filepath.t -> bool
 val is_javascript : Filepath.t -> bool
 val is_image : Filepath.t -> bool
 val is_markdown : Filepath.t -> bool
--- a/src/model.ml
+++ b/src/model.ml
@ -1,256 +0,0 @@
 open Yocaml
 let article_path file =
  let filename = basename $ replace_extension file "html" in
  filename |> into "articles"
 let tag_path tag = add_extension tag "html" |> into "tags"
 module Author = struct
  type t = {
    name : string;
    link : string;
    email : string;
    avatar : string option;
  }
  let equal a b =
    String.equal a.name b.name && String.equal a.link b.link
    && String.equal a.email b.email
    && Option.equal String.equal a.avatar b.avatar
  let make name link email avatar = { name; link; email; avatar }
  let from (type a) (module V : Metadata.VALIDABLE with type t = a) obj =
    V.object_and
      (fun assoc ->
        let open Validate.Applicative in
        make
        <$> V.(required_assoc string) "name" assoc
        <*> V.(required_assoc string) "link" assoc
        <*> V.(required_assoc string) "email" assoc
        <*> V.(optional_assoc string) "avatar" assoc)
      obj
  let default_user =
    make "robur" "https://blog.robur.coop/" "team@robur.coop" None
  let gravatar email =
    let tk = String.(lowercase_ascii $ trim email) in
    let hs = Digest.(to_hex $ string tk) in
    "https://www.gravatar.com/avatar/" ^ hs
  let inject (type a) (module D : Key_value.DESCRIBABLE with type t = a)
      { name; link; email; avatar } =
    let avatar = match avatar with Some uri -> uri | None -> gravatar email in
    D.
      [
        ("name", string name);
        ("link", string link);
        ("email", string email);
        ("avatar", string avatar);
      ]
 end
 module Co_author = struct
  type t = { author : Author.t; contribution : string }
  let make author contribution = { author; contribution }
  let from (type a) (module V : Metadata.VALIDABLE with type t = a) obj =
    V.object_and
      (fun assoc ->
        let open Validate.Applicative in
        make
        <$> V.(required_assoc (Author.from (module V))) "author" assoc
        <*> V.(required_assoc string) "contribution" assoc)
      obj
  let inject (type a) (module D : Key_value.DESCRIBABLE with type t = a)
      { author; contribution } =
    D.
      [
        ("author", object_ $ Author.inject (module D) author);
        ("contribution", string contribution);
      ]
 end
 module Article = struct
  type t = {
    article_title : string;
    article_description : string;
    tags : string list;
    date : Date.t;
    title : string option;
    description : string option;
    author : Author.t;
    co_authors : Co_author.t list;
    invited_article : bool;
  }
  let date { date; _ } = date
  let tags { tags; _ } = tags
  let escape_string str =
    let renderer = Cmarkit_renderer.make () in
    let buffer = Buffer.create (String.length str) in
    let ctx = Cmarkit_renderer.Context.make renderer buffer in
    Cmarkit_html.html_escaped_string ctx str;
    Buffer.contents buffer
  let to_rss_item url article =
    let title = escape_string article.article_title in
    let description = escape_string article.article_description in
    Rss.(
      Item.make ~title ~link:url ~pub_date:article.date ~description
        ~guid:(Guid.link url) ())
  let make article_title article_description tags date title description author
      co_authors =
    let author = Option.value ~default:Author.default_user author in
    let invited_article = not (Author.equal author Author.default_user) in
    {
      article_title;
      article_description;
      tags = List.map String.lowercase_ascii tags;
      date;
      title;
      description;
      author;
      co_authors;
      invited_article;
    }
  let from_string (module V : Metadata.VALIDABLE) = function
    | None -> Validate.error $ Error.Required_metadata [ "Article" ]
    | Some str ->
        let open Validate.Monad in
        V.from_string str
        >>= V.object_and (fun assoc ->
                let open Validate.Applicative in
                make
                <$> V.(required_assoc string) "article.title" assoc
                <*> V.(required_assoc string) "article.description" assoc
                <*> V.(optional_assoc_or ~default:[] (list_of string))
                      "tags" assoc
                <*> V.required_assoc
                      (Metadata.Date.from (module V))
                      "date" assoc
                <*> V.(optional_assoc string) "title" assoc
                <*> V.(optional_assoc string) "description" assoc
                <*> V.(optional_assoc (Author.from (module V))) "author" assoc
                <*> V.(
                      optional_assoc_or ~default:[]
                        (list_of (Co_author.from (module V)))
                        "coauthors" assoc))
  let inject (type a) (module D : Key_value.DESCRIBABLE with type t = a)
      {
        article_title;
        article_description;
        tags;
        date;
        title;
        description;
        author;
        co_authors;
        invited_article;
      } =
    let co_authors =
      List.map (fun c -> D.object_ $ Co_author.inject (module D) c) co_authors
    in
    let has_co_authors = match co_authors with [] -> false | _ -> true in
    D.
      [
        ("root", string "..");
        ( "metadata",
          object_
            [
              ("title", string article_title);
              ("description", string article_description);
            ] );
        ("tags", list (List.map string tags));
        ("date", object_ $ Metadata.Date.inject (module D) date);
        ("author", object_ $ Author.inject (module D) author);
        ("coauthors", list co_authors);
        ("invited", boolean invited_article);
        ("has_coauthors", boolean has_co_authors);
      ]
    @ Metadata.Page.inject (module D) (Metadata.Page.make title description)
  let compare_by_date a b = Date.compare a.date b.date
 end
 module Articles = struct
  type t = {
    articles : (Article.t * string) list;
    title : string option;
    description : string option;
  }
  let make ?title ?description articles = { articles; title; description }
  let title p = p.title
  let description p = p.description
  let articles p = p.articles
  let set_articles new_articles p = { p with articles = new_articles }
  let set_title new_title p = { p with title = new_title }
  let set_description new_desc p = { p with description = new_desc }
  let sort ?(decreasing = true) articles =
    List.sort
      (fun (a, _) (b, _) ->
        let a_date = Article.date a and b_date = Article.date b in
        let r = Date.compare a_date b_date in
        if decreasing then ~-r else r)
      articles
  let sort_articles_by_date ?(decreasing = true) p =
    { p with articles = sort ~decreasing p.articles }
  let inject (type a) (module D : Key_value.DESCRIBABLE with type t = a)
      { articles; title; description } =
    ( "articles",
      D.list
        (List.map
           (fun (article, url) ->
             D.object_
               (("url", D.string url) :: Article.inject (module D) article))
           articles) )
    :: ("root", D.string ".")
    :: (Metadata.Page.inject (module D) $ Metadata.Page.make title description)
 end
 let article_object (type a) (module D : Key_value.DESCRIBABLE with type t = a)
    (article, url) =
  D.object_ (("url", D.string url) :: Article.inject (module D) article)
 module Tag = struct
  type t = {
    tag : string;
    tags : (string * int) list;
    articles : (Article.t * string) list;
    title : string option;
    description : string option;
  }
  let make ?title ?description tag articles tags =
    { tag; tags; articles = Articles.sort articles; title; description }
  let inject (type a) (module D : Key_value.DESCRIBABLE with type t = a)
      { tag; tags; articles; title; description } =
    ("tag", D.string tag)
    :: ("root", D.string "..")
    :: ("articles", D.list (List.map (article_object (module D)) articles))
    :: ( "tags",
         D.list
           (List.map
              (fun (tag, n) ->
                D.object_
                  [
                    ("name", D.string tag);
                    ("link", D.string (tag_path tag));
                    ("number", D.integer n);
                  ])
              tags) )
    :: (Metadata.Page.inject (module D) $ Metadata.Page.make title description)
 end
--- a/src/model.mli
+++ b/src/model.mli
@ -1,55 +0,0 @@
 open Yocaml
 val article_path : Filepath.t -> Filepath.t
 val tag_path : string -> Filepath.t
 module Article : sig
  type t
  val date : t -> Date.t
  val tags : t -> string list
  val to_rss_item : string -> t -> Rss.Item.t
  val compare_by_date : t -> t -> int
  include Metadata.INJECTABLE with type t := t
  include Metadata.READABLE with type t := t
 end
 module Tag : sig
  type t
  val make
    :  ?title:string
    -> ?description:string
    -> string
    -> (Article.t * string) list
    -> (string * int) list
    -> t
  include Metadata.INJECTABLE with type t := t
 end
 module Articles : sig
  type t
  val make
    :  ?title:string
    -> ?description:string
    -> (Article.t * string) list
    -> t
  val sort
    :  ?decreasing:bool
    -> (Article.t * string) list
    -> (Article.t * string) list
  val sort_articles_by_date : ?decreasing:bool -> t -> t
  val articles : t -> (Article.t * string) list
  val title : t -> string option
  val description : t -> string option
  val set_title : string option -> t -> t
  val set_description : string option -> t -> t
  val set_articles : (Article.t * string) list -> t -> t
  include Metadata.INJECTABLE with type t := t
 end
--- a/src/task.ml
+++ b/src/task.ml
@ -1,108 +0,0 @@
 open Yocaml
 module Metaformat = Yocaml_yaml
 module Markup = Yocaml_cmark
 module Template = Yocaml_jingoo
 let css_target target = "css" |> into target
 let javascript_target target = "js" |> into target
 let images_target target = "images" |> into target
 let template file = add_extension file "html" |> into "templates"
 let article_template = template "article"
 let layout_template = template "layout"
 let list_template = template "list_articles"
 let article_target file target = Model.article_path file |> into target
 let binary_update = Build.watch Sys.argv.(0)
 let index_html target = "index.html" |> into target
 let index_md = "index.md" |> into "pages"
 let rss_feed target = "feed.xml" |> into target
 let tag_file tag target = Model.tag_path tag |> into target
 let tag_template = template "tag"
 let move_css target =
  process_files
    [ "css" ]
    File.is_css
    (Build.copy_file ~into:(css_target target))
 ;;
 let move_javascript target =
  process_files
    [ "js" ]
    File.is_javascript
    (Build.copy_file ~into:(javascript_target target))
 ;;
 let move_images target =
  process_files
    [ "images" ]
    File.is_image
    (Build.copy_file ~into:(images_target target))
 ;;
 let process_articles target =
  process_files [ "articles" ] File.is_markdown (fun article_file ->
    let open Build in
    create_file
      (article_target article_file target)
      (binary_update
      >>> Metaformat.read_file_with_metadata
            (module Model.Article)
            article_file
      >>> Markup.content_to_html ~strict:false ()
      >>> Template.apply_as_template (module Model.Article) article_template
      >>> Template.apply_as_template (module Model.Article) layout_template
      >>^ Stdlib.snd))
 ;;
 let merge_with_page ((meta, content), articles) =
  let title = Metadata.Page.title meta in
  let description = Metadata.Page.description meta in
  Model.Articles.make ?title ?description articles, content
 ;;
 let generate_feed target =
  let open Build in
  let* articles_arrow =
    Collection.Articles.get_all (module Metaformat) "articles"
  in
  create_file
    (rss_feed target)
    (binary_update >>> articles_arrow >>^ Feed.make >>^ Rss.Channel.to_rss)
 ;;
 let generate_tags target =
  let* deps, tags = Collection.Tags.compute (module Metaformat) "articles" in
  let tags_string = List.map (fun (i, s) -> i, List.length s) tags in
  let mk_meta tag articles () = Model.Tag.make tag articles tags_string, "" in
  List.fold_left
    (fun program (tag, articles) ->
      let open Build in
      program
      >> create_file
           (tag_file tag target)
           (init deps
           >>> binary_update
           >>^ mk_meta tag articles
           >>> Template.apply_as_template (module Model.Tag) tag_template
           >>> Template.apply_as_template (module Model.Tag) layout_template
           >>^ Stdlib.snd))
    (return ())
    tags
 ;;
 let generate_index target =
  let open Build in
  let* articles_arrow =
    Collection.Articles.get_all (module Metaformat) "articles"
  in
  create_file
    (index_html target)
    (binary_update
    >>> Metaformat.read_file_with_metadata (module Metadata.Page) index_md
    >>> Markup.content_to_html ~strict:false ()
    >>> articles_arrow
    >>^ merge_with_page
    >>> Template.apply_as_template (module Model.Articles) list_template
    >>> Template.apply_as_template (module Model.Articles) layout_template
    >>^ Stdlib.snd)
 ;;
--- a/src/task.mli
+++ b/src/task.mli
@ -1,7 +0,0 @@
 val move_css : string -> unit Yocaml.Effect.t
 val move_images : string -> unit Yocaml.Effect.t
 val move_javascript : string -> unit Yocaml.Effect.t
 val process_articles : string -> unit Yocaml.Effect.t
 val generate_feed : string -> unit Yocaml.Effect.t
 val generate_index : string -> unit Yocaml.Effect.t
 val generate_tags : string -> unit Yocaml.Effect.t
--- a/templates/article.html
+++ b/templates/article.html
@ -1,13 +1,13 @@
 <a href="/index.html">Back to index</a>
 <article>
-    <h1>{{ metadata.title }}</h1>
+    <h1>{{ title }}</h1>
    <ul class="tags-list">
        {%- for tag in tags -%}
-        <li><a href="/tags/{{ tag }}.html">{{ tag }}</a></li>
+	<li><a href="/tags.html#tag-{{ tag }}">{{ tag }}</a></li>
        {%- endfor -%}
    </ul>
    {%- autoescape false -%}
-    {{ body }}
+    {{ yocaml_body }}
    {% endautoescape -%}
 </article>
--- a/templates/list_articles.html
+++ b/templates/list_articles.html
@ -1,7 +1,7 @@
-<a class="small-button rss" href="./feed.xml">RSS</a>
+<a class="small-button rss" href="/feed.xml">RSS</a>
 {%- autoescape false -%}
-{{ body }}
+{{ yocaml_body }}
 {% endautoescape -%}
 <h3>Essays and ramblings</h3>
@ -20,13 +20,13 @@
            {%- endfor -%}
        </div>
        <div class="content">
-            <span class="date">{{ article.date.canonical }}</span>
+            <span class="date">{{ article.date.human }}</span>
-            <a href="{{ article.url }}">{{ article.metadata.title }}</a><br />
+            <a href="{{ article.url }}">{{ article.title }}</a><br />
-            <p>{{ article.metadata.description }}</p>
+            <p>{{ article.description }}</p>
            <div class="bottom">
                <ul class="tags-list">
                    {%- for tag in article.tags -%}
-                    <li><a href="/tags/{{ tag  }}.html">{{ tag }}</a></li>
+		    <li><a href="/tags.html#tag-{{ tag }}">{{ tag }}</a></li>
                    {%- endfor -%}
                </ul>
            </div>
--- a/templates/layout.html
+++ b/templates/layout.html
@ -1,20 +1,3 @@
 {%- if metadata.title -%}
 {%- set dash = " - " -%}
 {%- set page_title = metadata.title -%}
 {%- elseif title -%}
 {%- set dash = " - " -%}
 {%- set page_title = title -%}
 {%- else -%}
 {%- set dash = "" -%}
 {%- set page_title = "" -%}
 {%- endif %}
 {% if metadata.description -%}
 {%- set page_description = metadata.description -%}
 {%- elseif description -%}
 {%- set page_description = description -%}
 {%- else -%}
 {%- set page_description = "blog.robur.coop" -%}
 {%- endif -%}
 <!doctype html>
 <html lang="en">
  <head>
@ -22,13 +5,13 @@
    <meta http-equiv="x-ua-compatible" content="ie=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>
-        Robur's blog{{ dash }}{{ page_title }}
+        Robur's blog - {{ title }}
    </title>
-    <meta name="description" content="{{ page_description }}">
+    <meta name="description" content="{{ description }}">
-    <link type="text/css" rel="stylesheet" href="{{ root }}/css/hl.css">
+    <link type="text/css" rel="stylesheet" href="/css/hl.css">
-    <link type="text/css" rel="stylesheet" href="{{ root }}/css/style.css">
+    <link type="text/css" rel="stylesheet" href="/css/style.css">
-    <script src="{{ root }}/js/hl.js"></script>
+    <script src="/js/hl.js"></script>
-    <link rel="alternate" type="application/rss+xml" href="{{ root }}/feed.xml" title="blog.robur.coop">
+    <link rel="alternate" type="application/rss+xml" href="/feed.xml" title="blog.robur.coop">
  </head>
  <body>
    <header>
@ -39,7 +22,7 @@
    </header>
    <main>
        {%- autoescape false -%}
-        {{ body }}
+        {{ yocaml_body }}
        {% endautoescape -%}
    </main>
    <footer>
--- a/templates/tag.html
+++ b/templates/tag.html
@ -1,21 +0,0 @@
 <a href="/index.html">Back to index</a>
 <ul class="tags-list aeration">
    {%- for tag in tags -%}
    <li><a href="/{{ tag.link  }}">{{ tag.name }} ({{ tag.number }})</a></li>
    {%- endfor -%}
 </ul>
 <div class="tag-box" id="tag-{{ tag  }}">
    {%- set nb_tags = length (articles) -%}
    <h3>
        <span>{{ tag }}</span>
        {{ nb_tags }}
        {%- if nb_tags > 1 %} entries{%- else %} entry{%- endif -%}
    </h3>
    <ul>
        {%- for article in articles -%}
        <li><a href="/{{ article.url }}">{{ article.metadata.title  }}</a></li>
        {%- endfor -%}
    </ul>
 </div>
--- a/templates/tags.html
+++ b/templates/tags.html
@ -0,0 +1,20 @@
 <a href="/index.html">Back to index</a>
 <ul class="tags-list aeration">
    {%- for tag in all_tags -%}
    <li><a href="#tag-{{ tag.name }}">{{ tag.name }}</a></li>
    {%- endfor -%}
 </ul>
 {%- for tag in all_tags -%}
 <div class="tag-box" id="tag-{{ tag.name }}">
    <h3>
        <span>{{ tag.name }}</span>
    </h3>
    <ul>
        {%- for article in tag.articles -%}
 	<li><a href="{{ article.url }}">{{ article.title  }}</a></li>
        {%- endfor -%}
    </ul>
 </div>
 {%- endfor -%}
--- a/update.sh
+++ b/update.sh
@ -1,6 +1,7 @@
 #!/bin/sh
-opam exec -- dune exec src/blogger.exe -- push \
+opam exec -- dune exec bin/push.exe --
  -r git@git.robur.coop:robur/blog.robur.coop.git#gh-pages \
  --host https://blog.robur.coop \
  --name "The Robur team" \
  --email team@robur.coop
Author	SHA1	Message	Date
Reynir Björnsson	e993307d83	Merge pull request 'Add "GPTar update" article' (#22 ) from gptar-update into main Reviewed-on: robur/blog.robur.coop#22	2024-10-29 11:12:06 +00:00
dinosaure	bc0bbbc706	Merge pull request 'Add article about elit/ptt' (#21 ) from elit into main Reviewed-on: robur/blog.robur.coop#21	2024-10-29 11:01:31 +00:00
Calascibetta Romain	f37e1a5c1c	Update the date of the PTT article	2024-10-29 12:01:17 +01:00
Reynir Björnsson	c2aeb492ec	gptar-update.md: Add shell language	2024-10-29 09:21:56 +01:00
Reynir Björnsson	0aadded352	gptar-update.md: add tags, author	2024-10-29 09:05:15 +01:00
Hannes Mehnert	ceb856999c	Set blog title of /tags to "Tags"	2024-10-28 18:55:57 +01:00
Hannes Mehnert	45917109f0	in layout, use the '-' instead of undefined '{{dash}}'. fixes #5 (or at least works around it)	2024-10-28 18:40:49 +01:00
Hannes Mehnert	340a53acd4	use relative links in blog articles for links between articles	2024-10-28 18:35:17 +01:00
Hannes Mehnert	cf9e1df880	re-add old miragevpn testing article	2024-10-28 18:34:07 +01:00
Hannes Mehnert	f35e0763db	minor documentation updates	2024-10-28 18:10:05 +01:00
Hannes Mehnert	bc02087612	Merge pull request 'Fix inadvertent double slash' (#23 ) from fix-article-urls into main Reviewed-on: robur/blog.robur.coop#23	2024-10-28 17:08:23 +00:00
Reynir Björnsson	62c7a926f0	Fix inadvertent double slash	2024-10-28 16:40:26 +01:00
Reynir Björnsson	2228432cab	Add "GPTar update" article	2024-10-28 16:21:11 +01:00
Reynir Björnsson	4a4c22e244	Merge pull request 'Generate the commit message with the actual commit of main' (#20 ) from with-nice-commit into main Reviewed-on: robur/blog.robur.coop#20	2024-10-28 12:12:11 +00:00
Hannes Mehnert	1918cb3821	Merge pull request 'Remove usage of {{ host }} when our only target is https://blog.robur.coop ' (#18 ) from no-host into main Reviewed-on: robur/blog.robur.coop#18	2024-10-26 14:43:49 +00:00
Hannes Mehnert	0153d20b89	Merge pull request 'Delete useless feed files (rss1 & atom), for compatibility reasons, keep rss2' (#19 ) from delete-useless-feeds into main Reviewed-on: robur/blog.robur.coop#19	2024-10-26 14:42:47 +00:00
dinosaure	ca5efb67e8	Add article about elit	2024-10-26 11:21:04 +02:00
Calascibetta Romain	dcbb5e0e05	Generate the commit message with the actual commit of main	2024-10-25 17:52:13 +02:00
Calascibetta Romain	caec8c419c	Delete useless feed files (rss1 & atom), for compatibility reasons, keep rss2	2024-10-25 17:44:44 +02:00
Calascibetta Romain	58f1bf634b	Remove usage of {{ host }} when our only target is https://blog.robur.coop	2024-10-25 17:41:13 +02:00
dinosaure	f10a30f29c	Merge pull request 'Drop double slash in feed urls' (#11 ) from fix-feeds into main Reviewed-on: robur/blog.robur.coop#11 Reviewed-by: dinosaure <romain.calascibetta@gmail.com>	2024-10-25 15:37:31 +00:00
dinosaure	80192cb685	Merge pull request 'Delete useless pin-depends and use yocaml.2.0.1' (#17 ) from delete-pin-depends into main Reviewed-on: robur/blog.robur.coop#17	2024-10-25 15:28:58 +00:00
Calascibetta Romain	9991309d38	Delete useless pin-depends and use yocaml.2.0.1	2024-10-25 17:28:24 +02:00
Hannes Mehnert	f65105c31a	Merge pull request 'dnsvizor, first article' (#16 ) from dnsvizor into main Reviewed-on: robur/blog.robur.coop#16 Reviewed-by: Reynir Björnsson <reynir@reynir.dk> Reviewed-by: dinosaure <romain.calascibetta@gmail.com>	2024-10-25 10:03:42 +00:00
Hannes Mehnert	6f77487c47	add a usages of dnsvizor, as suggested by @dinosaure	2024-10-25 11:46:22 +02:00
Reynir Björnsson	c85b9ad712	dnsvizor01.md: minor changes	2024-10-25 10:58:27 +02:00
Hannes Mehnert	4643347770	minor addition	2024-10-24 15:29:04 +02:00
Hannes Mehnert	6ee1282392	minor edits	2024-10-24 13:06:08 +02:00
Hannes Mehnert	52d6ce6b67	dnsvizor, first article	2024-10-24 12:52:28 +02:00
Hannes Mehnert	06b0b673c6	Merge pull request 'add arguments article' (#8 ) from add-arguments into main Reviewed-on: robur/blog.robur.coop#8 Reviewed-by: Reynir Björnsson <reynir@reynir.dk>	2024-10-22 10:25:40 +00:00
Reynir Björnsson	7093e64796	Drop double slash in feed urls	2024-10-22 11:40:58 +02:00
Hannes Mehnert	db5e8fd9cb	add arguments article	2024-10-21 16:15:38 +02:00
Hannes Mehnert	9388e31171	README: minor fix	2024-10-21 13:29:57 +02:00
Hannes Mehnert	0b0c57de5c	Merge pull request 'add-finances-article' (#7 ) from add-finances-article into main Reviewed-on: robur/blog.robur.coop#7	2024-10-21 11:29:05 +00:00
Hannes Mehnert	f1c0e05e81	minor adjustments	2024-10-21 13:28:28 +02:00
Hannes Mehnert	8ced832149	minor	2024-10-19 22:38:46 +02:00
Hannes Mehnert	e1618b8c2c	minor edit	2024-10-19 22:37:27 +02:00
Hannes Mehnert	a1dbffeb7f	minor: clarify that tls 1.3 was a grant	2024-10-19 22:36:07 +02:00
Hannes Mehnert	21abbd9f94	use a better chart	2024-10-19 22:34:44 +02:00
Hannes Mehnert	73dd1a52c7	ec string: fix typo	2024-10-19 14:17:29 +02:00
Hannes Mehnert	4076bdff9e	use € instead of EUR, add a plot	2024-10-19 13:48:29 +02:00
Hannes Mehnert	86dbd5df8c	minor updates (include september money for 2024), add expenses section	2024-10-19 13:35:32 +02:00
Hannes Mehnert	62c58c5c30	edits	2024-10-19 13:14:24 +02:00
Hannes Mehnert	843b7a887f	initial	2024-10-19 13:13:18 +02:00
Reynir Björnsson	3deddd702f	Allow commonmark extensions	2024-10-16 11:57:39 +02:00
Reynir Björnsson	33ef4926e2	Merge pull request 'Implement tags' (#4 ) from yocaml2-tags into main Reviewed-on: robur/blog.robur.coop#4	2024-10-16 09:45:46 +00:00
Reynir Björnsson	90fc53c8d2	css: ok, it looks better with background-color higlighting	2024-10-09 12:10:14 +02:00
Reynir Björnsson	6c79caeb19	css: highlight targeted tag-box	2024-10-09 12:08:03 +02:00
Reynir Björnsson	3b1d9f0805	Implement tags All tags are now on a single page. This is easier to implement with yocaml2's architecture.	2024-10-09 11:51:14 +02:00
Reynir Björnsson	e54e40c6aa	Merge pull request 'Upgrade to the unreleased version of YOCaml 2' (#2 ) from yocaml2 into main Reviewed-on: robur/blog.robur.coop#2 Reviewed-by: Reynir Björnsson <reynir@reynir.dk>	2024-10-04 11:24:34 +00:00
Reynir Björnsson	74ad2da16d	Update usage message, too	2024-10-04 13:20:50 +02:00
Reynir Björnsson	34539125c4	Depend on dune 3.16 We depend on a feature newer than 3.14.2 and it works for 3.16.	2024-10-04 13:15:13 +02:00
Reynir Björnsson	4ff887acee	Explain remote is including branch	2024-10-04 13:14:38 +02:00
Calascibetta Romain	6b343af91c	Upgrade to the unreleased version of YOCaml 2	2024-09-30 20:39:49 +02:00
`@ -1,2 +1,2 @@`
	`(lang dune 2.8)`	`(lang dune 3.16)`
	`(name blogger)`	`(name blogger)`
		`@ -1 +0,0 @@`
			`val make : unit * Collection.Articles.t -> Yocaml.Rss.Channel.t`