Un site pour la promotion de catium - retour accueil
git clone git://bebou.netlib.re/site-catium
Log | Files | Refs | README |
commit 0a9c85fe037cfb8e3976dff3004a7194b0194fc0
parent a2fb5b18ae4c569406ebfa821fe00c7310ded0c2
Auterice: Arthur Pons <arthur.pons@unistra.fr>
Date: Wed, 25 Sep 2024 21:10:56 +0200
francium -> catium
Suite à la bonne réception de ce mail :
Salut à toutes et tous,
On m'a déjà plusieurs fois fait la remarque que francium était un nom
qui donnait une vibe un nationaliste. Je réponds toujours en expliquant
d'où le nom provient à savoir :
* on voulait un outil pour générer rapidement des pages html persos
pour les chercheureuses
* on voulait faire un exemple en choisissant une femme ayant fait de
la recherche à Strasbourg
* on a choisi Marguerite Perey, elle a découvert le francium, le nom
sonne bien et hop
C'est une histoire sympa à raconter, tout le monde comprend que le
souhait est de rendre hommage à une femme scientifique et non pas à
notre superbe nation et tout se passe bien.
Cela dit :
1. Ça peut être un peu fatiguant de "justifier" le nom à la longue
(bien que ce soit une opportunité de parler de sa génèse)
2. Il reste vrai que Perey a choisit ce nom "en hommage au pays dans
lequel avait eu lieu la découverte" dixit wikipedia ce qui, sans
être grave, me fait un peu rouler des yeux
Je ne m'en faisais pas vraiment un souci jusque là mais en relisant sa
page wikipedia je découvre qu'elle avait initialement choisi le nom
"catium" pour une histoire de quantité de cation (suis pas chimiste).
Irène Joliot-Curie (la fille de ses parents) l'en a dissuadé parce que
cela faisait trop penser aux chats.
Je me demande alors si ce n'est pas une superbe opportunité de :
1. se débarrasser du léger inconvénient d'avoir un nom un peu "make
france great again"
2. faire une super référence au fait que la dernière étape de la
génération des pages dans francium est un cat
3. laisser les gens penser qu'il y a peut-être une référence à des
chatons là dedans (toujours populaire chez les libristes)
4. ne rien perdre de la référence à la genèse de francium ni de
l'occasion de parler de Marguerite Perey (en lui rendant même
encore plus hommage puisque l'on aurait choisi son nom de coeur)
Qu'est-ce que vous en pensez ?
Bonne journée 🙂 Arthur
Diffstat:
| M | README | | | 2 | +- |
| M | contents/documentation/construire.sh | | | 18 | +++++++++--------- |
| M | contents/documentation/histoire.sh | | | 42 | +++++++++++++++++++++--------------------- |
| M | contents/documentation/usage.sh | | | 26 | +++++++++++++------------- |
| M | contents/index.sh | | | 30 | +++++++++++++++--------------- |
| A | contents/screenshots/185.155.93.110.webp | | | 0 | |
| A | contents/screenshots/adele.help.webp | | | 0 | |
| A | contents/screenshots/arthur.bebou.netlib.re.webp | | | 0 | |
| A | contents/screenshots/estrades.huma-num.fr.webp | | | 0 | |
| A | contents/screenshots/katzele.netlib.re.webp | | | 0 | |
| A | contents/screenshots/semis.bebou.netlib.re.webp | | | 0 | |
| A | contents/screenshots/techdays.pages.unistra.fr.webp | | | 0 | |
| M | db/galerie | | | 6 | +++--- |
| M | layouts/html | | | 14 | +++++++------- |
| M | makefile | | | 2 | +- |
15 files changed, 70 insertions(+), 70 deletions(-)
diff --git a/README b/README @@ -1,4 +1,4 @@ -Site pour la promotion de francium +Site pour la promotion de catium Pour construire le site faire : diff --git a/contents/documentation/construire.sh b/contents/documentation/construire.sh @@ -1,10 +1,10 @@ #! page -title: Construire francium -description: "Comment construire francium de zéro" +title: Construire catium +description: "Comment construire catium de zéro" section: main -# Comment vous aussi vous auriez pu construire francium +# Comment vous aussi vous auriez pu construire catium Imaginez vouloir construire une site et être doté.e d’un outil qui traduit le format dans lequel vous préférez écrire en html. Peut-être que vous aimez @@ -172,9 +172,9 @@ pourtant sur une autre solution que nous allons partir, une solution qui nous permettera plus de flexibilité par la suite et surtout la possibilité de dynamiquement créer certaines parties du contenu markdown. -### le format “à la francium” et la prolifération des scripts shell +### le format “à la catium” et la prolifération des scripts shell -Cette autre solution consiste à faire du document index.md lui même un script. Et oui, dans francium, si c’est pas une makefile, c’est un script shell. Comme le dit le meme : +Cette autre solution consiste à faire du document index.md lui même un script. Et oui, dans catium, si c’est pas une makefile, c’est un script shell. Comme le dit le meme : shshsh shshsh shshsh sh sh shshsh shshsh sh sh sh sh sh sh sh sh sh shsh sh sh sh sh sh shshsh @@ -396,7 +396,7 @@ l’avoir, est toujours une bonne information à prendre. Ce système peut être utilisé pour créer des typologies de pages (article, notes etc) qui seraient générées de manières différentes. -En réalité dans francium c’est le shebang +En réalité dans catium c’est le shebang #! /usr/bin/env ./page @@ -494,7 +494,7 @@ nouveau dossier : save() cat >> "$tmpdir/$1" show() cmark "$tmpdir/$1" -Et voilà, à une exception près[^7] vous avez recréé absolument tout Francium dans +Et voilà, à une exception près[^7] vous avez recréé absolument tout Catium dans sa version non étendue. Bravo ! ## Automatiser la génération : le makefile @@ -517,7 +517,7 @@ orchestrer la génération de notre site. Tout le nécessaire pour que make puisse fonctionner doit être inscrit dans un fichier nommé makefile à la racine du projet. -Francium utilise Gnu Make et quelques syntaxes lui sont très spécifiques. A +Catium utilise Gnu Make et quelques syntaxes lui sont très spécifiques. A l’avenir un effort sera peut-être consenti pour génériciser la syntaxe. ### Le but @@ -688,7 +688,7 @@ C’est pour palier ce genre de scénarios qu’il existe une directive `.PHONY` permet de lister ce genre de règles[^8]. Ainsi make saura qu’il faut, pour ces règles, ignorer la préexistence de la cible. -Et voilà, vous avez réécrit le makefile de francium tel qu’il existe aujourd’hui ! +Et voilà, vous avez réécrit le makefile de catium tel qu’il existe aujourd’hui ! [^1]: que l’on utilisera pour les exemples dans ce document [^2]: documentée ici https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_07_04 diff --git a/contents/documentation/histoire.sh b/contents/documentation/histoire.sh @@ -1,6 +1,6 @@ #! page -title: Histoire de francium -description: "Histoire et nature de francium" +title: Histoire de catium +description: "Histoire et nature de catium" section: main @@ -16,7 +16,7 @@ sh sh sh sh sh sh sh shshsh shshsh shshsh sh sh 🚶🔫🚶 - Always has been ``` -## Une histoire de Francium +## Une histoire de Catium Je discutais un jour avec une personne du contenu que l'on consommait sur internet. Le dialogue était à peu près le suivant, elle commence : @@ -80,7 +80,7 @@ il est possible d'argumenter qu'hugo est un logiciel trop complexe et faisant trop de choix pour vous. On pourrait épiloguer là dessus, pour une autre fois et une autre personne peut-être. -Si ces outils ont relancé l'intérêt pour les sites statiques, Francium souhaite +Si ces outils ont relancé l'intérêt pour les sites statiques, Catium souhaite à son tour profiter de l'intérêt nouveau pour les sites statiques afin de relancer l'intérêt pour une certaine approche du développement d'outils numériques, que l'on choisit à tort ou à raison d'appeler convivialiste. Plus @@ -89,39 +89,39 @@ Strasbourg autour du besoin de générer des sites statiques pour le domaine de la recherche. L'une des utilisations identifiées était la création de page personnelles pour les chercheureuses. Pour en faire une démonstration il avait été décidé de faire la page de Marguerity Perey, chercheuse française ayant -travaillé à l'université de Strasbourg et ayant découvert... le francium.\ +travaillé à l'université de Strasbourg et ayant découvert... le catium.\ Ce projet initial de générer des pages personnelles de chercheureuses n'est pas mort. Un template html et une feuille de style adéquate, à l'identité visuelle Unistra, pourrait aider à le concrétiser. C'est finalement la page perso de Marc Chantreux aujourd'hui hors ligne qui -sera le premier site généré et publié grâce à Francium. A date du 11 janvier -2023 le site généré par ce dépôt est le seul en ligne généré par Francium. Le +sera le premier site généré et publié grâce à Catium. A date du 11 janvier +2023 le site généré par ce dépôt est le seul en ligne généré par Catium. Le socle du projet a été conçu et développé par Marc Chantreux. Après la mise en ligne de ce site le développement s'est étendu à d'autres membres du collectif Kaztele. Il y aurait bien d'autres choses à dire sur la genèse du projet, d'où le titre -de cette rubrique, *Une* histoire de Francium. J'invite les autres parties +de cette rubrique, *Une* histoire de Catium. J'invite les autres parties prenantes à écrire la leur. -## Sur la nature de Francium +## Sur la nature de Catium Un jour Marc et moi sortions de plusieurs heures de discussions pendant -lesquelles nous avons plusieurs fois fait référence à Francium comme un outil +lesquelles nous avons plusieurs fois fait référence à Catium comme un outil atomique, se suffisant à lui même. En disant ça nous mettions peut-être dans la tête de nos interlocuteurs l'image d'un simple couteau qui tient dans la main, dont les contours sont nettes et la forme plus ou moins identique pour tous ses utilisateurices. En sortant nous nous sommes partagés une intuition commune : cette image n'est pas celle qui se formait dans nos têtes quand on parlait de -Francium. Il est compliqué de définir le périmètre exact de ce qu'est Francium. +Catium. Il est compliqué de définir le périmètre exact de ce qu'est Catium. Où est-ce que l'outil commence, où est-ce qu'il se termine ? Qu'est-ce qui relève du générateur et qu'est-ce qui relève du contenu du site ? Ces interrogations se retrouvent dans certains choix techniques que le projet est -amené à prendre. Ce dépôt permet aujourd'hui de versionner à la fois Francium +amené à prendre. Ce dépôt permet aujourd'hui de versionner à la fois Catium (sans savoir ce que c'est exactement) et le contenu du site de Katzele. Si nous -voulions créer un dépôt Francium pour d'autres projets nous devrions répondre à +voulions créer un dépôt Catium pour d'autres projets nous devrions répondre à ces questions pour détricoter l'un de l'autre. Pourquoi n'est-ce pas trivial ? @@ -154,22 +154,22 @@ par défaut tel que fourni dans le dépôt source s'il existe un jour ? La versi actuelle maintenue pour le site de Katzele ? L'idée de générer un flux atom via du shell ? Bref on en a pas fini. -Nous pourrions décliner ces questions pour toutes les parties de Francium. Pour +Nous pourrions décliner ces questions pour toutes les parties de Catium. Pour revenir à l'échange avec Marc, il avait d'avantage mûri la question que moi. -Francium ne devrait pas être pensé comme, un outil indivisible mais une comme +Catium ne devrait pas être pensé comme, un outil indivisible mais une comme armature intellectuelle soutenant des outils, certains pré existants, d'autres créés pour l'occasion. D'ailleurs pour le site de Katzele sed est un outil autant nécessaire qu'atomic même si l'un a été développé pour et l'autre non.\ Si l'on voulait pousser cette idée d'armature intellectuelle jusqu'au bout nous -pourrions dire que Francium est un système décrit à travers de la documentation +pourrions dire que Catium est un système décrit à travers de la documentation et non pas ses implémentations. Il n'existerait donc pas de sous-ensemble de ce -dépôt que l'on pourrait raisonnablement appelé Francium. Ce dépôt ne serait que -la première implémentation de Francium, celle sous une forme qui rend les +dépôt que l'on pourrait raisonnablement appelé Catium. Ce dépôt ne serait que +la première implémentation de Catium, celle sous une forme qui rend les services dont le collectif Katzele a besoin à un instant T. -Il existera probablement un jour un dépôt Francium dont le contenu aura été le +Il existera probablement un jour un dépôt Catium dont le contenu aura été le résultat de choix plus ou moins raisonnables, fait en fonction des projets qui -veulent utiliser Francium sur le moment[^1]. Ce sera certainement pour le mieux. Si +veulent utiliser Catium sur le moment[^1]. Ce sera certainement pour le mieux. Si le concept un peu prétentieux d'armature intellectuelle nous sert à quelque chose ce sera de faire sens de cette tension : construire un outil convivialiste qui respecte autant que possible l'autonomie des personnes qui @@ -180,4 +180,4 @@ Tracer le contour optimisant la convivialité et la facilité de publication étant hasardeux, on le fera à main levée et on compensera comme il se doit, en conversant entre humains, en vivant ensemble. -[^1]: c'est aujourd'hui le cas [ici](http://git.bebou.netlib.re/francium) +[^1]: c'est aujourd'hui le cas [ici](http://git.bebou.netlib.re/catium) diff --git a/contents/documentation/usage.sh b/contents/documentation/usage.sh @@ -1,29 +1,29 @@ #! page -title: Utiliser francium -description: "Comment utiliser francium" +title: Utiliser catium +description: "Comment utiliser catium" section: main -# Comment utiliser Francium +# Comment utiliser Catium -Ce document existe pour apprendre à utiliser Francium sans pour autant lire +Ce document existe pour apprendre à utiliser Catium sans pour autant lire toute la documentation se trouvant aujourd'hui dans [cet article](construire.html). -A noter, Francium est conçu pour être modifiable et même inciter à l'être. -Ainsi ce document documente comment utiliser Francium dans sa version +A noter, Catium est conçu pour être modifiable et même inciter à l'être. +Ainsi ce document documente comment utiliser Catium dans sa version "minimale". Des cas de modifications relativement simples seront couverts à la fin de ce document. -Il ne faut pas s'attendre à pouvoir modifier Francium facilement sans aucune -compétence en make/markdown/shell/html. L'idée est de faire de Francium un +Il ne faut pas s'attendre à pouvoir modifier Catium facilement sans aucune +compétence en make/markdown/shell/html. L'idée est de faire de Catium un logiciel favorisant l'apprentissage des ces technologies dont on estime qu'elles constituent un socle de compétences de bases en informatique. On pourrait évidemment débattre de ce que l'on inclu dans ce socle ou pas. ## Dépendances -En l'état Francium nécessite +En l'état Catium nécessite * de choisir un ou plusieurs formats dans lesquels écrire le site (du markdown par ex) @@ -37,7 +37,7 @@ markdown. ## Générer le site -Francium utilise GNU Make pour orchestrer la génération du site. Les règles de +Catium utilise GNU Make pour orchestrer la génération du site. Les règles de génération sont écrites dans le fichier `makefile`. Pour lancer la génération faire @@ -148,7 +148,7 @@ exécutables. Ils doivent commencer par la ligne #! /usr/bin/env ./page pour être préprocessés par le script `page`. Ils doivent ensuite contenir un -ensemble de métadonnée. En l'état Francium propose +ensemble de métadonnée. En l'état Catium propose * `title: "titre de la page"` pour renseigner le contenu de la balise `<title>`, à savoir ce qui s'affiche dans le titre de l'onglet de votre navigateur @@ -273,7 +273,7 @@ d'autres morceaux du site, de la date etc. Voilà, à partir de là si vous savez écrire du markdown et que vous n'avez pas besoin d'autre chose que des pages simplistes comme celles générées avec le template fourni vous avez les cartes en main pour créer votre site avec -Francium. Cela dit l'esprit de l'outil est qu'il est de nature "hackable" avec +Catium. Cela dit l'esprit de l'outil est qu'il est de nature "hackable" avec des compétences que l'on juge, dans le collectif, comme étant de bonnes candidates pour être des compétences "socles" dans l'informatique. @@ -281,7 +281,7 @@ En dessous nous voyons quelques cas élémentaires de modifications qui pourraient vous intéresser ou vous mettre sur la bonne piste. Pour des exemples plus aboutis voir [la galerie](/#galerie). -## Modifier francium +## Modifier catium Admettons que vous vouliez apporter les modifications suivantes à l'existant : diff --git a/contents/index.sh b/contents/index.sh @@ -1,17 +1,17 @@ #! /usr/bin/env ./page -title: Francium +title: Catium author: Arthur Pons -description: "Francium est un générateur de site statique mettant l'accent sur la simplicité, l'interopérabilité et la portabilité" +description: "Catium est un générateur de site statique mettant l'accent sur la simplicité, l'interopérabilité et la portabilité" section: main Un générateur de site statique nommé après l'élement chimique -[francium](https://fr.wikipedia.org/wiki/Francium) découvert par la chimiste +[catium](https://fr.wikipedia.org/wiki/Catium) découvert par la chimiste [Marguerite Perey](https://fr.wikipedia.org/wiki/Marguerite_Perey). ## Philosophie -francium est un logiciel ayant pour ambition : +catium est un logiciel ayant pour ambition : * d'être petit et simple * de faire peu de suppositions sur vos besoins @@ -21,25 +21,25 @@ francium est un logiciel ayant pour ambition : * d'être aussi extensible que possible * d'être sobre en ressource -Afin de satisfaire ces propriétés la version canonique de francium offre très +Afin de satisfaire ces propriétés la version canonique de catium offre très peu de fonctionnalités. Elle propose plutôt une implémentation très simple d'un système de templating en shell POSIX depuis lequel artisanalement construire son -site. Les contributeurs à l'outil disent parfois de francium qu'il est davantage +site. Les contributeurs à l'outil disent parfois de catium qu'il est davantage un "échafaudage intellectuel" qu'un logiciel ou framework aux contours bien définis. -En ce sens la plupart des sites construit avec francium l'étendent pour y +En ce sens la plupart des sites construit avec catium l'étendent pour y inclure de nouvelles fonctionnalités au gré de leurs besoins. Pour trouver des exemples jetez un coup d'œil à la [galerie](#galerie). Vous pouvez copier-coller du code que vous y trouverez ou, mieux encore, prendre contact avec la ou les personnes derrière un site qui vous plait pour échanger sur la façon dont -francium pourrait vous être utile ! +catium pourrait vous être utile ! ## Se lancer -Pour générer le site par défaut de francium vous devez télécharger le code : +Pour générer le site par défaut de catium vous devez télécharger le code : - $ git clone git://bebou.netlib.re/francium + $ git clone git://bebou.netlib.re/catium et construire le site : @@ -47,7 +47,7 @@ et construire le site : chmod +x contents/index.sh mkdir -p public; contents/index.sh > public/index.html ---------------------------- - Première exécution de francium, merci d'aller modifier le code juste en dessous + Première exécution de catium, merci d'aller modifier le code juste en dessous de ce paragraphe dans le fichier "page". Cela vous permettra de choisir un ou plusieurs transcripteurs pour votre site. Si une ou plusieurs des lignes déjà présentes vous conviennent vous pouvez la ou les décommenter en retirant le "#" @@ -105,10 +105,10 @@ section: main ## Documentation -[Pour savoir d'où vient francium et les questions que l'on se pose sur ses frontières](documentation/histoire.html) +[Pour savoir d'où vient catium et les questions que l'on se pose sur ses frontières](documentation/histoire.html) -[Explication complète du code de francium](documentation/construire.html) +[Explication complète du code de catium](documentation/construire.html) -[Guide sur l'utilisation de francium et des modifications élémentaires](documentation/usage.html) +[Guide sur l'utilisation de catium et des modifications élémentaires](documentation/usage.html) -Pour des exemples de sites existant utilisant francium voir [la galerie](/#galerie). +Pour des exemples de sites existant utilisant catium voir [la galerie](/#galerie). diff --git a/contents/screenshots/185.155.93.110.webp b/contents/screenshots/185.155.93.110.webp Binary files differ. diff --git a/contents/screenshots/adele.help.webp b/contents/screenshots/adele.help.webp Binary files differ. diff --git a/contents/screenshots/arthur.bebou.netlib.re.webp b/contents/screenshots/arthur.bebou.netlib.re.webp Binary files differ. diff --git a/contents/screenshots/estrades.huma-num.fr.webp b/contents/screenshots/estrades.huma-num.fr.webp Binary files differ. diff --git a/contents/screenshots/katzele.netlib.re.webp b/contents/screenshots/katzele.netlib.re.webp Binary files differ. diff --git a/contents/screenshots/semis.bebou.netlib.re.webp b/contents/screenshots/semis.bebou.netlib.re.webp Binary files differ. diff --git a/contents/screenshots/techdays.pages.unistra.fr.webp b/contents/screenshots/techdays.pages.unistra.fr.webp Binary files differ. diff --git a/db/galerie b/db/galerie @@ -1,13 +1,13 @@ http://katzele.netlib.re Le site du collectif Katzele -Premier site construit et publié avec francium, il intègre une version rudimentaire des boucles pour l'affichage des articles. Si vous voulez voir comment le générateur a commencé c'est par ici ! +Premier site construit et publié avec catium, il intègre une version rudimentaire des boucles pour l'affichage des articles. Si vous voulez voir comment le générateur a commencé c'est par ici ! git clone git://katzele.netlib.re/katzele.netlib.re /screenshots/katzele.netlib.re.webp %% http://semis.bebou.netlib.re Le site d'Elsa Van Kote -Structure de blog assez classique. Site plutôt simple pour prendre en main francium. +Structure de blog assez classique. Site plutôt simple pour prendre en main catium. /screenshots/semis.bebou.netlib.re.webp @@ -42,7 +42,7 @@ azda %% https://gitlab.huma-num.fr/estrades/presentations Des slides de présentation du projet estrades -Petit hack de francium pour générer des slides en html. Un peu de JS pour passer d'une slide à l'autre avec les flèches. Très ingénieux. +Petit hack de catium pour générer des slides en html. Un peu de JS pour passer d'une slide à l'autre avec les flèches. Très ingénieux. git clone https://gitlab.huma-num.fr/estrades/presentations https://gitlab.huma-num.fr/estrades/presentations /screenshots/estrades-presentations.webp diff --git a/layouts/html b/layouts/html @@ -7,12 +7,12 @@ layout() <<@@ cat <meta name="viewport" content="width=device-width,initial-scale=1.0"> <link rel="stylesheet" href="/style.css"/> <meta name="description" content="$description"> - <meta name="author" content="Francium" /> + <meta name="author" content="Catium" /> <link rel="icon" href="/favicon.png" /> <meta property="og:type" content="website" /> - <meta property="og:title" content="Francium" /> + <meta property="og:title" content="Catium" /> <meta property="og:description" content="" /> - <meta property="og:url" content="http://francium.bebou.netlib.re" /> + <meta property="og:url" content="http://catium.bebou.netlib.re" /> <meta property="og:image" content="" /> </head> <body> @@ -20,7 +20,7 @@ layout() <<@@ cat <header> <nav id="menu" aria-label="menu principal"> <ul> - <li id="nom"><a href="/#">francium</a></li> + <li id="nom"><a href="/#">catium</a></li> <li><a href="/#philosophie">Philosophie</a></li> <li><a href="/#se-lancer">Se lancer</a></li> <li><a href="/#galerie">Galerie</a></li> @@ -35,9 +35,9 @@ layout() <<@@ cat $(show main) </main> <footer> - Ce site est généré avec francium<br> - Code du site : <a href="http://git.bebou.netlib.re/site-francium/log.html">http://git.bebou.netlib.re/site-francium</a><br> - Code de francium : <a href="http://git.bebou.netlib.re/francium/log.html">http://git.bebou.netlib.re/francium</a><br> + Ce site est généré avec catium<br> + Code du site : <a href="http://git.bebou.netlib.re/site-catium/log.html">http://git.bebou.netlib.re/site-catium</a><br> + Code de catium : <a href="http://git.bebou.netlib.re/catium/log.html">http://git.bebou.netlib.re/catium</a><br> Contact : katzele@framalistes.org </footer> </div> diff --git a/makefile b/makefile @@ -18,7 +18,7 @@ clean:; rm -r public/* exec:; chmod +x ${sources} -deploy:; rsync -hvr public/* pi@bebou:~/francium.bebou.netlib.re/ +deploy:; rsync -hvr public/* pi@bebou:~/catium.bebou.netlib.re/ updatescreens:; bin/updatescreens