====== Convertir un document LibreOffice en JPEG ou PNG ======

Cette fiche regroupe plusieurs cas d'utilisation((Si vous pensez qu'il n'y a pas de bonne raison de faire ça, c'est que vous manquez d'expérience ou d'imagination, situation fréquente chez les personnes convaincues que la vie est soluble dans un manuel de bonnes pratiques :-D))

===== Document multi-pages =====

Dans le cas d'usage, l'objectif est d'obtenir une image indépendante pour chaque page((Et non d'avoir toutes les pages rassemblées dans un seul fichier image.)).

La marche suivre comprend 2 étapes :
  - exporter le document en PDF
  - convertir le fichier PDF résultant en autant de fichiers-images que nécessaire
Concrètement…
  - L'export en PDF se fait depuis LibreOffice (par exemple, à l'aide de la commande "Export direct au format PDF")
  - La conversion se fait en ligne de commande en utilisant la commande //convert// :<code>$ convert mon-fichier.pdf les-images.png</code>

Dans cet exemple, les fichiers-images seront nommés "les-images-X.png" où "X" sera l'indice numérique de chaque image créée (initialisé à 0).

Il peut être souhaitable de rassembler les fichiers-images dans un (sous-)répertoire. Il faut que le répertoire existe avant de lancer la commande :
<code>
$ mkdir dossier-images
$ convert mon-fichier.pdf ./dossier-images/les-images.png
</code>
Ici, les images seront générées dans la sous-répertoire "dossier-images" du répertoire courant où se trouve le fichier intermédiaire PDF.

==== Transparence des PNG ====

Par defaut, //convert// génère des images PNG utilisant la transparence permise par ce format (canal alpha). Si on souhaite des images PNG sans transparence, il suffit de l'indiquer dans la commande :
<code>$ convert -alpha remove mon-fichier.pdf les-images.png</code>
===== Une seule page d'un document =====

Dans le cas où on ne souhaite convertir qu'une seule page du document, tout se fait depuis LibreOffice.
  - ouvrir le document,
  - se positionner sur la page voulue,
  - exporter la page courante au format souhaité en utilisant la commande d'export de LibreOffice.

===== Document mono-page =====

Dans ce cas((Ou si on ne souhaite convertir que la première page.)), on peut utiliser LibreOffice, en ligne de commande.

On se contentera d'un format de commande minimal :
<code>
$ soffice --convert-to jpg mon_document.odt
</code>
ou on tirera parti des possibilités de paramétrage :
<code>
$ soffice --convert-to png:writer_png_Export mon-doc.odt --outdir "./mon-page-en-image"
</code>
Cette dernière commande placera le fichier-image dans un sous-répertoire du répertoire courant contenant le fichier LibreOffice.