PARTIE EN COURS DE RÉDACTION. Certaines parties sont encore manquantes et d'autres fautives.

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 Notices de dictionnaires
  • • 2.1. Modèle standard des notices de dictionnaires
    • 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 notices de dictionnaire
    • 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'une notices de Dictionnaire dans la rubrique « Dictionnaires » 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 notices de dictionnaire, le titre commence par le terme dictionnaire au singulier, suivi du titre de l'article, suivi du code ISO de la langue du document (fr, en, etc.), chaque terme étant séparé par un tiret bas / underscore (_).

Exemples de titre
dictionnaire_autofiction_fr
dictionnaire_autofiction_en
dictionnaire_autobiographical-novel_en
dictionnaire_roman_autobiographique_fr

1.2. Espaces de travail

2. Métadonnées des Notices de dictionnaires

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 notices du dictionnaire en ligne). 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 notices de dictionnaires

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"
subtitle: "Sous-titre de l'article s'il y en a"
authors:
  - "Prénom Nom"
  - "Prénom Nom"
translators:
  - "Prénom Nom"
  - "Prénom Nom"
lang: "code ISO"
note: "texte long"
keywords:
  - "Mot-clé"
  - "Mot-clé"
  - "Mot-clé"
nocite: '@*'
citation: "texte long"
publicationDate: "Année ou jour mois année"
revisionDate: "Année ou jour mois année"
---

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).

– subtitle:

Il s'agit du titre qui s'affichera sur le site en ligne. Par exemple, les lieux et années de naissance et de mort d'une personne pour une notice sur un auteur.

– authors:

Indiquez ici sous forme de liste le prénom suivi du nom du/des auteurs de la notice.

– 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: [].

– 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.

– note:

<!– 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: ""

–>

– 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 [].

– nocite:

– 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 la notice 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 notices, il s'agit donc d'indiquer :
Nom Prénom (de l'auteur / des auteurs), « Titre de la notice », dans EcriSoi, « Entretiens », année de publication

Exemple :

""

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.–>

– publicationDate:

Cette date correspond à la date de publication de la notice du dictionnaire en ligne. Elle est écrite au format jour mois année (ex : 16 mars 2026).

– revisionDate:

Cette date correspond à la date de révision, de mise à jour significative (révision de la bibliographie, ajout de nouvelles informations dans la notice, par exemple) de la notice du dictionnaire en ligne. Elle est écrite au format jour mois année (ex : 16 mars 2026).

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: "Autobiographie"
subtitle: ""
authors:
  - "Véronique Montémont"
translators: []
lang: "fr"
note: "*Cet article est issu de la version imprimée du* Dictionnaire de l’autobiographie*, 
dir. F. Simonet-Tenant, avec la collab. de M. Braud, J.-L. Jeannelle, P. Lejeune et 
V. Montémont, Paris, Champion, 2017, p. 77-84.*"
keywords:
  - "Autobiographie"
nocite: '@*'
citation: "Montémont Véronique, « Autobiographie », dans *Dictionnaire de l’autobiographie*,
dir. F. Simonet-Tenant avec la collab. de M. Braud, J.-L. Jeannelle, P. Lejeune et V. Montémont,
 Paris, Champion, 2017, p. 77-84, rééd. dans *EcriSoi*, « Dictionnaire en ligne », 2019"
publicationDate: "2019"
revisionDate: ""
---

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

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 notices de dictionnaire

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.

Dans les notices de dictionnaire, sauf exception, on ne trouve généralement pas de notes de bas de page.

– les italiques

*texte en italique* ou _texte en italique_

– 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/)

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 « Dictionnaires » 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.

–>