# Publication multi-supports : Markdown, Pandoc et Git

Sciences de l'information · Master 1

> Publier une seule source vers PDF, EPUB et web avec Markdown, Pandoc et versionnement Git.

## Introduction

Dans la publication traditionnelle, un même contenu est souvent ressaisi pour l'imprimé, le web et le livre numérique. Le single-source publishing propose l'inverse : une source unique, structurée et indépendante de la présentation, à partir de laquelle on génère plusieurs sorties (PDF, EPUB, HTML).

Des outils légers rendent cette approche accessible : Markdown pour écrire un texte structuré en format brut, Pandoc pour convertir vers de nombreux formats, des feuilles de style pour la mise en forme, et Git pour suivre les modifications et collaborer. Ce modèle séduit les presses universitaires, les documentations et les petites maisons d'édition.

Le deck présente les principes, avantages et limites d'une telle chaîne éditoriale, avec une attention à la mise en forme professionnelle et à la collaboration avec des auteurs non techniques.

## Objectifs d'apprentissage

- Expliquer le principe de séparation du contenu et de la présentation
- Décrire le rôle de Markdown, Pandoc et Git dans une chaîne éditoriale
- Identifier les avantages et limites pour une petite structure d'édition
- Concevoir un flux de travail adapté à des auteurs non techniques

## Concepts clés

- **Source unique** : Un contenu structuré unique d'où sont dérivées toutes les sorties, ce qui évite la duplication et les erreurs.
- **Markdown** : Langage de balisage léger en texte brut, lisible tel quel et convertible vers HTML ou d'autres formats.
- **Pandoc** : Outil de conversion entre formats de documents, capable de produire PDF, EPUB, HTML ou Word depuis Markdown.
- **Git** : Système de versionnement qui conserve l'historique des modifications et permet la collaboration.
- **Feuilles de style** : Définissent la mise en forme de chaque sortie, indépendamment du texte source.

## Conclusion

Le single-source publishing offre cohérence, rapidité et réduction des erreurs, à condition d'accompagner les équipes. Markdown, Pandoc et Git forment une chaîne légère et ouverte, mais le succès dépend autant de l'organisation et de la formation que des outils.

La question clé reste de maintenir une source propre, structurée et documentée.

## Cartes

### Qu'est-ce que le single-source publishing ?

Produire plusieurs sorties à partir d'une même source structurée.

### Pourquoi séparer contenu et présentation ?

Pour réutiliser le contenu sur plusieurs supports et modifier la mise en forme sans retoucher le texte.

### Qu'est-ce que Markdown ?

Un format de texte brut à balisage léger, facile à lire et convertir.

### Que fait Pandoc ?

Convertit des documents entre de nombreux formats.

### À quoi sert Git ?

À suivre l'historique des modifications et à collaborer sans écraser le travail des autres.

### Quel avantage pour une presse universitaire ?

Réduire la ressaisie et les erreurs entre versions imprimée et numérique.

### Quelle limite possible ?

La prise en main technique pour les auteurs et relecteurs non techniques.

### Pourquoi les feuilles de style sont-elles essentielles ?

Elles donnent à chaque sortie une mise en forme professionnelle.

### Que permet le versionnement ?

Revenir à une version antérieure et savoir qui a modifié quoi.

### Quelle alternative pour auteurs peu techniques ?

Fournir un éditeur visuel ou accepter Word et convertir en source structurée.

## Glossaire

- **Single source** : Source unique générant plusieurs sorties.
- **Markdown** : Langage de balisage léger en texte brut.
- **Pandoc** : Convertisseur universel de documents.
- **Git** : Système de contrôle de version.
- **Versionnement** : Enregistrement des états successifs d'un document.
- **Feuille de style** : Fichier définissant la mise en forme d'un document.
- **Chaîne éditoriale** : Ensemble d'étapes et d'outils qui mènent d'un manuscrit à une publication.

https://ruvy.ch/decks/-P5CyyiS3epAUmCbmRbW