111 lines
5.0 KiB
Markdown
111 lines
5.0 KiB
Markdown
# orgmode-to-gemini-blog
|
||
|
||
Génération de capsules gemini et blog html à partir d'articles en fichiers Orgmode.
|
||
|
||
exemple avec le blog de DragonFeu.
|
||
`sources/dragonfeu_blog`
|
||
|
||
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.
|
||
|
||
## 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
|
||
python3 pictures_resize.py
|
||
```
|
||
|
||
Vos miniatures sont crées, et les images originales sont déplacées dans un dossier output/pictures/{année_courante}.
|
||
|
||
Un texte orgmode sera mis à disposition dans output/images_{année_courante].org pour les intégrer dans votre ou vos articles Org. Un préfixe de chemin relatif de ces images est configuré dans `website_config.py`
|
||
|
||
Il vous faudra placer les images sur votre serveur.
|
||
|
||
## prérequis pour installation
|
||
|
||
Avoir des articles au format org, les mettre dans un dossier source/nom_du_blog, et avoir quelques bibliothèques dispo:
|
||
|
||
```shell
|
||
bash install.sh
|
||
```
|
||
[2024-11-04]
|
||
Testé avec:
|
||
Pandoc 2.9.2.1
|
||
http://fr.archive.ubuntu.com/ubuntu/pool/universe/p/pandoc/pandoc_2.9.2.1-3ubuntu2_amd64.deb
|
||
|
||
Python 3.10.12
|
||
## Conversion des fichiers Org vers gemini et html
|
||
Ceci va convertir ce qui se trouve dans le dossier `sources/tykayn_blog`
|
||
et produire un site web dans `html_output/tykayn_blog`
|
||
ainsi qu'une capsule gemini dans `capsules-gemini/tykayn_blog`
|
||
|
||
```shell
|
||
bash converters.sh tykayn_blog
|
||
```
|
||
|
||
|
||
## Conversion de blog en capsule gemini
|
||
:PROPERTIES:
|
||
:CREATED: [2024-11-02 12:08:22]
|
||
:END:
|
||
|
||
L'idée est d'avoir un ensemble de billets de blogs en texte simple versionnés avec git et servis par une capsule gemini ainsi que par un site web.
|
||
On aura besoin de convertir des billets existants, et de rédiger les nouveaux dans un format qui nous convient, par exemple markdown ou orgmode afin de rendre le tout le plus pérenne possible.
|
||
On aura aussi besoin de référencer les images dans un dossier de notre dépot, et de gérer les relations entres articles pour que les liens aient du sens sur la capsule gemini autant que dans la version web.
|
||
On souhaite aussi fournir un flux RSS, et un template de billet de blog avec une entête et un pied de page commun qui donne des moyens de contact, de soutenir l'auteur, et de revenir à l'accueil.
|
||
On prendra aussi en charge différentes pages:
|
||
- à propos
|
||
- contact
|
||
- nos projets
|
||
- une liste des articles triés par date.
|
||
Il nous faudra aussi un script de mise à jour du blog qui se charge de mettre à jour le flux rss, le dépot git.
|
||
On peut aller chercher de l'automatisation dans la gestion de plusieurs capsules différentes en tagguant les articles par nom de blog, ce qui nécessite un fichier de config pour les correspondances.
|
||
|
||
# export d'articles existants
|
||
## Depuis wordpress
|
||
Connec à la base de données mysql, et extraction de chaque article pour récupérer la partie HTML et la convertir en markdown et en fichiers org.
|
||
|
||
## Depuis des fichiers orgmode.
|
||
J'écris en orgmode une base de connaissances qui contient aussi un export de mes anciens billets de blog dans un dossier par blog. Pour cibler quels billets utiliser pour quel blog j'ai donc deux possibilités: leur chemin de fichier, ou des tags particuliers présents dans les fichiers org.
|
||
[[id:5a197a1b-ddfe-4c79-8934-d9a28ab6df65][Textes de blog en préparation]]
|
||
https://forge.chapril.org/tykayn/org-report-stats
|
||
|
||
# Flux créatif
|
||
Rédaction,
|
||
conversion,
|
||
completion des nouveaux articles,
|
||
régénération des indexs et flux rss,
|
||
mise à jour du dépot git,
|
||
publication des pages.
|
||
# Sources d'inspiration:
|
||
Offpunk
|
||
LazyBlog
|
||
Dotclear, Wordpress, Hugo, Pélican
|
||
Pandoc, PandocGmi
|
||
https://github.com/njamescouk/pandocGmi/tree/master
|
||
|
||
# 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
|
||
# Fait
|
||
- pages de tags
|
||
- génération de fichiers gmi
|
||
- config par site web de son nom de domaine
|
||
- navigation sur les pages d'article
|
||
- gestion des langues dans la source et la destination
|
||
- gestion multi site et multi langue |