1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794 |
- \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
|