Programming Historian en français : les valeurs de la science ouverte au service de la formation en humanités numériques

Programming Historian en français : les valeurs de la science ouverte au service de la formation en humanités numériques

Journée des logiciels libres en Archives, Bibliothèques et Centres de documentation (LibreABC)

9 septembre 2025 - Musée d'ethnographie de Genève

Alexandre Wauthier et Marie Flesch

<div>
						
						
						
						
							<div style='font-size:1.2em'>Présentation proposée par :
						
						👨‍💻 **Alexandre Wauthier <a href="https://orcid.org/0000-0001-9437-4529" target="_blank"><img src="images/orcid.png"></a> <a href="https://www.humatheque-condorcet.fr/" target="_blank"><img src="images/logo_humatheque.png" alt="logo humatheque" style="height: 70px; background: transparent;"></a>**
						Ingénieur d'études chargé d'accompagnement de projets numériques, Humathèque, Campus Condorcet, CNRS (Paris-Aubervilliers) Rédacteur à Programming Historian en français

👩‍💻 **Marie Flesch <a href="https://orcid.org/0000-0003-2139-1517" target="_blank"><img src="images/orcid.png"></a> <a href="https://www.univ-lorraine.fr/" target="_blank"><img src="images/logo_universite_lorraine.png" style="height: 50px; background: transparent;"></a>** 
						Maîtresse de conférences à l’Université de Lorraine (Nancy) Rédactrice en cheffe de Programming Historian en français
						</div>
						---

<div style='font-size:1.2em'>Plan :</div>
						
						
						1. Programming Historian, l’émergence d’une revue 
						2. Qu’est-ce qu’une leçon? 
						3. Un processus éditorial ouvert 
						4. Enjeux et perspectives 
						5. Pourquoi et comment contribuer?

---
						
						
						
						1. Programming Historian, l'émergence d'une revue

---

Au commencement était ...

---

<img src="images/ph-logo.png" width=10% height=5% style="vertical-align: middle;">
						D'une initiative anglophone...
						
						
							<ul class="custom-list">
							<li>2008 : Naissance de Programming Historian</li>
							<li>Initiative de William J. Turkel et Alan MacEachern (Université Western Ontario)</li>
							<li>Sous la forme d'un billet de blog exposant les intentions pour le projet.</li>
							<li>Projet initialement axé sur le langage de programmation Python</li>
							<li>Publié en libre accès dans le cadre d'un projet d'infrastructure numérique du Réseau canadien pour l'histoire et l'environnement
								<a href="https://niche-canada.org/research/niche-digital-infrastructure-project/the-programming-historian" target="_blank">
								<img src="images/niche-logo.png" width="7%" style="vertical-align: middle; margin-left: 0.5em;"></a>
							</li>
							<li>2012 : Programming Historian lancé en tant que journal scientifique en libre accès, évalué par des pairs, axé sur la méthodologie en humanités numériques.</li>
							</ul>

<aside class="notes">
							Les humanités numériques étudient l’impact de ces technologies sur le patrimoine culturel, les institutions de mémoire, les bibliothèques, les archives et la culture numérique. (Terras, 2011 ; Dacos & Mounier, 2015)
						</aside>
						---

...à une revue quadrilingue<img src="images/ph-lang.png" width=40% height=10% style="vertical-align: middle;">

---

<a href="https://programminghistorian.org/en" target="_blank">
						<img src="images/ph-en-logo.png" height="100" style="vertical-align: middle;"></a>
						2008 : Programming Historian

<a href="https://programminghistorian.org/es" target="_blank">
						<img src="images/ph-es-logo.png" height="100" style="vertical-align: middle;"></a>
						2018 : Programming Historian en español

<a href="https://programminghistorian.org/fr" target="_blank">
						<img src="images/ph-fr-logo.png" height="100" style="vertical-align: middle;"></a>
						2019 : Programming Historian en français

<a href="https://programminghistorian.org/pt" target="_blank">
						<img src="images/ph-pt-logo.png" height="100" style="vertical-align: middle;"></a>
						2021 : Programming Historian em português

