orgguide_fr/orgguide_en.texi

\input texinfo
@c %**start of header
@setfilename ../../info/orgguide
@settitle Le guide compact du mode Org
@documentencoding UTF-8
@documentlanguage fr

@include org-version.inc

@c Use proper quote and backtick for code sections in PDF output
@c Cf. Texinfo manual 14.2
@set txicodequoteundirected
@set txicodequotebacktick

@c Version and Contact Info
@set MAINTAINERSITE @uref{http://orgmode.org,maintainers webpage}
@set AUTHOR Carsten Dominik
@set MAINTAINER Carsten Dominik
@set MAINTAINEREMAIL @email{carsten at orgmode dot org}
@set MAINTAINERCONTACT @uref{mailto:carsten at orgmode dot org,contact the maintainer}
@c %**end of header
@finalout

@c Macro definitions
@iftex
@c @hyphenation{time-stamp time-stamps time-stamp-ing time-stamp-ed}
@end iftex

@c Subheadings inside a table.
@macro tsubheading{text}
@ifinfo
@subsubheading \text\
@end ifinfo
@ifnotinfo
@item @b{\text\}
@end ifnotinfo
@end macro

@macro seealso{text}
@noindent 
@b{Further reading}@*@noindent \text\
@end macro
@copying

Copyright @copyright{} 2010--2014 Free Software Foundation

@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.  A copy of the license
is included in the section entitled ``GNU Free Documentation License''
in the full Org manual, which is distributed together with the compact
guide.

(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
modify this GNU manual.''
@end quotation
@end copying

@dircategory Emacs
@direntry
* Org Mode Guide: (orgguide).  Abbreviated Org-mode Manual
@end direntry

@titlepage
@title Le guide compact du mode Org 

@subtitle Release @value{VERSION}
@author by Carsten Dominik traduit par Laurent Garnier

@c The following two commands start the copyright page.
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@c Output the table of contents at the beginning.
@shortcontents

@ifnottex
@node Top, Introduction, (dir), (dir)
@top Org Mode Guide

@insertcopying
@end ifnottex

@menu
* Introduction::		Commencer
* Structure de document::	Un arbre fonctionne comme votre cerveau
* Tables::			Pure magie pour le formattage rapide
* Hyperliens::			Notes dans contexte
* Listes TODO::			Chaque branche d'arbre peut être un élément TODO
* Balises::			Marquage des en-tête et correspondances d'ensemble de balises
* Propriétés::			Propriétés
* Dates et heures::		Créer des éléments utiles pour la planification
* Capturer - Sauver - Archiver::Les tenants et les aboutissants des projets
* Les vues de l'agenda::	La collecte d'information en vue
* Marquage::			Préparer le texte pour une exportation riche
* Exportation::			Partage et publication de notes
* Publication::			Créer un site web de fichiers Org liés
* Travail avec le code source::	Extrait de code source intégré dans Org
* Divers::		        Tout ce qui n'allait pas ailleurs

* GNU Free Documentation License::  This manual license.

@detailmenu
 --- The Detailed Node Listing ---

Introduction

* Préface::			Bienvenue
* Installation::		Comment faire pour installer une version téléchargée de Org
* Activation::			Comment activer Org pour certains tampons
* Réactions::			Rapports debogues, idées, patchs etc.

Structure du document

* Grandes lignes::		Org est basé sur le mode Outline
* Titres ::		        Comment composer des titres d'arbres Org
* Cycle de visibilité::		Afficher et masquer, très simplifié
* Motion::			Sauts à d'autres titres
* Structure d'édition::		Modification de la séquence et le niveau des titres 
* Arbres clairsemés::		Correspondances intégrées dans le contexte
* Listes complètes::		Structure supplémentaire dans une entrée
* Notes::			Comment les notes sont définies dans la syntaxe de Org

Hyperliens

* Format de lien::		Comment les liens sont formatés dans Org
* Liens internes::		Liens vers d'autres endroits dans le fichier actuel
* Liens externes::		Les URL comme des liens vers le monde
* Manipulation de liens::	Création, insertion et suivant
* Liens ciblés::		Le point, à un emplacement dans un fichier

Listes TODO 

* Utilisation des états TODO::	Configuration et basculement des états
* Flux de travail multi-état::	Plus qu'un simple marche/arrêt
* Journalisation des progrès::	Dates et notes des progrès
* Priorités::			Certaines choses sont plus importantes que d'autres
* Diviser les tâches::		Fractionnement d'une tâche en éléments gérables
* Boîtes à cocher::		Listes à cocher

Journalisation des progrès 

* Fermeture des items::		 Quand cet item a été marqué DONE?
* Suivi des basculement d'états TODO::	 Quand cet état a-t-il basculé?

Balises

* Héritage de balise::		Mots clés qui utilisent la structure arborescente des grandes lignes
* Configuration des balises::	Comment attribuer des balises à un titre
* Balise de groupes::		Utilisez une balise pour en chercher plusieurs
* Recherche de balise::		A la recherche de combinaisons de balises

Dates et heures

* Horodatages::			Donner une durée à une entrée de l'arborescence
* Création d'horodatages::	Les commandes qui insèrent des horodateurs
* Dates limites et calendrier::	Planification de votre travail
* Chronométrage du temps de travail:: Suivi du temps passé sur une tâche

Capturer - Sauver - Archiver

* Capture::			Capture de nouvelles choses 
* Sauver et copier::		Déplacement d'un arbre d'un endroit à un autre
* Archivage::			Que faire avec des projets finis

Capture

* Configuration d'un emplacement de capture::  Où les notes seront stockées
* Utilisation de capture::	Commandes qui invoquent et terminent la capture
* Modèles de capture::		Définir le contour des types de notes différentes

Vues de l'agenda

* Fichiers de l'agenda::	Fichiers recherchés pour les informations de l'agenda
* Répartiteur de l'agenda::	Accès clavier de l'agenda
* Les vues intégrées dans l'agenda:: Ce qui est disponible hors de la boîte ?
* Commandes de l'agenda::	Montage à distance des arbres Org
* Personnaliser les vues de l'agenda:: Définition de recherches spéciales et vues

Les vues intégrées dans l'agenda

* L'agenda quotidien/hebdomadaire:: La page du calendrier avec les tâches actuelles
* Liste TODO globale::		Tous les éléments d'action inachevées
* Correspondance balises et propriétés:: Informations structurées avec recherche affinée
* Chronologie::			Vue chronologique pour un fichier unique
* Vue de recherche::		Trouver des entrées par recherche de texte

Marquages pour exportation riche

* Eléments structurels de marquage:: La structure de base comme vue par l'exportateur
* Tableaux et imagess::		Images, tableaux et mécanisme de légende
* Exemples littéraux::		Des exemples de code source avec un formatage spécial
* Inclure des fichiers::	Inclure des fichiers supplémentaires dans un document 
* @LaTeX{} embarqué::		@LaTeX{} peut être utilisé librement à l'intérieur des documents Org

Eléments de balisage structurels

* Titre du document::		Lorsque le titre est tiré de
* Rubriques et sections::	La structure de document telle que vue par l'exportateur
* Table des matières::		Le si et où de la table des matières
* Paragraphes::			Paragraphes
* Emphase et monospace::	Gras, italique, etc.
* Commentaires::		Ce qui *ne* sera *pas* exporté

Exportation

* Options d'exportation::	Les paramètres par fichier d'exportation
* Le répartiteur exportation::	Comment accéder aux commandes de l'exportateur
* Exporter en ASCII/Latin-1/UTF-8 ::Exportation vers des fichiers avec encodage
* Exporter en HTML::		Exportation en HTML
* Exporter en @LaTeX{} et PDF ::Exportation en @LaTeX{}, et traitement en PDF
* Exporter vers iCalendar::	Exportation vers iCalendar

Divers

* Complétion::			M-TAB connaît ce dont vous avez besoin
* Vue propre::			Se débarasser des étoiles dans les grandes lignes
* MobileOrg::			Mode Org sur l'iPhone

@end detailmenu
@end menu

@node Introduction, Structure du document, Top, Top
@chapter Introduction

@menu
* Préface::			Bienvenue
* Installation::		Comment faire pour installer une version téléchargée de Org
* Activation::			Comment activer Org pour certains tampons
* Réactions::			Rapports debogues, idées, patchs etc.
@end menu

@node Préface, Installation, Introduction, Introduction
@section Préface

Org est un mode pour prendre des notes, maintenir des listes TODO, et faire 
de la planification de projet avec un système de texte brut rapide et efficace.
Il est également un système de création et de publication, et il permet le 
travail avec du code source pour la programmation littérale et la recherche 
reproductible.

@i{Ce document est un dérivé beaucoup plus comprimé du
@uref{http://orgmode.org/index.html#sec-4_1, manuel complet Org-Mode}.
Il contient toutes les fonctions de base et des commandes, ainsi que des
conseils importants pour la personnalisation. Il est destiné aux débutants 
intimidés par un manuel de 200 pages uniquement à cause de sa taille.}

@node Installation, Activation, Préface, Introduction
@section Installation

@b{Important:} @i{Si vous utilisez une version de Org qui fait partie de la
distribution d'Emacs ou un paquet XEmacs, prière sauter cette section et allez 
directement à la @ref{Activation}.}

Si vous avez téléchargé à partir Org depuis le Web, soit comme une distribution 
@file{.zip} ou un fichier @file{.tar}, ou comme une archive Git, il est 
préférable de l'exécuter directement à partir du répertoire de distribution. Vous 
devez ajouter le sous-répertoire @file{lisp} au chemin de chargement d'Emacs.
Pour ce faire, ajoutez la ligne suivante à votre fichier de configuration
@file{.emacs}:

@smallexample
(setq load-path (cons "~/path/to/orgdir/lisp" load-path))
(setq load-path (cons "~/path/to/orgdir/contrib/lisp" load-path))
@end smallexample

@noindent 
Pour aller plus vite vous devriez byte-compiler le fichier Lisp avec la
commande shell :

@smallexample
make autoloads
@end smallexample

@node Activation, Réactions, Installation, Introduction
@section Activation

Ajoutez les lignes suivantes à votre fichier @file{.emacs}. Les quatre dernières
définissent des touches @emph{globales} pour certaines commandes --- prière
de choisir les touches appropriées vous-même.

@smalllisp
;; The following lines are always needed.  Choose your own keys.
(global-set-key "\C-cl" 'org-store-link)
(global-set-key "\C-ca" 'org-agenda)
(global-set-key "\C-cc" 'org-capture)
(global-set-key "\C-cb" 'org-iswitchb)
@end smalllisp

Avec cette configuration, tous les fichiers avec l'extension @samp{.org} 
seront mis en mode Org.

@node Réactions, Activation, Introduction
@section Réactions

Si vous rencontrez des problèmes avec Org, ou si vous avez des questions, 
remarques, ou idées à propos de lui, prière d'envoyez un mail à 
la liste de diffusion @email{emacs-orgmode@@gnu.org}. Pour plus 
d'informations sur comment soummettre les rapports de bogues, voir le manuel 
complet.   

@node Structure du document, Tables, Introduction, Top
@chapter Structure du document

Org est basé sur le mode Outline et fournit des commandes flexibles pour 
éditer la structure du document.

@menu
* Outline::     		Org est basé sur le mode Outline
* Titres ::		        Comment composer des titres d'arbres Org
* Cycle de visibilité::		Afficher et masquer, très simplifié
* Motion::			Sauts à d'autres titres
* Structure d'édition::		Modification de la séquence et le niveau des titres 
* Arbres clairsemés::		Correspondances intégrées dans le contexte
* Listes complètes::		Structure supplémentaire dans une entrée
* Notes::			Comment les notes sont définies dans la syntaxe de Org
@end menu

@node Outline, Lignes d'en-tête, Structure du document, Structure du document
@section Outline

Org est implémenté par dessus le mode Outline. Les grandes lignes permettent 
au document d'être organisé avec une structure hiérarchique, qui (au moins
pour moi) est la meilleure représentation de notes et pensées. Un aperçu de
cette structure est réalisée en pliant (dépliant) de grandes parties du 
document pour montrer que la structure générale du document et les parties
en cours d'élaboration. Org simplifie grandement l'utilisation de grandes 
lignes en comprimant l'ensemble de la fonctionnalité montrer/cacher en une
seule commande, @command{org-cycle}, qui est liée avec la touche @key{TAB}.

@node Lignes d'en-tête, Cycle de visibilité, Outlines, Structure du document
@section Lignes d'en-tête

Les lignes d'en-tête définissent la structure d'une grande ligne de l'arbre.
Les lignes d'en-tête dans Org commencent par une ou plusieurs étoiles, 
dans la marge de gauche@footnote{Voir la variable @code{org-special-ctrl-a/e} 
pour configurer un comportement spécial de @kbd{C-a} et @kbd{C-e} dans les 
lignes d'en-tête.}.  

Par exemple :

@smallexample
* Ligne d'en-tête de niveau un
** Deuxième niveau
*** Troisième niveau
    du texte
*** Troisième niveau
    encore du texte

* Une autre ligne d'en-tête de niveau un
@end smallexample

@noindent Notez qu'une ligne d'en-tête nommée d'après @code{org-footnote-section},
qui par défaut @samp{Notes}, est considérée comme spéciale. Un sous-arbre
avec cette ligne d'en-tête sera ignoré par des fonctions d'exploration.

Certaines personnes trouvent l'abus d'étoiles trop embêtant et préfèreraient 
une grande ligne qui ait des espaces suivis par une seule étoile comme début
de ligne d'en-tête. @ref{Clean view}, décrit une configuration qui réalise cela.

@node Cycle de visibilité, Motion, Lignes d'en-tête, Structure du document
@section Cycle de visibilité

Les grandes lignes permettent de cacher des parties du texte dans le tampon.
Org n'utilise que deux commands, liées à @key{TAB} et
@kbd{S-@key{TAB}} pour changer la visibilité du tampon..

@table @kbd
@item @key{TAB}
@emph{Cycle de l'arborescence}: Rotation courante de l'arborescence à 
travers les états

@smallexample
,-> PLIE -> ENFANTS -> ARBORESCENCE --.
'-------------------------------------'
@end smallexample

Lorsqu'appelé avec un argument préfixé (@kbd{C-u @key{TAB}}) ou avec la touche 
shift, le cycle global est invoqué.

@item S-@key{TAB} @r{and} C-u @key{TAB}
@emph{Cycle global:} Rotation du tampon entier à travers les états

@smallexample
,-> APERCU -> CONTENU -> TOUT MONTRER --.
'---------------------------------------'
@end smallexample

@item C-u C-u C-u @key{TAB}
Montre tout, y compris les tiroirs.
@end table

Quand Emacs visite une première fois un fichier Org, l'état global est 
configuré à OVERVIEW, i.e. seules les lignes d'en-tête de niveau 1 sont
visibles. Cela peut être configuré à travers la variable 
@code{org-startup-folded}, ou sur la base d'un fichier-per en ajoutant un 
raccourci clavier de démarrage @code{overview}, @code{content},
@code{showall}, comme ça :

@smallexample
#+STARTUP: content
@end smallexample


@node Motion, Structure d'édition, Cycle de visibilité, Structure du document
@section Motion
Les commandes suivantes sautent jusqu'à d'autres lignes d'en-tête dans le 
tampon:

@table @kbd
@item C-c C-n
Prochain en-tête.
@item C-c C-p
Précédent en-tête.
@item C-c C-f
Prochain en-tête de même niveau.
@item C-c C-b
Précédent en-tête de même niveau.
@item C-c C-u
Retour vers l'en-tête de plus au niveau.
@end table

@node Structure d'édition, Arbres clairsemés, Motion, Structure du document
@section Structure d'édition

@table @kbd
@item M-@key{RET}
Insérez une nouvelle rubrique avec même niveau que l'actuelle. 
Si le curseur est dans une liste simple, un nouvel élément est créé
(@pxref{Listes complètes}).  Lorsque 
cette commande est utilisée dans le milieu d'une ligne, la ligne 
est divisée et le reste de la ligne devient le nouveau 
titre@footnote{Si vous ne voulez pas que la ligne soit divisée, personnalisez la 
variable @code{org-M-RET-may-split-line}.}.
@item M-S-@key{RET}
Insère une nouvelle entrée TODO avec le même niveau que l'en-tête
courante.
@item @key{TAB} @r{in new, empty entry}
Dans une nouvelle entrée, encore vierge, @key{TAB} bouclera à travers les niveaux
raisonnables.
@item M-@key{left}@r{/}@key{right}
Promouvoir/rétrograder l'entrée actuelle d'un niveau.
@item M-S-@key{left}@r{/}@key{right}
Promouvoir/rétrograder le sous-arbre actuel d'un niveau.
@item M-S-@key{up}@r{/}@key{down}
Déplacer l'arborescence vers le haut/bas (échange avec le sous-arbre 
précédent/suivant de même niveau).
@item C-c C-w
Enregistre l'entrée ou la région à un autre emplacement. @xref{Refile and copy}.
@item C-x n s/w
Réduit le tampon à la sous-arborescence actuelle / l'élargit à nouveau.
@end table

Quand il y a une région active (Transient Mark mode), monter/descendre 
fonctionne pour toutes les lignes d'en-tête de la région.

@node Arbres clairsemés, Listes complètes, Structure d'édition, Structure du document
@section Arbres clairsemés

Une caractéristique importante du mode Org est la capacité de construire des
@emph{arbres clairsemés} pour les informations sélectionnées dans un arbre de
grande ligne, de sorte que la totalité du document est pliée au maximum, 
mais l'information sélectionnée est rendue visible avec la structure de cette
ligne d'en-tête ci-dessus@footnote{Voir aussi la variable 
@code{org-show-context-detail} pour décider comment le contexte est montré autour
de chaque correspondance.}.  Juste essayez et vous verrez immédiatement comment 
ça marche.

Le mode Org contient plusieurs commandes de création telle que les arbres, 
toutes ces commandes peuvent être atteintes via un répartiteur:

@table @kbd
@item C-c /
Cela invite à ajouter une touche pour sélectionner une commande
de création d'arbre clairsemé.
@item C-c / r
Demande une expression régulière et montre un arbre clairsemé avec
toutes les correspondances qui sont mises en sur-brillance; la 
sur-brillance disparait en tapant @kbd{C-c C-c}.
@end table

Les autres commandes d'abre clairsemés sélectionnent les titres basés sur les
mots clés TODO, les balises, ou les propriétés et seront discutés plus tard
dans ce manuel.

@node Listes complètes, Notes, Arbres clairsemés, Structure du document
@section Listes complètes

Dans une entrée de l'arbre des grandes lignes, les listes formatées à la main
peuvent fournir une structure supplémentaire. Elles fournissent également un 
moyen de créer des listes de cases à cocher (@pxref{Cases à cocher}).  Org permet
l'édition de telles listes, et l'exportateur HTML (@pxref{Exporting}) les analyse
et les formate.

Org connaît les listes ordonnées, non ordonnées, et les listes de description.
@itemize @bullet
@item
les items des listes @emph{non ordonnées} commencent avec @samp{-}, @samp{+}, ou
@samp{*} comme puces.
@item
les items des listes @emph{ordonnées} commencent avec @samp{1.} or @samp{1)}.
@item
les listes de @emph{description} utilisent @samp{ :: } pour séparate le 
@emph{terme} de la description.
@end itemize

Les items appartenant à la même liste doivent avoir la même empreinte sur la
première ligne. Un item finit avant la ligne suivante qui est indentée 
comme sa puce/son nombre, ou moins. Une liste se termine quand tous les items
sont fermés, ou avant deux lignes blanches. Un exemple:

@smallexample
@group
** Le seigneur des anneaux
   Mes scènes préférées sont (dans cet ordre)
   1. L'attaque de Rohirrim
   2. Le combat d'Eowyn avec le roi sorcier
      + C'était déjà ma scène favorite dans le livre.
      + J'aime vraiment Miranda Otto.
   Les acteurs importants dans le film sont :
   - @b{Elijah Wood} :: Il joue Frodon
   - @b{Sean Austin} :: Il joue Sam, l'ami de Frodon.
@end group
@end smallexample

Les commandes suivantes agissent sur les items quand le curseur est dans la 
première ligne d'un item (la ligne avec la puce ou le nombre).

@table @kbd
@item @key{TAB}
Les items peuvent être pliés juste comme les niveaux de lignes d'en-tête.
@item M-@key{RET}
Insère un nouvel item au niveau en cours. Avec un argument 
préfixé, force le nouveau titre (@pxref{Structure d'édition}).
@item M-S-@key{RET}
Insère un nouvel item avec une boîte à cocher (@pxref{Cases à cocher}).
@item M-S-@key{up}@r{/}@key{down}
Déplace l'item incluant des sous-items vers le haut/bas (échange
avec l'item précédent/suivant de même niveau d'indentation). Si
la liste est ordonnée, la renumérotation est automatique.
@item M-@key{left}@r{/}M-@key{right}
Augmente/diminue l'indentation d'un item, laissant les enfants 
seuls.
@item M-S-@key{left}@r{/}@key{right}
Augmente/diminue l'indentation d'un item, incluant les sous-items.
@item C-c C-c
Si il y a une boîte à cocher (@pxref{Cases à cocher}) dans la ligne d'item, 
modifie l'état de la boîte à cocher. Vérifie aussi les puces et la cohérence de 
toute la liste.
@item C-c -
Cycle la liste entière des niveaux à travers les différents 
items/numéros
(@samp{-}, @samp{+}, @samp{*}, @samp{1.}, @samp{1)}).
@end table

@node Notes, Listes complètes, Structure du document
@section Notes

Une note de bas de page est définie dans un paragraphe qui a commencé par une
marque de la note de bas de page entre des crochets en colonne 0, aucune
indentation n'est autorisée. La référence de la note de bas de page est 
simplement la marque entre crochets, à l'intérieur du texte. Par exemple:

@smallexample
La page d'accueil Org[fn:1] est maintenant beaucoup mieux qu'auparavant.
...
[fn:1] Le lien est: http://orgmode.org
@end smallexample

@noindent 
Les commandes suivantes manipulent les notes de bas de pages :

@table @kbd
@item C-c C-x f
La commande de création de note. Quand le curseur est
sur une référence de note, il saute sur la définition.
Quand c'est une définition, il saute sur la (première)
référence. Quand cette commande est appelée avec un 
argument préfixé, un menu d'options supplémentaires
incluant la rénumérotation est proposé.

@item C-c C-c
Saute entre les définitions et références.
@end table

@seealso{
@uref{http://orgmode.org/manual/Document-Structure.html#Document-Structure,
Chapter 2 of the manual}@*
@uref{http://sachachua.com/wp/2008/01/outlining-your-notes-with-org/,
Sacha Chua's tutorial}}


@node Tables, Hyperliens, Structure du document, Top
@chapter Tables

Org vient avec un éditeur de tableau intuitif et rapide. Les calculs de type
tableur sont supportés avec le paquet Emacs @file{calc}
@ifinfo
(@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual}).
@end ifinfo
@ifnotinfo
(voir le manuel Emacs Calculator pour plus d'informations sur ce sujet).
@end ifnotinfo

Org permet facilement de formater des tableaux en ASCII. Chaque ligne avec
@samp{|} comme le premier caractère non-espace est considéré comme une partie de 
la table.  @samp{|} est aussi le séparateur de colonne. Une table pourrait 
ressembler à ceci:

@smallexample
| Nom   | Tél.  | Age |
|-------+-------+-----|
| Peter |  1234 |  17 |
| Anna  |  4321 |  25 |
@end smallexample

Une table est ré-alignée automatiquement chaque fois que vous pressez @key{TAB} ou
@key{RET} ou @kbd{C-c C-c} à l'intérieur de la table.  @key{TAB} déplace aussi le
prochain champ (@key{RET} pour la prochaine ligne) et crée une table des lignes à
la fin de la table ou avant la ligne horizontale. L'indentation de cette table 
est configurée par la première ligne. Toute ligne commençant par @samp{|-} est 
considérée comme un séparateur horizontal de ligne et sera développé sur le 
prochain ré-alignement afin de couvrir toute la largeur de la table. Donc, pour 
créer le tableau ci-dessus vous taperez seulement

@smallexample
|Nom|Tél.|Age|
|-
@end smallexample

@noindent 
en ensuite presserez @key{TAB} pour aligner la table et commencer à remplir les 
champs. Encore plus vite vous pourriez taper @code{|Nom|Tél.|Age} suivi par
@kbd{C-c @key{RET}}.

Lorsque vous tapez du texte dans un champ, Orgl traite @key{DEL},
@key{Backspace}, et toutes les touches de caractères d'une façon spéciale, telle 
que l'insertion et la suppression évite de décaler les autres champs. Aussi, 
lorsque vous taper @emph{immédiatement après que le curseur ait bougé dans un 
nouveau champ avec @kbd{@key{TAB}}, @kbd{S-@key{TAB}} ou @kbd{@key{RET}}}, le 
champ est automatiquement mis en blanc.

@table @kbd
@tsubheading{Création et conversion}
@item C-c |
Convertit la region active en table. Si chaque ligne contient au moins un 
caractère TAB, the function assumes that the material is tab separated.  If every
line contains a comma, comma-separated values (CSV) are assumed.  la fonction 
suppose que le matériel est séparé par une tabulation. Si chaque ligne contient 
une virgule, une valeur de virgule de séparation (CSV) est supposée.
Sinon, les lignes sont divisées au niveau des espaces dans les champs.
@*
S'il n'y a pas de région active, cette commande crée une table
Org vide. Mais c'est juste plus facile de commencer à taper,
comme
@kbd{|Nom|Tél.|Age C-c @key{RET}}.

@tsubheading{Ré-alignement et mouvement de champ}
@item C-c C-c
Ré-aligne la table sans déplacement du curseur.
@c
@item @key{TAB}
Ré-aligne la table, déplace vers le prochain champ. Crée
une nouvelle ligne si nécessaire.
@c
@item S-@key{TAB}
Ré-aligne, déplace au champ précédent.
@c
@item @key{RET}
Ré-aligne la table et déplace vers le bas vers la prochaine ligne. Crée une 
nouvelle ligne si nécessaire.

@tsubheading{Edition de ligne et colonne}
@item M-@key{left}
@itemx M-@key{right}
Déplace la colonne courante vers la gauche/droite.
@c
@item M-S-@key{left}
Détruit la colonne courante.
@c
@item M-S-@key{right}
Insère une nouvelle colonne vers la gauche depuis la position du curseur.
@c
@item M-@key{up}
@itemx M-@key{down}
Déplace la ligne courante vers le haut/bas.
@c
@item M-S-@key{up}
Détruit la ligne courante ou la ligne horizontale.
@c
@item M-S-@key{down}
Insère une nouvelle ligne au-dessus de la courante. Avec un 
argument préfixé, la ligne est créée en dessous de la courante.
@c
@item C-c -
Insère une ligne horizontale en dessous de la courante. Avec un 
argument préfixé, la ligne est créée au dessus de la courante.
@c
@item C-c @key{RET}
Insère une ligne horizontale en dessous de la courante, et 
déplace le cursuer à la ligne en dessous de l'horizontale.
@c
@item C-c ^
Tri les lignes de la table dans la région. La position du point
indique les colonnes utilisées pour le tri, et le rang des
lignes est le rang entre la plus proche ligne de séparation 
horizontale, ou la table entière.
@end table

@seealso{
@uref{http://orgmode.org/manual/Tables.html#Tables, Chapter 3 of the
manual}@*
@uref{http://orgmode.org/worg/org-tutorials/tables.php, Bastien's
table tutorial}@*
@uref{http://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.php,
Bastien's spreadsheet tutorial}@*
@uref{http://orgmode.org/worg/org-tutorials/org-plot.php, Eric's plotting tutorial}}

@node Hyperliens, Listes TODO, Tables, Top
@chapter Hyperliens

Comme HTML, Org fournit des liens à l'intérieur d'un fichier, des liens 
externes vers d'autres fichiers, des articles Usenet, des e-mails, et 
beaucoup plus.

@menu
* Format de lien::		Comment les liens sont formatés dans Org
* Liens internes::		Liens vers d'autres endroits dans le fichier actuel
* Liens externes::		Les URL comme des liens vers le monde
* Manipulation de liens::	Création, insertion et suivant
* Liens ciblés::		Le point, à un emplacement dans un fichier
@end menu

@node Format de lien, Liens internes, Hyperliens, Hyperliens
@section Format de lien

Org reconnaîtra des liens URL et les activera comme liens cliquables. Le 
format général pour les liens, cependant, ressemblera ceci:

@smallexample
[[lien][description]]       @r{ou alternativement}           [[lien]]
@end smallexample

@noindent
Une fois qu'un lien est complet (tous les crochets sont fermés) dans le 
buffer, Org changera l'affichage de sorte que @samp{description} soit affiché
au lieu de
@samp{[[link][description]]} et @samp{link} est affiché au lieu de
@samp{[[link]]}.  Pour éditer la partie invisible @samp{link}, utiliser @kbd{C-c
C-l} avec le curseur sur le lien.

@node Liens internes, Liens externes, Format de lien, Hyperliens
@section Liens internes

Si le lien ne ressemble pas à une URL, il est considéré comme interne au 
fichier courant. Le cas le plus important est lien comme
@samp{[[#my-custom-id]]} qui fera la liaison entre l'entrée et la propriété
@code{CUSTOM_ID} de @samp{my-custom-id}.

Des liens comme @samp{[[My Target]]} ou @samp{[[My Target][Find my target]]}
mènent à une recherche de texte dans le fichier courant pour les cibles 
correspondantes qui ressemblent à @samp{<<My Target>>}.

Les liens internes seront utilisés pour se référer à leur destination, via 
des liens ou des nombres, si possible.

@node Liens externes, Liens manuels, Liens internes, Hyperliens
@section Liens externes

Org supporte les liens vers des fichiers, vers sites web, vers Usenet et vers
des messages e-mail, vers des entrées de base de données BBDB et des liens
vers des conversations et journaux IRC. Les liens externes sont des 
localisateurs d'URL. Ils commencent par une courte chaîne d'identification 
suivi de deux points. Il ne peut y avoir d'espace après les deux points. 
Voici quelques exemples:

@smallexample
http://www.astro.uva.nl/~dominik          @r{sur le web}
file:/home/dominik/images/jupiter.jpg     @r{fichier, chemin absolu}
/home/dominik/images/jupiter.jpg          @r{idem que ci-dessus}
file:papers/last.pdf                      @r{fichier, chemin relatif}
file:projects.org                         @r{un autre fichier Org}
docview:papers/last.pdf::NNN              @r{fichier ouvert en doc-mode view à la page NNN}
id:B7423F4D-2E8A-471B-8810-C40F074717E9   @r{lien vers l'en-tête avec ID}
news:comp.emacs                           @r{lien Usenet}
mailto:adent@@galaxy.net                   @r{lien Mail}
vm:folder                                 @r{lien dossier VM}
vm:folder#id                              @r{lien message VM}
wl:folder#id                              @r{lien message WANDERLUST}
mhe:folder#id                             @r{lien message MH-E}
rmail:folder#id                           @r{lien message RMAIL}
gnus:group#id                             @r{lien article Gnus}
bbdb:R.*Stallman                          @r{lien BBDB (avec expression régulière)}
irc:/irc.com/#emacs/bob                   @r{lien IRC}
info:org:External%20links                 @r{lien noeud Info (avec un espace encodé)}
@end smallexample

Un lien devrait être entouré de doubles crochets et peut contenir un texte de 
description qui sera affiché à la place de l'URL (@pxref{Link
format}), par exemple:

@smallexample
[[http://www.gnu.org/software/emacs/][GNU Emacs]]
@end smallexample

@noindent
Si la description est un nom de fichier ou une URL qui pointe vers une image,
l'exportation HTML (@pxref{HTML export}) rendra l'image cliquable.  S'il n'y a 
pas de description et que le lien pointe sur une image, cette image sera 
reliée dans l'exportation HTML.

@node Liens manuels, Liens ciblés, Liens externes, Hyperliens
@section Liens manuels

Org fournit des méthodes pour créer un lien avec une bonne syntaxe, pour 
l'insérer dans un fichier Org, et faire suivre le lien.

@table @kbd
@item C-c l
Stocke un lien à l'emplacement courant. C'est une commande @emph{globale}
(vous devez créer la liaison vous-même) qui peut être utilisée dans
n'importe quel buffer pour créer un lien. Le lien sera stocké pour
des insertions ultérieures dans un buffer Org (voir plus bas).
@c
@item C-c C-l
Insère un lien. Cela attend un lien à insérer dans le buffer. Vous
pouvez juste taper un lien, ou utiliser les flèches @key{haut} et @key{bas} 
pour accéder aux liens stockés. On vous demandera de saisir la 
description du lien. Lorsqu'appelée avec un argument préfixé @kbd{C-u}, la 
complétion de nom de fichier est utilisée pour lier à un fichier.
@c
@item C-c C-l @r{(with cursor on existing link)}
Quand le curseur est sur un lien existant, @kbd{C-c C-l} vous permet d'éditer 
le lien et sa description.
@c
@item C-c C-o @r{or} mouse-1 @r{or} mouse-2
Ouvre le lien au point.
@item C-c &
Revient sur une position enregistrée. Une position est enregistrée
par la commande suivant les liens internes, et par @kbd{C-c %}.  L'utilisation 
de cette commande plusieurs fois successivement déplace à travers le cycle des 
positions précédemment enregistrées.
@c
@end table

@node Liens ciblés,  , Liens manuels, Hyperliens
@section Liens ciblés

Les liens de fichiers contiennent des information supplémentaires pour 
permettre à Emacs d'aller à des endroits particuliers dans le fichier en 
suivant un lien. Cela peut être un numéro de ligne ou une option de 
recherche après deux points (@key{:}).

Voici la syntaxe des différentes façon de lier une recherche à un fichier 
lien, ensemble avec une explication :

@smallexample
[[file:~/code/main.c::255]]                 @r{Trouve la ligne 255}
[[file:~/xx.org::Ma Cible]]                @r{Find @samp{<<Ma Cible>>}}
[[file:~/xx.org::#my-custom-id]]            @r{Trouve les entrées avec id 
personnalisé}
@end smallexample

@seealso{
@uref{http://orgmode.org/manual/Hyperlinks.html#Hyperlinks, Chapter 4 of the
manual}}

@node Listes TODO, Balises, Hyperliens, Top
@chapter Listes TODO

Le mode Org ne nécessite pas que les listes TODO (de tâches) soient dans des
documents à part. Les listes TODO font partie d'un fichier de notes, parce que
les listes TODO viennent habituellement en prenant des notes! Avec le mode Org,
il suffit de marquer une entrée dans un arbre comme étant un élément TODO. De
cette façon, les informations ne sont pas dupliquées, et les listes TODO 
restent dans le contexte dont elles sont issues.

Le mode Org fournissant des méthodes pour vous donner un aperçu de toutes les 
choses que vous avez à faire, recueillies auprès de nombreux fichiers.

@menu
* Utilisation des états TODO::	Configuration et basculement des états
* Flux de travail multi-état::	Plus qu'un simple marche/arrêt
* Journalisation des progrès::	Dates et notes des progrès
* Priorités::			Certaines choses sont plus importantes que d'autres
* Diviser les tâches::		Fractionnement d'une tâche en éléments gérables
* Boîtes à cocher::		Listes à cocher
@end menu

@node Utilisation des états TODO, Flux de travail multi-état, Listes TODO, Listes TODO
@section Utilisation des états TODO

N'importe qu'elle ligne d'en-tête devient un item TODO lorsqu'elle commence
par le mot @samp{TODO}, par exemple:

@smallexample
*** TODO Ecrire une lettre à Sam Fortune
@end smallexample

@noindent
Les commandes la plus importantes fonctionnant avec les entrées TODO sont :

@table @kbd
@item C-c C-t
Permutation de l'état actuel de TODO parmi les deux états possibles :

@smallexample
(unmarked) -> TODO -> DONE -> (unmarked)
@end smallexample

La même rotation peut être effectuée ``à distance'' à partir de la chronologie
et des tampons agenda avec la commande @kbd{t} (@pxref{Commandes de l'agenda}).

@item S-@key{right}@r{/}@key{left}
Sélectionne l'état TODO suivant/précédent, de façon cyclique.
@item C-c / t
Voir les listes TODO dans un @emph{arbre clairsemé} (@pxref{Arbres clairsemés}).
Plie le tampon, mais montre toutes les listes TODO et la hiérarchie des 
rubriques au dessus d'elles.
@item C-c a t
Montre la liste TODO en entier. Collecte les items TODO du 
fichier agenda (@pxref{Vues de l'agenda}) dans un tampon simple. 
@xref{Liste TODO globale}, pour plus d'information.
@item S-M-@key{RET}
Insère une nouvelle entrée TODO en dessous de l'actuelle.
@end table

@noindent
Le changement d'un état TODO peut également déclencher des changements de
balises. Voir la documentation de l'option @code{org-todo-state-tags-triggers} 
pour les details.

@node Flux de travail multi-état, Journalisation des progrès, Utilisation des états TODO, Listes TODO
@section Flux de travail multi-état

Vous pouvez utiliser les mots clés TODO pour indiquer différents états
@emph{sequentiels} dans le processus du travail sur un item, par exemple : 

@smalllisp
(setq org-todo-keywords
  '((sequence "TODO" "FEEDBACK" "VERIFY" "|" "DONE" "DELEGATED")))
@end smalllisp

La barre verticale sépare les mots-clés TODO (états qui @emph{ont besoin 
d'actions}) des états DONE (qui n'ont @emph{plus besoin d'action}). Si vous ne 
mettez pas. Si vous ne mettez pas la barre de séparation, le dernier état est 
considéré comme DONE. Avec cette configuration, la commande @kbd{C-c C-t} 
cyclera une entrée depuis TODO vers FEEDBACK, puis vers VERIFY, et finallement
vers DONE et DELEGATED. Parfois vous pouvez utiliser différents ensembles de 
mots-clés TODO en parallèle.  Par exemple, vous pouvez vouloir avoir le basique
@code{TODO}/@code{DONE}, mais aussi un flux de travail, résoudre les bogues.
Votre configuration devrait ressembler à cela:

@smalllisp
(setq org-todo-keywords
      '((sequence "TODO(t)" "|" "DONE(d)")
        (sequence "REPORT(r)" "BUG(b)" "KNOWNCAUSE(k)" "|" "FIXED(f)")))
@end smalllisp

Les mots-clés devraient tous être différents, cela aide le mode Org à garder
une trace de quelle sous-séquence devrait être utilisée pour une entrée
donnée. L'exemple montre aussi comment définir des touches pour un accès 
plus rapide à un état en particulier, en ajoutant une lettre entre 
parenthèses après chaque mot-clé---vous serez invité pour la touche après
@kbd{C-c C-t}.

Pour définir les mots-clés TODO qui sont valides uniquement dans un seul 
fichier, utilisez les lignes suivantes n'importe où dans le fichier.

@smallexample
#+TODO: TODO(t) | DONE(d)
#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)
#+TODO: | CANCELED(c)
@end smallexample

Après le changement de l'une de ces lignes, utiliser @kbd{C-c C-c} avec le
curseur encore dans la ligne pour faire connaître le changement au mode Org.

@node Journalisation des progrès, Priorités, Flux de travail multi-état, Listes TODO
@section Journalisation des progrès

Le mode Org peut enregistrer automatiquement un horodatage et éventuellement
une note lorsque vous marqué un item TODO comme DONE, ou même chaque fois
que vous changez l'état d'un item TODO. Ce système est hautement configurable;
les paramétrages peuvent être sur la base d'un mot-clé et peuvent être situé
dans un fichier ou même une arborescence. Pour information sur comment 
l'horloge fonctionne pour une tâche, voir @ref{Clocking
work time}.

@menu
* Fermeture des items::		 Quand cet item a été marqué DONE?
* Suivi des basculement d'états TODO::	 Quand cet état a-t-il basculé?
@end menu

@node Fermeture des items, Suivi des changements d'états TODO, Journalisation des progrès, Journalisation des progrès
@unnumberedsubsec Fermeture des items

La journalisation la plus basique est de garder la trace de @emph{quand} un 
certain item TODO est fini. Ceci est achevé avec@footnote{La correspondance
dans la configuration du tampon est :  @code{#+STARTUP: logdone}}.

@smalllisp
(setq org-log-done 'time)
@end smalllisp

@noindent
Ensuite chaque fois que vous modifiez une entrée depuis un état TODO (non
fait) en n'importe quel état DONE, une ligne @samp{CLOSED: [timestamp]} sera
inséré juste après la ligne d'en-tête. Si vous voulez enregistrer une note
avec l'horodatage, utilisez@footnote{La correspondance dans la configuration du 
tampon est : @code{#+STARTUP:lognotedone}}

@smalllisp
(setq org-log-done 'note)
@end smalllisp

@noindent
Vous serez invités pour une note, et cette note sera stockée en dessous de
l'entrée avec un en-tête @samp{Closing Note}.

@node Suivi des changements d'états TODO,  , Fermeture des items, Journalisation des progrès
@unnumberedsubsec Suivi des changements d'états TODO

Vous pouvez souhaiter garder la trace des changements d'états TODO. Vous 
pouvez aussi juste enregistrer un horodatage, ou une note horodatée pour
un changement. Ces enregistrements seront insérés après l'en-tête comme
une liste à puces. Personnalisez la variable @code{org-log-into-drawer} pour
obtenir ce comportement.

Pour un état de journalisation, le mode Org s'attend à une configuration
sur un per-mot-clés. Cela est achevé par ajout de marqueurs spéciaux @samp{!} 
(pour un horodatage) et
@samp{@@} (pour une note) entre parenthèses après
chaque mot clé. Par exemple: 
@smallexample
#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)
@end smallexample
@noindent
définira les mots clés TODO et les raccourcis clavier, et aussi requiert 
que le temps soit enregistré quand l'entrée est configurée à DONE, et qu'une
note soit enregistrée lors de la permutation vers WAIT ou CANCELED. La même
syntaxe fonctionnent aussi lors du paramétrage de @code{org-todo-keywords}.

@node Priorités, Diviser les tâches, Journalisation des progrès, Listes TODO
@section Priorités

Si vous utilisez le mode Org avancé, vous pouvez vous retrouver avec 
suffisamment d'items TODO que commencent à donner leur donner un sens de 
priorité. La priorisation ben être faite en plaçant un @emph{cookie de priorité}
dans l'en-tête d'un item TODO, comme ça 

@smallexample
*** TODO [#A] Write letter to Sam Fortune
@end smallexample

@noindent
Le mode Org comprend trois priorités: @samp{A}, @samp{B}, and @samp{C}.
@samp{A} est la plus élevée, @samp{B} est celle par défaut. Les priorités
font la différence uniquement dans l'agenda.

@table @kbd
@item @kbd{C-c ,}
Définit la priorité de l'en-tête courante. Pressez @samp{A}, @samp{B} ou
@samp{C} pour sélectionner une priorité, ou @key{SPC} pour enlever le cookie.
@c
@item S-@key{up}/@key{dwn}
Augmenter/réduire la priorité de l'en-tête en cours.
@end table

@node Diviser les tâches, Cases à cocher, Priorités, Listes TODO
@section Découper les tâches en sous-tâches

Il est souvent conseillé de décomposer une grosse tâche en tâches plus petites, 
plus gérable sous-tâches. Vous pouvez faire cela en créant une arborescence
de grandes lignes en dessous d'un item TODO, avec des sous-tâches détaillées
sur l'arbre. Pour garder un aperçu sur la fraction des sous-tâches qui ont
déjà été effectuées, insérer soit @samp{[/]} ou
@samp{[%]} n'importe où dans l'en-tête.
Les cookies seront mis à jour chaque fois que le statut TODO d'un enfant 
change, ou en pressant @kbd{C-c C-c} sur le cookie. Par exemple : 

@smallexample
* Organiser une fête [33%]
** TODO Appeler des gens [1/2]
*** TODO Peter
*** DONE Sarah
** TODO Acheter de la nourriture
** DONE Parler aux voisins
@end smallexample

@node Cases à cocher,  , Diviser les tâches, Listes TODO
@section Cases à cocher

Chaque item d'une liste complète (@pxref{Listes complètes}) peut être constitué 
d'une boîte à cocher en commençant par la chaîne @samp{[ ]}. Les cases à cocher 
ne sont pas incluses dans la liste complète TODO,
donc elles sont souvent bien pour diviser une tâche en un nombre d'étapes
simples. Voici un exemple d'une liste de boîte à cocher:

@smallexample
* TODO Organiser une fête [1/3]
  - [-] appeler des gesn  [1/2]
    - [ ] Peter
    - [X] Sarah
  - [X] commander de la nourriture
@end smallexample

Les cases à cocher Les boîtes à cocher fonctionnent de façon hiérarchique, donc 
si un item boîte à cocher a des enfants qui sont des boîtes à cocher, basculer 
l'un des enfants fera que la boîte parente reflètera si vide, quelque, ou tous
les enfants qui sont cochés. 

@noindent 
Les commandes suivantes fonctionnent avec les boîtes à cocher :

@table @kbd
@item C-c C-c
Bascule le statut de la boîte ou (avec un argument préfixé) présence au point.
@item M-S-@key{RET}
Insère un nouvel item avec une boîte à cocher. Cela fonctionne
seulement si le curseur est déjà dans un item de liste
(@pxref{Listes complètes}).
@end table

@seealso{
@uref{http://orgmode.org/manual/TODO-Items.html#TODO-Items, Chapter 5 of the manual}@*
@uref{http://orgmode.org/worg/org-tutorials/orgtutorial_dto.php, David
O'Toole's introductory tutorial}@*
@uref{http://members.optusnet.com.au/~charles57/GTD/gtd_workflow.html,
Charles Cave's GTD setup}}

@node Balises, Propriétés, Listes TODO, Top
@chapter Balises

Un excellent moyen pour implémenter des étiquettes et contextes pour les 
informations en corrélation croisées est d'assigner des @i{balises} aux 
en-tête. Le mode Org a un support étendu pour les balises.

Chaque en-tête peut contenir une liste de balises; elles apparaissent à la fin de 
l'en-tête.
Les balises sont des mots ordinaires contenant des lettres, des nombres, 
@samp{_}, et @samp{@@}.  Les balises doivent être précédées et suivies par deux
points, par exemple, @samp{:work:}.  Plusieurs balises peuvent être spécifiées,
comme @samp{:work:urgent:}.
Les balises seront par défaut en gras de la même couleur que l'en-tête.

@menu
* Héritage de balise::		Mots clés qui utilisent la structure arborescente des grandes lignes
* Configuration des balises::	Comment attribuer des balises à un titre
* Balise de groupes::		Utilisez une balise pour en chercher plusieurs
* Recherche de balise::		A la recherche de combinaisons de balises
@end menu

@node Héritage de balise, Configuration de balises, Balises, Balises
@section Héritage de balise

Les @i{Balises} font usage de la structure hiérarchique des grandes lignes de 
l'arborescence.
Si un en-tête a une certaine balise, toutes les sous-en-tête en hériteront. 
Par exemple, dans la liste 

@smallexample
* Rencontre avec le groupe français  :work:
** Résumé par Frank                  :boss:notes:
*** TODO Préparer des diapositives pour lui :action:
@end smallexample

@noindent
l'en-tête final aura les balises @samp{:work:}, @samp{:boss:},
@samp{:notes:}, et @samp{:action:} bien que l'en-tête n'est pas explicitement 
marqué par ces balises. Vous pouvez aussi définir des balises telles que toutes
les entrées dans un fichier devraient en hériter comme si ces balises étaient 
définies à un hypothétique niveau zéro qui entourerait tout le fichier. 
Utiliser une ligne comme cela@footnote{Comme avec tous ces réglages dans le 
tampon, presser @kbd{C-c C-c} active n'importe quel changement dans la ligne.}:

@smallexample
#+FILETAGS: :Peter:Boss:Secret:
@end smallexample

@node Configuration de balises, Balise de groupes, Héritage de balise, Balises
@section Configuration de balises

Les balises peuvent être simplement tapées dans le tampon à la fin d'une 
en-tête. Après deux points, @kbd{M-@key{TAB}} permet la complétion sur les 
balises. Il y a aussi une commande spéciale pour insérer des balises:

@table @kbd
@item C-c C-q
Entre de nouvelles balises pour l'en-tête courante. Le mode Org offrira 
une complétion ou une interface spéciale touche-simple pour configurer des
balises, voir plus bas. Après avoir pressé @key{RET}, les balises seront 
insérées et alignés à @code{org-tags-column}.  Lorsqu'appelé avec un argument 
préfixé @kbd{C-u} toutes les balises dans le tampon courant seront alignées 
avec cette colonne, juste pour rendre les choses plus belles.
@item C-c C-c
Lorsque le curseur est sur une en-tête, cela fait la même chose que 
@kbd{C-c C-q}.
@end table

Org supportera l'insertion de balise basée sur une @emph{liste de balises}. Par
défaut cette liste est construite dynamiquement, contenant toutes les balises 
couramment utilisées dans le tampon. Vous pouvez aussi spécifier globalement 
une liste de balises en dur avec la variable @code{org-tag-alist}. Finalement 
vous pouvez paramétrer les balises par défaut pour un fichier donné avec des 
lignes comme

@smallexample
#+TAGS: @@work @@home @@tennisclub
#+TAGS: laptop car pc sailboat
@end smallexample

Par défaut le mode Org utilise les facilités de complétion standard du 
mini-tampon pour entrer les balises. Toutefois, il implémente aussi d'autres, 
plus brèves, méthode de sélection de balises appelées @emph{sélection rapide 
de balises}. Cela vous permet de sélectionner et dé-sélectionner des balises 
juste avec une seule touche appuyée. Pour que cela fonctionne bien vous devrez 
affecter une unique lettre à la plupart de vos balises communément utilisées. 
Vous pouvez faire cela globalement en configurant la variable 
@code{org-tag-alist} dans votre fichier @file{.emacs}.  Par exemple, vous 
pouvez trouver l'intérêt de baliser beaucoup d'item dans différents fichiers 
avec @samp{:@@home:}.  Dans ce cas vous pouvez configurer quelque chose comme :

@smalllisp
(setq org-tag-alist '(("@@work" . ?w) ("@@home" . ?h) ("laptop" . ?l)))
@end smalllisp

@noindent 
Si la balise est seulement pertinante pour le fichier sur lequel vous 
travaillez, alors vous pouvez la ligne d'option TAGS à la place comme :

@smallexample
#+TAGS: @@work(w)  @@home(h)  @@tennisclub(t)  laptop(l)  pc(p)
@end smallexample

@node Balise de groupes, Tag searches, Configuration de balises, Balises
@section Balise de groupes

@cindex balises de groupe
@cindex balises, groupes
Dans un ensemble de balises mutellement exclusives, la première balise peut 
être définie comme une @emph{balise de groupe}. Lorsque vous cherchez une 
balise de groupe, cela vous renverra les correspondances pour tous les membres 
du groupe. Dans une vue d'agenda, par balise de groupe affichera les en-tête 
balisées avec au moins l'un des membre du groupe. Cela rend les recherches de 
balise et filtres plus flexible.

Vous pouvez configurer des balises de groupe en insérant deux points entre la 
balise de groupe et une autre, comme cela:

@example
#+TAGS: @{ @@read : @@read_book  @@read_ebook @}
@end example

Dans cet exemple, @samp{@@read} est une @emph{balise de groupe} pour un 
ensemble de trois balises: @samp{@@read}, @samp{@@read_book} et 
@samp{@@read_ebook}.

Vous pouvez aussi utiliser le mot-clé @code{:grouptags} directement lors de la 
configuration
@var{org-tag-alist}, voir la documentation de cette variable.

@kindex C-c C-x q
@vindex org-group-tags
Si vous souhaitez ignorer temporairement les balises de groupe, basculer une 
balise de groupe supportée avec @command{org-toggle-tags-groups}, liée à 
@kbd{C-c C-x q}.   Si vous souhaitez 
désactiver les balises de groupes complètement, configurer @var{org-group-tags}
à nil.

@node Balise de recherches,  , Balise de groupes, Balises
@section Balise de recherches

Une fois qu'un système de balises a été configuré, il peut être utilisé pour 
collecter les informations relatives dans des listes spéciales.

@table @kbd
@item C-c \
@itemx C-c / m
Crée un arbre epuré avec toutes les en-tête correspondantes à une 
recherche de balise. Avec un argument préfixé @kbd{C-u}, ignore les
en-tête qui ne sont pas des lignes TODO.
@item C-c a m
Crée une liste de balises correspondantes à tous les fichiers de l'agenda.
@xref{Correspondance balises et propriétés}.
@item C-c a M
Crée une liste complète de correspondances de balise à tous les 
fichiers d'agenda, mais ne regarde que les items TODO et force le 
regard des sous-items (voir la variable @code{org-tags-match-list-sublevels}).
@end table

Ces commandes invitent toutes à une correspondance de chaînes qui permet la 
logique booléenne de base comme @samp{+boss+urgent-project1}, pour trouver des 
entrées avec des balises @samp{boss} et @samp{urgent}, mais pas @samp{project1,
ou @samp{Kathy|Sally} pour trouver entrées qui sont balisées, comme 
@samp{Kathy} ou @samp{Sally}.  La syntaxe complète des recherches de chaînes 
est riche et permet aussi la correspondance avec les mots-clés TODO, niveaux 
d'entrée et propriétés. Pour une description complète avec beaucoup d'exemples,
voir @ref{Correspondance balises et propriétés}.

@seealso{
@uref{http://orgmode.org/manual/Tags.html#Tags, Chapter 6 of the manual}@*
@uref{http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-code-for-timeclocks-and-tags/,
Sacha Chua's article about tagging in Org-mode}}

@node Propriétés, Dates et heures, Balises, Top
@chapter Propriétés

Les propriétés sont des paires de valeurs clés associées à une entrée. Elles 
vivent dans un tiroir spécial avec le nom @code{PROPERTIES}.  Chaque propriété 
est spécifiée sur une seule ligne, avec la clé (entourrée de deux points) 
d'abord, et la valeur ensuite:

@smallexample
* collection de CD
** Classique
*** Variations de Goldberg
    :PROPERTIES:
    :Title:     Variations de Goldberg
    :Composer:  J.S. Bach
    :Publisher: Deutsche Grammophon
    :NDisks:    1
    :END:
@end smallexample

Vous pouvez définir les valeurs permises pour une propriété en particulier 
@samp{:Xyz:} configurant une propriété @samp{:Xyz_ALL:}.  Cette propriété 
spéciale est @emph{l'héritage}, donc si vous la configurez au niveau 1 entrée, 
ça s'appliquera à l'arbre entier. Lorsque les valeurs autorisées sont définies,
la configuration de la propriété correspondante devient plus facile et moins 
sujette à erreurs. Par exemple avec la collection de CD, nous pouvons
prédéfinir les éditeurs et le nombre de disques dans une boîte comme :

@smallexample
* collection de CD
  :PROPERTIES:
  :NDisks_ALL:  1 2 3 4
  :Publisher_ALL: "Deutsche Grammophon" Philips EMI
  :END:
@end smallexample
ou globalement en utilsant @code{org-global-properties}, ou déposer à l'échelle
comme ça :
@smallexample
#+PROPERTY: NDisks_ALL 1 2 3 4
@end smallexample

@table @kbd
@item C-c C-x p
Configure une propriété. Cela invite à saisir une propriété, nom et valeur.
@item C-c C-c d
Supprime une propriété de l'entrée en cours. 
@end table

Pour créer un arbre rare et des listes spéciale avec sélection basée sur les 
propriétés, les mêmes commandes sont utilisées que pour les recherches de 
balises (@pxref{Tag searches}).  La syntaxe pour la recherche de chaîne est 
décrite @ref{Correspondance balises et propriétés}.
@table @kbd
@end table

@seealso{
@uref{http://orgmode.org/manual/Properties-and-Columns.html#Properties-and-Columns,
Chapter 7 of the manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-column-view-tutorial.php,Bastien
Guerry's column view tutorial}}

@node Dates et heures, Capturer - Sauver - Archiver, Propriétés, Top
@chapter Dates et heures

Pour aider à la plannification du projet, les items TODO peuvent être étiquetés 
avec une date et/ou une heure. La chaîne spécialement formatée tenant compte de 
la date et de l'heure est appelée @emph{horodatage} dans le mode Org.

@menu
* Horodatages::			Donner une durée à une entrée de l'arborescence
* Création d'horodatages::	Les commandes qui insèrent des horodateurs
* Dates limites et calendrier::	Planification de votre travail
* Chronométrage du temps de travail:: Suivi du temps passé sur une tâche
@end menu


@node Horodatages, Création d'horodatages, Dates et heures, Dates et heures
@section Horodatages

Un horodatage est une spécification d'une date (éventuellement avec un temps ou 
une plage de temps) dans un format spécial, soit @samp{<2003-09-16 Tue>} ou
@samp{<2003-09-16 Tue 09:39>} ou @samp{<2003-09-16 Tue 12:00-12:30>}.  Un horodatage peut apparaître n'importe où dans une ligne
d'en-tête ou dans le corps d'une entrée d'arbre Org. Sa présence provoque 
l'affichage des entrées à des dates spécifiques dans l'agenda
(@pxref{L'agenda hebdomadaire/quotidien}).  Nous distinguons:

@noindent 
@b{L'horodatage complet; les événements; les rendez-vous}@*
Un simple horodatage affecte juste une date/temps à un item. C'est juste comme
écrire un rendez-vous ou un événement sur un agenda papier.
@smallexample
* Rencontrer Peter au cinéma
  <2006-11-01 Wed 19:15>
* Discussion sur le changement climatique
  <2006-11-02 Thu 20:00-22:00>
@end smallexample

@noindent 
@b{Horodatage avec intervalles répétés}@*
Un horodatage peut contenir un @emph{intervalle répété}, indiquant qu'il ne 
s'applique pas seulement sur les dates données,; mais encore et encore après 
un certains intervalle de N jours (d), semaines (w), mois (m), ou années (y). 
Les exemples suivants montreront l'agenda chaque mercredi :
@smallexample
* Aller chercher Sam à l'école
  <2007-05-16 Wed 12:30 +1w>
@end smallexample

@noindent 
@b{Entrées d'expressions symboliques quotidienne}@*
Pour des spécifications plus complexes de dates, le mode Org supporte l'usage 
d'expression symbolique spéciales implémentées dans le paque Emacs 
calendar/diary. Par exemple
@smallexample
* Le rendez-vous geek chaque deuxième jeudi du mois
  <%%(diary-float t 4 2)>
@end smallexample

@noindent 
@b{Plage de temps}@*
Deux horodatages connectés par @samp{--} dénote une plage.
@smallexample
** Rendez-vous à Amsterdam
   <2004-08-23 Mon>--<2004-08-26 Thu>
@end smallexample

@noindent 
@b{Horodatage inactif}@*
Comme l'horodatage complet, mais avec des crochets au lieu des chevrons. Ces 
horodatages sont inactifs dans le sens où ils ne déclenchent @emph{pas} une 
entrée pour la montrer dans l'agenda. 

@smallexample
* Gillian est arrivée en retard pour la 5ème fois
  [2006-11-01 Wed]
@end smallexample


@node Création d'horodatages, Dates limites et calendrier, Horodatages, Dates et heures
@section Création d'horodatages

Pour que le mode Org puisse reconnaître les horodatages, ils doivent être dans 
un format spécifique. Toutes les commandes listées en dessous produisent des 
horodatages dans le format correct.

@table @kbd
@item C-c .
Invite à saisir une date et insérer l'horodatage correspondant. Lorsque le 
curseur est sur un horodatage existant dans le tampon, la commande est
utilisée pour modifier cet horodatage au lieu d'en insérer un nouveau.
Lorsque la commande est utilisée deux fois successivement, une plage de 
temps est insérée. Avec un préfixe, rajoute l'heure actuelle.
@c
@item C-c !
Comme @kbd{C-c .}, mais insère un horodatage inactif qui ne provoquera pas une 
entrée dans l'agenda.
@c
@item S-@key{left}@r{/}@key{right}
Change la date au niveau du curseur d'un jour. 
@c
@item S-@key{up}@r{/}@key{down}
Change l'item sous le curseur dans un horodatage. Le curseur peut être sur une
année, un mois, un jour, une heure ou une minute. Lorsque l'horodatage 
contient une plage de temps comme @samp{15:30-16:30}, la modification de la 
première heure affectera la seconde, le décalage sera constant. Pour changer
cette constante, modifier la seconde heure.
@end table

Lorsque le mode Org invite à saisir une date/temps, cela acceptera n'importe 
qu'elle chaîne contenant une date et/ou une information temporelle, et 
interprètera intelligemment la chaîne, déduisant par défaut les informations 
non précisées depuis la date et l'heure. Vous pouvez aussi sélectionner une 
date dans le calendrier qui s'affiche. Voir le manuel pour plus d'informations.

@node Dates limites et calendrier, Chronométrage du temps de travail, Création d'horodatages, Dates et heures
@section Dates limites et calendrier

Un horodatage peut être précédé par des mots-clés spéciaux pour faciliter la 
plannification. 

@noindent 
@b{DEADLINE (date limite)}@*
Sens: la tâche (souvent comme un item TODO, bien que pas nécessairement) est 
supposée être finie à cette date.
@table @kbd
@item C-c C-d
Insère le mot-clé @samp{DEADLINE} suivi d'un horodatage, dans la ligne 
d'en-tête suivante.
@end table

Sur la date limite, la tâche sera listée dans l'agenda. De plus, l'agenda pour 
@emph{aujourd'hui} mentionnera une alerte à propos de l'approche ou du loupé de 
la date limite, commençant @code{org-deadline-warning-days} avant la date 
d'échéance, et continuant jusqu'à ce que l'entrée soit marquée DONE. Un 
exemple :

@smallexample
*** TODO écrire un article à propos de la Terre
    L'éditeur en charge est [[bbdb:Ford Prefect]]
    DEADLINE: <2004-02-29 Sun>
@end smallexample


@noindent 
@b{SCHEDULED (plannifié)}@*
Sens: vous @i{plannifiez de démarrer le travail} sur une tâche à la date donnée
@footnote{C'est assez différent de ce qui normalement compris par 
@i{plannification d'un rendez-vous}, qui est fait dans le mode Org juste par 
insertion d'une étiquette de temps sans mot-clé.}

@table @kbd
@item C-c C-s
Insère le mot-clé @samp{SCHEDULED} avec une étiquette, sur la ligne suivant 
l'en-tête.
@end table

L'en-tête sera listée sous la date donnée@footnote{Cela sera encore listé sur 
cette date après qu'elle soit marquée DONE. Si vous n'aimez pas ça, configurez 
la variable @code{org-agenda-skip-scheduled-if-done}.}. De plus, un rappel 
signalant que la date prévue est passée sera présent dans la compilation pour 
@emph{aujourd'hui}, jusqu'à ce que l'entrée soit marquée DONE. I.e.@: la tâche 
sera automatiquement transmise jusqu'à ce qu'elle soit achevée.

@smallexample
*** TODO Appeler Trillian pour un rencard au nouvel an
    SCHEDULED: <2004-12-25 Sat>
@end smallexample

Quelques tâches ont besoin d'être répétées encore et encore. Le mode Org aide à
organiser de telles usages de tâches un tel appel répété dans un DEADLINE, 
SCHEDULED, ou un horodatage complet. Dans l'exemple suivant 
@smallexample
** TODO Payer le loyer
   DEADLINE: <2005-10-01 Sat +1m>
@end smallexample
@noindent
le @code{+1m} est un répétiteur; l'interprétation attendue est que la tâche ait 
une date limite sur <2005-10-01> et se répète chaque mois à partir de cette 
date.

@node Chronométrage du temps de travail,  , Dates limites et calendrier, Dates et heures
@section Chronométrage du temps de travail

Le mode Org vous permet de chronométrer le temps que vous passez sur des tâches 
spécifiques dans un projet.

@table @kbd
@item C-c C-x C-i
Démarre le chrono à l'item actuel (clock-in). Cela insère le mot-clé
CLOCK ensemble avec un horodatage. Lorsque appelé avec un argument 
préfixé @kbd{C-u}, sélectionne la tâche depuis une liste de tâches
récemment chronométrées.
@c
@item C-c C-x C-o
Arrête le chrono (clock-out). Cela insère un autre horodatage au même
endroit que le chrono avait fait son dernier démarrage. Cela calcule 
aussi directement le temps résultant en l'insérant après la plage de
temps comme @samp{=>
HH:MM}.
@item C-c C-x C-e
Met à jour l'effort estimé pour la tâche en cours de chronométrage.
@item C-c C-x C-q
Annule le chrono en cours. C'est utile si un chrono a été déclenché
par erreur, ou si vous cessez votre travail sur quelque chose d'autre.
@item C-c C-x C-j
Saute jusqu'à l'entrée qui contient le chrono en cours. Avec un argument
préfixé @kbd{C-u}, sélectionne la tâche cible dans une liste de tâches
récemment chronométrées.
@item C-c C-x C-r
Insère un bloc dynamique contenant un rapport de chrono comme une table
en mode Org dans le fichier courant. Lorsque le curseur est sur une table
de chrono existante, il l'a met à jour.
@smallexample
#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file
#+END: clocktable
@end smallexample
@noindent
Pour les détails sur la personnalisation, voir @uref{http://orgmode.org/manual/Clocking-work-time.html#Clocking-work-time,the manual}.
@item C-c C-c
Mise à jour du bloc dynamique au point. Le curseur a besoin 
d'être dans la ligne @code{#+BEGIN} du bloc dynamique.
@end table

La touche @kbd{l} être utilisée dans la ligne du temps (@pxref{Chronologie}) et 
dans l'agenda (@pxref{L'agenda hebdomadaire/quotidien}) pour montrer quelles tâches ont été 
travaillée et fermée durant la journée.

@seealso{
@uref{http://orgmode.org/manual/Dates-and-Times.html#Dates-and-Times,
Chapter 8 of the manual}@*
@uref{http://members.optusnet.com.au/~charles57/GTD/org_dates/, Charles
Cave's Date and Time tutorial}@*
@uref{http://doc.norang.ca/org-mode.html#Clocking, Bernt Hansen's clocking workflow}}

@node Capturer - Sauver - Archiver, Vues de l'agenda, Dates et heures, Top
@chapter Capturer - Sauver - Archiver

Une part importante de n'importe quel système d'organisation est la 
capacité de capturer rapidement les nouvelles idées et tâches, et de
leur associer des documents de référence. Org définit un processus de
capture pour créer des tâches. Il stocke les fichiers reliés à une
tâche (@emph{attachements}) dans un répertoire spécial. Une fois dans le 
système, les tâches et projets ont besoin d'être déplacés autour. Le
déplacement d'arborescences de projet complété vers un fichier d'archive
garde le système compact et rapide.

@menu
* Capture::			Capture de nouvelles choses 
* Sauver et copier::		Déplacement d'un arbre d'un endroit à un autre
* Archivage::			Que faire avec des projets finis
@end menu

@node Capture, Sauver et copier, Capturer - Sauver - Archiver, Capturer - Sauver - Archiver
@section Capture

Org vous permet de stocker des notes rapides avec peu d'interruption de votre
flux de travail. Vous pouvez définir des modèles pour les nouvelles entrées et
les associer à différentes cibles pour le stockage de notes.

@menu
* Configuration d'un emplacement de capture::  Où les notes seront stockées
* Utilisation de capture::	Commandes qui invoquent et terminent la capture
* Modèles de capture::		Définir le contour des types de notes différentes
@end menu

@node Configuration d'un emplacement de capture, Utilisation de capture, Capture, Capture
@unnumberedsubsec Configuration d'un emplacement de capture

La personnalisation suivante configure un fichier cible par 
défaut, @footnote{Utilisant des modèles de capture, voir
@ref{Modèles de capture}.}, et définit un raccourci clavier global pour la
capture d'autres choses.

@example
(setq org-default-notes-file (concat org-directory "/notes.org"))
(define-key global-map "\C-cc" 'org-capture)
@end example

@node Utilisation de capture, Modèles de capture, Configuration d'un emplacement de capture, Capture
@unnumberedsubsec Utilisation de capture

@table @kbd
@item C-c c
Démarre une procédure de capture. Vous serez placé dans une tampon indirect 
réduit pour éditer l'item.
@item C-c C-c
Une fois que vous avez fini d'entrer les informations dans le
tampon de capture, @kbd{C-c C-c} vous renverra vers la fenêtre
de configuration avant le processus de capture, donc vous
pouvez résumer votre travail sans distraction.
@item C-c C-w
Finaliser en déplaçant l'entrée vers un emplacement de fichier (voir section 
9.2).
@item C-c C-k
Annule le processus de capture et renvoit à l'état précédent.
@end table

@node Modèles de capture,  , Utilisation de capture, Capture
@unnumberedsubsec Modèles de capture

Vous pouvez utiliser des modèles pour générer différents types de capture 
de notes, et les stocker dans différents endroits. Par exemple, si vous 
aimeriez stocker des nouvelles tâches sous un en-tête @samp{Tâches} dans le
fichier @file{TODO.org}, et le journal des entrées dans une arborescence de date
dans @file{journal.org} vous pouvez utiliser : 

@smallexample
(setq org-capture-templates
 '(("t" "Todo" entry (file+headline "~/org/gtd.org" "Tasks")
        "* TODO %?\n  %i\n  %a")
   ("j" "Journal" entry (file+datetree "~/org/journal.org")
        "* %?\nEntered on %U\n  %i\n  %a")))
@end smallexample

@noindent 
Dans ces entrées, la première chaîne est la clé pour accéder au modèle, la
seconde est une courte description. Vient ensuite le type de l'entrée et une 
définition de l'emplacement de la cible pour stocker la note. Finalement, le
modèle lui-même, une chaîne avec des échappements % où remplir les informations
basées sur le temps et le contexte.

Lorsque vous appelez @kbd{M-x org-capture}, Org vous invitera à saisir une 
touche pour choisir le modèle (si vous en avez plus d'un) et ensuite 
préparera le tampon comme
@smallexample
* TODO
  [[file:@var{lien vers où vous étiez lors de l'initialisation de la capture}]]
@end smallexample

@noindent
Durant l'expansion du modèle, les échappements @kbd{%} spéciaux@footnote{Si vous
avez besoin d'une de ces séquences littéralement, échappez le @kbd{%} avec une 
contre-oblique.} permet l'insertion dynamique de contenu. Voici une petite 
sélection des possibilités, consulter le manuel pour plus de détails.
@smallexample
%a          @r{annotation, normalement le lien créé avec @code{org-store-link}}
%i          @r{contenu initial, la région lorsque la capture est appelée avec C-u.}
%t, %T      @r{horodatage, date seulement}
%u, %U      @r{horodatage avec date et heure}
@end smallexample

@node Sauver et copier, Archivage, Capture, Capturer - Sauver - Archiver
@section Sauver et copier

Lors du revisionnage de données capturées, vous pouvez souhaiter les déposer
à nouveau ou les copier certaines des entrées dans une liste différente, par
exemple dans un projet. Couper, trouver le bon emplacement, et ensuite coller
la note est fastidieux. Afin de simplifier ce processus, vous pouvez utiliser
les commandes spéciales suivantes :

@table @kbd
@item C-c M-x
Copier l'entrée ou la région au point. Cette commande se comporte comme 
@code{org-refile}, sauf que la note originale ne sera pas effacée.
@item C-c C-w
Dépose à nouveau l'entrée ou la région au point. Cette 
commande offre des emplacements possibles pour le dépôt et
vous laisse en choisir un avec la complétion. L'item (ou tous
les items dans la région) est déposée sous l'en-tête cible
en tant que sous-item.@*
Par défaut, tous les en-tête de niveau 1 dans le tampon actuel
sont considérés comme des cibles, mais vous pouvez avoir des
définitions plus complexes à travers un nombre de fichiers. 
Voir la variable @code{org-refile-targets} pour les details.
@item C-u C-c C-w
Utilise l'interface de dépôt pour sauter vers l'en-tête.
@item C-u C-u C-c C-w
Sauter vers l'emplacement où @code{org-refile} dernier mouvement d'une 
arborescence.
@end table

@node Archivage,  , Sauver et copier, Capturer - Sauver - Archiver
@section Archivage

Lorsqu'un projet est représenté par un (sous)arbre est fini, vous pouvez 
vouloir déplacer l'arbre en dehors de la voie et arrêter sa contribution à 
l'agenda. L'archivage est important pour garder vos fichiers travail compact
et les recherches globales comme la construction des vues d'un agenda rapides.
L'action d'archivage la plus commune est de déplacer une arborescence de 
projet vers un autre fichier, le fichier d'archive.

@table @kbd
@item C-c C-x C-a
Archive l'entrée actuelle en utilisant la commande spécifiée
dans la variable @code{org-archive-default-command}.
@item C-c C-x C-s@ @r{ou version courte} @ C-c $
Archive le sous-arbre démarrant à la position du curseur 
jusqu'à l'emplacement donné par @code{org-archive-location}.
@end table

L'emplacement de l'archive par défaut est un fichier dans le même répertoire
que le fichier courant, avec le même nom dérivé suivi de @file{_archive} Pour 
des informations et des exemples sur comment changer cela, voir la documentation
de la variable @code{org-archive-location}.  Il y a aussi une option de tampon 
pour configurer cette variable, par exemple

@smallexample
#+ARCHIVE: %s_done::
@end smallexample

@seealso{
@uref{http://orgmode.org/manual/Capture-_002d-Refile-_002d-Archive.html#Capture-_002d-Refile-_002d-Archive,
Chapter 9 of the manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-protocol-custom-handler.php,
Sebastian Rose's tutorial for capturing from a web browser}}@uref{}@*

@node Vues de l'agenda, Markup, Capturer - Sauver - Archiver, Top
@chapter Vues de l'agenda

En raison de la façon dont fonctionne Org, éléments TODO, items horodatés, et
en-tête balisées peuvent dispersés dans un fichier ou même un certain nombre
de fichiers. Pour obtenir un aperçu des items ouverts en action, ou 
d'événements qui sont importants pour une date donnée, ces informations 
doivent être collectées, triées et affichées d'une manière organisée. Il y a
plusieurs points de vue différents, voir ci-dessous.

Les informations extraites sont affichées dans un tampon spécial agenda. Ce 
tampon est en lecture seule, mais fournit des commandes pour visiter les 
emplacements correspondants dans les fichiers Org originaux, et même d'éditer
ces fichiers à distance. Montage à distance du tampon agenda signifie, par
exemple, que vous pouvez modifier les dates de délais et de rendez-vous depuis
le tampon agenda. Les commandes disponibles dans le tampon agenda sont listées
dans @ref{Commandes de l'agenda}.

@menu
* Fichiers de l'agenda::	Fichiers recherchés pour les informations de l'agenda
* Répartiteur de l'agenda::	Accès clavier de l'agenda
* Les vues intégrées dans l'agenda:: Ce qui est disponible hors de la boîte ?
* Commandes de l'agenda::	Montage à distance des arbres Org
* Personnaliser les vues de l'agenda:: Définition de recherches spéciales et vues
@end menu

@node Fichiers de l'agenda, Répartiteur de l'agenda, Vues de l'agenda, Vues de l'agenda
@section Fichiers de l'agenda

L'information qui doit être montrée est normalement collectée depuis tous les
@emph{fichiers agenda}, les fichiers listés dans la variable
@code{org-agenda-files}.

@table @kbd
@item C-c [
Ajouter le fichier courant à la liste des fichiers agenda.
Le fichier est ajouté en début de liste. Si il était déjà dans
la liste, il est déplacée en tête. Avec un argument préfixé,
le fichier est ajouté/déplacé à la fin.
@item C-c ]
Efface le fichier courant depuis la liste des fichiers agenda.
@item C-,
Cycle à travers la liste de fichier de l'agenda, visite un fichier après 
l'autre.
@end table

@node Répartiteur de l'agenda, Vues intégrées de l'agenda, Fichiers de l'agenda, Vues de l'agenda
@section Le répartiteur de l'agenda
Les vues sont créées à travers le répartiteur, qui devrait être lié à la 
touche globale---par exemple @kbd{C-c a} (@pxref{Installation}).  Après la 
frappe de @kbd{C-c a}, une lettre supplémentaire est requise
pour exécuter une commande :
@table @kbd
@item a
Le calendrier de l'agenda (@pxref{L'agenda hebdomadaire/quotidien}).
@item t @r{/} T
Une liste de tous les items TODO (@pxref{Liste TODO globale}).
@item m @r{/} M
Une liste d'en-tête correspondantes à une expression balisée (@pxref{Matching
tags and properties}).
@item L
La chronologie pour le tampon courant (@pxref{Chronologie}).
@item s
Une liste des entrées sélectionnées par une expression booléenne
de mots-clés et/ou des expressions régulières qui doivent ou ne 
doivent pas apparaître dans l'entrée.
@end table

@node Vues intégrées de l'agenda, Commandes de l'agenda, Répartiteur de l'agenda, Vues de l'agenda
@section Les vues intégrées de l'agenda

@menu
* L'agenda quotidien/hebdomadaire:: La page du calendrier avec les tâches actuelles
* Liste TODO globale::		Tous les éléments d'action inachevées
* Correspondance balises et propriétés:: Informations structurées avec recherche affinée
* Chronologie::			Vue chronologique pour un fichier unique
* Vue de recherche::		Trouver des entrées par recherche de texte
@end menu

@node L'agenda hebdomadaire/quotidien, Liste TODO globale, Vues intégrées de l'agenda, Vues intégrées de l'agenda
@subsection L'agenda hebdomadaire/quotidien

Le but de l'@emph{agenda} hebdomadaire/quotidien est d'agir comme une page 
d'un agenda de papier, montrant toutes les tâches pour la semaine ou le
jour en cours.

@table @kbd
@item C-c a a
Compile un agenda pour la semaine en cours depuis une liste de fichiers Org. 
L'agenda montre les entrées pour chaque jour.
@end table

Emacs contient le calendrier et le journal de Edward M. Reingold. Le mode 
Org comprend la syntaxe du journal et vous permet d'utiliser les entrées
sexp du journal directement dans les fichiers Org:

@smallexample
* Anniversaire et trucs du genre
#+CATEGORY: Vacances
%%(org-calendar-holiday)   ; fonction spéciale pour les noms de vacances
#+CATEGORY: Ann
%%(diary-anniversary  5 14 1956)@footnote{Notez que le ordre des arguments (mois, jour, années) dépend de la configuration de @code{calendar-date-style}.} Arthur Dent a %d ans
%%(diary-anniversary 10  2 1869) Mahatma Gandhi aurait %d ans
@end smallexample

Org peut intéragir avec les notifications de rendez-vous Emacs. Pour ajouter
tous les rendez-vous de vos fichiers agenda, utiliser la commande 
@code{org-agenda-to-appt}.  Voir la documentation pour les détails.

@node Liste TODO globale, Correspondance balises et propriétés, L'agenda hebdomadaire/quotidien, Vues intégrées de l'agenda
@subsection La liste TODO globale

La liste TODO globale contient tous les items TODO non terminés formatés et
collectés en un seul endroit. L'édition d'items TODO à distance vous permet 
de modifier une entrée TODO avec une seule frappe de touche. Les commandes 
disponibles dans la liste TODO sont décrites dans @ref{Commandes de l'agenda}.

@table @kbd
@item C-c a t
Montre la liste TODO globale. Cela collecte les items TODO
depuis tous les fichiers d'agenda (@pxref{Vues de l'agenda}) dans un seul 
tampon.
@item C-c a T
Comme ci-dessus, mais permet une sélection de mots-clés spécifiques TODO.
@end table

@node Correspondance balises et propriétés, Chronologie, Liste TODO globale, Vues intégrées de l'agenda
@subsection Correspondance balises et propriétés

Si les en-tête dans les fichiers de l'agenda sont marqués avec des 
@emph{balises} (@pxref{Balises}), ou ont des propriétés (@pxref{Propriétés}), 
vous pouvez sélectionner les en-tête basée sur cette méta-donnée et les 
collecter dans un tampon agenda. La syntaxe de correspondance décrite ici 
s'applique aussi lors de la création d'arbres clairsemés avec @kbd{C-c /
m}.  Les commandes disponible dans la liste de balises sont décrites dans 
@ref{Commandes de l'agenda}.

@table @kbd
@item C-c a m
Produit une liste de tous les en-tête qui correspondent à un
ensemble de balises. La commande invite à saisir une 
sélection de critères, qui sont des expressions de logique
booléenne avec des balises, comme @samp{+work+urgent-withboss} ou
@samp{work|home} (@pxref{Balises}).  Si vous avez souvent besoin d'une 
recherche spécifique, définit une commande personnalisée pour ça 
(@pxref{Répartiteur de l'agenda}).
@item C-c a M
Comme @kbd{C-c a m}, mais sélectionne seulement les en-tête qui sont aussi des 
items TODO.
@end table

@subsubheading Syntaxe de correspondance

Une recherche de chaîne peut utiliser des opérateurs booléens @samp{&} pour ET 
et @samp{|} pour OU.  @samp{&} lie plus fortement que @samp{|}.  Les parenthèses
ne sont couramment pas implémentées. Chaque élément dans la recherche est soit 
une balise, une expression régulière correspondante à des balises, ou une 
expression comme @code{PROPERTY OPERATOR VALUE} avec un opérateur de 
comparaison, l'accès à une valeur de propriété. Chaque élément peut être 
précédé par @samp{-}, pour le sélectionner, et @samp{+} est du sucre syntaxique 
pour une sélection positive. L'opérateur ET @samp{&} est optionnel lorsque
@samp{+} ou @samp{-} est présent.  Voici quelques exemples, utilisant seulement 
les balises.

@table @samp
@item +work-boss
Sélectionne les lignes d'en-tête balisées @samp{:work:}, mais rejette aussi
celles qui sont balisées @samp{:boss:}.
@item work|laptop
Sélectionne les lignes balisées @samp{:work:} ou @samp{:laptop:}.
@item work|laptop+night
Comme avant, mais requiert que les lignes @samp{:laptop:} soient aussi balisées
@samp{:night:}.
@end table

Vous pouvez aussi tester des propriétés en même temps que des correspondances
de balises, voir le manuel pour plus d'informations.

@node Chronologie, Vue de recherche, Correspondance balises et propriétés, Vues intégrées de l'agenda
@subsection Chronologie pour un fichier unique

La chronologie résume tous les éléments horodatés à partir d'un fichier en mode
Org un @emph{temps trié prévu}. Le but principal de cette commande est de donner
un aperçu sur les événements dans un projet.

@table @kbd
@item C-c a L
Montre un temps trié prévu du fichier Org, avec des items horodatés. Lorsqu'appelé avec
un argument préfixé @kbd{C-u} toutes les entrées TODO non terminées (programmées ou pas)
sont aussi listées sous la date courante.
@end table

@node Vue de recherche,  , Chronologie, Vues intégrées de l'agenda
@subsection Vue de recherche

Cette vue d'agenda est une facilité de recherche générale de texte pour les
entrées en mode Org. C'est particulièrement utile pour trouver des notes.

@table @kbd
@item C-c a s
C'est une recherche spéciale qui vous permet de sélectionner des entrées par 
correspondance d'une sous-chaîne ou mots spécifiques utilisant une logique 
booléenne.
@end table
Par exemple, la recherche de la chaîne @samp{computer equipment} trouvera des 
entrées contenant @samp{computer equipment} comme sous-chaîne. 
La vue de recherche peut aussi chercher des mots-clés spécifiques dans l'entrée, 
utilisant la logique booléenne. La recherche de la chaîne 
@samp{+computer +wifi -ethernet -@{8\.11[bg]@}} cherchera les entrées qui 
contiennent les mots-clés @code{computer} et @code{wifi}, mais pas le mot-clé 
@code{ethernet}, et qui ne sont pas aussi associés à l'expression régulière 
@code{8\.11[bg]}, signifiant d'exclure à la fois 8.11b et 8.11g. 

Notez qu'en supplément des fichiers d'agenda, cette commande cherchera aussi
les fichiers listés dans @code{org-agenda-text-search-extra-files}.

@node Commandes de l'agenda, Custom agenda views, Vues intégrées de l'agenda, Vues de l'agenda
@section Commandes dans le tampon agenda

Les entrées du tampon agenda sont liées au fichier Org ou au journal dont ils
proviennent. Les commandes sont fournies pour montrer et sauter vers 
l'emplacement l'entrée originale, et pour éditer les fichiers Org <<à 
distance>> depuis le tampon agenda. C'est juste une sélection des nombreuses
commandes, qui explorez le menu @code{Agenda} et le manuel pour une liste complète.

@table @kbd
@tsubheading{Mouvement}
@item n
Ligne suivante (comme @key{haut} et @kbd{C-p}).
@item p
Ligne précédente (comme @key{bas} et @kbd{C-n}).
@tsubheading{Voir/Aller vers un fichier Org}
@item mouse-3
@itemx @key{SPC}
Affiche l'emplacement original de l'item dans une autre fenêtre.
Avec un argument préfixé, s'assure que l'entrée est visible
dans les grandes lignes, pas seulement l'en-tête.
@c
@itemx @key{TAB}
Va à l'emplacement original de l'item dans une autre fenêtre. Sous Emacs
22, @kbd{mouse-1} fonctionnera aussi pour ça.
@c
@itemx @key{RET}
Va à l'emplacement original de l'item et détruit l'autre fenêtre.
@c

@tsubheading{Modifier l'affichage}
@item o
Détruit les autres fenêtres.
@c
@item d @r{/} w
Permute vers la vue jour/semaine
@c
@item f @r{et} b
Va en avant/en arrière dans le temps pour affihcer les jours suivants
@code{org-agenda-current-span}.  Par exemple, si l'affichage couvre une semaine, 
permute à la prochaine/précédente semaine.
@c
@item .
Va à aujourd'hui.
@c
@item j
Invite à saisir une date et y va.
@c
@item v l @ @r{ou version courte} @ l
Bascule en mode Logbook. En mode Logbook, les entrées qui étaient
marquées DONE tandis que logging était activé (variable @code{org-log-done}) sont
montrées dans l'agenda, comme entrées qui ont été chronométrées ce jour-là. 
Lorsqu'appelée avec un argument préfixé @kbd{C-u} montre toutes les entrées 
logbook possible, incluant les changements d'états.
@c
@item r @r{ou} g
Recrée le tampon agenda, pour refléter les changements.
@item s
Sauvegarde tous les tampons Org dans la session Emacs en cours, et aussi les 
emplacements des IDs.

@tsubheading{Secondary filtering and query editing}

@item /
Filter the current agenda view with respect to a tag.  You are prompted for a
letter to select a tag.  Press @samp{-} first to select against the tag.

@item \
Narrow the current agenda filter by an additional condition.

@tsubheading{Remote editing (see the manual for many more commands)}

@item 0--9
Digit argument.
@c
@item t
Change the TODO state of the item, in the agenda and in the
org file.
@c
@item C-k
Delete the current agenda item along with the entire subtree belonging
to it in the original Org file.
@c
@item C-c C-w
Refile the entry at point.
@c
@item C-c C-x C-a @ @r{or short} @ a
Archive the subtree corresponding to the entry at point using the default
archiving command set in @code{org-archive-default-command}.
@c
@item C-c C-x C-s @ @r{or short} @ $
Archive the subtree corresponding to the current headline.
@c
@item C-c C-s
Schedule this item, with prefix arg remove the scheduling timestamp
@c
@item C-c C-d
Set a deadline for this item, with prefix arg remove the deadline.
@c
@item S-@key{right} @r{and} S-@key{left}
Change the timestamp associated with the current line by one day.
@c
@item I
Start the clock on the current item.
@c
@item O / X
Stop/cancel the previously started clock.

@item J
Jump to the running clock in another window.
@end table

@node Custom agenda views,  , Commandes de l'agenda, Vues de l'agenda
@section Custom agenda views

The main application of custom searches is the definition of keyboard
shortcuts for frequently used searches, either creating an agenda
buffer, or a sparse tree (the latter covering of course only the current
buffer).
Custom commands are configured in the variable
@code{org-agenda-custom-commands}.  You can customize this variable, for
example by pressing @kbd{C-c a C}.  You can also directly set it with
Emacs Lisp in @file{.emacs}.  The following example contains all valid
search types:

@smalllisp
@group
(setq org-agenda-custom-commands
      '(("w" todo "WAITING")
        ("u" tags "+boss-urgent")
        ("v" tags-todo "+boss-urgent")))
@end group
@end smalllisp

@noindent
The initial string in each entry defines the keys you have to press after the
dispatcher command @kbd{C-c a} in order to access the command.  Usually this
will be just a single character.  The second parameter is the search type,
followed by the string or regular expression to be used for the matching.
The example above will therefore define:

@table @kbd
@item C-c a w
as a global search for TODO entries with @samp{WAITING} as the TODO
keyword
@item C-c a u
as a global tags search for headlines marked @samp{:boss:} but not
@samp{:urgent:}
@item C-c a v
as the same search as @kbd{C-c a u}, but limiting the search to
headlines that are also Listes TODO
@end table

@seealso{
@uref{http://orgmode.org/manual/Agenda-Views.html#Agenda-Views, Chapter 10 of
the manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php,
Mat Lundin's tutorial about custom agenda commands}@*
@uref{http://www.newartisans.com/2007/08/using-org-mode-as-a-day-planner.html,
John Wiegley's setup}}

@node Markup, Exporting, Vues de l'agenda, Top
@chapter Markup for rich export

When exporting Org-mode documents, the exporter tries to reflect the
structure of the document as accurately as possible in the backend.  Since
export targets like HTML, @LaTeX{}, or DocBook allow much richer formatting,
Org mode has rules on how to prepare text for rich export.  This section
summarizes the markup rules used in an Org-mode buffer.

@menu
* Structural markup elements::	The basic structure as seen by the exporter
* Images and tables::		Images, tables and caption mechanism
* Literal examples::		Source code examples with special formatting
* Include files::		Include additional files into a document
* Embedded @LaTeX{}::		@LaTeX{} can be freely used inside Org documents
@end menu

@node Structural markup elements, Images and tables, Markup, Markup
@section Structural markup elements

@menu
* Document title::		Where the title is taken from
* Headings and sections::	The document structure as seen by the exporter
* Table of contents::		The if and where of the table of contents
* Paragraphs::			Paragraphs
* Emphasis and monospace::	Bold, italic, etc.
* Comment lines::		What will *not* be exported
@end menu

@node Document title, Headings and sections, Structural markup elements, Structural markup elements
@subheading Document title

@noindent
The title of the exported document is taken from the special line

@smallexample
#+TITLE: This is the title of the document
@end smallexample

@node Headings and sections, Table of contents, Document title, Structural markup elements
@subheading Headings and sections

The outline structure of the document as described in @ref{Document
Structure}, forms the basis for defining sections of the exported document.
However, since the outline structure is also used for (for example) lists of
tasks, only the first three outline levels will be used as headings.  Deeper
levels will become itemized lists.  You can change the location of this
switch globally by setting the variable @code{org-export-headline-levels}, or on a
per-file basis with a line

@smallexample
#+OPTIONS: H:4
@end smallexample

@node Table of contents, Paragraphs, Headings and sections, Structural markup elements
@subheading Table of contents

The table of contents is normally inserted directly before the first headline
of the file.

@smallexample
#+OPTIONS: toc:2          (only to two levels in TOC)
#+OPTIONS: toc:nil        (no TOC at all)
@end smallexample

@node Paragraphs, Emphasis and monospace, Table of contents, Structural markup elements
@subheading Paragraphs, line breaks, and quoting

Paragraphs are separated by at least one empty line.  If you need to enforce
a line break within a paragraph, use @samp{\\} at the end of a line.

To keep the line breaks in a region, but otherwise use normal formatting, you
can use this construct, which can also be used to format poetry.

@smallexample
#+BEGIN_VERSE
 Great clouds overhead
 Tiny black birds rise and fall
 Snow covers Emacs

     -- AlexSchroeder
#+END_VERSE
@end smallexample

When quoting a passage from another document, it is customary to format this
as a paragraph that is indented on both the left and the right margin.  You
can include quotations in Org-mode documents like this:

@smallexample
#+BEGIN_QUOTE
Everything should be made as simple as possible,
but not any simpler -- Albert Einstein
#+END_QUOTE
@end smallexample

If you would like to center some text, do it like this:
@smallexample
#+BEGIN_CENTER
Everything should be made as simple as possible, \\
but not any simpler
#+END_CENTER
@end smallexample

@node Emphasis and monospace, Comment lines, Paragraphs, Structural markup elements
@subheading Emphasis and monospace

You can make words @b{*bold*}, @i{/italic/}, _underlined_, @code{=code=}
and @code{~verbatim~}, and, if you must, @samp{+strike-through+}.  Text
in the code and verbatim string is not processed for Org-mode specific
syntax, it is exported verbatim.  To insert a horizontal rules, use a line 
consisting of only dashes, and at least 5 of them.

@node Comment lines,  , Emphasis and monospace, Structural markup elements
@subheading Comment lines

Lines starting with zero or more whitespace characters followed by @samp{#}
and a whitespace are treated as comments and, as such, are not exported.

Likewise, regions surrounded by @samp{#+BEGIN_COMMENT}
... @samp{#+END_COMMENT} are not exported.

Finally, a @samp{COMMENT} keyword at the beginning of an entry, but after any
other keyword or priority cookie, comments out the entire subtree.  The
command below helps changing the comment status of a headline.

@table @kbd
@item C-c ;
Toggle the COMMENT keyword at the beginning of an entry.
@end table

@node Images and tables, Literal examples, Structural markup elements, Markup
@section Images and Tables

For Org mode tables, the lines before the first horizontal separator line
will become table header lines.  You can use the following lines somewhere
before the table to assign a caption and a label for cross references, and in
the text you can refer to the object with @code{[[tab:basic-data]]}:

@smallexample
#+CAPTION: This is the caption for the next table (or link)
#+NAME:   tbl:basic-data
   | ... | ...|
   |-----|----|
@end smallexample

Some backends allow you to directly include images into the exported
document.  Org does this, if a link to an image files does not have
a description part, for example @code{[[./img/a.jpg]]}.  If you wish to
define a caption for the image and maybe a label for internal cross
references, you sure that the link is on a line by itself precede it with:

@smallexample
#+CAPTION: This is the caption for the next figure link (or table)
#+NAME:   fig:SED-HR4049
[[./img/a.jpg]]
@end smallexample

The same caption mechanism applies to other structures than images and tables
(e.g., @LaTeX{} equations, source code blocks), provided the chosen export
back-end supports them.

@node Literal examples, Include files, Images and tables, Markup
@section Literal examples

You can include literal examples that should not be subjected to
markup.  Such examples will be typeset in monospace, so this is well suited
for source code and similar examples.

@smallexample
#+BEGIN_EXAMPLE
Some example from a text file.
#+END_EXAMPLE
@end smallexample

For simplicity when using small examples, you can also start the example
lines with a colon followed by a space.  There may also be additional
whitespace before the colon:

@smallexample
Here is an example
   : Some example from a text file.
@end smallexample

For source code from a programming language, or any other text
that can be marked up by font-lock in Emacs, you can ask for it to
look like the fontified Emacs buffer

@smallexample
#+BEGIN_SRC emacs-lisp
(defun org-xor (a b)
   "Exclusive or."
   (if a (not b) b))
#+END_SRC
@end smallexample

To edit the example in a special buffer supporting this language, use
@kbd{C-c '} to both enter and leave the editing buffer.

@node Include files, Embedded @LaTeX{}, Literal examples, Markup
@section Include files

During export, you can include the content of another file.  For example, to
include your @file{.emacs} file, you could use:

@smallexample
#+INCLUDE: "~/.emacs" src emacs-lisp
@end smallexample
@noindent
The optional second and third parameter are the markup (i.e., @samp{example}
or @samp{src}), and, if the markup is @samp{src}, the language for formatting
the contents.  The markup is optional, if it is not given, the text will be
assumed to be in Org mode format and will be processed normally.  File-links
will be interpreted as well:
@smallexample
#+INCLUDE: "./otherfile.org::#my_custom_id" :only-contents t
@end smallexample
@noindent
@kbd{C-c '} will visit the included file.

@node Embedded @LaTeX{},  , Include files, Markup
@section Embedded @LaTeX{}

For scientific notes which need to be able to contain mathematical symbols
and the occasional formula, Org-mode supports embedding @LaTeX{} code into
its files.  You can directly use TeX-like syntax for special symbols, enter
formulas and entire @LaTeX{} environments.

@smallexample
Angles are written as Greek letters \alpha, \beta and \gamma.  The mass if
the sun is M_sun = 1.989 x 10^30 kg.  The radius of the sun is R_@{sun@} =
6.96 x 10^8 m.  If $a^2=b$ and $b=2$, then the solution must be either
$a=+\sqrt@{2@}$ or $a=-\sqrt@{2@}$.

\begin@{equation@}
x=\sqrt@{b@}
\end@{equation@}
@end smallexample
@noindent  
With
@uref{http://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments,special
setup}, @LaTeX{} snippets will be included as images when exporting to HTML.

@seealso{
@uref{http://orgmode.org/manual/Markup.html#Markup, Chapter 11 of the manual}}

@node Exporting, Publishing, Markup, Top
@chapter Exporting

Org-mode documents can be exported into a variety of other formats: ASCII
export for inclusion into emails, HTML to publish on the web, @LaTeX{}/PDF
for beautiful printed documents and DocBook to enter the world of many other
formats using DocBook tools.  There is also export to iCalendar format so
that planning information can be incorporated into desktop calendars.

@menu
* Export options::		Per-file export settings
* The export dispatcher::	How to access exporter commands
* ASCII/Latin-1/UTF-8 export::	Exporting to flat files with encoding
* HTML export::			Exporting to HTML
* @LaTeX{} and PDF export::	Exporting to @LaTeX{}, and processing to PDF
* iCalendar export::		Exporting to iCalendar
@end menu

@node Export options, The export dispatcher, Exporting, Exporting
@section Export options

The exporter recognizes special lines in the buffer which provide additional
information.  These lines may be put anywhere in the file.  The whole set of
lines can be inserted into the buffer with @kbd{C-c C-e #}.

@table @kbd
@item C-c C-e #
Insert template with export options, see example below.
@end table

@smallexample
#+TITLE:       the title to be shown
#+AUTHOR:      the author (default taken from @code{user-full-name})
#+DATE:        a date, fixed, or an Org timestamp
#+EMAIL:       his/her email address (default from @code{user-mail-address})
#+LANGUAGE:    language, e.g.@: @samp{en} (@code{org-export-default-language})
#+OPTIONS:     H:2 num:t toc:t \n:nil ::t |:t ^:t f:t tex:t ...
@end smallexample

@node The export dispatcher, ASCII/Latin-1/UTF-8 export, Export options, Exporting
@section The export dispatcher

All export commands can be reached using the export dispatcher, which is
a prefix key that prompts for an additional key specifying the command.
Normally the entire file is exported, but if a region is active, it will be
exported instead.

@table @kbd
@item C-c C-e
Dispatcher for export and publishing commands.
@end table

@node ASCII/Latin-1/UTF-8 export, HTML export, The export dispatcher, Exporting
@section ASCII/Latin-1/UTF-8 export

ASCII export produces a simple and very readable version of an Org-mode
file, containing only plain ASCII.  Latin-1 and UTF-8 export augment the file
with special characters and symbols available in these encodings.

@table @kbd
@item C-c C-e t a @ @ @r{and} @ @ C-c C-e t A
Export as ASCII file or temporary buffer.
@item C-c C-e t n @ @ @r{and} @ @ C-c C-e t N
Like the above commands, but use Latin-1 encoding.
@item C-c C-e t u @ @ @r{and} @ @ C-c C-e t U
Like the above commands, but use UTF-8 encoding.
@end table

@node HTML export, @LaTeX{} and PDF export, ASCII/Latin-1/UTF-8 export, Exporting
@section HTML export

@table @kbd
@item C-c C-e h h
Export as HTML file @file{myfile.html}.
@item C-c C-e h o
Export as HTML file and immediately open it with a browser.
@end table

To insert HTML that should be copied verbatim to
the exported file use either

@smallexample
#+HTML: Literal HTML code for export
@end smallexample
@noindent 
or
@smallexample
#+BEGIN_HTML
All lines between these markers are exported literally
#+END_HTML
@end smallexample

@node @LaTeX{} and PDF export, iCalendar export, HTML export, Exporting
@section @LaTeX{} and PDF export

@table @kbd
@item C-c C-e l l
Export as @LaTeX{} file @file{myfile.tex}.
@item C-c C-e l p
Export as @LaTeX{} and then process to PDF.
@item C-c C-e l o
Export as @LaTeX{} and then process to PDF, then open the resulting PDF file.
@end table

By default, the @LaTeX{} output uses the class @code{article}.  You can
change this by adding an option like @code{#+LATEX_CLASS: myclass} in your
file.  The class must be listed in @code{org-latex-classes}.

Embedded @LaTeX{} as described in @ref{Embedded @LaTeX{}}, will be correctly
inserted into the @LaTeX{} file.  Similarly to the HTML exporter, you can use
@code{#+LATEX:} and @code{#+BEGIN_LATEX ... #+END_LATEX} construct to add
verbatim @LaTeX{} code.

@node iCalendar export,  , @LaTeX{} and PDF export, Exporting
@section iCalendar export

@table @kbd
@item C-c C-e c f
Create iCalendar entries for the current file in a @file{.ics} file.
@item C-c C-e c c
Create a single large iCalendar file from all files in
@code{org-agenda-files} and write it to the file given by
@code{org-icalendar-combined-agenda-file}.
@end table

@seealso{
@uref{http://orgmode.org/manual/Exporting.html#Exporting, Chapter 12 of the manual}@*
@uref{http://orgmode.org/worg/org-tutorials/images-and-xhtml-export.php,
Sebastian Rose's image handling tutorial}@*
@uref{http://orgmode.org/worg/org-tutorials/org-latex-export.php, Thomas
Dye's LaTeX export tutorial}
@uref{http://orgmode.org/worg/org-tutorials/org-beamer/tutorial.php, Eric
Fraga's BEAMER presentation tutorial}}

@node Publishing, Working With Source Code, Exporting, Top
@chapter Publishing

Org includes a publishing management system that allows you to configure
automatic HTML conversion of @emph{projects} composed of interlinked org
files.  You can also configure Org to automatically upload your exported HTML
pages and related attachments, such as images and source code files, to a web
server.  For detailed instructions about setup, see the manual.

Here is an example:

@smalllisp
(setq org-publish-project-alist
      '(("org"
         :base-directory "~/org/"
         :publishing-directory "~/public_html"
         :section-numbers nil
         :table-of-contents nil
         :style "<link rel=\"stylesheet\"
                href=\"../other/mystyle.css\"
                type=\"text/css\"/>")))
@end smalllisp

@table @kbd
@item C-c C-e P x
Prompt for a specific project and publish all files that belong to it.
@item C-c C-e P p
Publish the project containing the current file.
@item C-c C-e P f
Publish only the current file.
@item C-c C-e P a
Publish every project.
@end table

Org uses timestamps to track when a file has changed.  The above functions
normally only publish changed files.  You can override this and force
publishing of all files by giving a prefix argument to any of the commands
above.

@seealso{
@uref{http://orgmode.org/manual/Publishing.html#Publishing, Chapter 13 of the
manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php,
Sebastian Rose's publishing tutorial}@*
@uref{http://orgmode.org/worg/org-tutorials/org-jekyll.php, Ian Barton's
Jekyll/blogging setup}}

@node Working With Source Code, Miscellaneous, Publishing, Top
@chapter Working with source code
Org-mode provides a number of features for working with source code,
including editing of code blocks in their native major-mode, evaluation of
code blocks, tangling of code blocks, and exporting code blocks and their
results in several formats.

@subheading Structure of Code Blocks
The structure of code blocks is as follows:

@example
#+NAME: <name>
#+BEGIN_SRC <language> <switches> <header arguments>
  <body>
#+END_SRC
@end example

Where @code{<name>} is a string used to name the code block,
@code{<language>} specifies the language of the code block
(e.g.@: @code{emacs-lisp}, @code{shell}, @code{R}, @code{python}, etc...),
@code{<switches>} can be used to control export of the code block,
@code{<header arguments>} can be used to control many aspects of code block
behavior as demonstrated below, and @code{<body>} contains the actual source
code.

@subheading Editing source code
Use @kbd{C-c '} to edit the current code block.  This brings up a language
major-mode edit buffer containing the body of the code block.  Saving this
buffer will write the new contents back to the Org buffer.  Use @kbd{C-c '}
again to exit the edit buffer.

@subheading Evaluating code blocks
Use @kbd{C-c C-c} to evaluate the current code block and insert its results
in the Org-mode buffer.  By default, evaluation is only turned on for
@code{emacs-lisp} code blocks, however support exists for evaluating blocks
in many languages.  For a complete list of supported languages see the
manual.  The following shows a code block and its results.

@example
#+BEGIN_SRC emacs-lisp
  (+ 1 2 3 4)
#+END_SRC

#+RESULTS:
: 10
@end example

@subheading Extracting source code
Use @kbd{C-c C-v t} to create pure source code files by extracting code from
source blocks in the current buffer.  This is referred to as ``tangling''---a
term adopted from the literate programming community.  During ``tangling'' of
code blocks their bodies are expanded using @code{org-babel-expand-src-block}
which can expand both variable and ``noweb'' style references.  In order to
tangle a code block it must have a @code{:tangle} header argument, see the
manual for details.

@subheading Library of Babel
Use @kbd{C-c C-v l} to load the code blocks from an Org-mode files into the
``Library of Babel'', these blocks can then be evaluated from any Org-mode
buffer.  A collection of generally useful code blocks is distributed with
Org-mode in @code{contrib/library-of-babel.org}.

@subheading Header Arguments
Many aspects of the evaluation and export of code blocks are controlled
through header arguments.  These can be specified globally, at the file
level, at the outline subtree level, and at the individual code block level.
The following describes some of the header arguments.
@table @code
@item :var
The @code{:var} header argument is used to pass arguments to code blocks.
The values passed to arguments can be literal values, values from org-mode
tables and literal example blocks, or the results of other named code blocks.
@item :results
The @code{:results} header argument controls the @emph{collection},
@emph{type}, and @emph{handling} of code block results.  Values of
@code{output} or @code{value} (the default) specify how results are collected
from a code block's evaluation.  Values of @code{vector}, @code{scalar}
@code{file} @code{raw} @code{html} @code{latex} and @code{code} specify the
type of the results of the code block which dictates how they will be
incorporated into the Org-mode buffer.  Values of @code{silent},
@code{replace}, @code{prepend}, and @code{append} specify handling of code
block results, specifically if and how the results should be inserted into
the Org-mode buffer.
@item :session
A header argument of @code{:session} will cause the code block to be
evaluated in a persistent interactive inferior process in Emacs.  This allows
for persisting state between code block evaluations, and for manual
inspection of the results of evaluation.
@item :exports
Any combination of the @emph{code} or the @emph{results} of a block can be
retained on export, this is specified by setting the @code{:results} header
argument to @code{code} @code{results} @code{none} or @code{both}.
@item :tangle
A header argument of @code{:tangle yes} will cause a code block's contents to
be tangled to a file named after the filename of the Org-mode buffer.  An
alternate file name can be specified with @code{:tangle filename}.
@item :cache
A header argument of @code{:cache yes} will cause associate a hash of the
expanded code block with the results, ensuring that code blocks are only
re-run when their inputs have changed.
@item :noweb
A header argument of @code{:noweb yes} will expand ``noweb'' style references
on evaluation and tangling.
@item :file
Code blocks which output results to files (e.g.@: graphs, diagrams and figures)
can accept a @code{:file filename} header argument in which case the results
are saved to the named file, and a link to the file is inserted into the
Org-mode buffer.
@end table

@seealso{
@uref{http://orgmode.org/manual/Literal-examples.html#Literal-examples,
Chapter 11.3 of the manual}@*
@uref{http://orgmode.org/worg/org-contrib/babel/index.php,
The Babel site on Worg}}

@node Miscellaneous, GNU Free Documentation License, Working With Source Code, Top
@chapter Miscellaneous

@menu
* Completion::			M-TAB knows what you need
* Clean view::			Getting rid of leading stars in the outline
* MobileOrg::			Org-mode on the iPhone
@end menu

@node Completion, Clean view, Miscellaneous, Miscellaneous
@section Completion

Org supports in-buffer completion with @kbd{M-@key{TAB}}.  This type of
completion does not make use of the minibuffer.  You simply type a few
letters into the buffer and use the key to complete text right there.  For
example, this command will complete @TeX{} symbols after @samp{\}, TODO
keywords at the beginning of a headline, and tags after @samp{:} in a
headline.

@node Clean view, MobileOrg, Completion, Miscellaneous
@section A cleaner outline view

Some people find it noisy and distracting that the Org headlines start with a
potentially large number of stars, and that text below the headlines is not
indented.  While this is no problem when writing a @emph{book-like} document
where the outline headings are really section headings, in a more
@emph{list-oriented} outline, indented structure is a lot cleaner:

@smallexample
@group
* Top level headline             |    * Top level headline
** Second level                  |      * Second level
*** 3rd level                    |        * 3rd level
some text                        |          some text
*** 3rd level                    |        * 3rd level
more text                        |          more text
* Another top level headline     |    * Another top level headline
@end group
@end smallexample

@noindent
If you are using at least Emacs 23.1.50.3 and version 6.29 of Org, this kind
of view can be achieved dynamically at display time using
@code{org-indent-mode}, which will prepend intangible space to each line.
You can turn on @code{org-indent-mode} for all files by customizing the
variable @code{org-startup-indented}, or you can turn it on for individual
files using

@smallexample
#+STARTUP: indent
@end smallexample

If you want a similar effect in earlier version of Emacs and/or Org, or if
you want the indentation to be hard space characters so that the plain text
file looks as similar as possible to the Emacs display, Org supports you by
helping to indent (with @key{TAB}) text below each headline, by hiding
leading stars, and by only using levels 1, 3, etc to get two characters
indentation for each level.  To get this support in a file, use

@smallexample
#+STARTUP: hidestars odd
@end smallexample

@node MobileOrg,  , Clean view, Miscellaneous
@section MobileOrg

@i{MobileOrg} is the name of the mobile companion app for Org mode, currently
available for iOS and for Android.  @i{MobileOrg} offers offline viewing and
capture support for an Org mode system rooted on a ``real'' computer.  It
does also allow you to record changes to existing entries.

The @uref{http://mobileorg.ncogni.to/, iOS implementation} for the
@i{iPhone/iPod Touch/iPad} series of devices, was developed by Richard
Moreland. Android users should check out
@uref{http://wiki.github.com/matburt/mobileorg-android/, MobileOrg Android}
by Matt Jones.  The two implementations are not identical but offer similar
features.

@seealso{
@uref{http://orgmode.org/manual/Miscellaneous.html#Miscellaneous, Chapter 15
of the manual}@*
@uref{http://orgmode.org/manual/MobileOrg.html#MobileOrg, Appendix B of the
manual}@*
@uref{http://orgmode.org/orgcard.pdf,Key reference card}}


@c @node GNU Free Documentation License,  , Miscellaneous, Top
@c @appendix GNU Free Documentation License
@c @include doclicense.texi


@bye

@c Local variables:
@c fill-column: 77
@c End:


@c  LocalWords:  webdavhost pre