Commit e79fc815 authored by Antoine Fauchié's avatar Antoine Fauchié
Browse files

Merge branch '1-relecture-corrections' into 'master'

Corrections après relecture du tutoriel

See merge request marviro/tutorielmdpandoc!2
parents 34a1f75a 05322d5f
......@@ -75,6 +75,7 @@ On distinguera deux catégories de formats :
- des chaînes basées sur des formats libres et standards : [XML](https://fr.wikipedia.org/wiki/Extensible_Markup_Language), [TeX](https://fr.wikipedia.org/wiki/TeX), [Markdown](https://fr.wikipedia.org/wiki/Markdown), etc.
[Markdown](https://daringfireball.net/projects/markdown) (`.md`) est un format de plus en plus utilisé comme format pivot dans les chaînes de publication car il permet une édition structurée très simple capable de produire à peu près tous les formats.
Pour découvrir et apprendre à utiliser Markdown en quelques minutes, voici un tutoriel très accessible : [https://commonmark.org/help/tutorial/](https://commonmark.org/help/tutorial/).
Remarque : ce cours est édité en Markdown (cliquez sur ![display source](./media/displaySource.png) pour voir la source).
......
......@@ -4,11 +4,11 @@
Stylo est un éditeur de texte simplifiant la rédaction et l'édition de documents scientifiques en sciences humaines et sociales.
Vous pouvez consulter [la documentation](http://stylo-doc.ecrituresnumeriques.ca/), [une présentation vidéo](https://www.youtube.com/watch?v=qcwEqbcxBF8).
Vous pouvez consulter [la documentation](http://stylo-doc.ecrituresnumeriques.ca/) ainsi qu'[une présentation vidéo](https://www.youtube.com/watch?v=qcwEqbcxBF8).
### Chaine de publication
### Chaîne de publication
![Chaine de publication Stylo](./media/chaine_stylo_sp.png)
![Chaîne de publication Stylo](./media/chaine_stylo_sp.png)
## Fonctionnalités
......@@ -17,13 +17,13 @@ L'environnement de travail de Stylo intègre une chaîne éditoriale complète b
- **un éditeur de métadonnées**
- **un versionnage**
- **une gestion de la bibliographie**
- **différents formats exports** : HTML5, XML (TEI, Erudit), pdf...
- **différents formats exports** : HTML5, XML (TEI, Érudit), PDF...
- **l'annotation**
- **le partage de document**
### Édition
Un article dans Stylo est composé par trois éléments distincts :
Un article dans Stylo est composé de trois éléments distincts :
- un corps de texte
- des métadonnées
......@@ -36,10 +36,10 @@ L'environnement d'édition est composé de 5 modules :
1. au centre : l'espace d'écriture, consacré au corps de texte de l'article
2. à droite : le bouton [Metadata] ouvre l'éditeur de métadonnées
3. à gauche :
3.1. les Versions pour naviguer et agir sur les différentes versions de l'article
3.2. le Sommaire de l'article liste les titres de niveau 2 et 3
3.3. la Bibliographie liste les références bibliographiques
3.4. les Statistiques offrent quelques données quantitatives sur l'article
1. les Versions pour naviguer et agir sur les différentes versions de l'article
2. le Sommaire de l'article liste les titres de niveau 2 et 3
3. la Bibliographie liste les références bibliographiques
4. les Statistiques offrent quelques données quantitatives sur l'article
![Stylo_Modules](./media/stylo_fullopen_marqued.png)
......@@ -53,19 +53,21 @@ Après vous être créé un compte sur [stylo.ecrituresnumeriques.ca](http://sty
Dans la liste des articles, ouvrez et consultez le document **How-to** qui vous permettra de découvrir les fonctionnalités de Stylo, et vous donnera l'essentiel de la syntaxe Markdown pour éditer un document.
À découvrir :
- le module de versionnage
- le sommaire
- la gestion des références
- les métadonnées
- la comparaison de versions
- le module de versionnage
- le sommaire
- la gestion des références
- les métadonnées
- la comparaison de versions
À éditer :
- déclarer un titre et niveaux de titre
- ajouter un italique
- ajouter une citation
- ajouter une image
- ajouter une note de bas de page
- ajouter une référence
- déclarer un titre et niveaux de titre
- ajouter un italique
- ajouter une citation
- ajouter une image
- ajouter une note de bas de page
- ajouter une référence
Vous pouvez à tout moment visualiser un rendu du document en cours d'édition avec le bouton **[Annotate]**.
......@@ -81,16 +83,16 @@ L'exercice va consister à éditer un article simple à l'aide de Stylo dans le
2. reporter le texte dans Stylo
3. éditer le texte en Markdown et traiter notamment :
- les hyperliens: `[texte du lien](http://lien.ca)`
- les italiques: `un mot *en italique*`
- les italiques: `un mot _en italique_`
- les espaces insécables: en ASCII ` `, ou sur Stylo `CTRL+ESPACE`
- les citations: avec `> ` en début de ligne
4. à titre pédagogique, ajouter des éléments supplémentaires :
- 2 niveaux de titre: `#` niveau 1 et `##` niveau 2
- une ou plusieurs note.s de bas de page: `[^note]`
- une ou plusieurs note.s de bas de page: `[^note]` pour l'appel de note dans le texte et `[^note]: Ma note.` pour le texte de la note en fin de document
- une image: `![Légende de l'image](http://lien.ca/vers/image.jpg)`
5. traiter les deux références bibliographiques:
- générer les références en bibtex (voir tutoriel [Comment importer rapidement une bibliographie vers Zotéro ?](http://www.youtube.com/watch?v=S-f3J9LOqdQ))
- intégrer les clés bibtex dans l'article (voir [Références en markdown/bibtex](./parcours/09_ressources.md#r%C3%A9f%C3%A9rences-en-markdownbibtex))
- intégrer les clés BibTeX dans l'article (voir [Références en Markdown/BibTeX](./parcours/09_ressources.md#r%C3%A9f%C3%A9rences-en-markdownbibtex))
Les deux références utilisés en bibtex :
......@@ -116,7 +118,7 @@ Les deux références utilisés en bibtex :
Stylo permet de produire plusieurs formats à partir du format pivot en Markdown.
Il est possible de choisir entre deux styles de citations : ![moduleexport](./media/exportmodal.png)
Il est possible de choisir entre deux styles de citation : ![moduleexport](./media/exportmodal.png)
1. _inline citations_ : la référence de type _(Goody, 1976)_ est ajoutée dans le corps du texte,
2. _footnotes citations_ : la référence est intégrée avec un appel de note.
......@@ -131,4 +133,4 @@ Il est possible de choisir entre deux styles de citations : ![moduleexport](./me
Au prochain exercice, nous allons utiliser les sources du `.zip` pour personnaliser la production de document.
---
Voir la suite [[03_outils](./03_outils.md)]
Voir la suite [[04_edition](./04_edition.md)]
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment