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:

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.

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:

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

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é
  • pages de tags
• liste de N derniers articles 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

• 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