<aside class="notes">
							2016 : ajout d'une publication en langue espagnole à la publication initiale en langue anglaise 
							2017 : publication de leçons traduites sous le titre de Programming Historian en español 
							2018, organisation d'un premier atelier d'écriture en espagnol et lancement d'un appel pour de nouvelles leçons en espagnol 
							La même année, nous avons ajouté une publication en français 
							2020 : une équipe lusophone s'est jointe 
							Indépendance éditoriale de chaque journal ou chapitre, support de l'équipe éditoriale et technique de ProgHist Ltd (Association de droit britannique, 2019).
						</aside>

---

2. Qu'est-ce qu'une leçon ?

---

<!--

-->
						<img src="images/capture_ecran_lecon_1.png" style="border:4px solid #3d7c81; border-radius:6px;" />

Entête d'une leçon (<a href="https://programminghistorian.org/fr/lecons/gestion-manipulation-donnees-r">lien</a>)

<aside class="notes">
						Les leçons de PH sont plus que des tutoriels, ou , tutoriels "augmentés", car : 
						- sont relues et évaluées par les pairs 
						- sont actualisés au fil du temps ; 
						- PH donne ses lettres de noblesse aux tutoriels. 
						</aside>

---

<img src="images/capture_ecran_lecon_2.png" style="border:4px solid #3d7c81; border-radius:6px; width:1000px;" />
						
						3 niveaux de difficulté (facile, moyen, avancé)
					
						---

Mention des personnes contributrices

---

DOI pour des enjeux de pérennité

<aside class="notes">
						DOI. Idée : donne de la légitimité, format académique
						</aside>		
						
						---

Plan de la leçon et traductions

<aside class="notes">
						Les auteur·ices s’adressent directement aux lecteur·ices
						</aside>

---

Exemple d'un code et d'une figure

<aside class="notes">
						Edition légère grâce au langage markdown
						</aside>

---

Des leçons plus que des tutoriels

- Cas d'usage et problématiques concrètes, inscrits dans un contexte de recherche
						- Jeux de données authentiques et adaptés
						- Réflexions méthodologiques
						- Solutions libres et _open source_ privilégiées
						- Formats ouverts
						- Bibliographie

---

<aside class="notes">
						- Publication des leçons au fil de l’eau 
						- Leçons classées par thèmes, comme des tutoriels
						</aside>

---

3. Un processus éditorial ouvert

---

Aspects techniques

- Git <img src="images/git.png" height="40" style="vertical-align: middle;">	
							- Gestion de versions qui permet de sauvegarder, suivre et collaborer sur des fichiers (surtout du code).
 							- Chaque modification est enregistrée avec un historique, facilitant le retour en arrière et le travail à plusieurs.

---

Aspects techniques

- GitHub <img src="images/github.png" height="40" style="vertical-align: middle;"> depuis 2015
							- Plateforme en ligne basée sur Git, qui héberge des dépôts de code et facilite la collaboration.
							- Centralise le flux de travail
							- Suivi des leçons avec les tickets (_issues_)

---

Aspects techniques

