Sommaire

• • Sommaire
  • 1. Création et intitulé de l'article
  • • 1.1. Convention de nommage
    • 1.2. Espaces de travail
  • 2. Métadonnées des entretiens
  • • 2.1. Modèle standard des entretiens
    • 2.2. Description explicative des métadonnées
    • 2.3. Exemple de YAML d'un entretien
    • 2.4. Masque de saisie
  • 3. Textes
  • • 3.1. Balisage Markdown dans les entretiens
    • 3.2. Pseudo-classes utilisées
  • 4. Publication de l'article
  • • 4.1. Rattachement de l'article à l'espace de travail
    • 4.2. Rattachement de l'article au corpus
    • 4.3. Mise à jour du site

Cette partie vous présente la procédure de publication étape par étape d'un entretien dans la rubrique « Critiques » du site EcriSoi.

1. Création et intitulé de l'article

Pour ajouter un nouvel entretien sur le site, vous devez créer un nouvel article sur Stylo. Connectez-vous à votre espace sur l'éditeur Stylo, puis dans l'onglet « Articles », cliquez sur Créer un article.

Donnez un titre à votre article en suivant la convention de nommage ci-dessous puis cliquez sur Créer.

1.1. Convention de nommage

Afin de pouvoir retrouver plus facilement les articles dans Stylo, nous avons mis en place une convention de nommage pour chacune des sections du site.

Pour les entretiens, le titre commence par le terme entretien au singulier, suivi du nom de la personne interviewée, suivi du code ISO de la langue du document (fr, en, etc.), puis de la date de publication, chaque terme étant séparé par un tiret bas / underscore (_).

Exemples de titre
entretien_leader_fr_02_10_2020
entretien_Leader_en_02_10_2020
entretien_Brant-Saunders_fr_22_09_2021

1.2. Espaces de travail

2. Métadonnées des entretiens

La partie des métadonnées se situe au tout début de l'article, avant votre texte.

Afin de ne pas oublier de métadonnées ou de ne pas avoir à recopier chacun des champs manuellement, nous vous proposons un modèle standard pour les entretiens que vous pouvez copier et coller dans Stylo. Il vous suffira alors de remplir les champs.

N'oubliez pas que la zone des métadonnées YAML doit être délimitée au début et à la fin par les trois tirets ---.

La liste des métadonnées doit toujours être la même pour un même type d'article (ici les entretiens). Si une métadonnée ne peut être complétée car votre article ne contient pas cette information, vous devez tout de même indiquer le nom de la métadonnée suivi directement de : et indiquer ensuite que le champ est vide soit en ajoutant des guillemets anglais vides "" si la métadonnée est à choix unique ou des crochets vides [] si la métadonnée est à choix multiple.

Exemple de champs vides

• Métadonnée à choix unique
  

date: ""

• Métadonnée à choix multiple
  

translators: []

2.1. Modèle standard des entretiens

Vous pouvez copier et coller ce modèle et remplacer ensuite les éléments textuels avec les informations dont vous disposez pour votre article (le titre, les différents noms, etc.)

---
title: "Titre de l'article"
interviewers: 
  - "Prénom Nom"
  - "Prénom Nom"
translators:
  - "Prénom Nom"
  - "Prénom Nom"
guests:
  - "Prénom Nom"
  - "Prénom Nom"
date: "jour mois année"
lang: "code ISO"
summary: |
  Texte libre
image: "lien Nakala"
keywords:
  - "Mot-clé"
  - "Mot-clé"
  - "Mot-clé"
index_authors:
  - "Nom Prénom"
  - "Nom Prénom"
index_theoreticians:
  - "Nom Prénom"
  - "Nom Prénom"
citation : "texte libre"
group: "Prénom Nom, Prénom Nom"
---

2.2. Description explicative des métadonnées

– title:

Il s'agit du titre qui s'affichera sur le site en ligne. (Il est donc différent du titre de votre article Stylo dont nous avons vu la convention de nommage ci-dessus).

– interviewers:

Indiquez ici sous forme de liste le prénom suivi du nom des personnes qui ont mené l'entretien.

– translators:

Certains articles ont été traduits dans une autre langue. Indiquez ici sous forme de liste le prénom suivi du nom des traducteurs. Si votre article n'est pas une traduction, ce champ est vide et il faut alors remplir ce champ en mettant des crochets vides [] : translators: [].

– guests:

