pandoc-cl/devis/README.md

83 lines
2.5 KiB
Markdown
Raw Normal View History

2019-06-03 10:47:48 +00:00
# Template devis pandoc
2019-06-03 10:43:50 +00:00
## Utilisation
### Méta-données nécessaires
Un [bloc de méta-donnée doit être présent au début du fichier](https://pandoc.org/MANUAL.html#extension-pandoc_title_block).
Le plus simple est d'utiliser un `metadata_yaml_block` au début du fichier markdown / rst:
```
---
destinataire: UCLouvain
title: 'Estimation'
devisnum: 20XX-XX
date: 3 juin 2019
lang: fr-BE
---
Mon devis commence ici
```
### Compilation en odt
Un template odt est disponible. Il est nécessaire de forcer le `data-dir` vers le répertoire correspondant, et pointer le template vers le fichier `content.xml`
```bash
pandoc \
--template content.xml \
--data-dir . \
--from markdown \
--to odt \
-o /path/to/devis.odt \
/pato/from/devis.md
```
Le fichier de méta-données peut également être stocké séparément (nécessite une version récente de pandoc):
```bash
pandoc \
--template content.xml \
--data-dir . \
--from markdown \
--to odt \
--metadata-file /path/to/devis.metadata.yml \
-o /path/to/devis.odt \
/pato/from/devis.md
```
2019-06-03 10:43:50 +00:00
#### A vérifier après la compilation
- vérifier le contenu, et notamment le bon de commande ;
- vérifier les listes à puce ;
- vérifier les indications par défaut (modalités de paiement, etc.) ;
2019-06-03 10:47:48 +00:00
## Développement / contribution
- le fichier content.xml contient le rendu en xml ;
- le fichier references.odt est le fichier de base. Seul le content.xml compilé est remplacé ;
### Explications sur le dev
### Fichier `styles.xml` de references.odt
#### `First_20_paragraph`
Pandoc attribute le style `First_20_paragraph` au premier paragraphe de chaque section.
Ajout d'un style pour le premier paragraphe, dans le fichier `styles.xml` de l'archive `reference.odt`. Ce style est identique au corps de texte.
2019-06-03 10:43:50 +00:00
```xml
<!-- ajouté pour pandoc -->
<style:style style:name="First_20_paragraph" style:display-name="First text body" style:family="paragraph" style:parent-style-name="Standard" style:class="text">
<style:paragraph-properties fo:margin-top="0cm" fo:margin-bottom="0.212cm" loext:contextual-spacing="false" fo:text-align="justify" style:justify-single-word="false" />
<style:text-properties style:font-size-asian="10.5pt" />
</style:style>
<style:style style:name="List" style:family="paragraph" style:parent-style-name="Text_20_body" style:class="list">
<style:text-properties style:font-size-asian="12pt" style:font-name-complex="Lohit Hindi1" style:font-family-complex="&#39;Lohit Hindi&#39;" />
</style:style>
<!-- fin de l'ajout -->
```