Org-noter

Pour ce premier vrai article, je voulais vous présenter Org-noter.

Il s'agit d'un paquet Emacs vous proposant de prendre des notes sur des documents. Les notes sont au format Org-mode et les documents peuvent être au format PDF, EPUB, OpenDocument, DVI, PS ou Microsoft Office.

Org-noter vous affiche, côte à côte, votre document ainsi que les notes qui vous aurez prises. Chaque note est liée à une page du document. Les notes sont automatiquement pliées ou dépliées en fonction de la page affichée sur le document.

Vous avez accès à toutes les fonctionnalités d'Org-mode, que ce soit pour organiser vos notes en différentes sections et sous-sections, faire des citations, inclure des bloques de code, des tableaux ou des images, etc.

Vos notes restent sauvegardés dans des fichiers textes, sur lesquels vous pouvez utiliser des outils comme grep pour faire des recherches, ou git pour gérer les différentes versions de vos notes.

Et tout ça depuis Emacs, avec vos raccourcis, vos snippets et toute votre personnalisation.

Installation du paquet Org-noter

Un paquet Org-noter est disponible sur le dépôt MELPA.

Après avoir ajouté ce dépôt à votre Emacs, vous avez deux options pour installer Org-noter: Manuellement ou automatiquement.

Manuellement

Depuis Emacs, lancez la commande package-refresh-content avec le raccourcis M-x suivit du nom de la commande.

Ensuite, toujours avec le raccourcis M-x, lancez la commande package-install. Emacs vous demandera le nom du paquet, écrivez simplement org-noter et validez.

Automatiquement

Si vous configurez Emacs avec le fichier ~/.emacs.d/init.el et que le paquet use-package est installé, vous pouvez simplement ajouter ceci à votre configuration Emacs:

(use-package org-noter)

Maintenant, il reste à évaluer ce bout de code. À chaque évaluation, si Org-noter n'est pas installé il le sera. Si il est déjà installé, rien ne se passera.

Utilisation

Pour utiliser Org-noter, il suffit:

  • D'ouvrir un document Org-mode avec Emacs
  • D'y créer une section qui regroupera vos notes
  • D'appeler la commande org-noter avec le raccourcis M-x suivis du nom de la commande

La première fois que vous le ferez, il vous demandera le chemin vers le document que vous voulez utiliser. Vous pouvez préciser un document attaché à votre section Org-mode, si vous en avez attaché un.

Une fois le document choisis, une nouvelle frame Emacs s'ouvre, avec 2 fenêtre Emacs: À gauche votre document, à droite vos notes. La fenêtre du document aura le focus.

Pour insérer une nouvelle note, appuyez sur i. Le titre de la note est demandé dans le mini-buffer d'Emacs. Une fois le titre renseigné, vous pouvez écrire le corps de votre note.

Raccourcis clavier

Voici quelques unes des fonctions fournies par Org-noter, avec leur raccourcis clavier:

Action Raccourcis
Insérer une note dans le document Org i
Insérer une note liée à un emplacement préciser M-i
Terminer la session q
Synchroniser les notes avec la page actuelle M-.
Synchroniser avec la page suivante/précédente M-n / M-p
Synchroniser la page avec la note actuelle C-M-.
Synchroniser avec la note suivante/précédente C-M-n / C-M-p

Plus d'infos

Pour plus d'informations sur Org-noter:

Conclusion

Org-noter est très pratique pour prendre des notes détaillées depuis un document. Je m'en sert beaucoup avec des documents PDF, mais quand j'aurai à nouveau le temps de lire des livres, j'essayerai avec des documents EPUB.

Je regrette de pas pouvoir l'utiliser sur des vidéos ou des pages web. Mais peut-être que ça viendra.

Un grand merci à aux personnes qui ont développés Org-noter.