Pourquoi et comment ce site

Pourquoi

Marre des gestionnaires de contenus, des CMS avec des langages compliqués avec moultes bases de données qui, pour afficher des idées vous obligent à vous transformer en technicien/gestionnaire de site alors que le but n’est pas là.
Un blog est la présentation d’idées, et trop souvent on en oublie cette évidence en le transformant en une présentation artistique. Ce blog n’est alimenté que par une seule personne qui privilégie le texte et les idées à la présentation et à la débauche d’images, d’animations. Donc l’administration et la gestion des rédacteurs et modérateurs est inutile.
Ce blog est donc ultra minimaliste même si l’édition des articles permet tout de même une mise en page simple mais élégante. La mise en forme du texte, l’insertion de liens, d’images et de tableaux sont possibles (voir plus) mais ce n’est pas le but premier. On utilise ici le langage d’édition markdown.
Et surtout la base technique ne nécessite aucun produit (ni php, ni bdd). Seul l’interpréteur html des navigateurs suffira; on peut donc rédiger, tester sur son propre PC avant la publication.

Comment

pré-requis

On utilisera le logiciel pandoc pour générer les article au bon format. Installation:

apt install pandoc

Il existe plusieurs manières d’écrire les articles en markdown. J’ai privilégié un utilitaire en wysiwyg nommé ReText. Il est dans la bibliothèque standard de Debian. J’avais un temps testé KeenWrite mais il m’a fait plusieurs fois défault jusqu’à ne plus rien entendre. Donc out.. ReText est un des rares éditeurs qui a une présentation simple des mises en forme et un pré-visualisation en temps réel.

Ce gestionnaire de blog est à installer sur un PC, les articles seront édités et convertis sur place, il faudra ensuite les mettre en ligne. Il est donc organisé de la manière suivante:

• déjà tout est dans le même répertoire. J’avais mis les articles dans un répertoire séparé mais, pour les gestion de la feuille de style ça compliquait. Comme c’est pas le but – out
• les fichiers
  • txt ce sont en fait des modèles html qui servent à construire la page d’accueil et les articles.
  • Readme.md est le fichier qui présentera le blog dans la page d’accueil
  • generate.sh est la procédure qui génère tous les fichiers html. La procédure intègre aussi le tranfert sur le site final mais cette partie est à adapter à chaque cas
  • blog.py est appelé par la procédure generate.sh. Ce programme crée le fichier index.html
  • la feuille de style est unique pour tous; elle intègre la fléche de remontée dans un article
  • Les fichiers articles écrits en markdown doivent avoir la syntaxe suivante: préfixe en AAAA-MM-JJ (afin de les classer et les regrouper par année), nom de fichier dont les espaces sont remplacés par des blancs soulignée (ce qui permettra d’en déduire le titre en remplaçant les blancs soulignés par des espaces) et l’extension .md. Exemple de nom de fichier; 2023-01-01Bonne_année_à_tous.md
  • Les fichiers images à utiliser au minimum auront si possible, pour simplifier, le même nom (ou au moins la même racine) que l’article si ils s’y réfèrent.
• Donc un site vide devra comporter home.png et top.png, index.html, style.css; et à la partie génération de site on ajoutera generate.sh, blog.p et les fichiers txt.

Chronologie d’installation du logiciel: on met le logiciel où on veut, un répertoire dans “Mes Documents” semblant le plus approprié.

Chronologie de publication:

1. Écriture en markdown de l’article.
2. génération du/des fichiers html avec l’utilitaire generate.sh qui appellera blog.py (1)
3. transfert sur le site final (ftp, copy…) à éventuellement automatiser dans generate.sh.

Memo Markdown
Editeur Markdown
Convertisseur markdown-htlm et aide en ligne
Éditeur KeenWrite

1. Le programme python accepte les options suivantes:
   -i pour initialiser la date de publication (première fois ou pour tout renvoyer)
   -c pour convertir les fichiers md en html
   -g pour générer le fichier index.html
   -s pour envoyer les fichiers sur le serveur

Flux RSS

Il semblerait possible de s’abonner à un flux RSS de ce site en l’intégrant dans les alertes de Google.
Ce site explique comment.
Et j’ai créé un lien de flux, c’est celui-ci. À tester.

Divers

Update: N/A Contribue: Aide bienvenue Roadmap: Pas d’évolution prévue Changelog: V1.0 init version Author: Vangeles Contact: vanille.angeles@gmail.com Licence: GNU General Public License v3.0

¹ Abonnement - Se désabonner