Org-mode 3/5 : des liens et des images dans vos notes

Org-mode est un mode de l’éditeur de texte GNU Emacs utilisé pour la prise de notes, la gestion de tâches, la publication de documents, de blogs, les bibliographies, etc., même la synchronisation avec un smartphone ! Oui, oui, oui, les possibilités d’utilisation d’org-mode sont nombreuses et diverses. Tout ça en texte brut.

Ben Maughan de Pragmatic Emacs a rédigé cinq tutoriels d’introduction à Org-mode sur la prise de notes et leur publication. La suite présente son troisième article (traduit en français avec l’accord de l’auteur).

NdM : j’ai profondément revu la traduction initiale de ptitjano pour conserver le style rapide, concis et rythmé de l’auteur.

Cette série d’introduction sur Org-mode se concentre sur les notes en texte simple. Nous avons déjà vu comment structurer vos notes et y ajouter des tableaux.

L’étape suivante, c’est d’ajouter des liens et des images. Les liens pointent vers des fichiers, des URL ou des emplacements dans le document actuel. Si c’est un lien vers une image, alors Emacs peut l’afficher directement dans le document org. C’est pratique pour améliorer vos notes et ce sera utile lorsque nous les exporterons dans différents formats.

Comme avant, je suggère d’ajouter les notes ci‐dessous au fichier org en cours.

N. B. : Ci‐dessous, j’ai formaté les notes comme du texte brut à cause d’Org-mode qui change l’apparence des liens en cachant les [] autour — c’est plus joli dans votre document Org-mode, mais c’est plus difficile pour vous montrer ce qui se passe !

* Les liens et les images
Org mode gère les liens vers les fichiers, vers les URL et les liens qui 
pointent dans le document. Nous allons utiliser une image de mon site. D'abord, 
copiez-là dans le répertoire courant. On peut le faire sans quitter Emacs, mais 
pour l'instant on va taper cette commande dans un terminal :

curl http://www.star.bris.ac.uk/bjm/superman_cluster.gif -o superman_cluster.gif

Pour mettre un lien vers un fichier, faites C-u C-c C-l et indiquez le 
nom du fichier. Avec le tab-complètement sélectionnez l'image que nous 
venons de copier, ensuite on vous demandera une description — vous pouvez 
faire Entrée pour laisser ça vide. Ça va créer un lien qui ressemble à ça :

[[file:superman_cluster.gif]]

Dans votre fichier org, vous ne verrez pas les [[ ]] ci-dessus, à la 
place vous aurez le texte comme un lien cliquable.

Comme on a inséré une image, on peut dire à Emacs de l'afficher dans le 
document avec C-C C-x C-v puis utiliser la même commande pour masquer
l'image à nouveau.

Vous pouvez aussi cliquer sur le lien, ou faire C-C C-o pour le suivre, 
ça lancera le navigateur web ou un afficheur d'images, ou bien ça ouvrira 
un fichier dans Emacs, ça dépend de la cible du lien.

Dans org-mode, la structure d'un lien ressemble à ça :

#+EXEMPLE_DÉBUT
[[adresse du lien][description]]
#+EXEMPLE_FIN

(J'ai entouré le lien d'un bloc exemple qui empêche org-mode 
de l'interpréter comme un lien réel, afin d'en montrer 
la structure — on reviendra plus tard sur ce genre de bloc.)

L'adresse du lien c'est l'URL ou le fichier, et la description c'est le
texte affiché, nous pouvons donc remplacer notre lien superman par 
un truc plus propre comme [[file:superman_cluster.gif][ça]].

Les liens vers les pages web c'est facile — tapez l'adresse http dans la 
partie adresse. C-c C-l le fait en raccourci (vous vous souvenez, avec 
C-u C-c C-l on a mis un lien vers un fichier).

Les liens vers d'autres endroits du fichier org, c'est aussi facile que 
[[Les liens et les images][ça]]. Comme l'adresse correspond à un titre de 
ce document, org-mode pointe le lien vers cette partie du fichier. Cliquer 
dessus emmènera le curseur là-bas.

Enfin on peut ajouter un chapeau et un nom à notre image

#+CAPTION: Superman et le cluster galactique
#+NAME: img.super
[[file:superman_cluster.gif]]

ça permet de renvoyer plus tard à notre image avec un lien comme
[[img.super]]

Ben Maughan, Org-mode basics III: add links and images to your notes, le 11 septembre 2015.

---

Ce 20 juin, Ben Maughan vient d’enrichir Org-mode d’une fonction améliorée pour les liens internes : vous pouvez choisir votre lien dans une liste.

Aller plus loin

• Le site d’Org mode (357 clics)
• Org-mode basics III: add links and images to your notes (121 clics)
• Org-mode 2/5 : Insérer des tableaux dans vos notes (127 clics)
• Org-mode 1/5 : gérer ses notes avec GNU Emacs (244 clics)