Balises de media

embed-pdf

Permet d'intégrer un lien vers un fichier PDF avec un titre.

Attributs

src

Le chemin vers le fichier PDF. Vous devez spécifier le chemin relatif vers le fichier PDF à intégrer.

embed-pdf[#:src "chemin/vers/document.pdf"]

titre

Le titre à afficher pour le lien. Ce texte sera affiché comme légende du lien vers le PDF.

embed-pdf[#:titre "Mon document PDF"]

Usage

pollen

◊embed-pdf[#:src "chemin/vers/document.pdf" #:titre "Mon document PDF"]

htmlepubxhtmltex

<a class="embed-pdf" href="chemin/vers/document.pdf" target="_blank">
  <div class="legende">
    <div>Mon document PDF</div>
  </div>
</a>

<a class="embed-pdf" href="chemin/vers/document.pdf" target="_blank">
  <div class="legende">
    <div>Mon document PDF</div>
  </div>
</a>

Non supporté en format PDF.

image

Image standard qui peut être intégrée dans le texte avec différentes options de positionnement.

Pour insérer une image, mettez-la dans le dossier images qui se trouve à la racine du projet. Ensuite, il suffira de la référencer grâce à cette balise image, sans spécifier son extension de fichier.

image supporte plusieurs formats de fichier image.

Les extensions supportées sont :

.svg (image/svg+xml)
.png (image/png)
.jpeg (image/jpeg)
.jpg (image/jpeg)
.webp (image/webp)

Support d'autres extensions

Cette liste d'extensions supportées est éditable dans le fichier /pollen/utility/file.rkt.

L'ordre dans la liste est important. En effet, le premier est l'image par défaut. Par défaut dans Fabrilivre, le PNG est donc utilisé en priorité, pour sa capacité de compression sans perte et sa qualité d'affichage.

Pour une même image, vous pouvez spécifier un ou plusieurs plusieurs fichiers de formats différents. Vous pouvez par exemple proposer une version PNG, une version WEBP, et une version JPEG. Cette flexibilité vous permet d'utiliser le format qui vous convient le plus.

Note

Cette balise n'a pas de contenu entre les accolades. Tout est géré dans les attributs.

Attributs

alt: Texte alternatif utilisé par les terminaux avec assistants de lecture. Correspond à l'attribut alt HTML.
pregen-src: Chemin vers le fichier image, sans l'extension de fichier.

Exemple

Pour un fichier "images/exemple.png", il faut mettre "images/exemple".
height: Hauteur de l'image. Peut être spécifiée avec ou sans unité (pt par défaut).
width: Largeur de l'image. Peut être spécifiée avec ou sans unité (pt par défaut).
high-quality-paper-src TEX: Valeur utilisée lors de l'export tex. Il faut spécifier le chemin complet, extension incluse, vers un fichier d'image en haute définition (300 dpi et plus). Si non spécifié, l'image ne sera pas affichée en mode TEX pour éviter les images floues ou pixellisées.
paper-height TEX: Hauteur spécifique pour l'export TEX. Si non spécifié, utilise la valeur de height. En pt si l'unité est non spécifiée.
paper-width TEX: Largeur spécifique pour l'export TEX. Si non spécifié, utilise la valeur de width. En pt si l'unité est non spécifiée.
float: Positionnement de l'image dans le texte. Valeurs possibles : - "left" : L'image flotte à gauche - "right" : L'image flotte à droite - "none" : L'image reste dans le flux normal du texte (par défaut)

Usage

pollen

◊image[
    #:pregen-src "images/exemple"
    #:height "200pt"
    #:width "300pt"
    #:high-quality-paper-src "assets/exemple-hdpi.png"
    #:paper-height "2cm"
    #:paper-width "4cm"
    #:float "left"
    #:alt "Description textuelle de l'image."
]{}

htmlepubxhtmltex

<picture class="float-left">
    <source srcset="images/exemple.webp" type="image/webp"></source>
    <img src="images/exemple.png" alt="Description textuelle de l'image." width="300pt" height="200pt" />
</picture>

<picture class="float-left">
    <source srcset="../images/exemple.webp" type="image/webp"></source>
    <img src="../images/exemple.png" alt="Description textuelle de l'image." />
</picture>

\begin{wrapfigure}{l}{0.5\textwidth}
\includegraphics[width=4cm,height=2cm]{assets/exemple-hdpi.png}
\end{wrapfigure}

L'image sera positionnée à gauche du texte avec un retour à la ligne automatique.

image-page

Image dite en pleine page. Il s'agit d'une image qui est supposée s'afficher entièrement sur une page d'un livre.

Pour insérer une image, mettez-la dans le dossier images qui se trouve à la racine du projet. Ensuite, il suffira de la référencer grâce à cette balise image-page, sans spécifier son extension de fichier.

image-page supporte plusieurs formats de fichier image.

Les extensions supportées sont :

.svg (image/svg+xml)
.png (image/png)
.jpeg (image/jpeg)
.jpg (image/jpeg)
.webp (image/webp)

Support d'autres extensions

Cette liste d'extensions supportées est éditable dans le fichier /pollen/utility/file.rkt.

L'ordre dans la liste est important. En effet, le premier est l'image par défaut. Par défaut dans Fabrilivre, le PNG est donc utilisé en priorité, pour sa capacité de compression sans perte et sa qualité d'affichage.

Pour une même image, vous pouvez spécifier un ou plusieurs plusieurs fichiers de formats différents. Vous pouvez par exemple proposer une version PNG, une version WEBP, et une version JPEG. Cette flexibilité vous permet d'utiliser le format qui vous convient le plus.

Note

Cette balise n'a pas de contenu entre les accolades. Tout est géré dans les attributs.

Attributs

alt: Texte alternatif utilisé par les terminaux avec assistants de lecture. Correspond à l'attribut alt HTML.
pregen-src: Chemin vers le fichier image, sans l'extension de fichier.

Exemple

Pour un fichier "images/exemple.png", il faut mettre "images/exemple".
height: Nombre entier représentant la hauteur de l'image. Il s'agit de la valeur intrinsèque de l'image, et non pas la taille désirée.
high-quality-paper-src TEX: Valeur utilisée lors de l'export tex. Il faut spécifier le chemin complet, extension incluse, vers un fichier d'image en haute définition (300 dpi et plus).
width: Nombre entier représentant la largeur de l'image. Il s'agit de la valeur intrinsèque de l'image, et non pas la taille désirée.

Usage

pollen

◊image-page[
    #:pregen-src "images/exemple"
    #:height "645"
    #:width "906"
    #:high-quality-paper-src "assets/exemple-hdpi.png"
    #:alt "Description textuelle de l'image."
]{}

htmlepubxhtmltex

<picture class="image-page">
    <source srcset="images/exemple.webp" type="image/webp"></source>
    <img src="images/exemple.png" alt="Description textuelle de l'image." width="906" height="645" />
</picture>

<picture class="image-page">
    <source srcset="../images/exemple.webp" type="image/webp"></source>
    <img src="../images/exemple.png" alt="Description textuelle de l'image." />
</picture>

\afterpage{\includepdf{assets/exemple-hdpi.png}}

L'image prendra la page entière qui suit la page où se trouve cette balise.