{ "id": "https://jon.recoil.org/blog/2025/04/this-site.html", "title": "This site", "link": "https://jon.recoil.org/blog/2025/04/this-site.html", "updated": "2025-04-07T00:00:00", "published": "2025-04-07T00:00:00", "summary": "Summary", "content": "

This site

I've spent a lot of time over the past few years working on Odoc, the OCaml documentation generator, so when it came time to (re)start my own website and blog, I found it hard to resist thinking about how I might use odoc as part of it. We've spent a lot of time recently trying to make odoc more able to generate structured documentation sites, so I've gone all in and am trialling using it as a tool to generate my entire site. This is a bit of an experiment, and I don't know how well it will work out, but let's see how it goes.

Additionally, I've recently been working on a project currently called odoc_notebook, which is a set of tools to allow odoc mld files to be used as a sort of Jupyter-style notebook. The idea is that you can write both text and code in the same file, and then run the code in the notebook interactively. Since I've only got a webserver, all the execution of code has to be done client side, so I'm making extensive use of the phenomenal Js_of_ocaml project to get an OCaml engine running in the browser.

My focus has initially been on getting 'toplevel-style' code execution working. As an example, let's write a little demo.

Continue reading here

", "content_type": "html", "author": { "name": "Jon Ludlam", "email": null, "uri": "https://jon.recoil.org/" }, "categories": [], "source": "https://jon.recoil.org/atom.xml" }