Indiquez ici sous forme de liste le prénom suivi du nom des personnes interviewées.

– date:

Cette date correspond à la date de publication de l'entretien sur Stylo. Elle est écrite au format jour mois année (ex : 16 mars 2026).

– lang:

Indiquez ici le code ISO 639-1 de la langue (code à deux lettres) soit, par exemple,
fr pour français,
en pour anglais,
de pour allemand,
es pour espagnol,
it pour italien,
zh pour chinois.

Vous pouvez retrouver la liste des codes ISO en ligne (2ᵉ colonne, code à deux lettres) : https://www.loc.gov/standards/iso639-2/php/code_list.php.

– summary:

Cette métadonnée est un champ de texte long dans lequel on précise notamment, et de manière rédigée, le nom des différents intervenants ayant participé à l'entretien, le sujet de l'entretien si nécessaire ainsi que la date de l'entretien. Ce texte peut-être mis en forme en utilisant un encodage Markdown si on souhaite ajouter des italiques, des exposants, des retours à la ligne, etc.

Ce texte doit être court (2 ou 3 lignes) car il se retrouve sur la page d'accueil listant tous les entretiens.

La mise en forme de cette métadonnée, comportant un texte long, est une peu différente des autres. Elle utilise le caractère « | » (barre verticale). Si vous avez un doute sur la syntaxe de cette métadonnée, reportez-vous à sa description plus détaillée, publiée dans cette documentation dans la section intitulée « Entrée avec | (pipe) ».

Exemple :

summary: |
  Entretien entre Francis Walsh et Sophie-Anna Fischbach (éditrice scientifique 
  de Jules Supervielle, _Choix de lettres_, Paris, Classiques Garnier, 2021) 
  -- Janvier 2022

Si cette métadonnée est vide, il faut remplacer le texte par des guillemets anglais vides.

Exemple :

summary: ""

– image:

Il s'agit de l'image qui sert de vignette illustrative dans la liste des entretiens de la page d'accueil de la section. Cette image doit être déposée dans l'espace Nakala en sélectionnant la section Entretiens.
Si vous avez des doutes concernant la procédure de mise en ligne d'une image sur l'espace Nakala, reportez-vous à la documentation sur les principes généraux dans la section « Les hyperliens et les images ».

Le lien qui doit être copié est celui qu'on obtient quand on clique sur « Copier l'url de téléchargement ».

Si vous n'avez pas d'image pour illustrer votre entretien, vous pouvez ajouter l'image par défaut que nous avons déposée sur Nakala en copiant ce lien : https://api.nakala.fr/data/10.34847/nkl.e7f792z8/905b592982dee8e6b8e0ffa9946f0b2281c3dc87

– keywords:

Il faut ajouter ici la liste des mots-clés qui a été définie par le rédacteur de l'entretien.
Si ce champ est vide, il faut remplacer la liste par des crochets vides [].

– index_authors:

Il s'agit ici de la liste des auteurs cités dans l'entretien (le nom en premier suivi du prénom, afin que la liste soit classée par ordre alphabétique), définie par le rédacteur de cet entretien.
Si ce champ est vide, il faut remplacer la liste par des crochets vides [].

– index_theoreticians:

Il s'agit ici de la liste des auteurs critiques, universitaires cités dans l'entretien (le nom en premier suivi du prénom, afin que la liste soit classée par ordre alphabétique), définie par le rédacteur de cet entretien.
Si ce champ est vide, il faut remplacer la liste par des crochets vides [].

– citation:

Ce champ est un champ de texte long dans lequel on précise la référence bibliographique utile au lecteur qui souhaiterait citer l'entretien dans une bibliographie. Cette référence sera indiquée dans la partie intitulée « Pour citer cet article » publiée en fin d'article. Ce texte peut-être mis en forme en utilisant un encodage Markdown si on souhaite ajouter des italiques, des exposants, etc.

Pour les entretiens, il s'agit donc d'indiquer :
Nom Prénom (de l'auteur / des auteurs de l'entretien), « Titre de l'article », dans EcriSoi, « Entretiens », année de publication

Exemple :

"Walsh Francis, « Entretien avec Sophie-Anna Fischbach, autour de *Choix de lettres* de Jules Supervielle », dans *EcriSoi*, « Entretiens », 2022"

Attention : Il ne faut pas mettre de point ou de virgule après la date. La suite de la référence, c'est à dire l'URL et la date de consultation, sera ensuite générée automatiquement sur le site.

