-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathorgguide.tex
2316 lines (1841 loc) · 93.7 KB
/
orgguide.tex
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
% Created 2024-06-22 Sat 10:48
% Intended LaTeX compiler: pdflatex
\documentclass[11pt]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{graphicx}
\usepackage{longtable}
\usepackage{wrapfig}
\usepackage{rotating}
\usepackage[normalem]{ulem}
\usepackage{amsmath}
\usepackage{amssymb}
\usepackage{capt-of}
\usepackage{hyperref}
\author{The Org Mode Developers Luca Canali}
\date{\today}
\title{Org Mode Compact Guide\\\medskip
\large Release 9.7}
\hypersetup{
pdfauthor={The Org Mode Developers Luca Canali},
pdftitle={Org Mode Compact Guide},
pdfkeywords={},
pdfsubject={},
pdfcreator={Emacs 29.3 (Org mode 9.6.15)},
pdflang={Italian}}
\begin{document}
\maketitle
\tableofcontents
\section{Copying}
\label{sec:org41c2bc7}
Copyright \textcopyright{} 2004--2024 Free Software Foundation, Inc.
\begin{quote}
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 this
compact guide.
(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
modify this GNU manual.''
\end{quote}
\section{Introduzione}
\label{sec:orgad0e3b0}
Org é una modalità per prendere note, mantenere liste TODO ed a
pianificare progetti con un sistema di testo semplice veloce ed
efficace. È anche un sistema di creazione e pubblicazione che supporta
il lavoro con i blocchi di codice per la programmazione letterale e la
ricerca riproducibile.
Questo documento é un derivato molto compresso dal più completo
\href{https://www.gnu.org/software/emacs/manual/html\_mono/org.html\#Top}{manuale Org mode}. Contiene tutte le funzionalità ed i comandi di base,
assieme ad importanti suggerimenti per la personalizzazione. È
destinato ai principianti che potrebbero tirarsi indietro, a causa
delle dimensioni, davanti ad un manuale di 200 pagine.
\subsection*{Installazione}
\label{sec:org9bfcda8}
\begin{quote}
Se usi una versione di Org che fa parte della distribuzione di Emacs,
per favore salta questa sezione e vai direttamente all'\hyperref[sec:orgb24a1ce]{Attivazione}.
\end{quote}
Se hai scaricato Org dal web, solitamente viene distribuito come file
\texttt{.zip} , \texttt{.tar} oppure come archivio Git, é meglio avviarlo
direttamente dalla directory di distribuzione. Hai bisogno di
aggiungere la sottodirectory \texttt{lips/} alla path di Emacs. Per fare
questo aggiungi la seguente linea nel tuo file di inizializzazione:
\begin{verbatim}
(add-to-list 'load-path "~/path/to/orgdir/lisp")
\end{verbatim}
Se hai usato git o tar ball per ottenere Org, hai bisogno di avviare il
seguente comando per generare le informazioni di autoload.
\begin{verbatim}
make autoload
\end{verbatim}
\subsection*{Attivazione}
\label{sec:orgb24a1ce}
Aggiungi le seguenti linee al tuo file di init per definire delle chiavi
\emph{globali} per tre comandi che sono utili in ogni buffer Emacs, non solo nel
buffer Org. Per favore scegli le chiavi più comode per te.
\begin{verbatim}
(global-set-key (kbd "C-c l") #'org-store-link)
(global-set-key (kbd "C-c a") #'org-agenda)
(global-set-key (kbd "C-c c") #'org-capture)
\end{verbatim}
I file con estensione \texttt{.org} sono posti in modo automatico nella modalità
Org.
\subsection*{Feedback}
\label{sec:org61a5e86}
Se riscontri dei problemi con Org o se hai delle domande, osservazioni o
idee a riguardo, per favore invia una mail alla mailing list
\url{mailto:emacs-orgmode@gnu.org}. Per informazioni su come inviare dei report
sui bug, guarda il \href{manual}{[[info:org][manuale principale}.
\section{Struttura del documento}
\label{sec:orgdcc49a7}
Org è uno schematizzato-re. La schematizzazione permette al documento
di essere organizzato in strutture gerarchiche, che, almeno per me,
sono la migliore rappresentazione delle note e dei
pensieri. Un'osservazione di questa struttura si ottiene piegando,
es. nascondendo larghe porzioni del documento per mostrarne solo la
struttura generale e la parte dove al momento si sta lavorando. Org
semplifica molto bene l'uso delle strutture comprimendo l'intera vista e
nascondendo le funzionalità con un singolo comando \texttt{org-cycle} che é
legato al tasto TAB.
\subsection{Intestazioni}
\label{sec:orgd91538d}
Le intestazioni definiscono la struttura di uno schema ad albero. Le
intestazioni in Org iniziano dal margine sinistro\footnote{Guarda la variabile \texttt{org-special-ctrl-a/e} per configurare
speciali comportamenti di C-a e C-e nei titoli.} con uno o più
asterischi seguiti da uno spazio. Per esempio:
\begin{verbatim}
* Livello iniziale dei titoli
** Secondo livello
*** Terzo livello
Un po di testo
*** Terzo livello
Altro testo
* Un'altro livello iniziale
\end{verbatim}
Nota che un'intestazione nominata dopo \texttt{org-footnote-section}, che di
default é detto \texttt{Footnotes}, é considerato come speciale. Un
sotto-albero con questa intestazione sarà ignorata silenziosamente
dalla funzione di esportazione.
Alcune persone trovano i vari asterischi troppo fastidiosi e
preferiscono uno schema con degli spazzi vuoti seguiti da un singolo
asterisco. Guarda nelle \ref{sec:orgb82de5e} per un setup che lo realizza.
\subsection{Ciclo di visualizzazione}
\label{sec:org12e9ab8}
Gli schemi rendono possibile nascondere parte del testo del buffer. Org usa
giusto due comandi, legati a TAB e S-TAB (\texttt{org-cycle} e
\texttt{org-shifttab} ) per scambiare la visibilità nel buffer.
\begin{description}
\item[{TAB (\texttt{org-cycle})}] \emph{Ciclo del sotto-albero}: Ruota il sotto-albero corrente attraverso gli stai
\begin{verbatim}
,-> CHIUSO -> FIGLI -> SOTTO-ALBERO --.
'------------------------------------'
\end{verbatim}
Quando viene chiamato con l'argomento prefisso (C-u TAB) o con
il tasto Shitf, viene invocato il ciclo globale.
\item[{S-TAB (\texttt{org-global-cycle}), C-u TAB (\texttt{org-cycle})}] \emph{Ciclo globale}: Ruota l'intero buffer attraverso gli stati
\begin{verbatim}
,-> OVERVIEW -> CONTENUTO -> MOSTRA TUTTO --.
'-------------------------------------------'
\end{verbatim}
\item[{C-u C-u C-u TAB (\texttt{org-show-all})}] Mostra tutto incluso i drawer.
Quando Emacs visita per la prima volta un file Org, lo stato globale
é settato a OVERVIEW, es. solo i livelli più alti delle intestazione
sono visibili. Questo può essere configurato tramite la variabile
\texttt{org-startup-folder} o nell'intestazione del file aggiungendo una
keyword \texttt{STARTUP} con \texttt{overview}, \texttt{content}, \texttt{shoall},
\texttt{showeverything} o \texttt{show<n>levels} (n = 2..5 ) tipo:
\begin{verbatim}
#+STARTUP: content
\end{verbatim}
\end{description}
\subsection{Movimento}
\label{sec:orge9cca99}
I comandi seguenti ti fanno saltare ad altre intestazioni nel buffer
\begin{description}
\item[{C-c C-n (\texttt{org-next-visible-heading})}] Intestazione successivo
\item[{C-c C-p (\texttt{org-previous-visible-heading})}] Intestazione precedente
\item[{C-c C-f (\texttt{org-backward-headling-same-level})}] Intestazione successivo nello stesso livello
\item[{C-c C-b (\texttt{outline-backward-same-level})}] Instestazione precedente nello stesso livello
\item[{C-c C-u (\texttt{outline-up-heading})}] Torna all'intestazione
più in alto
\end{description}
\subsection{Modificare la struttura}
\label{sec:orgcad88a0}
\begin{description}
\item[{\textbf{M-RET} (\texttt{org-meta-return})}] Inserisce un nuovo titolo con lo stesso livello del corrente. Se il
punto é una lista di oggetti, viene creato un nuovo oggetto (vedere
\ref{sec:org462886b}). Quando questo comando viene usato nel mezzo di
una linea, la linea viene divisa e il resto della linea diventa la
nuova intestazione\footnote{Se non vuoi che la linea sia divisa, personalizza la variabile
\texttt{org-M-RET-may-split-line}}
\item[{M-S-RET (\texttt{org-inser-todo-heading})}] Inserisce un nuovo oggetto TODO con lo stesso livello dell'intestazione corrente
\item[{TAB (\texttt{org-cycle}) in un oggetto vuoto}] In un nuovo oggetto che non ha ancora del testo, il TAB cicla tra i vari
livelli
\item[{M-SINISTRA (\texttt{org-metaleft}), M-DESTRA (\texttt{org-metaright})}] Promuove o retrocede l'intestazione corrente di un livello
\item[{M-SU (\texttt{org-move-subtree-up}), M-GIÙ (\texttt{org-move-subtree-down})}] Muove il sotto-albero su o giù es. scambia con il precedente o il
successivo sotto-albero nello stesso livello.
\item[{C-c C-w (\texttt{org-refile})}] Ricolloca un oggetto o una regione in una posizione differente. Vedere
\ref{sec:org2e2b0b8}.
\item[{C-x n s (\texttt{org-narrow-to-subtree}), C-x n w (\texttt{widen})}] Allarga il buffer al corrente sotto-albero e lo nasconde nuovamente
\end{description}
Quando c'è una regione attiva (Modalità Contrassegno di transito), promuove
o retrocede lavorando su tutti i titoli nella regione.
\subsection{Alberi sparsi}
\label{sec:org10abd71}
Una funzionalità importante della modalità Org é l'abilità di costruire
\emph{alberi sparsi} per le informazioni selezionate in una struttura ad albero,
in modo che l'intero documento sia piegato il più possibile, ma le
informazioni selezionate siano comunque visibili assieme alla struttura
dell'intestazione sopra di esso\footnote{Vedi anche la variabile \texttt{org-show-context-detail} per decidere
quanto contesto mostrare attorno ad ogni selezione.}. Provalo subito e vedrai immediatamente
come lavora.
La modalità Org contiene diversi comandi che creano questi alberi, a tutti
questi comandi si può accedere attraverso uno dispacher.
\begin{description}
\item[{C-c / (\texttt{org-sparse-tree})}] Mostra un prompt in cui selezionare una chiave per creare un comando di
sparse-tree
\item[{C-c / r (\texttt{org-occur})}] Mostra un prompt per un'espressione regolare (regexp) e mostra un albero
sparso con tutte le occorrenze trovate. Ogni occorrenza viene
sottolineata; La sottolineatura svanisce se si preme C-c C-c.
L'altro comando di sparse tree seleziona le intestazioni basandosi sulle
chiavi dei TODO, tags o proprietà che verrà discusso più avanti in questo
documento.
\end{description}
\subsection{Liste semplici}
\label{sec:org462886b}
Assieme gli oggetti della struttura ad albero, gli elenchi formattati
manualmente possono fornire una struttura aggiuntiva. Inoltre
forniscono un modo per creare liste selezionabili o caselle di
controllo ( vedi \ref{sec:org3cb803e} ). Org supporta la modifica di queste
liste ed ogni esportatore ( Vedi \ref{sec:orgaae776d}) può analizzarlo e
formattarlo.
Org riconosce le liste ordinate, non ordinate e descritte.
\begin{itemize}
\item Gli elementi di una lista \emph{non ordinata} iniziano con un \texttt{-}, \texttt{+} o
un \texttt{*} come puntatore.
\item Gli elementi di una lista \emph{ordinata} iniziano con un \texttt{1.} o \texttt{1)}.
\item Le liste \emph{descritte} usano \texttt{::} per separare il \emph{termine} dalla
descrizione.
\end{itemize}
Gli elementi appartenenti allo stesso elenco devono avere la stessa
indentazione sulla prima riga. Un elemento termina prima della riga
successiva che é rientrato come il su elenco/numero o meno. Un elenco
termina quanto tutti gli elementi vengono chiusi o dopo due righe
vuote.
\begin{verbatim}
* Lord of the Rings
My favorite scenes are (in this order)
1. The attack of the Rohirrim
2. Eowyn's fight with the witch king
+ this was already my favorite scene in the book
+ I really like Miranda Otto.
Important actors in this film are:
- Elijah Wood :: He plays Frodo
- Sean Astin :: He plays Sam, Frodo's friend.
\end{verbatim}
I seguenti comandi agiscono sugli elementi quando il punto si trova
nella prima riga di un elemento (la riga con il punto elenco o il
numero).
\begin{description}
\item[{TAB (\texttt{org-cycle})}] Gli elementi possono essere ripiegati come le intestazioni.
\item[{M-RET (\texttt{org-insert-heading})}] Inserisce un nuovo elemento nel livello corrente. Con un argomento
prefisso, forza una nuova intestazione ( vedere \ref{sec:orgcad88a0} ).
\item[{M-S-RET (\texttt{org-insert-todo-heading})}] Inserisce un nuovo elemento con un casella di controllo ( vedere
\ref{sec:org3cb803e} ).
\item[{M-S-SU (\texttt{org-move-item-up}), M-S-GIU (\texttt{org-move-item-down})}] Muove l'elemento, inclusi i sotto-elementi, su/giù ( spostandoli con
il precedente/successivo elemento nella medesima indentazione ). Se
la lista é ordinata, la rinumera in automatico.
\item[{M-SINISTRA (\texttt{org-do-promote}), M-DESTRA (\texttt{org-do-subtree})}] Aumenta/diminuisce l'indentazione dell'elemento, fatta esclusione
per i figli.
\item[{M-S-SINISTRA (\texttt{org-promote-subtree}), M-S-DESTRA (\texttt{org-demote-subtree})}] Aumenta/diminuisce l'indentazione dell'elemento, esclusi i figli.
\item[{C-c C-c (\texttt{org-toggle-checkbox})}] Se c'è una casella di controllo ( vedere \ref{sec:org3cb803e} ) nella linea
degli elementi, cambia lo stato della checkbox. Verificando anche i
puntatori e la consistenza del'indentazione in tutta la lista.
\item[{C-c - (\texttt{org-cycle-list-bullet})}] Scorre tra la lista dei livelli degli elementi attraverso
differenti tipi di puntatori ( \texttt{-}, \texttt{+}, \texttt{*}, \texttt{1.}, \texttt{1)}).
\end{description}
\section{Tabelle}
\label{sec:org039a4ee}
Org ha un editor di tabelle veloce ed intuitivo. Come per i fogli di
calcolo sono supportati i calcoli, in connessione con il pacchetto
Emacs Calc (vedere \href{https://www.gnu.org/software/emacs/manual/html\_mono/calc.html\#Top}{GNU Emacs Calculator Manuale} ).
Org rende facile formattare le tabelle in semplice codice ASCII. Ogni
linea con \texttt{|} come primo carattere senza spazi viene considerato come
parte di una tabella. Il carattere \texttt{|} é anche un separatore di
colonne. Una tabella si presenta in questo modo:
\begin{verbatim}
| Name | Phone | Age |
|-------+-------+-----|
| Peter | 1234 | 17 |
| Anna | 43212 | 25 |
\end{verbatim}
Una tabella viene riallineata automaticamente ogni volta che viene
premuto TAB o RET oppure C-c C-c
quando ci si trova all'interno della tabella. Il TAB
inoltre muove il punto al campo successivo ( RET alla riga
successiva ) e crea nuove righe alla fine della tabella o prima delle
linee orizzontali. L'indentation di una tabella é settata nella prima
linea. Ogni linea che inizia con un \texttt{|-} é considerata un separatore
orizzontale e viene espanso al successivo riallineamento per occupare
tutta la larghezza della tabella. Quindi per creare la tabella
precedente devi solo digitare
\begin{verbatim}
|Name|Phone|Age|
|-
\end{verbatim}
e premere TAB per allineare la tabella ed iniziare a
riempire i campi. Per voler essere più veloce digita \texttt{|Name|Phone|Age}
seguito da C-c RET.
Quando digiti un testo in un campo, Org tratta DEL,
Backspace e tutti gli altri caratteri, in un modo speciale,
in modo che l'inserimento e la cancellazione non sposti gli altri
campi. Inoltre quando digiti, \emph{subito dopo che il punto viene mosso in
un nuovo campo con TAB, S-TAB o RET},
il campo viene automaticamente creato bianco.
\subsection*{Creazione e conversione}
\label{sec:org3f50e5e}
\begin{description}
\item[{C-c | (\texttt{org-table-create-or-convert-from-regio})}] Converte la regione attiva in una tabella. Se ogni linea contiene
almeno un carattere TAB, la funzione assume che le cose
siano separate da tab. Se ogni linea é separata da virgola (CSV)
assume che sia un file separato da virgole. Altrimenti, le linee sono
divise in capi tramite gli spazzi bianchi.
Se non ci sono regioni attive, questo comando crea una tabella Org
vuota. Ma é più facile inserendo | N a m e | P h o n e | A g e RET | - TAB.
\end{description}
\subsection*{Ri-allineamento e spostamento dei campi}
\label{sec:orgb5b7cd0}
\begin{description}
\item[{C-c C-c (\texttt{org-table-align})}] Ri-allinea la tabella senza spostare il punto.
\item[{TAB (\texttt{org-table-next-field})}] Ri-allinea la tabella, muovendosi nel campo successivo. Crea una
nuova riga se necessario.
\item[{S-TAB (\texttt{org-table-previous-field})}] Ri-allinea la tabella, muovendo nel campo precedente.
\item[{RET (\texttt{org-table-next-row})}] Ri-allinea la tabella e muove in basso nella riga
successiva. Creando una nuova riga se necessario.
\item[{S-SU (\texttt{org-table-move-cell-up}), S-GIU (\texttt{org-table-move-cell-down}), S-SINISTRA (\texttt{org-table-move-cell-left}), S-DESTRA (\texttt{org-table-move-cell-right})}] Muove le celle su, giù, a sinistra e a destra spostando la cella adiacente.
\end{description}
\subsection*{Modifica colonne e righe}
\label{sec:org862f73e}
\begin{description}
\item[{M-SINISTRA (\texttt{org-table-move-column-left}), M-DESTRA (\texttt{org-table-move-column-right})}] Muove la colonna corrente a sinistra/destra.
\item[{M-S-SINISTRA (\texttt{org-table-delete-column})}] Elimina la colonna corrente.
\item[{M-S-DESTRA (\texttt{org-table-insert-column})}] Inserisce una nuova colonna a sinistra della posizione del punto.
\item[{M-SU (\texttt{org-tablet-move-row}), M-GIU (\texttt{org-tablet-move-row-down})}] Muove la riga corrente su/giù.
\item[{M-S-SU (\texttt{org-table-kill-row})}] Elimina la riga corrente o la linea orizzontale.
\item[{M-S-GIU (\texttt{org-table-insert-row})}] Inserisce una nuova riga sopra la corrente. Con un argomento
prefisso la linea viene creata sotto la corrente.
\item[{C-c - (\texttt{org-table-insert-hline})}] Inserisce una linea sotto la corrente. Con un argomento prefisso la
linea viene creata sopra la corrente.
\item[{C-c RET (\texttt{org-table-hline-and-move})}] Inserisce una linea sotto la corrente e muove il punto nella riga
sotto questa linea.
\item[{C-c \^{} (\texttt{org-table-sort-lines})}] Ordina le linee della tabella in regioni. La posizione del punto
indica la colonna da usare per l'ordinamento ed il range delle linee
é il range delle linee tra le linee orizzontali più vicine o
l'intera tabella.
\end{description}
\section{Collegamenti ipertestuali}
\label{sec:orgd2358b9}
Come nell'HTML, Org fornisce i link all'interno di un file, link
esterni ad altri file, articoli Usenet, email e molto altro.
Org riconosce i semplici URIs, é possibile racchiuderli tra parentesi
quadrate ed attivarli come link cliccabili. Il formato generale dei
link si presenta simile a questo:
\begin{verbatim}
[[LINK][DESCRIZIONE]]
\end{verbatim}
od in alternativa
\begin{verbatim}
[[LINK]]
\end{verbatim}
Quando un link nel buffer é completo, con tutte le parentesi, Org
cambia la sua visualizzazione con \texttt{DESCRIZIONE} al posto di
\texttt{[[LINK][DESCRIZIONE]]} e in \texttt{LINK} al posto di \texttt{[[LINK]]}. Per
modificare la parte invisibile del LINK usa C-c C-l con il punto sul link.
\subsection*{Link interni}
\label{sec:org8b21239}
Se i link non sono rappresentati come URI, vengono considerati come
interni al file corrente. Il caso più rilevante é un link tipo
\texttt{[[\#my-custom-id]]} che viene collegato ad un elemento con la
proprietà \texttt{CUSTOM\_ID} settata a \texttt{my-custom-id}.
Link tipo \texttt{[[My Target]]} o \texttt{[[My Targhet][Find my target]]} cerca,
nel file corrente, un testo che corrisponda al targhet \texttt{<{}<{}My
Target>{}>{}}.
\subsection*{Link esterni}
\label{sec:org42fa705}
Org supporta i link ai file, siti web, Usenet, messaggi email, elementi
BBDB database e sia le conversazioni che i logs IRC. I collegamenti
sono simili agli URL. Iniziano con una breve stringa di
identificazione seguita dai due-punti \textbf{:}. Non ci sono spazzi dopo i
due-punti. Ecco alcuni esempi:
\begin{center}
\begin{tabular}{ll}
\texttt{http://www.astro.uva.nl/=dominikper} & Nel web\\[0pt]
\texttt{file:/home/dominik/images/jupiter.jpg} & file, path assoluta\\[0pt]
\texttt{/home/dominik/images/jupiter.jpg} & come sopra\\[0pt]
\texttt{file:papers/last.pdf} & file, path relativa\\[0pt]
\texttt{./papaers/last.pdf} & come sopra\\[0pt]
\texttt{file:project.org} & un'altro file org\\[0pt]
\texttt{docview:papers/last.pdf::NNN} & apre in modalità DocView alla pagina NNN\\[0pt]
\texttt{id:B7423F4D-2E8A-471B-8810-C40F074717E9} & link ad un titolo con ID\\[0pt]
\texttt{news:comp.emacs} & Usenet link\\[0pt]
\texttt{mailto:adent@galaxy.net} & link mail\\[0pt]
\texttt{mhe:folder\#id} & link messaggio MH-E\\[0pt]
\texttt{rmail:folder\#id} & link messaggio Rmail\\[0pt]
\texttt{gnus:gruop\#id} & link articolo Gnus\\[0pt]
\texttt{bbdb:R.*Stalman} & link BBDB (con regexp)\\[0pt]
\texttt{irc:/irc.com/\#emacs/bob} & link IRC\\[0pt]
\texttt{info:org\#Hyperlink} & link nodo Info\\[0pt]
\end{tabular}
\end{center}
I collegamento ai file possono contenere informazioni addizionali per
consentire ad Emacs di saltare ad una particolare posizione nel file
quando si segue un link. Questa può essere un numero di linea o un
opzione di ricerca dopo i due due-punti. Di seguito alcuni esempi,
assieme alle spiegazioni:
\begin{center}
\begin{tabular}{ll}
\texttt{file:\textasciitilde{}/code/main.c::255} & Trova la linea 255\\[0pt]
\texttt{file:\textasciitilde{}/xx.org::My Target} & Trova \texttt{=<{}<{}My Target>{}>{}=}\\[0pt]
\texttt{[[file:\textasciitilde{}/xx.org::\#my-custom-id]]} & Trova l'elemento con l'ID personalizzato\\[0pt]
\end{tabular}
\end{center}
\subsection*{Manipolare i collegamenti}
\label{sec:orgea98d60}
Org fornisce un modo per creare link con la sintassi corretta, per
inserirla in un file Org e per seguire il link.
La funzione principale é \texttt{org-store-link} richiamabile con M-x org-store-link. Per la sua importanza, suggeriamo di abbinarlo ad
una combinazione più comoda ( vedere \hyperref[sec:orgb24a1ce]{Attivazione}
). Salva un link nella posizione attuale. Il link viene salvato per
essere successivamente inserito in un buffer Org -- vedi sotto.
Da un buffer Org, i comandi seguenti creano, navigano o, più
generalmente, agiscono sui link.
\begin{description}
\item[{C-c C-l (\texttt{org-insert-link})}] Inserisce un link. Questo richiede un link che sarà inserito nel
buffer. Puoi inserire il link o usare la history SU e
GIU per accedere ai link salvati. Richiederà la parte di
descrizione per il link.
Quando chiamato con l'argomento prefisso C-u il
completamento dei nomi viene usato per l'inserimento di un nome di
file.
\item[{C-c C-l (Che punta ad un link esistente) (\texttt{org-insert-link})}] Quando il punto é su un link esistente, C-c C-l permette la
modifica del link e della parte della descrizione.
\item[{C-c C-o (\texttt{open-link-at-point})}] Apre il link su cui si si trova.
\item[{C-c \& (\texttt{org-mark-ring-goto})}] Torna indietro a una posizione registrata. Una posizione é
registrata tramite il comando di link interno e tramite C-c \%. Usando questo comando più volte in diretta successione si
muove attraverso un anello di posizioni precedenti.
\end{description}
\section{Elementi TODO}
\label{sec:org57f3545}
Org mode non necessita che le liste TODO risiedano in documenti
separati. Tant'è che gli elementi TODO sono parte del file di note,
perché gli elementi TODO vengono solitamente usati quando si prendono
note! Con la modalità Org, semplicemente si marca un oggetto in un
albero mettendo all'inizio un elemento TODO. In questo modo, le
informazioni non vengono duplicate e gli elementi TODO rimangono nel
contesto in modo che emergano.
La modalità Org ti fornisce dei metodi per una visione d'insieme
delle cose che devi fare, raccogliendoli da diversi file.
\subsection[TODO Basics]{Funzionalità base dei TODO}
\label{sec:orgcfb6ead}
Un'intestazione é un elemento TODO quando inizia con la parola \texttt{TODO},
per esempio:
\begin{verbatim}
*** TODO Write letter to Sam Fortune
\end{verbatim}
I comandi più importanti quando si lavora con i TODO sono:
\begin{description}
\item[{C-c C-t (\texttt{org-todo})}] Cambia lo stato del TODO dell'elemento corrente
\begin{verbatim}
,-> (non segnato) -> TODO -> DONE --.
'-----------------------------------'
\end{verbatim}
La stessa rotazione può anche essere fatta ``da remoto'', dal buffer
dell'agenda, tramite la chiave t ( vedi \ref{sec:orge996076} ).
\item[{S-RIGHT (\texttt{org-shiftright}), S-LEFT (\texttt{org-shiftleft})}] Seleziona il seguente/precedente stato TODO, similmente al ciclo.
\item[{C-c / t (\texttt{org-show-todo-tree})}] Visualizza gli elementi TODO in un \emph{albero sparso} ( vedi \ref{sec:org10abd71} ). Piega l'intero buffer ma mostra tutti gli elementi
TODO - con uno stato non-DONE - e la gerarchia delle intestazioni
sopra di loro.
\item[{M-x org-agenda t (\texttt{org-todo-list})}] Mostra la lista globale dei TODO. Colleziona tutti gli elementi TODO
( con stato non-DONE ) da tutti i file agenda ( vedi
\ref{sec:org42aa4c4} ) in un unico buffer. Vedi \ref{sec:org07e6dd3} per maggiori informazioni.
\item[{S-M-RET (\texttt{org-insert-todo-heading})}] Inserisce un nuovo oggetto TODO sotto al corrente.
\end{description}
Cambiando lo stato di un TODO può anche cambiare i tag. Vedi la
docstring dell'opzione \texttt{org-todo-state-tags-triggers} per dettagli.
\subsection{Workflow multi-stato}
\label{sec:org2c9a7e0}
Puoi usare le parole chiave TODO per indicare uno stato di lavoro
\emph{sequenziale}:
\begin{verbatim}
(setq org-todo-keywords
'((sequence "TODO" "FEEDBACK" "VERIFY" "|" "DONE" "DELEGATED")))
\end{verbatim}
La barra verticale separa le keyword \texttt{TODO} ( stati che \emph{necessitano
azioni} ) da quelle \texttt{DONE} ( che \emph{non necessitano future azioni} ). Se
non fornisci una barra di separazione, l'ultimo stato viene usato come
stato \texttt{DONE}. Con questo setup, il comando C-c C-t cicla un
oggetto da \texttt{TODO} a \texttt{FEEDBACK} quindi \texttt{VERIFY} ed in fine \texttt{DONE} e
\texttt{DELEGATED}.
A volte vorresti usare, contemporaneamente, diversi insiemi di parole chiave
TODO. Per esempio, potresti voler avere il basico \texttt{TODO=/=DONE}, ma
anche un workflow per il bug fix. Il tuo setup potrebbe essere simile
a questo:
\begin{verbatim}
(setq org-todo-keywords
'((sequence "TODO(t)" "|" "DONE(d)")
(sequence "REPORT(r)" "BUG(b)" "KNOWNCAUSE(k)" "|" "FIXED(f)")))
\end{verbatim}
Le keyword dovrebbero essere tutte differenti, questo aiuta Org mode a
tenere traccia di quale sotto-sequenza debba essere usata dall'oggetto
dato. L'esempio mostra, anche, come definire delle chiavi per un
accesso più veloce ad un particolare stato, aggiungendo una lettera
tra parentesi dopo ogni parola chiave - riceverai un prompt dopo aver
premuto C-c C-t.
Per definire delle keyword TODO che siano valide solo in un singolo
file, usa il seguente testo in una qualsiasi parte del file.
\begin{verbatim}
#+TODO: TODO(t) | DONE(d)
#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)
#+TODO: | CANCELED(c)
\end{verbatim}
Dopo aver cambiato una di queste linee, usa C-c C-c con il
cursore nella linea dove hai fatto il cambiamento per farlo conoscere
alla modalità Org.
\subsection{Registrazioni dei progressi}
\label{sec:orgbe8daf9}
Per registrare un timestamp e una nota quando cambi lo stato di un
TODO, esegui il comando \texttt{org-todo} con un argomento prefisso.
\begin{description}
\item[{C-u C-c C-t (\texttt{org-todo})}] Fornisce un prompt per una nota e registra il tempo in cui é stato
cambiato lo stato del TODO.
\end{description}
Org mode può anche registrare automaticamente un timestamp e
opzionalmente una nota quando segni un elemento TODO come DONE, o ogni
volta che cambi lo stato di un elemento TODO. Questo sistema é
altamente configurabile, le impostazioni possono essere basate su una
parola chiave e possono essere localizzate in un file o ogni
sotto-albero. Per maggiori informazioni su come cronometrare il tempo
di lavoro vedi \ref{sec:orgbe53bba}.
\subsubsection*{Chiudere un elemento}
\label{sec:orge9b7363}
La più semplice registrazione é tenere traccia di \emph{quando} un certo
elemento TODO é segnato come completato. Questo può essere fatto
con\footnote{L'impostazione corrispondente nel buffer é \texttt{\#+STARTUP: logdone}.}
\begin{verbatim}
(setq org-log-done 'time)
\end{verbatim}
Nel momento in cui modifichi lo stato di un oggetto da TODO ( non
fatto ) in uno degli stati DONE, una linea \texttt{CLOSED: [timestamp]} viene
inserita subito sotto l'intestazione.
Se vuoi registrare una nota con il timestamp usa\footnote{L'impostazione corrispondente nel buffer é \texttt{\#+STARTUP:
logenotedone}.}
\begin{verbatim}
(setq org-log-done 'note)
\end{verbatim}
Ti verrà mostrato un prompt dove inserire la nota e questa nota sarà
registrata sotto l'oggetto con un'intestazione \texttt{Closing Note}.
\subsubsection*{Tenere traccia degli stati TODO}
\label{sec:org3895a1f}
Potresti voler tenere traccia dello stato del TODO. Puoi registrare
solo un timestamp o un timestamp con nota per un cambiamento. Queste
registrazioni sono inserite dopo il titolo come elementi di
lista. Quando prendi una gran quantità di note, potresti volere tenere
le note esternamente in un drawer. Per questa funzionalità customizza
la variabile \texttt{org-log-into-drawer}.
Per la registrazioni dello stato, Org mode si basa sulla
configurazione delle parole chiave. Questo si ottiene aggiungendo un
marker speciale \textbf{!} ( per il timestamp ) e \textbf{@} ( per le note ) tra
parentesi dopo ogni parola chiave. Per esempio:
\begin{verbatim}
#+TODO: TODO(t) WAIT(w@/!) | DONE(d!) CANCELLED(c@)
\end{verbatim}
definendo le keyword TODO e le chiavi per l'accesso rapido, è anche
richiesto che un tempo sia registrato quando un oggetto viene settato
a \texttt{DONE}, e che una nota sia registrata quando si cambia a \texttt{WAIT} o
\texttt{CANCELED}. La stessa sintassi funziona anche quando setti
\texttt{org-todo-keywords}.
\subsection{Priorità}
\label{sec:orgaf03c77}
Se usi la modalità Org in maniera estesa, potresti trovarti con tanti
elementi TODO e quindi potrebbe aver senso dargli delle priorità. Si
possono dare priorità mettendo un \emph{priority cookie} nell'intestazione
dell'elemento TODO, tipo questo:
\begin{verbatim}
*** TODO [#A] Write letter to Sam Fortune
\end{verbatim}
Org mode supporta tre priorità \texttt{A}, \texttt{B} e \texttt{C}. \texttt{A} è la più alta, \texttt{B}
quella di default se non specificata. Le priorità creano una
differenza solo nell'agenda.
\begin{description}
\item[{C-c , (\texttt{org-priority})}] Imposta la priorità nell'intestazione corrente. Premi A,
B o C per selezionare la priorità o \texttt{SPC} per
rimuovere il cookie.
\item[{S-SU (\texttt{org-priority-up}); S-GIU (\texttt{org-priority-down})}] Aumentano/diminuiscono la priorità dell'intestazione corrente.
\end{description}
\subsection[Breaking Down Tasks]{Dividi i compiti in sotto compiti}
\label{sec:org611fd63}
A volte é consigliabile dividere i grandi compiti in compiti più
piccoli, e gestibili. Puoi farlo creando una struttura
ad albero con sotto-elementi TODO, con dettagliati i sotto-compiti
dell'albero. Per avere un'anteprima della frazione dei sotto-compiti
che hai già segnato come fatti, inserisci \texttt{[/]} o \texttt{[\%]} dove vuoi
nell'intestazione. Questi cookie saranno aggiornati ogni volta che lo
stato dei TODO figli cambia o quando premi C-c C-c nel
cookie. Per esempio:
\begin{verbatim}
* Organizzare un party [33%]
** TODO Chiamare le persone [1/2]
*** TODO Peter
*** DONE Sarah
** TODO Buy food
** DONE Parlare con il vicino
\end{verbatim}
\subsection{Liste selezionabili}
\label{sec:org3cb803e}
Ogni elemento in una lista ( vedi \ref{sec:org462886b} ) può essere
trasformata in una casella di controllo ( checkbox ) che deve iniziare con
la stringa \texttt{[ ]}. Le checkbox non sono incluse nella lista di TODO
globale, sono molto comode per dividere un compito in un numero di
semplici step.
Qui c'è un esempio di una lista di checkbox.
\begin{verbatim}
* TODO Organizzare un party [2/4]
- [-] Chiamare le persone
- [ ] Peter
- [X] Sarah
- [X] Ordinare il cibo
\end{verbatim}
Le caselle di controllo lavorano in maniera gerarchica, quindi se un
elemento checkbox ha figli che sono checkbox, attivando una casella di
controllo figlia si fa in modo che nella casella di controllo padre
venga riflesso se nessuno, alcuni o tutti i figli sono stati selezionati.
I seguenti comandi operano con le checkbox:
\begin{description}
\item[{C-c C-c, C-u C-c C-c (\texttt{org-toggle-checkbox})}] Aggiorna lo stato di una checkbox o---con un argomento
prefisso---cambia la presenza della checkbox nel punto.
\item[{M-S-RET (\texttt{org-insert-todo-heading})}] Inserisce un nuovo elemento con una checkbox. Questo funziona solo
se ci si trova in un elemento della lista ( vedi \ref{sec:org462886b} ).
\end{description}
\section{TAG}
\label{sec:org56e6514}
Un modo eccellente per implementare le label ed i contesti, per le
informazioni incrociate correlate, é quello di assegnare dei \emph{tag} alle
intestazioni. La modalità Org ha un supporto molto esteso per i tag.
Ogni intestazione può contenere una lista di tag; sono messi alla fine
delle intestazioni. I tag sono normali parole che contengono lettere,
numeri, \texttt{\_} e \texttt{@}. I tag sono preceduti e succeduti da un singolo
due-punti, es. \texttt{:work:}. Alcuni tag possono essere specificati come in
\texttt{:work:urgent:}. I tag di default sono in grassetto dello stesso
colore dell'intestazione.
\subsection*{Ereditare i tag}
\label{sec:orge04d1cb}
I tag usano la struttura gerarchica dell'albero di outline. Se
un'intestazione ha un certo tag, tutti i sottotitoli ereditano il
tag. Per esempio nella lista
\begin{verbatim}
* Incontro con il gruppo Francese :work:
** Sommario di Frank :boss:notes:
*** TODO Prepara le slide per lui :action:
\end{verbatim}
l'intestazione finale ha i tag \texttt{work}, \texttt{boss}, \texttt{notes} ed \texttt{action} anche se nel titolo finale non vengono segnati
questi tag.
Puoi anche impostare i tag che tutte gli elementi nel file devono
ereditare semplicemente come se questi tag fossero definiti in un
ipotetico livello zero che sovrasta l'intero file. Usando una linea
del genere\footnote{Come tutto nelle impostazioni del buffer, premendo C-c C-c si attivano i cambiamenti nella linea.}:
\begin{verbatim}
#+FILETAGS: :Peter:Boss:Secret:
\end{verbatim}
\subsection*{Impostare i tag}
\label{sec:orge2470ab}
I tag possono essere semplicemente inserite nel buffer alla fine di
una intestazione. Dopo i due-punti, M-TAB offre il completamento dei
tag. Ci sono anche altri comandi speciali per inserire i tag:
\begin{description}
\item[{C-c C-q (\texttt{org-set-tags-command})}] Inserisce un nuovo tag nel titolo corrente. Org mode, inoltre, offre
il completamento o una speciale singola-chiave di interfaccia per
impostare i tag, vedi sotto.
\item[{C-c C-c (\texttt{org-set-tags-command})}] Quando il punto é in un'intestazione, questo compie la stessa azione di
C-c C-q.
\end{description}
Org supporta l'inserimento dei tag da una \emph{lista di tag}. Di default
questa lista é costruita dinamicamente, contiene tutti i tag usati, al
momento, nel buffer. Puoi anche specificare una lista fissa globale
con la variabile \texttt{org-tag-alist}. In fine puoi impostare i tag di
default da mettere in un file usando la keyword \texttt{TAGS}, tipo
\begin{verbatim}
#+TAGS: @work @home @tennisclub
#+TAGS: laptop car pc sailboat
\end{verbatim}
Di default Org mode usa la funzionalità standard di completamento del mini-buffer per inserire i
tag. Comunque, implementa anche un'altro metodo di selezione, veloce, del tag chiamato \emph{fast tag
selection}. Questo ti permette di selezionare e deselezionare i tag con solo una pressione di
una singola chiave. Per questo scopo é bene assegnare una singola lettera ai tuoi tag più
comunemente usati. Puoi fare questo globalmente configurando la variabile \texttt{org-tag-alist} nel tuo file
di init di Emacs. Per esempio, puoi trovare utile assegnare a degli elementi in diversi file con
\texttt{@home}. In questo caso puoi impostare qualcosa di simile:
\begin{verbatim}
(setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))
\end{verbatim}
Se il tag é rilevante solo per il file su cui stai lavorando, allora
puoi inserire ed impostare la keyword \texttt{TAGS} come:
\begin{verbatim}
#+TAGS: @work(w) @home(h) @tennisclub(t) laptop(l) pc(p)
\end{verbatim}
\subsection*{Raggruppare i tag}
\label{sec:org44dd320}
Un tag può essere definito come un \emph{gruppo di tag} per un insieme di
altri tag. Il gruppo di tag può essere visto come il ``termine più
ampio'' per un insieme di tag.
Puoi impostare un gruppo di tag usando le parentesi ed inserendo i
due-punti tra il gruppo di tag ed i tag relazionati:
\begin{verbatim}
#+TAGS: [ GTD : Control Presp ]
\end{verbatim}
o se i tag nel gruppo sono mutualmente esclusivi:
\begin{verbatim}
#+TAGS: { Context : @Home @Work }
\end{verbatim}
Quando cerchi per un gruppo di tag, ti vengono ritornati tutti i membri del gruppo e i
sottogruppi. Nella visualizzazione agenda, filtrando per un gruppo di tag mostra o nasconde i titoli
segnati con almeno uno dei membri, del gruppo o ognuno dei sottogruppi.
Se vuoi, temporaneamente, ignorare i gruppi di tag, cambia il gruppo
dei dag supportati con \texttt{org-toggle-tags-groups}, mappato con
C-c C-x q.
\subsection*{Ricerca dei tag}
\label{sec:org40328a4}
\begin{description}
\item[{C-c / m o C-c $\backslash$ (\textasciitilde{} org-match-sparse-tree\textasciitilde{})}] Crea un albero sparso con tutte le intestazioni che corrispondono ad
un tag cercato. Con un argomento prefisso C-u, ignora le
intestazioni che non sono una linea TODO.
\item[{M-x org-agenda m (\texttt{org-tags-views})}] Crea una lista globale di tag corrispondenti, da tutti i file
dell'agenda. vedi \ref{sec:orgcab3792}.
\item[{M-x org-agenda M (\texttt{org-tags-views})}] Crea una lista globale di tag corrispondenti, da tutti i file
dell'agenda, ma controlla solo gli elementi TODO.
\end{description}
Tutti questi comandi richiedono una stringa di corrispondenza che
rispetti la logia booleana di base \texttt{+boss+urgent-project1}, per
trovare gli elementi con i tag \texttt{boss} e \texttt{urgent}, ma non \texttt{project},
oppure \texttt{Kathy|Sally} per trovare un elemento che sia segnato come
\texttt{Kathy} o \texttt{Sally}. La sintassi completa per cercare queste stringhe é
ricca e permette anche la ricerca all'interno di keyword TODO, di
livelli e di proprietà. Per una più dettagliata descrizione con
diversi esempi, vedi \ref{sec:orgcab3792}.
\section{Proprietà}
\label{sec:org0c8f5dd}
Le proprietà sono un associazione di chiave-valore associate ad un
oggetto. Risiedono in speciali drawer con nome \texttt{PROPERTIES}. Ogni
proprietà è specificata su una linea singola, con la chiave prima (
circondata dai due-punti ) ed il valore dopo.
\begin{verbatim}
* CD collection
** Classic
*** Goldberg Variations
:PROPERTIES:
:Title: Goldberg Variations
:Composer: J.S. Bach
:Publisher: Deutsche Grammophon
:NDisks: 1
:END:
\end{verbatim}
Potresti definire i valori permessi per una particolare proprietà
\texttt{Xyz} settando una proprietà \texttt{Xyz\_ALL}. Questa speciale proprietà è
\emph{ereditata}, quindi se lo imposti nell'oggetto di livello 1, viene
applicato agli oggetti dell'albero. Quando i valori permessi sono
definiti, l'impostazione della corrispondente proprietà diventa più
semplice e meno soggetta ad errori di battitura. Per l'esempio con la
collezione di CD, possiamo predefinire la casa discografica ed il
numero di dischi nella custodia tipo:
\begin{verbatim}
* CD collection
:PROPERTIES:
:NDisks_ALL: 1 2 3 4
:Publisher_ALL: "Deutsche Grammophon" Philips EMI
:END:
\end{verbatim}
Se vuoi impostare una proprietà che può essere ereditata da ogni
oggetto nel file, usa una linea tipo:
\begin{verbatim}
#+PROPERTY: NDisks_ALL 1 2 3 4
\end{verbatim}
Il seguente comando aiuta a lavorare con le proprietà:
\begin{description}
\item[{C-c C-x p (\texttt{org-set-property})}] Imposta una proprietà. Questo richiede un nome ed un valore.
\item[{C-c C-c d (\texttt{org-delete-property})}] Rimuove una proprietà dall'oggetto corrente.
\end{description}
Per creare un albero sparso e liste speciali con la selezione basata
sulle proprietà, gli stessi comandi sono usati per cercare tag ( vedi
\ref{sec:org56e6514} ) . La sintassi per la stringa di ricerca è descritta nella
sezione \ref{sec:orgcab3792}.
\section{Data e orario}
\label{sec:org1c5e9f6}
Per assistere la pianificazione, gli elementi TODO possono essere
etichettati con una data e/o un orario. La speciale stringa formattata
trasporta le informazioni di data ed orario chiamata, in Org mode,
timestamp. Questo può creare un po di confusione in quanto il
timestamp é usato, a volte, per indicare quando qualcosa é stato
creato o l'ultima modifica. Comunque, nella modalità Org questo
termine viene usato in questo senso più ampio.
Il timestamp può essere usato per pianificare appuntamenti, schedulare
impegni, impostare scadenze, tracciare il tempo ed altro. La sezione
seguente descrive il formato timestamp e gli strumenti che Org mode ci
mette a disposizione per i casi d'uso che riguardano il tempo e gli
intervalli di tempo.
\subsection{Timestamp}
\label{sec:org78352b1}
Un timestamp é una specifica data---possibilmente con un orario o un
range di orari---in uno speciale formato, come \texttt{<2003-09-16 Tue>} o
\texttt{<2003-09-16 Tue 09:39>} oppure \texttt{<2003-09-16 Tue 12:00-12:30>}.
Un timestamp può essere inserito ovunque nelle intestazioni o nel corpo di un