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

Posté par  . Édité par Davy Defaud, Benoît Sibaud et palm123. Modéré par Pierre Jarillon. Licence CC By‑SA.
Étiquettes :
21
28
juin
2017
Doc

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

  • # Merci

    Posté par  (site web personnel) . Évalué à 2.

    Merci pour le rappel du C-u devant le C-c C-l, qui permet d'accéder directement aux système de fichiers. Je ne m'en souvenais plus, et c'est vrai que c'est bien pratique à l'usage. Car la plupart du temps, je fais des liens entre mes fichiers Org. C'est assez rare que je pointe vers autre chose (sachant que pour les URL Internet, il suffit de les taper en clair, puis de faire un C-c C-l pour leur ajouter un titre…).

    On peut aussi utiliser la syntaxe avec les [[][]], mais ces symboles sont tellement pénibles à taper sur un clavier AZERTY (et je trouve que c'est encore pire sur un Mac), que je préfère essayer de retenir le raccourcis : C-u, C-u, C-u, C-u, …

    • [^] # Re: Merci

      Posté par  . Évalué à 1.

      Pour référence, on peut aussi faire C-c C-l, puis taper file: (et entrée) dans le prompt qui s'affiche pour accéder au système fichier.

  • # Org-Reftex

    Posté par  . Évalué à 1.

    Je recherche de la documentation sur Org-Reftex, mais sans succès. Si quelqu'un a des liens à partager.

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.