– group:

Cette métadonnée doit être OBLIGATOIREMENT renseignée. Elle permet de catégoriser les différents entretiens et de rassembler un même entretien qui existerait en plusieurs langues dans un même groupe. La métadonnée group apparaît en ligne comme une sorte de sous-titre dans la page affichant tous les entretiens disponibles en ligne.

Pour les entretiens, il s'agit d'écrire ici le nom de la/des personnes interviewée/s. Quand il existe plusieurs noms, ils doivent être séparés par une virgule.

Exemple :

group: "Clare Brant, Max Saunders"

2.3. Exemple de YAML d'un entretien

Retrouvez ci-dessous un exemple de métadonnées YAML d'un article déjà publié sur le site :

---
title: "Conversation with Clare Brant and Max Saunders, founding members
and co-directors of the Centre for Life-Writing Research (King’s College London)"
interviewers:
  - "Jean-Louis Jeannelle"
  - "Bruno Tribout"
translators: []
guests:
  - "Clare Brant"
  - "Max Saunders"
date: "22 septembre 2021"
lang: "en"
summary: |
  Conversation with Clara Brant and Max Sauders, conducted by Jean-Louis
  Jeannelle (Sorbonne Université) and Bruno Tribout (University of
  Aberdeen) -- Autumn 2021
image: "https://api.nakala.fr/data/10.34847/nkl.ab031toc/43fc6b63fc5ef4034c88228c5da7104f1e6d5534"
keywords:
  - "Archive"
  - "Autobiografiction"
  - "Autobiographie"
  - "Autobiography"
  - "Autofiction"
  - "Biographie"
  - "Biographie de groupe"
  - "Blogs"
  - "Correspondance"
  - "Diary"
  - "Digital Subjectivity"
  - "Eco-Narrative"
  - "Egodocument"
  - "Ego Media"
  - "Journal d’écrivain"
  - "Life"
  - "Life History"
  - "Life Narrative"
  - "Life Writing"
  - "Memoir"
  - "Mémoire"
  - "Mémoires"
  - "Numérique"
  - "Récit de vie"
  - "Self-Biography"
  - "Vie"
  - "Vie médicale"
  - "Vlog"
index_authors:
  - "Austen Jane"
  - "Coleridge-Taylor Samuel"
  - "Ford Ford Madox"
  - "Gray John"
  - "Huntington William"
  - "Joyce James"
  - "Proust Marcel"
  - "Reynolds Stephen"
  - "Tennyson Alfred"
  - "Woolf Virginia"
index_theoreticians:
  - "Brant Clare"
  - "Saunders Max"
citation: "Jeannelle Jean-Louis et Tribout Bruno, « Conversation with Clare Brant and Max Saunders, founding members and co-directors of the Centre for Life-Writing Research (King’s College London) », dans *EcriSoi*, « Entretiens », 2021"
group: "Clare Brant, Max Saunders"
---

Vous pouvez retrouver cet article complet à l'adresse https://stylo.huma-num.fr/article/696dfc2f5bcdc100281261c2.

2.4. Masque de saisie

(Partie en cours de réflexion).

3. Textes

Si vous utilisez pour la première fois le langage de balisage Markdown, MERCI de prendre connaissance des principes généraux du Markdown décrits dans cette documentation : Introduction – Textes.

3.1. Balisage Markdown dans les entretiens

Vous pouvez utiliser dans les entretiens le balisage Markdown habituel, et notamment :

– les titres

## titre de niveau 2
### titre de niveau 3
#### titre de niveau 4

Attention : il ne faut pas utiliser le titre de niveau 1 car celui-ci est le titre de votre article, celui qui est inscrit dans les métadonnées YAML.

– les paragraphes et les retours à la ligne

Pour changer de paragraphe vous devez laisser une ligne vide.
Pour faire un retour à la ligne, vous devez ajouter une barre oblique inverse (antislash) en fin de ligne : \

Exemple :

Demain, dès l’aube, à l’heure où blanchit la campagne,\
Je partirai. Vois-tu, je sais que tu m’attends.\
J’irai par la forêt, j’irai par la montagne.\
Je ne puis demeurer loin de toi plus longtemps.

Je marcherai les yeux fixés sur mes pensées,\
Sans rien voir au dehors, sans entendre aucun bruit,\
Seul, inconnu, le dos courbé, les mains croisées,\
Triste, et le jour pour moi sera comme la nuit.

