ajout de section pandoc et debut section bootstrap
This commit is contained in:
François Pelletier
parent
d91499b285
commit
625180d767
2 changed files with 193 additions and 4 deletions
BIN
bootswatch.png
Normal file
BIN
bootswatch.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 120 KiB |
197
document2_0.md
197
document2_0.md
|
|
@ -22,7 +22,7 @@ Objectifs de cet atelier:
|
|||
1. Les thèmes Bootstrap
|
||||
1. L'outil de conversion de documents Pandoc
|
||||
|
||||
## Markdown
|
||||
# Markdown
|
||||
|
||||
- Markdown est une syntaxe simple pour écrire des textes et de la documentation.
|
||||
- C'est un langage de balisage léger, beaucoup plus simple que le HTML et le LaTeX.
|
||||
|
|
@ -59,6 +59,8 @@ Quelques _saveurs_:
|
|||
La documentation de la syntaxe Markdown peut facilement être trouvée en ligne. Une version française se trouve ici:
|
||||
|
||||
- [Traduction de la documentation en français](https://michelf.ca/projets/php-markdown/syntaxe/)
|
||||
- [Un guide pour bien commencer avec markdown](https://blog.wax-o.com/2014/04/tutoriel-un-guide-pour-bien-commencer-avec-markdown/)
|
||||
|
||||
|
||||
## Quel éditeur utiliser?
|
||||
|
||||
|
|
@ -73,13 +75,13 @@ La documentation de la syntaxe Markdown peut facilement être trouvée en ligne.
|
|||
|
||||
[Atom](https://atom.io/): Éditeur de texte pour le 21e siècle!
|
||||
|
||||
|
||||
|
||||
|
||||
## Visual Studio
|
||||
|
||||
[Visual Studio Code](https://code.visualstudio.com) est un éditeur libre, moderne et tres performant développé par la communauté et Microsoft.
|
||||
|
||||
|
||||
|
||||
|
||||
Je recommande Visual Studio Code. Il est disponible sur tous les environnements de bureau et existe aussi en version portable afin de contourner les restrictions d'entreprise.
|
||||
|
||||
|
|
@ -89,7 +91,7 @@ Remarkable est un éditeur simple et convivial pour la syntaxe Markdown
|
|||
|
||||
[Remarkable sur GitHub](https://github.com/jamiemcg/remarkable)
|
||||
|
||||
|
||||
|
||||
|
||||
## RStudio
|
||||
|
||||
|
|
@ -98,3 +100,190 @@ RStudio est d'abord un environnement de développement intégré (IDE) pour le l
|
|||
|
||||
|
||||
[RStudio RMarkdown](http://rmarkdown.rstudio.com/)
|
||||
|
||||
# Bootstrap
|
||||
|
||||
Bootstrap est un module qui permet d'utiliser des consignes de formatages faciles à interpréter par le navigateur. Il utilise le CSS (Cascading Style Sheet) pour créer des thèmes personnalisés et interchangeables. Créer un thème bootstrap requiert une connaissance du HTML et du CSS, mais les utiliser est plutôt simple.
|
||||
|
||||
## Bootswatch
|
||||
|
||||
[Bootswatch](https://bootswatch.com/) est un ite web qui propose des thèmes gratuits pour Bootstrap.
|
||||
|
||||
|
||||
|
||||
# Pandoc
|
||||
|
||||
Pandoc est un outil et une librairie écrit en Haskell qui permet de convertir des documents entre plusieurs formats ouverts.
|
||||
|
||||
Il y a aussi une librairie très utilisée par plusieurs autres logiciels. Si votre éditeur permet d'exporter votre travail dans une multitude de formats, c'est probablement du à Pandoc.
|
||||
|
||||
Pandoc est multi-plateformes, mais certaines fonctionnalités peuvent être limitées. Par exemple, il faut avoir Microsoft Word ou LibreOffice pour produire des DOCX.
|
||||
|
||||
|
||||
Installation
|
||||
|
||||
```bash
|
||||
sudo apt-get install pandoc
|
||||
```
|
||||
|
||||
Installation avec Cabal, pour avoir la version la plus récente:
|
||||
|
||||
```bash
|
||||
cabal install pandoc
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Pandoc: Formats d'entrée
|
||||
|
||||
Les formats d'entrée incluent:
|
||||
|
||||
- markdown
|
||||
- DocBook
|
||||
- LaTeX
|
||||
- OpenDocument
|
||||
- Epub
|
||||
- ...
|
||||
|
||||
---
|
||||
|
||||
## Pandoc: Formats de sortie
|
||||
|
||||
Les formats de sortie incliuent:
|
||||
|
||||
- HTML
|
||||
- OpenDocument
|
||||
- EPub
|
||||
- DocBook
|
||||
- LaTeX
|
||||
- PDF
|
||||
- markdown
|
||||
- MediaWiki
|
||||
- DokuWiki
|
||||
|
||||
---
|
||||
|
||||
## Pandoc Markdown
|
||||
|
||||
Le Pandoc Markdown est un des formats d'entrée les plus vertatiles. Il s'agit d'une variante de Markdown supportant plusieurs fonctionnalités additionnelles.
|
||||
|
||||
Référence: [Anthoring Pandoc Markdown](http://rmarkdown.rstudio.com/authoring_pandoc_markdown.html)
|
||||
|
||||
---
|
||||
|
||||
## Pandoc Markdown: Blocs de lignes
|
||||
|
||||
Les **blocs** de lignes permettent de séparer le texte manuellement. Par exemple, pour les adresses:
|
||||
|
||||
**Code:**
|
||||
|
||||
```markdown
|
||||
| Centre de loisirs St-Louis-de-France
|
||||
| 1560 Route De L’Église
|
||||
| Québec, G1W 3P5
|
||||
```
|
||||
|
||||
**Résultat:**
|
||||
|
||||
| Centre de loisirs St-Louis-de-France
|
||||
| 1560 Route De L’Église
|
||||
| Québec, G1W 3P5
|
||||
|
||||
---
|
||||
|
||||
## Pandoc Markdown: Tables simples
|
||||
|
||||
Il faut spécifier l'extension `+simple_tables`
|
||||
|
||||
**Code:**
|
||||
|
||||
```markdown
|
||||
Droite Gauche Centre Defaut
|
||||
------- ------ ---------- ------
|
||||
12 12 12 12
|
||||
123 123 123 123
|
||||
|
||||
Table: Demonstration de la syntaxe des tables simples.
|
||||
```
|
||||
|
||||
**Résultat:**
|
||||
|
||||
Droite Gauche Centre Defaut
|
||||
------- ------ ---------- ------
|
||||
12 12 12 12
|
||||
123 123 123 123
|
||||
|
||||
Table: Demonstration de la syntaxe des tables simples.
|
||||
|
||||
---
|
||||
|
||||
## Pandoc Markdown: métadonnées
|
||||
|
||||
Les métadonnées permettent d'identifier le titre, l'auteur et la date dans l'entête du document. On utilise l'extension `+pandoc_title_block`
|
||||
|
||||
**Code:**
|
||||
```markdown
|
||||
% Les formats de documents ouverts
|
||||
% François Pelletier
|
||||
% 25 novembre 2017
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Pandoc Markdown: mathématiques
|
||||
|
||||
Pandoc permet de traiter les équations mathématiques saisies avec la syntaxe LaTeX à l'aide de différents outils tout dépendamment du format de document en sortie.
|
||||
|
||||
Les principaux outils utilisés sont MathML et AMS \LaTeX
|
||||
|
||||
---
|
||||
|
||||
## Pandoc Markdown: mathématiques
|
||||
|
||||
On saisis les contenus mathématiques entre signes `$` ou `$$` pour les expressions multilignes.
|
||||
|
||||
**Code:**
|
||||
|
||||
```markdown
|
||||
$$
|
||||
{\begin{aligned}/home/francois/nextCloud/LinuQ/20171025_pandoc/20171025_formats_ouverts
|
||||
&\gamma _{ij}(x,t) \\
|
||||
=&\sum _{k=1}^{N}\sigma _{ik}(x,t)\sigma _{jk}(x,t)
|
||||
\end{aligned}}
|
||||
$$
|
||||
```
|
||||
|
||||
**Résultat:**
|
||||
|
||||
$$
|
||||
{\begin{aligned}
|
||||
&\gamma _{ij}(x,t) \\
|
||||
=&\sum _{k=1}^{N}\sigma _{ik}(x,t)\sigma _{jk}(x,t)
|
||||
\end{aligned}}
|
||||
$$
|
||||
|
||||
---
|
||||
|
||||
## Produire des présentations facilement
|
||||
|
||||
Un exemple: cette présentation a été écrite avec le langage Markdown et exportée en PDF et en HTML avec Pandoc.
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
pandoc -f markdown+simple_tables+pandoc_title_block \
|
||||
-t beamer -s presentation.md -o presentation.pdf
|
||||
pandoc -f markdown+simple_tables+pandoc_title_block \
|
||||
-t slidy -s presentation.md -o presentation.html
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Publier sur un wiki ou un site web
|
||||
|
||||
Il est aussi possible d'exporter le contenu d'un document vers la syntaxe dokuwiki, ce qui peut être très utile !
|
||||
|
||||
```bash
|
||||
pandoc -f markdown+simple_tables+pandoc_title_block \
|
||||
-t dokuwiki -s presentation.md -o presentation.dokuwiki
|
||||
```
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue