up readme

This commit is contained in:
Tykayn 2025-02-20 17:41:43 +01:00 committed by tykayn
parent d885085861
commit 5fc7b49405
2 changed files with 19 additions and 220 deletions

View file

@ -7,17 +7,27 @@ exemple avec le blog de DragonFeu.
Les articles sont écrits dans le dossier source/, leur nom permet de déduire l'ordre de publication grâce à une date YYY-MM-DD en début de nom de fichier.
Une fois vos fichiers Orgmode placés dans un dossier de sources/votre_blog, lancez la commande:
```shell
bash converters.sh votre_blog
```
Si vous n'avez pas encore de fichiers org dedans, une structure vierge sera crée avec des dossiers pour les pages de contenu, les articles en français, et en anglais.
## création d'un article
Pour un article en langue En (english), sur le blog cipherbliss_blog, donner le titre entre guillemets ainsi:
```shell
python3 new_article.py cipherbliss_blog en "Creation of a gemini blog"
```
On peut se faire un alias de commande en bash pour n'avoir à remplir que le titre pour un blog donné.
### Inclure des images
Dans un article on souhaite avoir des thumbnails liées à leur version plus grande et hébergées sur notre site.
Placez vos images et autres documents de votre article dans le dossier, puis lancez la commande de conversion et déplacement de vos fichiers.
```commandline
```shell
python3 pictures_resize.py
```
@ -90,16 +100,19 @@ https://forge.chapril.org/tykayn/org-report-stats
# Roadmap
- template footer article: gestion article suivant et précédent
- sérendipité, navigation
- liens en bas de page vers d'autres articles, et les précédents et suivants.
- auto tagging avancé avec plusieurs termes reliés à un seul, liste personnalisée par configuration de blog
- liste de N derniers articles développés sur l'accueil, 10 par défaut
- réécriture des liens internes
- conversion des liens avec nom de domaine si relatifs
- détection des ID org-roam pour réécrire les liens html
- réécriture des url des images vers le dossier courant
- les gains de performance pour ne pas régénérer les pages déjà faites alors qu'elles n'ont pas été modifiée, et un rendu statique un peu plus joli
- mettre un lien vers le fichier Org d'origine, disponible sur une forge en ligne si on l'a mis en config du site web.
# Fait
- liste de N derniers articles développés sur l'accueil, 10 par défaut
- template footer article: gestion article suivant et précédent
- sérendipité, navigation
- liens en bas de page vers d'autres articles, et les précédents et suivants.
- auto tagging avancé avec plusieurs termes reliés à un seul, liste personnalisée par configuration de blog
- pages de tags
- génération de fichiers gmi
- config par site web de son nom de domaine