Je ne regarderai ni l’or du soir qui tombe,\
Ni les voiles au loin descendant vers Harfleur,\
Et quand j’arriverai, je mettrai sur ta tombe\
Un bouquet de houx vert et de bruyère en fleur.

dont voici le rendu

Demain, dès l’aube, à l’heure où blanchit la campagne,
Je partirai. Vois-tu, je sais que tu m’attends.
J’irai par la forêt, j’irai par la montagne.
Je ne puis demeurer loin de toi plus longtemps.

Je marcherai les yeux fixés sur mes pensées,
Sans rien voir au dehors, sans entendre aucun bruit,
Seul, inconnu, le dos courbé, les mains croisées,
Triste, et le jour pour moi sera comme la nuit.

Je ne regarderai ni l’or du soir qui tombe,
Ni les voiles au loin descendant vers Harfleur,
Et quand j’arriverai, je mettrai sur ta tombe
Un bouquet de houx vert et de bruyère en fleur.

– les blocs de citations longues

Utilisez le caractère > suivi d'une espace au début de la citation longue.

> Longtemps, je me suis couché de bonne heure. Parfois, à peine ma bougie éteinte, mes yeux se fermaient
si vite que je n’avais pas le temps de me dire : « Je m’endors. »

Voici une idée du rendu :

Longtemps, je me suis couché de bonne heure. Parfois, à peine ma bougie éteinte, mes yeux se fermaient si vite que je n’avais pas le temps de me dire : « Je m’endors. »

La mise en forme peut être différente sur le site EcriSoi en fonction des styles CSS qui auront été définis. Pour en savoir plus à ce sujet, reportez-vous à la section sur le fond et la forme de cette documentation.

– Les notes de bas de page

Texte de l'entretien^[note de bas de page.].

Si les notes peuvent être encodées de plusieurs manières différentes (voir la section sur les notes dans les principes généraux), nous avons privilégié ce système qui semble le plus simple. Les numéros des appels de note seront générés automatiquement par le site.

– les italiques

*texte en italique* ou _texte en italique_

– les caractères gras

**texte en gras**

Dans les entretiens, les caractères gras sont notamment utilisés pour indiquer le nom de la personne qui prend la parole, au début de son intervention.

– les exposants

texte ^exposant^

– les espaces insécables

Sur Stylo, les espaces insécables sont visibles grâce à un petit rectangle orangé. Elles deviennent invisibles si le texte est très long et qu'elles sont trop nombreuses, mais seront bien prises en compte à la publication si elles ont été encodées.

– les liens hypertextes

[nom du lien](url du lien)

Exemple : [Stylo](https://stylo.huma-num.fr/)

– les images

![légende de l'image](url de l'image)

Exemple :

![Ceci est ma légende.](https://api.nakala.fr/data/10.34847/nkl.e7f792z8/2c035336347b8fa12a3ded6e30776b19af39de91)

Pour ajouter une image, il faut auparavant l'avoir déposée dans l'espace dédié aux entretiens dans la collection EcriSoi sur Nakala : https://nakala.fr/10.34847/nkl.ab031toc.

Pour savoir comment déposer une image sur Nakala, reportez-vous à la documentation de l'entrepôt Nakala.
Veillez à récupérer le bon lien en cliquant sur Copier l'url de téléchargement.

Si vous ne souhaitez pas ajouter de légende, laissez le champ entre crochets vide :

![](url de l'image)

Si l'image vous semble trop grande, vous pouvez également en réduire la taille en utilisant le code suivant :

[légende de l'image](url de l'image){width="50%"}

Width correspond à la largeur de votre image. Choisissez un pourcentage de réduction. Les proportions de l'image seront recalculées automatiquement pour ne pas que l'image soit déformée.

3.2. Pseudo-classes utilisées

Certains éléments ne sont pas encodables directement en Markdown. Pour enrichir la mise en forme de nos articles, nous utilisons alors des « pseudo-classes » dont le style a été défini pour le site EcriSoi, et dont le nombre est limité.

Pour les entretiens, plusieurs pseudo-classes sont régulièrement utilisées.

– les petites capitales

Cette pseudo-classe s'applique au niveau de la lettre ou du mot :

[texte]{.smallcaps}

Elle permet de mettre le texte entre crochets en petites capitales (notamment pour les adjectifs numéraux ordinaux indiquant les siècles, inscrits en chiffres romains en petites capitales).

– alignement à droite

Deux autres pseudo-classes seront appliquées au niveau du paragraphe. Pour aligner un texte à droite, il faut encoder le paragraphe ainsi (pensez à ajouter une espace après les :::) :

::: {.alignRight}
texte aligné à droite
:::

– paragraphe non numéroté

Dans les entretiens, les paragraphes du texte sont numérotés par défaut pour améliorer la citabilité des articles publiés en ligne.
Cependant, on peut vouloir que certains paragraphes ne soient pas numérotés (par exemple une note de l'auteur en préambule, une épigraphe, une dédicace, une indication sur la date ou le lieu de l'entretien à la fin du texte, etc.).

Dans ce cas, il faut encadrer ce paragraphe par la pseudo-classe suivante :

::: {.numberOff}
Texte pour lequel on ne veut pas de numérotation des paragraphes.
:::

– combinaison de pseudo-classes

Si l'on souhaite qu'un paragraphe ne soit pas numéroté et qu'il soit aligné sur la droite, il suffit alors de cumuler les deux pseudo-classes.

::: {.numberOff}
::: {.alignRight}
Texte aligné à droite et pour lequel on ne veut pas de numérotation des paragraphes.
:::
:::

4. Publication de l'article

Une fois que votre article est complet, relu et corrigé, vous devez procéder à sa mise en ligne.

Trois étapes sont alors nécessaires :

• le rattachement de l'article à l'« espace de travail » du site EcriSoi.
• le rattachement de l'article au « corpus » correspondant à la sous-rubrique « Entretien » et son classement dans le corpus.
• la mise à jour du site afin que le nouvel article apparaisse en ligne.

4.1. Rattachement de l'article à l'espace de travail

Une fois votre article terminé, retournez sur la page de vos articles sur Stylo.

Pour cela,

1. Cliquez sur l'onglet « Articles »
2. En face de l'article que vous souhaitez publier, cliquez sur les trois points verticaux (⁝) tout à droite
3. Enfin, cliquez sur « Modifier ».

Une nouvelle fenêtre s'ouvre (image ci-dessous).

• Sélectionnez alors l'espace de travail correspondant au site EcriSoi, qui est intitulé ecrisoi-site-web, et validez votre choix en cliquant sur « Modifier ».

Votre article est à présent rattaché à l'espace de travail du site.

4.2. Rattachement de l'article au corpus

Afin que votre article soit publié en ligne, vous devez également le rattacher au corpus dans lequel vous souhaitez qu'il apparaisse, en l'occurrence ici celui des « Entretiens » qui se trouve dans la rubrique « Critiques » du site.

Pour ce faire,

• Cliquez sur l'onglet « Espaces de travail » dans le menu du haut puis sélectionnez ecrisoi-site-web.

Une liste de tous les articles qui existent déjà dans cet espace de travail s'affiche.

• Positionnez-vous ensuite dans les corpus en cliquant sur l'onglet « Corpus » toujours dans le menu du haut.

Tous les corpus du site EcriSoi apparaissent alors.

• Choisissez le corpus souhaité, en l'occurrence ici celui nommé critiques_entretiens et cliquez sur « Choisir des articles ».

• Dans la liste des articles qui s'affiche, retrouvez l'article que vous souhaitez publier, et cliquez sur « Ajouter ».

Si la liste des articles présents dans le corpus est trop longue, vous pouvez rechercher votre article en vous servant de la fonction « filtrer » pour rechercher le titre que vous avez donné à votre article Stylo.

• Une fois les articles ajoutés, vous devez alors classer le corpus. Pour les entretiens, le classement se fait par ordre antichronologique (de l'article le plus récent au plus ancien, ce qui explique l'intérêt d'ajouter la date dans le titre en suivant les conventions de nommage). Pour ce faire, il vous suffit de cliquer sur les symboles ⁝⁝ et déplacer l'article où vous souhaitez le classer.

Tout est à présent prêt pour procéder à la mise en ligne, et donc à l'actualisation des articles publiés sur le site.

4.3. Mise à jour du site

Dans un premier temps, la mise à jour du site sera effectuée par un membre de l'équipe de la Chaire d'excellence en édition numérique.

Lorsque vous êtes arrivé à cette étape, vous pouvez contacter l'équipe en précisant le/les article/s ajouté/s afin que nous puissions vérifier que tout fonctionne correctement. Nous procéderons alors à la mise à jour du site.