7 Rédiger un article
Le manuel “Comprendre et maîtriser la lecture scientifique” présente deux chapitres à consulter avant de se lancer dans la rédaction d’un article :
(voir aussi le support de cours)
Markdown est un excellent format pour cette rédaction. Il permet d’aller à l’essentiel (écrire) sans distractions inutiles.
Pour rédiger un article, on commence par ouvrir un éditeur de texte (à moins de choisir une autre méthode, voir dans le manuel le chapitre “outils”). On enregistre le document, en indiquant .md comme extension (typiquement article.md).
7.1 Format
Le principe de base, est de rédiger cet article en suivant le guide des auteurs de la revue à laquelle l’article va être soumis. Il est en effet essentiel, dès le départ, de :
- choisir la revue (pour rédiger directement avec les bonnes instructions) ;
- décider de la liste des auteurs (pour éviter de mauvaises surprises par la suite).
Dans la majorité des cas, les instructions demanderont :
- de fournir un document au format .docx ;
- de fournir un titre (et éventuellement un titre court pour l’en-tête), en français et en anglais ;
- de rédiger un résumé (le plus souvent structuré) en français et en anglais ;
- de fournir des mots-clés et des keywords ;
- de structurer l’article (par exemple, pour un article STM, au format IMReD1) ;
- de préciser, pour chaque autrice et auteur, un identifiant ORCiD et l’apport individuel en utilisant éventuellement la taxonomie CReDiT.
Comme il faut fournir un fichier .docx (ou éventuellement un fichier .odt), il faut éviter les instructions spécifiques à la création des fichiers .pdf via LaTeX et se “limiter” aux instructions Markdown de base qui sont de toutes façons largement suffisantes (tout ce dont on a besoin s’y trouve) .
Il est totalement inutile d’essayer de soumettre un article avec un look d’article fini, comme LaTeX le fait parfaitement. C’est l’éditeur qui fait ce travail en tenant compte de ses outils, de ses choix éditoriaux et de sa maquette. Tous les choix esthétiques que vous feriez seront effacés.
7.2 Bibliographie
La liste bibliographique et les citations dans le texte constituent des éléments essentiels d’un article scientifique. L’utilisation du format Pandoc Markdown est particulièrement puissant à ce propos.
Pour rappel :
- il faut disposer de deux fichiers bien spécifiques :
- un fichier BibTex créé avec un gestionnaire bibliographique. Avec Zotero, il faut utiliser la fonction “exporter les documents” (sélectionnés) et choisir le format BibTex pour créer un fichier .bib ;
- copier ce fichier dans le même dossier que l’article ;
- copier le fichier csl (Citation Stype Language) correspondant au style bibliographique que vous souhaitez utiliser (l’éditeur vous demandera peut-être un style spécifique mais vous fournira généralement le fichier csl correspondant) ;
- que ces deux fichiers soient renseignés dans l’en-tête YAML (voir le modèle ci-dessous) ;
Pour insérer les citations :
- soit avec l’appel [@auteur0000]2 pour une citation avec des parenthèses : “texte texte texte (Auteur, 0000)” ;
- soit avec l’appel @auteur0000 (sans [ et ]) pour une citation directe : “texte texte texte Auteur (0000)” ;
Ajouter :
- le titre “Bibliographie” en fin de document ;
- “–citeproc” dans la commande Pandoc : pandoc --citeproc article.md -o article.docx
7.3 Modèle
Ci-dessous un modèle basique que vous pouvez copier-coller dans votre éditeur de texte pour débuter la rédaction. Dans ce modèle :
- on choisit la classe article ;
- pour améliorer la lisibilité, on veille à choisir un interligne supérieur à la valeur par défaut (ici 1,5 au lieu de 1) et on choisit un caractère de 12 ;
- on n’utilise pas le paquet orcidlink (voir Section 4.8.1) parce qu’il ne fonctionne pas pour les exports .docx (on va néanmoins introduire le n° ORCiD au début de l’affiliation qui apparaît en note pour chaque auteur) ;
- on va mettre le résumé dans les deux langues et les mots-clés dans les deux langues en dehors de l’en-tête YAML (avec les métadonnées YAML, on ne gère qu’une seule langue à la fois), au début du texte.
Pour l’interligne et la taille des caractères, il faudra de toutes façons se conformer aux instructions de l’éditeur.
---
documentclass: article
header-includes:
- \usepackage[french]{babel}
- \usepackage[sfdefault]{noto}
title: Titre
subtitle: Sous-titre
author:
- Auteur1^[Orcid1, université 1]
- Auteur2^[Orcid2, université 2]
date: 2024
right: CC-BY
geometry:
- left=2cm
- right=2cm
- top=2cm
- bottom=2cm
- a4paper
linestretch: 1.5
fontsize: 12pt
bibliography: library.bib
csl: apa.csl
---
## Résumé
## Abstract
## mots-clés
## Keywords
# Introduction
# Matériel et méthode
# Résultats
# Discussion/conclusion
# remerciements
# Bibliographie
7.4 Épreuves
Une fois le travail de rédaction terminé (ou à tout moment d’ailleurs) on peut, pour une épreuve, exporter un fichier .pdf, ou pour la soumission, faire une exportation au format .docx.
pandoc –citeproc article.md -o article.docx
ou
pandoc –citeproc article.md -o article.pdf
Voici ce que donne ce modèle et voici un exemple plus complet.
Lors du processus d’édition, le fichier .docx fera l’objet d’annotations ou de suggestions de modifications. Il est parfois pénible d’identifier celles-ci dans le document reçu.
Avec LibreOffice, la “comparaison de documents” (Édition -> Suivit des modifications -> Comparer le document) permet d’obtenir une liste des changements entre le document soumis (ou une épreuve intermédiaire) et le document transmis par l’éditeur.
On peut aussi décider de poursuivre avec un traitement de texte mais alors on perd une partie de la souplesse du travail avec un format texte…