Commit d657b8b8 authored by sauret's avatar sauret

initialisation cours

parent ba77aabd
# EDN6102 Outils de rédaction numérique pour la publication
EDN6102 outils de rédaction numérique pour la publication
\ No newline at end of file
Bienvenu dans l'atelier EDN6102. Vous trouverez ici toutes les ressources pour suivre l'atelier et faire les exercices.
Avant de venir à l'atelier, merci [de vous créer un compte sur Framagit](https://framagit.org/users/sign_in?redirect_to_referer=yes) (et de m'envoyer votre username) et [d'installer les outils nécessaires](./parcours/03_outils.md).
## Plan de cours
### Samedi 12 janvier
0. Introduction générale ([parcours/00_introduction](./parcours/00_introduction.md))
1. Un peu de théorie ([parcours/01_theorie](./parcours/01_theorie.md))
1. Fichiers : Arborescence, nomenclature et versionnage
2. Formats de texte
3. Chaines éditoriales
4. Edition savante
2. Exercice 1 - Stylo
1. présentation
2. édition d'un article
3. export d'un article
_pause déjeuner_
3. Outils
1. Installation des outils
2. Versionnage avec git
3. Conversion avec pandoc
_pause_
4. Exercice 2 - édition
1. Sources et analyse
2. Exports par défaut
5. Customisation
1. CSS
2. LATEX
---
[Démarrer](./parcours/00_introduction.md)
# Introduction générale
**Objectifs de l'atelier:**
- créer et éditer des documents divers
- devenir autonome dans l'utilisation de chaines de publications alternatives
- comprendre les enjeux liés aux formats et aux outils
- savoir trouver l'information qu'il vous manque
**Fonctionnement de l'atelier**
- ressource principale : https://framagit.org/laconis/edn6102
- un wiki pour collaborer : https://framagit.org/laconis/edn6102/wikis/home
**Evaluation**
---
[Voir la suite](./01_theorie.md)
# Un peu de théorie
## Arborescence de dossier
## L'arborescence des fichiers
Il faut d'abord comprendre comment est organisé votre ordinateur et où se trouvent vos fichiers.
Votre disque dur peut être compris comme une grande boîte dans laquelle se trouvent d'autres boîtes (dossiers).
La boîte principale est ce qu'on appelle "racine". Dans un ordinateur Unix (Mac ou Linux) la racine est `/`. Dans un ordinateur Windows, la racine est `C:/`.
Dans la racine vous trouvez plusieurs "boîtes".
![arborescence](https://image.jimcdn.com/app/cms/image/transf/dimension=1920x400:format=jpg/path/s2bf1aa8287716b07/image/ic069251148aebd24/version/1522921075/image.jpg)
L'emplacement du Dossier correspond à ce qu'on appelle son "chemin" (_path_).
Par exemple, par rapport à l'image ci-dessus, le dossier "Vacances" aura le chemin `/Document Personnel/Images/Vacances (dans un système Unix)` et `C:/Dossier Personnel/Images/Vacances`
Il est important que vous connaissiez la structure de l'arborescence de votre ordinateur car c'est ainsi qu'on accède aux fichiers.
## Nomenclature de fichier
_Quel nom donner à un fichier ?_ Une question pas si banale que ça. Il existe des règles qui sont fondamentales pour :
- classer un fichier,
- le retrouver facilement,
- partager ses fichiers avec d'autres personnes
- éviter des problèmes de comptabilité d'un système à un autre
Quelques règles à appliquer :
1. **les noms de fichier ne doivent pas contenir des caractères spéciaux, des accents NI des espaces.** Ce types de caractères peuvent poser des problèmes car l’ordinateur ne les reconnais pas immédiatement, il doit les convertir et dans la conversion il y a souvent des erreurs. Le fichier `mémoire de maîtrise.doc` sera difficile à retrouver. On préférera `memoire_de_maitrise.doc`.
2. **les noms des fichiers doivent être significatifs.** Le fichier `chapitre1.md` ne précise pas de quel ouvrage il est le chapitre 1. On préférera `Espace-numérique_chapitre1.md`.
3. **faites attention aux extensions que vous utilisez.** Par principe, ne masquez pas les extensions de fichiers dans vos navigateurs de fichiers. L'extension est une information primordiale pour la machine et les utilisateurs. Elle renseigne sur le format du contenu du fichier et sur ce qu'on doit/peut faire avec ce fichier. Un fichier `.doc` ne contient pas les mêmes données qu'un fichier `.pdf` par exemple.
Récapitulatif :
- pas de caractères spéciaux
- pas d'espaces
- extension
- nom parlant
- camelCase
- exemples : `2019-01-11notesEDN6102marcelloVitaliRosati.md`
[pour aller plus loin](http://ptaff.ca/blogue/2008/06/29/les_3_rgles_dor_pour_nommer_un_fichier/).
nomenclature de fichier (voir blog - http://blog.sens-public.org/marcellovitalirosati/nomenclature-dun-fichier/,
http://vitalirosati.net/slides/cours-2018-numeriqueSeminaireCollectif.html#/24
versionnage dans la nomenclature ou avec un outil de versionnage (puis on verra git)
format de texte : txt, md, asciidoc etc.
- format propriétaire / format libre (voir diapo de marcello)
- http://vitalirosati.net/slides/cours-2018-numeriqueSeminaireCollectif.html#/7
1. chaine éditoriale
- word > indesign
- chaines de format standard (XML, Tex, md, etc.)
- XML Lodel/Erudit schema
- tex
- epub
- **md** est une des chaines possibles.
- getty, o'reilly, Distill,
- Stylo [schema de la chaine] (avec un focus pratique sur stylo)
2. édition savante
- structuration & bibliographie
# Quelques outils pour travailler
Pour l'atelier vous aurez besoin d'amener votre propre ordinateur (indispensable) et d'installer quelques outils pour travailler ensemble.
## un éditeur de texte/code (indispensable)
Les éditeurs de code sont plus ou moins simples selon les fonctionnalités qu'ils offrent. À minima pour l'atelier, l'éditeur devra pouvoir colorer les syntaxes html et css (ce qu'ils font tous).
Suggestion : [Atom.io](https://atom.io/) qui fonctionnera sur toutes les plateformes.
Voir d'autres éditeurs sous [Windows](https://alternativeto.net/software/atom/?platform=windows), [Max](https://alternativeto.net/software/atom/?platform=mac), [Linux](https://alternativeto.net/software/atom/?platform=linux).
## un compte sur framagit.org (indispensable)
Sur [Framagit.org](https://framagit.org/users/sign_in?redirect_to_referer=yes), créez vous un compte. Cela vous sera utile pour :
1. partager votre code avec moi (et la classe si vous le souhaitez),
2. publier des documents en ligne,
3. [participer au wiki](https://framagit.org/edn6102-h2019/edn6102/wikis/home) de ce répertoire.
Cliquez sur le bouton [Request Access] pour demander un accès au répertoire.
**Merci de m'envoyer ensuite votre username.**
## un gestionnaire de version : git (indispensable)
Le gestionnaire de version git va vous permettre de communiquer votre code à Framagit. Nous verrons ensemble comment l'utiliser.
- Linux: déjà installé
- Mac: déjà installé sinon, dans un terminal :
- installer homebrew : `/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
- installer git avec homebrew : `brew install git`
- Windows : [installez git pour Windows](https://git-scm.com/downloads)
## LaTeX (indispensable)
LaTeX est un langage et un système de composition de documents.
Vous pouvez télécharger Latex [depuis le site officiel](https://www.latex-project.org/get/)
Markdown is supported
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