Org mode pour GNU Emacs

Points forts

Fonctionnalités

Installation

Démarrage rapide

Contribuer

Mobile/Web

Org est un format de fichier en texte brut, structuré et très souple, composé de quelques structures simples mais polyvalentes — conçu pour être à la fois assez simple pour le débutant et assez puissant pour l'expert.

L'exemple ci-dessous donne un aperçu de la puissance expressive d'Org. Cliquez sur les titres et les liens pour découvrir comment Org replie intelligemment le contenu structuré. Vous pouvez aussi consulter la spécification formelle de la syntaxe Org et une liste d'analyseurs syntaxiques d'Org

#+title:  Example Org File
#+author: TEC
#+date:   2020-10-27
* Revamp orgmode.org website

The /beauty/ of org *must* be shared.
[[https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg]]
share icon
** DONE Make screenshots
   CLOSED: [2020-09-03 Thu 18:24]

** DONE Restyle Site CSS

Go through [[file:style.scss][stylesheet]]

** TODO Check CSS on main pages 








* Learn Org

Org makes easy things trivial and complex things practical.

You don't need to learn Org before using Org: read the quickstart
page and you should be good to go.  If you need more, Org will be
here for you as well: dive into the manual and join the community!
    
** Feedback

#+include: "other/feedback.org*manual" :only-contents t
* Check CSS minification ratios
      
#+begin_src python
from pathlib import Path
cssRatios = []
for css_min in Path("resources/style").glob("*.min.css"):
    css = css_min.with_suffix('').with_suffix('.css')
    cssRatios.append([css.name,
    "{:.0f}% minified ({:4.1f} KiB)".format( 100 *
                      css_min.stat().st_size / css.stat().st_size,
                      css_min.stat().st_size / 1000)])
return cssRatios
#+end_src
#+RESULTS:
| index.css    | 76% minified ( 1.4 KiB) |
| org-demo.css | 77% minified ( 2.8 KiB) |
| errors.css   | 74% minified ( 4.9 KiB) |
| org.css      | 75% minified (10.7 KiB) |

En savoir plus

Au-delà du démarrage rapide et du manuel, Org dispose d'un guide et d'une abondante documentation rédigée par la communauté sur Worg.

Presque tous les utilisateurs d'Org ont une histoire à raconter sur la manière dont Org les aide au quotidien — certains l'ont trouvé si utile qu'ils ont écrit des papiers (scientifiques) sur la valeur d'Org pour mener des travaux de recherche reproductible. D'autres ont produit des outils tiers pour profiter d'Org en dehors d'Emacs, comme des applications mobiles.

Plus d'Org

Le type MIME de facto des fichiers Org est text/org. Les fichiers Org utilisent l'extension .org. La plupart des systèmes d'exploitation ne savent pas qu'il faut ouvrir les fichiers .org dans Emacs, mais ils peuvent être configurés pour le faire sans grande difficulté.

Bien que l'implémentation de référence d'Org en Emacs Lisp soit de loin la plus complète, il existe de nombreux autres outils qui fonctionnent avec Org.

Le pouls du projet

Worg, un monde (World) d'Org

Org et Org-mode ont tellement de cas d'usage qu'il est tout simplement impossible de les documenter facilement, et encore moins de tous les présenter sur une seule page. C'est pourquoi Worg sert de wiki communautaire : on y documente et on y partage des informations sur tous les aspects de l'utilisation d'Org.

Par exemple, Worg contient :

Worg est maintenu sous la forme d'un dépôt Git de fichiers Org publiés en site HTML. Les nouvelles contributions sont bienvenues.

~$ git clone https://git.sr.ht/~bzg/worg

Rejoindre la liste de diffusion

La liste de diffusion d'Org est le lieu central pour entrer en contact avec la communauté. Vous pouvez vous abonner à la liste et parcourir ses archives sur list.orgmode.org ou sur cette page mailman.

Si vous n'êtes pas abonné à la liste, vous pouvez tout de même écrire à emacs-orgmode@gnu.org : nous vous ajouterons à la liste blanche des personnes autorisées à y publier.

Vous pouvez en lire plus sur la liste de diffusion et trouver d'autres informations sur les actualités d'Org sur le web social.

Vous pouvez aussi discuter avec d'autres org-thousiastes via IRC sur les canaux #org-mode et #org-mode-fr sur Libera.Chat.

La liste complète des contributeurs à Org mode est maintenue sur Worg et vous pouvez aussi consulter les remerciements du manuel.

Doom, Spacemacs, Scimax et autres configurations populaires

Les kits de démarrage Emacs Doom, Spacemacs et Scimax fournissent un ensemble choisi de paquets et de configurations qui visent à améliorer Org mode (et Emacs plus généralement) pour certains cas d'usage. Ils incluent Org ainsi que des intégrations entre org-mode et d'autres modes (comme evil-mode). Voici les liens vers les paquets actuellement inclus dans Doom et Spacemacs. Scimax est profondément intégré à Org : un bon point de départ est son manuel. Doom installe une version d'Org proche du HEAD de développement, tandis que Spacemacs et Scimax suivent Org tel que publié sur ELPA.

Les kits de démarrage modifient souvent de façon importante l'expérience utilisateur par défaut d'Emacs. Si vous cherchez quelque chose de plus proche d'un Emacs standard, il existe des configurations populaires comme l'emacs.d de Purcell qui incluent des personnalisations d'org-mode et des paquets liés à Org.

Dans d'autres éditeurs, sur Android et iOS

Bien que l'ensemble complet des fonctionnalités d'Org soit pour l'instant exclusif à Emacs, les fonctions de base pour les fichiers Org ont été implémentées dans divers éditeurs et applications mobiles. Voici quelques extensions et applications qui prennent en charge les fichiers Org.

Created by TEC with Org mode unicorn logo

licensed under the GNU FDL 1.3 — see the source code for this website.