- Jekyll <img src="images/jekyll.png" height="40" style="vertical-align: middle;">
							- Générateur de site statique simple, conçu pour transformer du texte (Markdown) en site Web.
							- Indexation des leçons multilingues (cf. [_Concordance de traduction_](https://programminghistorian.org/translation-concordance))
							- Facilement intégré à GitHub : dépôt du code du site, puis déploiement gratuit avec GitHub Pages

---

Ces 3 éléments permettent :

- Une maintenance minimale
						- Un recours limité à l’externalisation des services
						- Un langage technique en commun
						- Des solutions libres et gratuites
						- et ...

---

#### De la **documentation**

2 dépôts principaux sur GitHub :

---

1 Wiki intégré à chacun des 2 dépôts GitHub :
						- Pour le site → https://github.com/programminghistorian/jekyll/wiki 
						- Pour le suivi des leçons → https://github.com/programminghistorian/ph-submissions/wiki

---

Accès au ticket GitHub d'une leçon <img src="images/github.png" height="40" style="vertical-align: middle;">

---

---

---

---

---

Processus éditorial accessible sur GitHub <a href="https://github.com/programminghistorian/ph-submissions"><img src="images/github.png" height="40" style="vertical-align: middle;"></a>

<div class="table-container">
						<table>
						<thead>
							<tr>
							<th>N° étape</th>
							<th>Intitulé</th>
							<th>Responsable</th>
							</tr>
						</thead>
						<tbody>
							<tr><td>0</td><td>Proposition</td><td>Rédacteur·ice en chef</td></tr>
							<tr><td>1</td><td>Soumission</td><td>Équipe de publication</td></tr>
							<tr><td>2</td><td>Édition initiale</td><td>Rédacteur·ice</td></tr>
							<tr><td>3</td><td>Révision 1</td><td>Auteur·ice & éditeur·ice</td></tr>
							<tr><td>4</td><td>Examen par pairs</td><td>Relecteur·ices & éditeur·ice</td></tr>
							<tr><td>5</td><td>Révision 2</td><td>Auteur·ice & éditeur·ice</td></tr>
							<tr><td>6</td><td>Durabilité + accessibilité</td><td>Équipe de publication</td></tr>
							<tr><td>7</td><td>Publication</td><td>Rédacteur·ice en chef</td></tr>
						</tbody>
						</table>

</div>

<aside class="notes">
						- Utilisation de l'écriture inclusive selon les principes arrêtés par l’Office québécois de la langue française (cf. B. <a href="https://programminghistorian.org/fr/consignes-auteurs">Règles typographiques</a> et <a href="https://programminghistorian.org/posts/bienvenue-ph-fr">Lancement de Programming Historian en français</a>
						</aside>	
						---

- Evaluation par les pairs, pour les leçons originales comme pour les traductions
						- Système éditorial ouvert en 4 langues
						- Licence CC-BY 4.0 (*Creative Commons Attribution*) sur toutes les leçons
						
						<aside class="notes">
						CC-BY : Licence libre qui permet d'utiliser, modifier et de partager une œuvre, même commercialement, tant que l’auteur·ice original·e est cité·e
						</aside>

---

- Équipe de rédaction à l'écoute du lectorat
						- Utilisation de _Programming Historian_ dans les cours, les formations ou les ateliers

<aside class="notes">
						- Leçon comme objet édité (article scientifique ?) prêt à l'emploi 
						- Cas d'études concrèts 
						- Données authentiques 
						- Réflexions sur la méthodologie
						</aside>

---

4. Enjeux et perspectives

---

Premier défi : le maintien des leçons à jour

Exemple d'un <a href="https://github.com/programminghistorian/jekyll/issues/3504">ticket</a> sur la maintenance d'une leçon

<aside class="notes">
						Logiciel Atom abandonné depuis novembre 2022
						</aside>

---

Information apparaissant au début de la <a href="https://programminghistorian.org/es/lecciones/publicar-archivos-tei-ceteicean#introducci%C3%B3n-y-software-que-usaremos">leçon</a>

<aside class="notes">
						Remplacement par VS Code 
						</aside>

---

Changement des modalités d'accès à l'API de Twitter, aujourd'hui X (<a href="https://programminghistorian.org/en/lessons/scalable-reading-of-structured-data">leçon</a>)

<aside class="notes">
						API : Application Programming Interface
						</aside>

---

Exemple d'une <a href="https://programminghistorian.org/en/lessons/retired/creating-new-items-in-zotero">leçon</a> dépubliée

<aside class="notes">
						Bibliothèque Python libZotero pour créer des items de manière semi-automatisée plus maintenue à jour
						</aside>

---

Deuxième défi : la pérennité de la plateforme

- GitHub <img src="images/github.png" height="40" style="vertical-align: middle;"> : racheté par Microsoft en 2018
						- Jekyll <img src="images/jekyll.png" height="40" style="vertical-align: middle;"> : paramétrage de plus en plus complexe
						- 2025 : discussion relative au renouvellement des infrastructures techniques (ticket GitHub n°<a href="https://github.com/programminghistorian/jekyll/issues/3530">3530</a>)

<aside class="notes">
						- Interrogations sur un changement de site statique ou d'hébergement de revue en discussion 
						- Jekyll pas abandonné, mais évolue lentement et principalement sous forme de maintenance ou de petits ajouts 
						- Dernière version stable (4.4.1) publiée le 29 janvier 2025 
						- Programming Historian propose un usage abouti de Jekyll, limites ?
						</aside>

---

Sauvegarde annuelle du dépôt Jekyll dans Zenodo

<a href="https://zenodo.org/records/10402479" target="_blank"><img src="images/DOI_badge_Zenodo_10402479.svg" height="20" style="vertical-align: middle;"></a>
						 (et sur GitHub <a href="https://github.com/programminghistorian/jekyll/releases" target="_blank"><img src="images/github.png" height="20" style="vertical-align: middle;"></a>)
						
						
						<aside class="notes">
						Toutes les leçons sont également archivées dans <a href="https://perma.cc/">Perma.cc</a>
						</aside>

---

Objectif : représenter des communautés de pratique ...

- Par sélection : une leçon doit aider à répondre à une problématique scientifique
						- Par prospection : _Programming Historian_ aspire à représenter les pratiques et les connaissances les plus récentes

<aside class="notes">
						- Problématique scientifique : par exemple TEI ou traitement de données avec R, ou _web scraping_ avec Python 
						- La leçon rend visible les personnes ayant contribué à sa publication
						</aside>

---

... en particulier dans le monde francophone

- Intégrer davantage un lectorat francophone situé dans les pays du Sud

- Hégémonie de l’anglais comme langue technique :
							- Langage standard pour les 4 chapitres
							- Difficulté à traduire une leçon en adaptant contexte didactique

<aside class="notes">
						- La leçon rend visible les personnes ayant contribué à sa publication
						- A l'image de _Programming Historian en español_ et sa communauté originaire d'Amérique du sud, très active 
						- Locuteur·ices francophones de Belgique, de Suisse et du Québec, mais aussi d'autres francophones, notamment sur le continent africain. 348 millions de francophones (RDC 50 M / Algérie 15 M / Maroc 13 M /Canada 11 M dont 8 M Québec / Cameroun 11 M / Côte d'Ivoire 9 M / Belgique 9 M / Madagascar 8 M / Tunisie 6M / Suisse 6 M., <a href="https://fr.statista.com/statistiques/1345913/nombre-francophones-par-pays-monde/">Nombre de francophones dans le monde, par pays en 2022</a>) 
						</aside>

---

<a href="https://programminghistorian.org/posts/appel-a-traductions">Appel</a> à traductions de leçons sur la TEI <img src="images/TEI.jpg" height="40" style="vertical-align: middle;">

<aside class="notes">
						Texte Encoding Initiative : format de balise XML et communauté académique travaillant sur le texte encodé

</aside>

---

<a href="https://programminghistorian.org/posts/fr-appel-evaluateur-ices">Appel</a> à évaluateur·ices (édition française)

<aside class="notes">
						Renouvellement et enrichissement d'un agenda d'évaluateur·ices
						</aside>

---

5. Pourquoi et comment contribuer à Programming Historian en français ?

---

Pourquoi contribuer ?

- Œuvrer à une recherche collaborative et durable
						- Intégrer une communauté francophone d'humanités numériques.
						- Proposer de nouvelles ressources éducatives libres et ouvertes
						- Avoir une expérience en rédaction technique
						- Participer à une publication selon les mêmes modalités qu'un article scientifique

---

Comment contribuer ?

- Écrire une nouvelle leçon
						- Évaluer une leçon
						- Assurer le suivi éditorial d’une leçon
						- Traduire une leçon
						- Faire des retours, des suggestions, signaler des problèmes
						- Proposer un soutien institutionnel

https://programminghistorian.org/fr/contribuer

Thank you! ¡Gracias! Merci ! Obrigado!

➡️ Lien vers le support :
alexandrewa.github.io/LibreABC-PH-2025/presentation.pdf

➡️ Lien vers le dépôt GitHub LibreABC-PH-2025

🔁 retour au début de la présentation