Le blog : Maîtriser l’insertion des images dans Ulysses

Le blog : Maîtriser l’insertion des images dans Ulysses

Insérer des images dans les pages

Revoyons dans un premier temps les deux méthodes pour insérer une image dans Ulysses.

En passant par le menu Balisage, puis Image, vous affichez un dialogue pour insérer l’image.

Description de l’image

Le bouton Fichier permet de sélectionner l’image dans votre gestionnaire de fichiers. Avec le bouton URL vous saisissez l’URL de l’image que vous souhaitez insérer dans votre document et qui est déjà publiée sur le web.

Description de l’image

Ensuite, vous devez saisir, si vous le voulez, le Titre et la Légende de l’image.

Description de l’image

La deuxième solution vous permet de faire un cliqué-glissé du fichier de l’image à insérer, à l’endroit voulu de votre page Ulysses. L’image est insérée. Pour la paramétrer, faites un double clic sur sa vignette.

Description de l’image

Vous retrouvez les champs Titre et Légende.

Description de l’image

Afficher les images dans Ulysses

Pour gérer l’affichage des images dans les pages, allez dans les Préférences. Dans l’onglet Général, paramétrez les options dans la zone Aperçus d’images.

Description de l’image

Vous pouvez décider d’afficher ou pas les vignettes des images insérées, en couleurs ou pas et sur combien de lignes.

Trouver les fichiers des pages

Ulysses ne donne pas accès aux fichiers des pages dans votre gestionnaire de fichiers. Nous ne pouvons qu’accéder aux pages dans la bibliothèque d’Ulysses. Les fichiers sources sont accessibles par ce chemin : ~/Library/Group Containers/X5AZV975AG.com.soulmen.shared/Ulysses/Documents/Library/.

Dans le dossier Library, chaque dossier est un dossier dans la bibliothèque. Ensuite, chaque fichier .ulysses est une page dans le dossier. Pour terminer, chaque fichier .ulysses est un paquet qu’il faut ouvrir avec le menu contextuel.

Connaître les paquets sources d’Ulysses

Dans chaque paquet, nous avons un fichier Content.xml contenant tout le contenu rédactionnel de vos pages. Le dossier nommé Media contient les images importées dans le document Ulysses. Quand vous insérez une image dans vos pages, Ulysses la duplique dans ce dossier Media. Les images sont renommées en conservant le nom d’origine en tant que préfixe et en conservant aussi son extension. Entre les deux, un identifiant unique est inséré. Par exemple, pour le fichier original dorsoduro.jpg, le fichier dupliqué devient dorsoduro.b108e4dd3f5849eba40247528a31300d.jpg.

Comprendre l’insertion des images dans les pages

Dans le fichier XML, nous avons tout le contenu rédactionnel et sa mise en forme qui utilisent la syntaxe XML. Voici un exemple d’une insertion d’une image :

<p><element kind="image"><attribute identifier="image">b108e4dd3f5849eba40247528a31300d</attribute><attribute identifier="title">La pointe de Dorsoduro</attribute><attribute identifier="description">Les douanes à la pointe de Dorsoduro</attribute></element></p>

Nous retrouvons les attributs de l’identifiant unique du fichier dupliqué et des libellés du Titre et de la Légende.

Ajouter des champs à l’image

Pour ajouter des dimensions pour l’exportation, il faut ajouter un nouveau champ à l’image. Faites un double-clic sur la vignette, ajoutez un nouveau champ en cliquant sur le bouton + et en choisissant Taille.

Description de l’image

Renseignez la Largeur ou la Hauteur. Si vous ne renseignez qu’une valeur, le redimensionnement se fait de manière proportionnelle et l’autre champ prend la valeur auto.

Description de l’image

Voici la modification apportée au fichier XML, avec l’attribut size :

<p><element kind="image"><attribute identifier="image">b108e4dd3f5849eba40247528a31300d</attribute><attribute identifier="title">La pointe de Dorsoduro</attribute><attribute identifier="description">Les douanes à la pointe de Dorsoduro</attribute><attribute identifier="size"><size width="800"></size></attribute></element></p>

Vous pouvez aussi ajouter le champ Exporter au format pour renommer le fichier de l’image lors de l’exportation de la page et éventuellement créer un dossier spécifique pour les images exportées.

Description de l’image

Voici la modification apportée au fichier XML, avec l’identifiant filename :

<attribute identifier="filename">images/dorsoduro-venise.jpg</attribute>

Utiliser les champs à l’exportation

Les champs utilisés pour paramétrer les images vont pouvoir être exploités lors de l’exportation des pages.

Voici le code généré lors de l’exportation au format HTML :

<figure><img src="images/dorsoduro-venise.jpg" alt="Les douanes à la pointe de Dorsoduro" title="La pointe de Dorsoduro" width="800"><figcaption>Les douanes à la pointe de Dorsoduro</figcaption></figure>

Tous les champs sont utilisés :

  • Titre pour l’attribut title.
  • Légende pour l’attribut alt.
  • Largeur pour l’attribut width.
  • Exporter au format pour l’attribut src.

Aux formats PDF et DOCX, seuls les champs Largeur et/ou Hauteur sont utilisés.

Avec le format Texte enrichi (.rtfd), aucun champ n’est utilisé.

Au format Markdown, MultiMarkdown pour être précis, tous les champs sont utilisés :

![Les douanes à la pointe de Dorsoduro](images/dorsoduro-venise.jpg "La pointe de Dorsoduro" width=800)

Le format de paquet TextBundle utilise tous les champs.

Enfin, au format ePub, tous les champs sont utilisés :

<figure><div class="figureContainer"><img src="../Images/image-2.jpg" title="La pointe de Dorsoduro" width="200" alt="La pointe de Dorsoduro"></div><figcaption>Les douanes à la pointe de Dorsoduro</figcaption></figure>

Connaître l’insertion, le paramétrage et l’exportation des images

Voilà terminé ce tour d’horizon sur l’insertion des images, leur paramétrage et l’utilisation des champs pour l’exportation. Du fait de sa structure double Markdown - XML, Ulysses a une gestion toute personnelle des documents rédactionnels. Vous êtes maintenant en mesure d’en connaître les arcanes.

Posted on