---
robots: noindex, nofollow
---
màj : 20/04/2023; 28/08/2023

[Toc]
# A - Objectif : Rzine review mémo (infraordinaire)
> [name=Hugues] Pour une *taylorisation/spécialisation* des tâches éditoriales

## I - Suivi/observation/description des opérations éditoriales

### publication de ressources ([gitlabhumanum](https://gitlab.huma-num.fr/rzine/ressources_rzine))
- proposition de ressources
- débat/vote : [boards gitlab](https://gitlab.huma-num.fr/rzine/ressources_rzine/-/boards), réunions de validation
- mise en ligne des ressources

### publication d'actualités

### publication/éditorialisation de fiches rzine
- courriels type
- auteurices
- reviewers
- création (à partir d'un *fork*) du dépôt rzine-reviews de la fiche
- nom
- description

### Publication d'une fiche après le processus de relecture terminé

> [name=Hugues]
> Exemple du processus réalisé pour la mise en ligne d'une fiche Rzine.

1) Après avoir bien **vérifier que la fiche est prête**
- présence de tous les éléments indispensables comme
- la partie session info,
- le lien de téléchargement ves les données,
- ...,
- Attention, on a besoin
- d'un résumé,
- de thématique(s) (nomenclature rzine)
- et de mots clefs !!
2) l'éditeurice principal·e, en accord avec au moins un·e directeurice de la collection, **valide la publication finale**.

3) L'éditeurice principal·e **complète le readMe de la fiche** sur Github de la manière suivante :

# TITRE [<img src="https://rzine.fr/img/Rzine_logo.png"  align="right" width="120"/>](http://rzine.fr/)
### SOUS-TITRE

**Auteur·es :**   
Prénom Nom (Affiliation 1, Affiliation 2)   
Prénom Nom (Affiliation 1, Affiliation 2)   
 
**Evaluateur·trices :**   
Prénom Nom (Affiliation 1, Affiliation 2)   
Prénom Nom (Affiliation 1, Affiliation 2)  

**Résumé :**   
xxxxxxxxxx xxxxxxx xxx xxxxxxxxxx xxxxx xxxxx xxxxxxxxxx xxxxxx xxx

