fix(theme): submodule address to https

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "themes/clean-blog"]
 	path = themes/clean-blog
-	url = ssh://gitea@git.epheme.re:2222/fmouhart/pelican-clean-blog.git
+	url = https://git.epheme.re/fmouhart/pelican-clean-blog.git

readme.md

@@ -1 +1,45 @@
+This repository contains the sources necessary to build the blog at:
 <https://blog.epheme.re>
+
+# Dependencies
+
+To use this repository as intended, you need, to build the blog, the following
+software:
+
+- `git`
+- `make`
+- `uv`
+
+To synchronise the blog remotely with its intended target, the synchronisation
+is done using `rsync` over `ssh`.
+
+# Install
+
+To install a local copy to work on this blog, you also need the theme for it,
+available [there](https://git.epheme.re/fmouhart/pelican-clean-blog). It is
+embedded in the repository as a git submodule, so you can simply run git clone
+with the `--recurse-submodule` option:
+
+```sh
+git clone -- recurse-submodule https://git.epheme.re/fmouhart/blog.git fmouhart-blog
+```
+
+This blog relies on [pelican](https://getpelican.com) as a static site
+generator. To manage the different python dependencies of this project, we are
+using [`uv`](https://github.com/astral-sh/uv) as a python project manager.
+
+To download the dependencies, run `uv sync` or:
+
+```sh
+make init
+```
+
+# Development
+
+When writing an article, you can run the blog with livereload enabled with the command:
+
+```sh
+make dev
+```
+
+It’ll span a local development server on port `8000`: <http://localhost:8000>