]> Git — Sourcephile - sourcephile-web.git/blob - README.md
add Hakyll experiments
[sourcephile-web.git] / README.md
1 Expérimentations de seulement deux jours pour voir ce que permet `hakyll` pour générer un site Web statique. Ça devrait pouvoir me dépanner un peu en attendant plusieurs mois que j'em arrive au stade de remettre sur pieds `hdoc`...
2
3 Pour charger l'environnement Nix de dév :
4 ```bash
5 direnv allow
6 ```
7
8 Note : il faut un `nix` >2.3 pour pouvoir utiliser `flake.nix`. Autrement débrouillez-vous avec `$NIX_PATH` et `nix-shell`.
9
10 FIXME : Le `nixpkgs` non-portable dans `flake.lock` est dû à mes patchs en local, utilisez votre propre `nixpkgs` post 20.09, du genre :
11 ```nix
12 inputs.nixpkgs.url = "github:NixOS/nixpkgs/ b69f140a8028e4718bde4e5082f8df38e50b7971"
13 ```
14
15 Pour générer `_site/` :
16 ```bash
17 cabal run site -- rebuild
18 ```
19
20 Tant que le Haskell n'est pas modifié il est possible d'avoir une reconstruction automatique rapide avec :
21 ```bash
22 cabal run site -- watch
23 ```
24
25 PS : Oui le formatage de mes pauvres posts en Markdown laissent à désirer. Sur un téléphone c'est galère. Et si `hdoc` revoit le jour il me faudra de toute façon les formater autrement.
26
27 # TODO
28 - [ ] Peut-être utiliser des catégories (dossiers) en plus des tags, typiquement pour les DDC.
29 - [ ] Peut-être utiliser des fields au lieu de bullet points pour certaines des entêtes des DDC. Ou pas, car ce serait trop figé.
30 - [ ] Mettre le corps des posts dans les feeds Atom/RSS.
31 - [ ] Simplifier encore plus les CSS, mais là encore je préfère faire ça avec `hdoc`.