Pour la consulter, cliquez [**ici**](https://rzine-reviews.github.io/xxxxxxxxxxx/)

[![DOI:à venir](https://zenodo.org/badge/DOI/10.48645/xxxx-xxxx.svg)](https://doi.org/10.48645/xxxx-xxxx)
[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](http://creativecommons.org/licenses/by-sa/4.0/)

**Ensuite, il/elle peut démarrer l'ajout du contenu sur Rzine .fr**

4) L'éditeur **ajoute dans un sous-répertoire du dossier *docs*** (site web rzine.fr) :
- La fiche en format HTML (index.html) et **TOUTES LES DEPENDANCES !** (dossier figures, data...)
- Les données téléchargeables (data.zip)

:::info
Pour plus de cohérence, le nom du sous-répertoire doit avoir le même nom dans ***docs***, ***content/publication_rzine*** et dans ***content/publication***
:::

5) L'éditeur principal **crée les pages suivantes** sur Rzine .fr :

- A) Modifier (ou créer) Les fiches des auteur·es
- Pour cela, ajouter un nouveau dossier auteur dans *content/authors*
- Dans ce dossier, ajouter une image obligatoirement nommée *avatar* (.png ou .jpeg) + un fichier markdown style auteur (repartir d'un markdown déjà existant).
- La valeur du paramètre "authors:" (ex authors: **hpecout**) devra être utilisée dans la landing page de la ressource.
- Si la fiche est déjà créée : **modifier le paramètre** ***user_groups:*** en indiquant

user_groups:
- Publications Rzine

- B) La landing page de la fiche (obligtoire pour le dépôt d'un DOI)

- Ajouter un nouveau dossier dans *content/Publication_rzine*
- Dans ce dossier, ajouter
- une image d'illustration obligatoirement nommée *featured* (.png ou .jpeg)
- \+ un fichier bibtex (citation)
- \+ un fichier markdown style Publication_rzine (repartir d'un markdown déjà existant).
:grey_question:Configuration style fiche rzine : c'est très ressemblant à l'ajout d'une ressource diverse mise à part que les paramètres suivants sont toujours les mêmes :
`publication_types: ["2"]`
`update: ["0"]`
`projects: [rzine]`
`sources: ["8"]`
`languages : ["0"]`
`url_source: '/docs/[sous-repertoire]/index.html'`
`url_code: 'https://github.com/rzine-reviews/[sous-repertoire]'`
`url_dataset: '/docs/[sous-repertoire]/data.zip'`
- Bien utiliser le *codename* (ex : *hpecout*) des auteurs (cf. fiche auteur).
- Ajouter le texte markdown du document, structuré de la manière suivante :

**Auteur·es** : [Prénom Nom](https://rzine.fr/authors/codename/), [Prénom Nom](https://rzine.fr/authors/codename/)   
**Evaluateur.rices** : [Prénom Nom](https://rzine.fr/authors/codename/), [Prénom Nom](https://rzine.fr/authors/codename/)   
**Editeur.rices** : Prénom Nom](https://rzine.fr/authors/codename/), [Prénom Nom](https://rzine.fr/authors/codename/)   

#### Résumé 

Incenderat autem audaces usque ad insaniam homines ad haec, quae nefariis egere conatibus, Luscus quidam curator urbis subito visus: eosque ut heiulans baiolorum praecentor ad expediendum quod orsi sunt incitans vocibus crebris. qui haut longe postea ideo vivus exustus est.

#### Citation

<div style="font-size:15px;">
Lambert N (2021). <i>"TITRE"</i>, doi: XXxxXX/XXXXxX, URL: url_de_la_landing_page>.
</div>

<p class="d-inline-flex" style="gap:12px;"><a href="https://doi.org/XXXXxx/XXXXxX"><img style="gap:12px;margin-top:15px;margin-bottom:15px;padding:0;" src="https://zenodo.org/badge/DOI/10.48645/a4ra-yr11.svg" alt="DOI: 10.48645/a4ra-yr11"></a><a href="http://creativecommons.org/licenses/by-sa/4.0/"><img style="gap:12px;margin-top:15px;margin-bottom:15px;padding:0;" src="https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg" alt="License: CC BY-SA 4.0"></a></p>

:::danger
**Il faudra de nouveau modifier cette page pour ajouter le DOI une fois qu'il sera déposé.**
:::

6) Mettre en ligne la landing page. Du coup, demander aux administrateurs principaux du site (hugues, tim et Seb) de faire un merge pour passer les modifications sur la branche en production (rzine.fr).

7) Une fois la page en ligne, L'éditeur contact Marion G. en lui fournissant :
- l'URL du dépôt de la fiche pour le résumé (ex : https://github.com/rzine-reviews/ironcurtain)
- L'URL de la page index.html stockée dans le répertoire ***docs*** (ex: https://rzine.fr/docs/20191125_ironcurtain/)
- L'URL de la landing page mis en ligne (ex: https://rzine.fr/publication_rzine/20191125_ironcurtain/)

A partir de ces infos, Marion sera en mesure de déposer un DOI et une notice sur HAL

8) Une fois le dépôt du DOI réalisé, l'éditeur·rice ajoute le DOI sur :
- Sur la fiche déployé sur GitHub
- Sur le ReadME GitHub
- Sur la landing page (+ URL sur HAL) et dans le fichier de citation (.bib)

:::danger
**IMPORTANT** : une fois ces modifs réalisées, il faut écraser l'ancienne version de la fiche stockée sur rzine.fr (index.html) dans le sous-répertoire ***docs**
:::

9) Dupliquer le sous-répertoire ***content/Publication_Rzine/xxxxxx*** dans ***content/publication/*** pour que la fiche soit également dans la liste des publications diverses

10) L'éditeur.rice demande aux administrateurs principaux du site (hugues, tim et Seb) de faire un merge pour passer toutes les modifications sur la branche en production (rzine.fr)

**Et c'est publié ! On peut communiquer !**

### ajout d'auteurices

## II - Transformations de structure/infra
- modification des modèles de document (*template*)
- choix quarto

## III - Documentation : publier une fiche Rzine
[HTML](https://rzine-reviews.github.io/documentation/)
[Github](https://github.com//rzine-reviews/documentation)

### 1 - relecture/corrections/màj
(1) rejoindre le groupe [hypothesis](https://hypothes.is/groups/ZZAnNQxm/rzine)
(2) lire les [annotations directement sur le document html publié](https://hyp.is/go?url=https%3A%2F%2Frzine-reviews.github.io%2Fdocumentation%2F&group=ZZAnNQxm)
- [name=Raphaëlle]
- [x] [§1 une fiche rzine ?](https://rzine-reviews.github.io/documentation/#une-fiche-rzine)
**commentaires/suggestions/corrections** : voir le [§ dédié](#%C2%A711-Crit%C3%A8res-d%E2%80%99acceptation)
- [name=Raphaëlle]
- Julie: première proposition de changement de la structure de la doc de présentation de fiche, voir [fork Git](https://github.com/JGravier/documentationrzine).
- [x] [§2 Le package `rzine`](https://rzine-reviews.github.io/documentation/#le-package-rzine)
**constat** : l'installation du package éditorial rzine est explicitée dans la documentation github ET cette explication est reprise partiellement dans le [readme du dépôt gitlab humanum du package](https://gitlab.huma-num.fr/rzine/package/-/tree/master?ref_type=heads)
**proposition** : créer un lien dans le readme du dépôt gitlab humanum vers le § du package rzine dans la documentation github (ne pas dupliquer la doc) (voir [à discuter/décider](#B---A-discuterd%C3%A9cider))
**commentaires/suggestions/corrections** : voir le [§ dédié](#%C2%A72-Le-package-rzine)

- [name=]

### 2 - commentaires / questions

#### §1.1 Critères d'acceptation
> les données **et jeux de données** utilisés dans le cadre de la démonstration doivent obligatoirement être **publiés**, sourcées ~~, libres de droit et mises à disposition~~ **et librement réutilisables**.

**Argumentaire :** il n'y a pour l'instant aucun cadre formalisé (licence "donnée" en tant que telle, qui est seulement publiée et donc publique et de libre réutilisation) pour des critères demandés pour les données (voir argumentaire [$1.4](#%C2%A714-Publication-et-licence-d%E2%80%99utilisation))

**Exemples :**
- question de la _non-réplication_ des données utilisées INED (Go) de _geomorphon_
- question du _re-dépôt_ nakala (ou autre) des données produites par l'exécution fiche
- bouton _télécharger les données_

#### §1.2 Forme et modèle de fiche (*template*)
> paradigme de la **programmation lettrée**
>
**Question :** Ajouter une ou plusieurs références ou une note de base de page comme définition ?

:::warning
**Références :** à ajouter ?
:::
#### §1.3 Soumission et évaluation
> Pour être soumise à évaluation, **une fiche doit être déposée et déployée sur GitHub** (cf. partie 5).

**Question:** est-il possible de proposer une fiche initialement au sein d'une autre instance, avant qu'elle soit forkée dans le repo rzine-reviews ?

#### §1.4 Publication et licence d’utilisation
> son **stockage pérenne**

**Question** : le lien est github (sic!) or, une logique attendue dans l'ESR, est de mobiliser les *datacenters* institutionnels, la fiche reste-t'elle sur github ou enviage-t'on de la déposer sur gitlab humanum ou ailleurs ?

> Etre auteurice d’une fiche Rzine, c’est accepter que votre publication (HTML) soit mise à disposition sous les conditions d’utilisation de la licence Creative Commons BY-SA 4.0, **que les données et jeux de données associés ont été ou sont rendus publics et que leur réutilisation est libre** et que son code source réponde aux conditions d’utilisation de la licence MIT.

**Argumentaire** : outre la fiche et son code, les jeux de données sont eux-mêmes susceptibles de faire l'objet d'une [publication (préalable ou non à la publication de la fiche elle-même) et d'une réutilisation libre](https://recherche.data.gouv.fr/fr/actualite/focus-les-donnees-de-recherche-du-point-de-vue-du-droit)

**Question :** est-il envisagé de possibles adaptations de licences ouvertes, notamment pour des auteurices des [institutions publiques](https://www.data.gouv.fr/fr/pages/legal/licences/) ?
#### §2 Le package `rzine
> Le package rzine fournit le modèle (*template*) de ~~mise en page des fiches Rzine, ainsi que l’architecture de répertoire et l’ensemble des fichiers associés nécessaires~~ **document numérique (Pedauque, Salaün 2006) associé à une fiche rzine. Il comprend un ensemble de fichiers et une structure de répertoires correspondant à un package R. Il permet de déployer, en syntaxe Rmarkdown, le modèle readrzine d'un notebook R qui sera publié au format statique HTML**.
*Rk : ajout biblio.bib*

**Argumentaire** : suite aux travaux et webinaire du GT notebook, peut-être sommes nous plus à même de préciser ce que "fait" le package rzine et "ce qu'est" une fiche rzine ?

NB : "template" est systématiquement remplacé par "modèle (*template*)"
#### $2.1
> dépôt ~~de l'organisation~~ **du groupe** Rzine

correction de syntaxe dans le code et commentaire pour `remotes`
#### $2.2
> Utiliser le **modèle** (*template*) `readrzine` **- pas-à-pas**

**Argumentaire** : il s'agit bien d'un pas-à-pas ici, une expression "rassurante" pour qui ne connaît pas notre univeR... ;)

**Réorganisation partielle des sous-paragraphes :**
- Regroupement des paragraphes 2.2.1 (install package), 2.2.2 (espace de travail) **et 2.3 en 2.2.3 (knitter)** en **étapes** du pas-à-pas
- et réorganisation des modalités d'exécution de code R dans l'ordre des recommandations (Rstudio en 1. et lignes de code R en 2. ou 3.)

**Sur pandoc** (invisible dans le "knit" `readrzine` ;) : réorganisation des liens (vers le logiciel, vers la page d'installation) dans le texte

**Mention de fiche "vierge" ou en-tête "vierge"** : remplacement de "vierge" par "blanche" ou "vide"

# B - A discuter/décider
- [ ] dans le [readme du dépôt du package rzine](https://gitlab.huma-num.fr/rzine/package/-/tree/master?ref_type=heads), supprimer le texte (duplication) et faire un [lien vers le § du package rzine](https://rzine-reviews.github.io/documentation/#le-package-rzine) de la documentation github de la fiche rzine
- [ ] normaliser les noms/description des dépôts des fiches rzine publiées
> motivation : hétérogénéïté des noms des dépôts 
- [ ] intégré dans documentation au point 5, doit-on garder ou renommer la version initiale forkée de chez Grégoire [TutoExpressGithubLeCampionG](https://lecampiong.github.io/github_fiche_rzine/) ?
> motivation : homogénéïté du dépôt github des fiches