Compare commits

..

5 Commits

6 changed files with 26 additions and 9 deletions

1
.gitignore vendored
View File

@ -1,5 +1,4 @@
output
__pycache__
*.pid
plugins
cache

6
.gitmodules vendored
View File

@ -1,3 +1,9 @@
[submodule "themes/clean-blog"]
path = themes/clean-blog
url = https://git.epheme.re/fmouhart/pelican-clean-blog.git
[submodule "plugins/autopages"]
path = plugins/autopages
url = https://git.epheme.re/fmouhart/pelican-autopages.git
[submodule "plugins/i18n_subsites"]
path = plugins/i18n_subsites
url = https://git.epheme.re/fmouhart/pelican-i18n_subsites.git

View File

@ -12,7 +12,10 @@ publish:
clean:
uv run invoke clean
init:
%.mo: %.po
msgfmt "$^" -o "$@"
init: themes/clean-blog/translations/fr/LC_MESSAGES/messages.mo
uv sync
.PHONY: clean build publish dev init

1
plugins/autopages Submodule

Submodule plugins/autopages added at 7ebe350704

1
plugins/i18n_subsites Submodule

Submodule plugins/i18n_subsites added at 5903058c97

View File

@ -9,26 +9,32 @@ software:
- `git`
- `make`
- `uv`
- `gettext`
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:
To install a local copy to work on this blog, you also need other components,
such as the [theme](https://git.epheme.re/fmouhart/pelican-clean-blog) and
[some](https://git.epheme.re/fmouhart/pelican-autopages)
[plugins](https://git.epheme.re/fmouhart/pelican-clean-blog). Those are embedded
in the repository as a git submodule. You can thus simply run git clone with the
`--recurse-submodule` option:
```sh
git clone -- recurse-submodule https://git.epheme.re/fmouhart/blog.git fmouhart-blog
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:
Moreover, translations are managed with python `gettext` which requires
compiling the translation file.
Those two steps are performed with the following command:
```sh
make init
@ -36,7 +42,8 @@ make init
# Development
When writing an article, you can run the blog with livereload enabled with the command:
When writing an article, you can run the blog with `livereload` enabled with the
command:
```sh
make dev