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 comptes rendus
  • • 2.1. Modèle standard des comptes rendus
    • 2.2. Description explicative des métadonnées
    • 2.3. Exemple de YAML d'un compte rendu
    • 2.4. Masque de saisie
  • 3. Textes
  • • 3.1. Balisage Markdown dans les comptes rendus
    • 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 et classement
    • 4.3. Mise à jour du site

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

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

Pour ajouter un nouveau compte rendu 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 comptes rendus, le titre commence par le terme compte-rendu au singulier, suivi du nom de l'auteur de l'ouvrage recensé, puis du nom de l'auteur du compte rendu, puis de la date de publication, chaque terme étant séparé par un tiret bas / underscore (_).

Exemples de titre
compte-rendu_Tenant_Enriquez_06_02_2021
compte-rendu_Robinson_Corrado_16_11_2021

1.2. Espaces de travail

2. Métadonnées des comptes rendus

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

keywords: []

2.1. Modèle standard des comptes rendus

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 »"
authors:
  - "Prénom Nom"
date: "jour mois année"
lang: "code ISO"
reference: |
  Texte libre
image: "lien Nakala"
keywords:
  - "Mot-clé"
  - "Mot-clé"
index_authors:
  - "Nom Prénom"
  - "Nom Prénom"
index_theoreticians:
  - "Nom Prénom"
  - "Nom Prénom"
citation: "texte libre"
---

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

Exemple :
title: "« L’autobiographie homosexuelle en question »"

afin que le titre en ligne soit : « L’autobiographie homosexuelle en question » avec les guillemets français.

– authors:

Indiquez ici sous forme de liste le prénom suivi du nom du/des auteur/s du compte rendu.

– date:

Cette date correspond à la date de publication du compte rendu 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.

– reference:

Cette métadonnée est un champ de texte long dans lequel on précise notamment, la/les référence/s bibliographique/s des ouvrages recensés.

Si plusieurs ouvrages sont recensés, pensez à effectuer un retour à la ligne entre chaque référence en utilisant une barre oblique inverse \ en fin de ligne. 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 court sera publié sur la page d'accueil listant tous les comptes rendus, précisant ainsi les ouvrages recencés dans chacun des comptes-rendus.

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 :

reference: |
  Wagner-Egelhaaf Martina (dir.), _Handbook of Autobiography /
  Autofiction, vol. I : Theory and Concepts_, Berlin-Boston, de Gruyter,
  2019, 681 p. -- (volumes liés : vol. II, _History_, p. 682-1279
  et vol. III : _Exemplary Texts_)

– image:

Il s'agit de l'image qui sert de vignette illustrative dans la liste des comptes rendus de la page d'accueil de la section. Cette image doit être déposée dans l'espace Nakala en sélectionnant la section Comptes rendus.
L'image choisie est généralement celle de la couverture de l'ouvrage recensé. Si plusieurs ouvrages sont mentionnés, il faut alors créer un fichier image unique regroupant les différentes couvertures.

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 compte rendu, 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 du compte rendu.
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 le compte rendu (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 du compte rendu.
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 le compte rendu (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 du compte rendu.
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 le compte rendu 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 comptes rendus, il s'agit donc d'indiquer :
Nom Prénom (de l'auteur / des auteurs du compte rendu), « Titre de l'article », dans EcriSoi, « Comptes rendus », année de publication

Exemple :

citation: "Jeannelle Jean-Louis, « Le mondial, la poétique et le marché des langues », dans *EcriSoi*, « Comptes rendus », 2021"

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.

2.3. Exemple de YAML d'un compte rendu

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

---
title: "« Écritures de soi : encore un effort pour être transnational… »"
authors:
  - "Romain Enriquez"
date: "15 novembre 2021"
lang: "fr"
reference: |
  Simonet-Tenant Françoise (dir.), Braud Michel, Jeannelle Jean-Louis,
  Lejeune Philippe et Montémont Véronique (collab.), _Dictionnaire de
  l'autobiographie : écritures de soi de langue française_, Paris, Honoré
  Champion, 2017, 844 p. (repris dans la collection « Champion
  classiques » en 2018).\
  Jolly Margaretta (dir.), _Encyclopedia of Life Writing: Autobiographical
  and Biographical Forms_, Londres / Chicago, Fritzroy Dearborn, 2001,
  2 vol., 1090 p.
image: "https://api.nakala.fr/data/10.34847/nkl.afec3429/
dd84e2b70b436d27c83a5327d7f0654deb3bd417"
keywords:
  - "Dictionnaire"
  - "Écritures de soi"
  - "Encyclopédie"
  - "International"
  - "Méthodologie"
  - "Trans-historique"
  - "Transnational"
  - "Dix-neuvième siècle"
  - "Vingtième siècle"
index_authors:
  - "Amiel Henri-Frédéric"
  - "Bashkirtseff Marie"
  - "Baudelaire Charles"
  - "Bloy Léon"
  - "Chateaubriand François‑René de"
  - "Crèvecœur St. John de"
  - "Delacroix Eugène"
  - "Garibaldi Giuseppe"
  - "Goncourt Edmond de"
  - "Goncourt Jules de"
  - "Groult Benoîte"
  - "Groult Flora"
  - "Hugo Victor"
  - "Lévi-Strauss Claude"
  - "Lorimier Chevalier de"
  - "Loti Pierre"
  - "Louÿs Pierre"
  - "Luxemburg Rosa"
  - "Mann Thomas"
  - "Mesonero Ramos Ramón de"
  - "Musset Alfred de"
  - "Pellico Silvio"
  - "Quincey Thomas de"
  - "Rilke Rainer Maria"
  - "Rousseau Jean-Jacques"
  - "Saint-Denys Garneau Hector de"
  - "Sartre Jean-Paul"
  - "Staël‑Holstein Germaine de"
  - "Tocqueville Alexis de"
  - "Vallès Jules"
index_theoreticians:
  - "Amen Philippe"
  - "Boutry Philippe"
  - "Cassel Jeris"
  - "Corrado Danielle"
  - "Crinquand Sylvie"
  - "Genette Gérard"
  - "Jeannelle Jean-Louis"
  - "Jolly Margaretta"
  - "Jouanny Sylvie"
  - "Lefort-Favreau Julien"
  - "Lejeune Philippe"
  - "Plasse Christine"
  - "Simonet-Tenant Françoise"
citation: "Enriquez Romain, « Écritures de soi : encore un effort pour être transnational… », dans *EcriSoi*, « Comptes rendus », 2021"
---

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

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 comptes rendus

Vous pouvez utiliser dans les comptes rendus 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 résultat :

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 du compte rendu^[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**

– 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.afec3429/dd84e2b70b436d27c83a5327d7f0654deb3bd417)

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

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 comptes rendus, 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 comptes rendus, 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).

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 « Comptes rendus » 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 et classement

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 « Comptes rendus » 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_comptes-rendus 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 comptes rendus, 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.