Concevoir un site web avec l'éditeur de texte Stylo et le langage Julia

[marie-flesch]

Programming Historian en Français a reçu une proposition de leçon intitulée "Concevoir un site web avec l'éditeur de texte Stylo et le langage Julia"' de la part d'Antoine Fauchié, Josselin Morvan (@sardinecan), et Julien Dehut.

Les objectifs d'apprentissage de la leçon proposée sont les suivants :

• proposer une approche complémentaire du format de balisage Markdown et des leçons liées, en se basant sur un outil existant, l'éditeur de texte Stylo, et un langage de programmation utilisé par la communauté scientifique (notamment en DH), Julia.
• expliquer comment récupérer des documents et des données provenant de l'éditeur de texte Stylo
  (https://stylo.huma-num.fr) via son API (https://stylo.huma-num.fr/graphql).
• utiliser plusieurs scripts Julia, et les adapter pour créer un site web (structure simple de quelques pages/rubriques).
• appréhender une structure classique : scripts de récupération de données, stockage des données, gestion des gabarits des pages web, modification d'une feuille de styles.

J'ai diffusé cette proposition au sein de l'équipe française afin d'obtenir leurs impressions. Nous avons évalué cette proposition en prenant en compte les considérations suivantes :

• Ouverture : nous préconisons l'utilisation de logiciels libres, de langages de programmation libres et d'ensembles de données libres.
• Accès global : nous servons un lectorat travaillant avec différents systèmes d'exploitation et des ressources informatiques variées.
• Multilinguisme : nous encourageons la conception de méthodologies et les outils qui peuvent être appliqués ou adaptés pour être utilisés dans des contextes de recherche multilingues. L'ensemble des termes techniques, souvent d'origine anglaise, doivent apparaître traduits au moins une fois dans le document.
• Durabilité : nous nous engageons à publier des ressources d'apprentissage qui peuvent rester utiles au-delà des interfaces graphiques actuelles et des versions actuelles des logiciels.

Nous sommes heureux·ses d'avoir invité les auteurs e à développer cette proposition en une soumission complète.

La discussion du comité de rédaction a notamment tourné autour du logiciel Julia, qui est très peu représenté sur notre site. Nous avons, par conséquent, demandé aux auteurs de présenter brièvement le langage dans la leçon (comparaison avec Python, différences et similitudes, ses atouts).

Le dossier de soumission doit inclure :

• Le texte de la leçon (écrit en Markdown)
  Pour vous guider, nous vous recommandons la leçon de Sarah Simpkin Getting Started with Markdown.
• Figures : images / graphiques (si utilisés)
• Données : livres de code / échantillons de données (si utilisés)

Nous demandons aux auteurs de partager leur dossier de soumission avec notre équipe de publication par courriel, en mettant en copie l'adresse de l'équipe francophone.

Nous avons convenu d'un délai de soumission un peu supérieur à 90 jours, pour accommoder les emplois du temps des auteurs. La date de soumission est fixée au 28 février 2026. En cas de retard, nous demandons aux auteurs de nous prévenir, sur ce ticket ou via email.

Une fois le dossier de soumission reçu, notre équipe d'édition traitera le matériel et préparera un aperçu de la version initiale. Elle publiera un commentaire dans ce ticket pour indiquer l'emplacement des les fichiers clés, ainsi qu'un lien vers l'aperçu où les contributeurs pourront lire la leçon au fur et à mesure de la progression du projet. La leçon sera ensuite confiée à un·e membre de l'équipe francophone qui en assurera le suivi éditorial.

Si nous n'avons pas reçu le dossier de soumission avant le 28 février, je contacterai les auteurs. Pour garantir l'efficacité de notre processus d'édition, ce ticket sera clos si nous ne reçevons aucune nouvelle.

Notre médiatrice attitrée est Hélène Huet (français). N'hésitez pas à la contacter si vous souhaitez qu'un observateur impartial adresse un problème. Contacter la médiatrice n'aura aucun impact sur l'issue d'une évaluation par les pairs.

[anisa-hawes]

Bonjour Antoine, Josselin, et Julien (+ Marie)

I’m taking a year-end break Friday 19th December - Monday 5th January. If you post here during that time, please be mindful that I won't be on hand to offer support as usual.

I’ll pick up any GitHub notifications, tasks and actions upon my return.

With thanks for your patience,
Anisa.