# GT Notebook Workshop proposal

<span style="color:green;font-size:16pt;">**Prochaine réunion : <br>vendredi 28 novembre à partir de 15h30-16h**</span>
https://webconf.univ-rouen.fr/greenlight/rey-px2-ewg-7av

# Slides program WIP (1st part - morning)
https://gitlab.huma-num.fr/gt-notebook/workshop/chr-2025/slides

## General issues

- enter reproducibility paradigms
- render accessible and readable data or files
- experiment new and shared scientific digital writing
- working within historical facts and trends
- epistemological and ecosophy issues

## Who are we ?

- french reproducible research network
- notebook working group
- rzine editors
- jdh editors
- pluri disciplinary team

## Data, KG and questions adressed

- data science / research data
- knowledge graphs (semantic web / ontologies) : factgrid
- building a shared exploration / methodology
- eliciting work in progress / literate programming paradigm
- data collection with externalities / a perpetual research question (index, proof)

> données au regard de leur reproductibilité computationnelle (**au sens mécanique**)
Créée / produite par une humain, calculée/simulée ou issue d'observation (appareillée)

> généricités & échelles de la donnée (polysémie) : on s'intéresse au rôle des données dans le calcul ou dans la recherche
exemples

> G. Simondon parle lui de mécanologie
> E. Nunes parle d'instrumentation https://journals.openedition.org/filigrane/82

## Workshop short presentation

## Editorialization

# Editors' point of view (2nd part - morning)

## Rzine

### Pour la diffusion et le partage de ressources sur la pratique de R en sciences humaines et sociales

- génèse du projet
-

## JdH

# Workshop (3rd part - afternoon)

https://gitlab.huma-num.fr/gt-notebook/workshop/chr-2025/atelier

---

# Workshop Luxembourg (9-12 décembre 2025)

- conférence Humanités numériques (public plutôt histoire, études de texte)
- possible visite du [Department of Geography and Spatial Planning - Université du Luxembourg](https://www.uni.lu/fhse-en/research-departments/department-of-geography-and-spatial-planning/)
- [Premier doc de travail](https://hackmd.io/UwFTJXZBSGC6qtqRadIFig)
- [Document soumis](https://filesender.renater.fr/?s=download&token=ce174892-cd70-44bd-a445-e88f9f4ddab4)

# Organisation

Workshop 9 décembre
Proposition par le comité local:
9h30 -13h / 14h30 -17h
DONE: mail envoyé à Mattia Bunel - comité local

# Description

- atelier d'une journée (le pourquoi du comment du notebook)
- [Site web de l'appel](https://2025.computational-humanities-research.org/cfp/)
- Projet :
- base de données histoire dans SparQL
- https://programminghistorian.org/en/lessons/intro-to-linked-data

## Déroulé

[[Slides]](https://gitlab.huma-num.fr/gt-notebook/workshop/chr-2025/slides/-/tree/main?ref_type=heads)
- ce qu'est un notebook ?
- requêter et mobiliser la donnée
- objectifs & implcations techniques
- un récit avec une API Sparql https://database.factgrid.de/query avec les questions possibles : https://database.factgrid.de/wiki/FactGrid:Sample_queries
- 1 peu de reproductibilité, 1 peu litteracy, 1 peu de notebook - public historien & littéraire (pratique de logiciels - gephi et autres "presse-bouton")

[[Atelier]](https://gitlab.huma-num.fr/gt-notebook/workshop/chr-2025/atelier)
atelier (VM) avec Jupyter notebook (python)
- frameworks (proposer différents rendus ? (quarto, mystmd, notebook "classique") / schéma/stack technique ?)
- Libs utilisées
- rdflib
- shapely
- ...
- notebook personnalisé par participant⋅e (reproductibilité du notebook?) - gestion des credentials
- pas d'écriture de code, interaction avec SparQL (connaissance préalable requise)

[[Revues]]

- 2 revues (exemples)
- ~~on part de la stack JdH~~ présentation de JdH - Élisabeth https://github.com/C2DH/journal-of-digital-history-jupyter-stack
- [Vidéo tuto](https://journalofdigitalhistory.org/en/guidelines/AuthorGuideline-mac?idx=4)
- présentation R-Zine - Sébastien

**Jupyter book - Quarto - MystMD**

Example ici: Quarto - MystMD
- https://gricad-gitlab.univ-grenoble-alpes.fr/so-shs/literate_programming/TP_published/mon_super_notebook_python
- https://cours-376c29.gricad-pages.univ-grenoble-alpes.fr/#/title-slide
- https://cours-376c29.gricad-pages.univ-grenoble-alpes.fr/#/jupyter-vs-quarto

## Environnement d'execution

- ~~VMs C2DH~~
- ~~VMs In2P3 (ils sont ok)~~
- Alernative possible => aller vers un déploiement de Jupyter Hub sur 1 grosse VM plutot que 10 Jupyter Lab => avantage + souple sur le nb et la gestion utilisateurs : https://tljh.jupyter.org/en/latest/howto/admin/resource-estimation.html

- ~~10 VM IN2P3 (Sébastien & Mattia)~~
- ~~8 Gb RAM~~
- ~~2 VCpu~~
- ~~5 go disque~~
- ~~type de provisionnement (ansible, terraform, ...) ?~~
- 1 VM
- 30 personnes * 2 go / 4 go => ~120Go
- 30 * 1 cpu => 30 cpu + 20% overhead => 36 CPU

**Ok pour IN2P3 - une seule de 128Go/64 vCPU**

## Rendu éventuel auprès du comité éditorial

Ok - Mattia a répondu

## Supports

- Slides de presentation : [repo](https://gitlab.huma-num.fr/gt-notebook/workshop/chr-2025/slides) et [deploiment](https://slides-7f8d7a.gitpages.huma-num.fr/#/title-slide)
- Activite : [repo](https://gitlab.huma-num.fr/gt-notebook/workshop/chr-2025/atelier#) et [deploiment](https://atelier-61c03b.gitpages.huma-num.fr/)

CSS
https://github.com/myst-templates/lapreprint-typst/tree/main
https://typst.app/
https://jupyter-book.github.io/myst-theme/?path=/docs/components-grid-system--docs

# Logistique

- Etablissement budget voyage - hôtel : prise en charge C2DH

## Participant⋅es
Elisabeth, Mattia, ~~Hugues~~, Sébastien, Raphaëlle, Konrad (sous réserve)
- Atelier le 9 décembre - journée
- suite de la conf ? Raphaëlle

## dépenses

hotel - train - inscription
1 nuit prise en charge

besoin de savoir les préférences - C2DH se charge de prendre les billets et les réservations

A voir pour le traiteur le midi

Pour les nuits d'hôtel: https://2025.computational-humanities-research.org/venue/accommodation/
TO DO: confirmer nombre nuit d'hôtel