2025-02-15 11:45:18 +01:00
|
|
|
|
This repository contains the sources necessary to build the blog at:
|
2019-04-22 17:05:20 +05:30
|
|
|
|
<https://blog.epheme.re>
|
2025-02-15 11:45:18 +01:00
|
|
|
|
|
|
|
|
|
|
# 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
|
2025-02-15 12:35:11 +01:00
|
|
|
|
git clone --recurse-submodule https://git.epheme.re/fmouhart/blog.git fmouhart-blog
|
2025-02-15 11:45:18 +01:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
2025-02-15 13:27:44 +01:00
|
|
|
|
When writing an article, you can run the blog with `livereload` enabled with the
|
|
|
|
|
|
command:
|
2025-02-15 11:45:18 +01:00
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
make dev
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
It’ll span a local development server on port `8000`: <http://localhost:8000>
|
