-------------------------------------------------------------------------------- id: 8e220f62-f0fc-4394-8bdf-f9b3db30711e title: cipherbliss_blog -------------------------------------------------------------------------------- ```{=org} #+CREATED: 2024-11-03 12:41:56 ``` ```{=org} #+SLUG: création-d'un-blog-gemini ``` ```{=org} #+BLOG: cipherbliss_blog ``` # Création d'un blog gemini {#création-dun-blog-gemini-1} Et hop, un générateur qui fait le café à partir de fichiers orgmode ou markdown. 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, sur le blog cipherbliss~blog~, donner le titre entre guillemets ainsi: ```shell python3 new~article~.py cipherbliss~blog~ en "Creation of a gemini blog" ``` ## prérequis pour installation Avoir des articles au format org, les mettre dans un dossier source/nom~dublog~, 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 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 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. ## 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 https://forge.chapril.org/tykayn/org-report-stats 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. Offpunk LazyBlog Dotclear, Wordpress, Hugo, Pélican Pandoc, PandocGmi => https://github.com/njamescouk/pandocGmi/tree/master https://github.com/njamescouk/pandocGmi/tree/master * config par site web de son nom de domaine * réécriture des liens internes * réécriture des url des images vers le dossier courant * réparer la génération de fichiers gmi * template footer article: gestion article suivant et précédent * conversion des liens avec nom de domaine si relatifs ```{=html} ``` * navigation sur les pages d'article - gestion des langues dans la source et la destination * gestion multi site et multi langue