compito - Online nel cloud

PROGRAMMA:

NOME

task - Un gestore di attività da riga di comando.

SINOSSI

compito [ | ]
compito --versione

DESCRIZIONE

Taskwarrior è un gestore di elenchi di cose da fare da riga di comando. Mantiene un elenco di attività che tu
vogliono fare, permettendoti di aggiungerli/rimuoverli e di manipolarli in altro modo. Taskwarrior ha un
ricco set di sottocomandi che ti permettono di fare varie cose con esso.

Al centro, Taskwarrior è un programma di elaborazione di elenchi. Aggiungi testo e altri elementi correlati
parametri e visualizzare nuovamente le informazioni in modo piacevole. Si trasforma in un programma di liste di cose da fare
quando aggiungi date di scadenza e ricorrenza. Si trasforma in un programma organizzato di elenchi di cose da fare quando
aggiungi priorità, tag (descrittori di una parola), gruppi di progetto, ecc.

FILTRO

Il è costituito da zero o più criteri di ricerca che selezionano le attività. Ad esempio, a
elenca tutte le attività in sospeso appartenenti al progetto 'Home':

progetto compito: elenco Home

Puoi specificare più termini di filtro, ognuno dei quali limita ulteriormente il risultato:

progetto compito: casa + elenco giardino del fine settimana

Questo esempio applica tre filtri: il progetto 'Home', il tag 'weekend' e il
la descrizione o le annotazioni devono contenere la sequenza di caratteri 'giardino'. In questo esempio,
'giardino' è tradotto internamente in:

descrizione.contiene:giardino

come comoda scorciatoia. Il 'contiene' qui è un modificatore di attributo, che viene utilizzato per
esercitare un controllo maggiore sul filtro rispetto alla semplice assenza o presenza. Vedi la sezione
'ATTRIBUTE MODIFIERS' di seguito per un elenco completo dei modificatori.

Si noti che un filtro può avere zero termini, il che significa che tutte le attività si applicano al comando.
Questo può essere pericoloso e questo caso speciale è confermato e non può essere ignorato. Per
esempio, questo comando:

compito modificare + lavoro
Questo comando non ha filtri e modificherà tutte le attività. Sei sicuro? (si No)

aggiungerà il tag 'lavoro' a tutte le attività, ma solo dopo la conferma.

Altri esempi di filtri:

compito
compito 28
compito + fine settimana
compito progetto:Casa scadenza.prima:oggi
task ebeeab00-ccf8-464b-8b58-f7f2d606edfb <command> <mods>

Per impostazione predefinita, gli elementi di filtro sono combinati con un operatore 'and' implicito, ma 'or' e
'xor' può anche essere usato, purché le parentesi siano incluse:

attività '( /[Cc]at|[Dd]og/ o /[0-9]+/ )'

Le parentesi isolano il termine logico da qualsiasi filtro di comando predefinito o implicito
filtro di report che verrebbe combinato con una "e" implicita.

Un filtro può mirare ad attività specifiche utilizzando numeri ID o UUID. Per specificare più attività
utilizzare uno di questi moduli (elenco separato da spazi di numeri ID, numeri UUID o intervalli ID):

compito 1 2 3 elimina
attività 1-3 informazioni
compito 1 2-5 19 modifica pri:H
task 4-7 ebeeab00-ccf8-464b-8b58-f7f2d606edfb info

MODIFICHE

Il consistono in zero o più modifiche da applicare alle attività selezionate, come ad esempio:

compito progetto:Casa
compito +weekend +giardino in scadenza:domani
compito Descrizione/testo dell'annotazione
compito /da/a/ <- sostituisci la prima corrispondenza
compito /from/to/g <- sostituisci tutte le corrispondenze

SOTTOCOMANDI

Taskwarrior supporta diversi tipi di comandi. Ci sono comandi di lettura, scrittura
comandi, comandi vari e comandi di supporto dello script. I comandi di lettura non consentono
modifica dei compiti. I comandi di scrittura possono alterare quasi ogni aspetto di un'attività. sceneggiatura
i comandi di supporto sono forniti per aiutarti a scrivere script aggiuntivi, ad esempio shell
completamento (viene generato solo un output minimo, come con verbose=nothing).

LEGGI SOTTOCOMANDI

I report sono sottocomandi di lettura. Ci sono diversi rapporti attualmente predefiniti in
Taskwarrior. L'output e il comportamento di ordinamento di questi report possono essere configurati nel
file di configurazione. Vedi anche la pagina man taskrc(5). Ci sono anche altre letture
sottocomandi che non sono report.

compito --versione
Questo è l'unico argomento convenzionale della riga di comando supportato da Taskwarrior e
è destinato agli script aggiuntivi per verificare il numero di versione di un installato
Taskwarrior senza invocare i meccanismi che creano i file predefiniti.

compito
Senza alcun comando specificato, viene eseguito il comando predefinito e viene applicato il filtro.

compito attivo
Mostra tutte le attività che corrispondono al filtro che sono state avviate ma non completate.

compito contro tutti i
Mostra tutte le attività che corrispondono al filtro, inclusi i genitori delle attività ricorrenti.

compito bloccato
Mostra tutte le attività corrispondenti al filtro, attualmente bloccate da altre attività.

compito blocco
Mostra tutte le attività che corrispondono al filtro, che bloccano altre attività.

compito burndown.quotidiano
Mostra un grafico burndown, per giorno.

compito burndown.settimanale
Mostra un grafico burndown, per settimana. Nota che 'burndown' è un alias del
rapporto 'burndown.weekly'.

compito burndown.mensile
Mostra un grafico burndown, per mese.

compito calendario [dovuto| | ] [Y]
Mostra un calendario mensile con le attività in scadenza contrassegnate. Mostra una linea orizzontale di
mesi. Se viene fornito l'argomento 'y', mostrerà almeno un anno completo. Se
viene fornito un anno, ad esempio "2015", quindi viene mostrato l'intero anno. Se entrambi un mese
e un anno ('6 2015'), quindi i mesi visualizzati iniziano al
mese e anno specificati. Se viene fornito l'argomento 'due', mostrerà il
mese di inizio della prima attività in scadenza.

compito Colori [campione | leggenda]
Visualizza tutti i colori possibili, un campione denominato o una legenda contenente tutti attualmente
colori definiti.

compito colonne [sottostringa]
Visualizza tutte le colonne e gli stili di formattazione supportati. Utile quando si crea personalizzato
rapporti. Se viene fornita una sottostringa, vengono visualizzati solo i nomi di colonna corrispondenti.

compito comandi
Mostra tutti i comandi supportati, con alcuni dettagli di ciascuno.

compito completato
Mostra tutte le attività che corrispondono al filtro che sono state completate.

compito contare
Visualizza solo un conteggio delle attività che corrispondono al filtro.

compito export
Esporta tutte le attività in formato JSON. Reindirizza l'output su un file, se lo desideri
per salvarlo o reindirizzarlo a un altro comando o script per convertirlo in un altro
formato. La versione standard dell'attività viene fornita con alcuni script di esempio, come:

esportazione-csv.pl
export-sql.py
export-xml.py
export-yaml.pl
esportazione-html.pl
esportazione-tsv.pl
esporta-xml.rb
esportazione-ical.pl
esportazione-xml.pl
esportazione-yad.pl

compito storia.annuale
Mostra un report grafico dello stato dell'attività per anno.

compito ghistory.mensile
Mostra un report grafico dello stato dell'attività per mese. Nota che 'ghistory' è un alias
a 'ghistory.mensile'.

compito Aiuto
Mostra il testo di utilizzo prolungato.

compito storia.annuale
Mostra un report della cronologia delle attività per anno.

compito cronologia.mensile
Mostra un rapporto della cronologia delle attività per mese. Nota che "storia" è un alias di
'storia.mensile'.

compito ids
Applica il filtro, quindi estrae solo gli ID attività e li presenta come uno spazio-
elenco separato. Questo è utile come input per un comando di attività, per ottenere questo:

attività $(progetto attività:ID casa) modifica priorità:H

Questo esempio ottiene prima gli ID per il filtro project:Home, quindi imposta la priorità
a H ​​per ciascuno di questi compiti. Ciò può essere ottenuto anche direttamente:

task project:Home modifica priorità:H

Questo comando è principalmente utile per script esterni.

compito uuid
Applica il filtro a tutte le attività (anche quelle eliminate e completate), quindi estrae
solo gli UUID dell'attività e li presenta come un elenco separato da virgole. Questo è utile come
input a un comando di attività, per ottenere questo:

task $(task project:Home status:completed uuid) modifica stato:in attesa

Questo esempio ottiene prima gli UUID per il progetto:Home e lo stato:completato
filtri, quindi rende nuovamente in sospeso ciascuna di queste attività.

Questo comando è principalmente utile per script esterni.

compito udas
Mostra un elenco di UDA definiti, incluso il loro nome, tipo, etichetta e
valori ammessi. Mostra anche l'utilizzo degli UDA e tutti gli UDA orfani.

compito generali
Mostra tutti i dati e i metadati per le attività specificate. Questo è l'unico mezzo per
visualizzare tutti gli aspetti di una determinata attività, inclusa la cronologia delle modifiche.

compito stratagemma
Fornisce un elenco standard di attività che corrispondono al filtro.

compito lungo
Fornisce l'elenco più dettagliato delle attività che corrispondono al filtro.

compito ls
Fornisce un breve elenco di attività che corrispondono al filtro.

compito minimo
Fornisce un elenco minimo di attività che corrispondono al filtro.

compito ultimo
Mostra le attività più recenti che corrispondono al filtro.

compito GENERAZIONE
Mostra una pagina delle attività più urgenti, ordinate per urgenza, che è un calcolato
valore.

compito pronto
Mostra una pagina delle attività pronte più urgenti, ordinate per urgenza. Un compito pronto è
uno che non è programmato o ha una data programmata che è passata e non ha
data di attesa.

compito il più vecchio
Mostra le attività più vecchie che corrispondono al filtro.

compito in ritardo
Mostra tutte le attività incomplete corrispondenti al filtro che sono scadute.

compito progetti
Elenca tutti i nomi dei progetti attualmente utilizzati dalle attività in sospeso e il numero di
compiti per ciascuno.

compito ricorrenti
Mostra tutte le attività ricorrenti che corrispondono al filtro.

compito sbloccato
Mostra tutte le attività che non sono attualmente bloccate da altre attività, corrispondenti al filtro.

compito attesa
Mostra tutte le attività in attesa che corrispondono al filtro.

SCRIVERE SOTTOCOMANDI

compito aggiungere
Aggiunge una nuova attività in sospeso all'elenco delle attività.

compito annotare
Aggiunge un'annotazione a un'attività esistente.

compito aggiungere
Aggiunge il testo della descrizione a un'attività esistente.

compito delete
Elimina l'attività specificata dall'elenco delle attività.

compito denotare
Elimina un'annotazione per l'attività specificata. Se la descrizione fornita corrisponde
esattamente un'annotazione, l'annotazione corrispondente viene eliminata. Se il fornito
descrizione corrisponde parzialmente alle annotazioni, la prima annotazione parzialmente abbinata è
cancellato.

compito fatto
Contrassegna l'attività specificata come completata.

compito duplicare
Duplica l'attività specificata e consente modifiche.

compito edit
Avvia un editor di testo che consente di modificare direttamente tutti gli aspetti di un'attività. In
in generale, questo non è il metodo consigliato per modificare le attività, ma è previsto
circostanze eccezionali. Utilizzare con attenzione.

compito importare [ ...]
Importa le attività nel formato JSON. Può essere utilizzato per aggiungere nuove attività o aggiornare esistenti
quelli. Le attività sono identificate dal loro UUID.

Se non viene specificato alcun file o "-", importare le attività da STDIN.

Si consiglia di impostare rc.recurrence.confirmation su un livello appropriato se si importa
deve essere utilizzato in flussi di lavoro automatizzati. Vedere taskrc(5).

Per l'importazione di altri formati di file, il rilascio dell'attività standard include alcuni
script di esempio, come:

import-todo.sh.pl
import-yaml.pl

compito ceppo
Aggiunge una nuova attività già completata all'elenco delle attività.

compito modificare
Modifica l'attività esistente con le informazioni fornite.

compito anteporre
Antepone il testo della descrizione a un'attività esistente.

compito inizia a
Contrassegna le attività specificate come avviate.

compito Fermati
Rimuove il inizia a tempo dall'attività specificata.

VARIE SOTTOCOMANDI

I vari sottocomandi non accettano argomenti della riga di comando o accettano non standard
argomenti.

compito Tracciato
Valuta un'espressione algebrica. Può essere usato per testare come Taskwarrior analizza e
valuta l'espressione fornita sulla riga di comando.

Esempi:

calcolo compiti 1 + 1
2

calcolo attività ora + 8d
2015-03-26T18:06:57

calcolo attività eom
2015-03-31T23:59:59

compito config [nome [valore | '']]
Aggiungi, modifica e rimuovi le impostazioni direttamente nella configurazione di Taskwarrior. Questo
comando modifica l'impostazione 'nome' con un nuovo valore di 'valore', o aggiunge a
nuova voce equivalente a 'nome=valore':

valore del nome di configurazione dell'attività

Questo comando imposta un valore vuoto. Questo ha l'effetto di sopprimere qualsiasi default
valore:

nome configurazione attività ''

Infine, questo comando rimuove qualsiasi voce 'name=...' dal file .taskrc:

nome di configurazione dell'attività

compito contesto
Imposta il contesto attualmente attivo. Vedi la sezione CONTESTO.

Esempio:

contesto del compito lavoro

compito contesto delete
Elimina il contesto con il nome . Se il contesto da eliminare è attualmente
impostato come attivo, verrà disattivato.

Esempio:

contesto dell'attività elimina lavoro

compito contesto definire
Definisce un nuovo contesto con nome e definizione . Questo comando lo fa
non influisce sul contesto attualmente impostato, aggiunge solo una nuova definizione di contesto.

Esempi:

contesto dell'attività definire progetto di lavoro:Lavoro
contesto dell'attività definire il progetto home:Home o +home
contesto dell'attività definire superurgente dovuto: oggi e + urgente

compito contesto stratagemma
Restituisce un elenco di contesti disponibili insieme alle relative definizioni.

compito contesto nessuna
Cancella il contesto attualmente attivo, se ne è stato impostato uno.

compito contesto mostrare attraverso le sue creazioni
Mostra il contesto attualmente attivo, insieme alla sua definizione.

compito diagnostica
Mostra le informazioni di diagnostica, del tipo necessario quando si segnala un problema. quando
segnali un bug, è probabile che la piattaforma, la versione e l'ambiente lo siano
importante. L'esecuzione di questo comando genera un riepilogo di informazioni simili che
dovrebbe accompagnare una segnalazione di bug.

Include informazioni su compilatore, libreria e software. Non include nessuno
informazioni personali, diverse dalla posizione e dalle dimensioni dei file di dati dell'attività.

Questo comando esegue anche una scansione diagnostica dei tuoi file di dati alla ricerca di comuni
problemi, come UUID duplicati.

compito eseguire <external comando>
Esegue il comando specificato. Non utile da solo, ma se usato insieme
con alias ed estensioni può fornire un'integrazione perfetta.

compito logo
Visualizza il logo Taskwarrior.

compito rapporti
Elenca tutti i report supportati. Ciò include i report incorporati e qualsiasi custom
rapporti che hai definito.

compito mostrare attraverso le sue creazioni [Tutti | sottostringa]
Mostra tutte le impostazioni correnti. Se viene specificata una sottostringa, solo le impostazioni
contenente quella sottostringa verrà visualizzato.

compito stats
Mostra le statistiche delle attività definite dal filtro.

compito sommario
Mostra un rapporto sullo stato dell'attività aggregato per progetto.

compito tag
Mostra un elenco di tutti i tag utilizzati. Eventuali tag speciali utilizzati vengono evidenziati. Notare che
i tag virtuali non sono elencati - in realtà non esistono e sono solo un comodo
notazione per altri metadati dell'attività. È un errore tentare di aggiungere o rimuovere a
etichetta virtuale.

compito scheda attività [settimane]
Mostra un report settimanale delle attività completate e avviate.

compito disfare
Ripristina l'azione più recente. Rispetta l'impostazione di conferma.

compito versione
Mostra il numero di versione di Taskwarrior.

ASSISTENTE SOTTOCOMANDI

compito _alias
Genera un elenco di tutti gli alias, per scopi di completamento automatico.

compito _colonne
Visualizza solo un elenco di colonne supportate.

compito _comandi
Genera un elenco di tutti i comandi, per scopi di completamento automatico.

compito _config
Elenca tutte le variabili di configurazione supportate, a scopo di completamento.

compito _contesto
Elenca tutte le variabili di contesto disponibili, a scopo di completamento.

compito _id
Mostra solo gli ID delle attività corrispondenti, sotto forma di elenco. Deprecato a favore
di _unico.

compito _mostrare
Mostra le impostazioni predefinite combinate e le sostituzioni delle impostazioni di configurazione, per l'uso da
applicazioni di terze parti.

compito _unico
Riporta un insieme univoco di valori di attributo. Ad esempio, per vedere tutti gli attivi
progetti:

task + IN ATTESA _progetti unici

compito _uuid
Mostra solo gli UUID delle attività corrispondenti tra tutte le attività (anche cancellate e completate
compiti), sotto forma di elenco. Deprecato a favore di _unique.

compito _udas
Mostra solo i nomi UDA definiti, sotto forma di elenco.

compito _progetti
Mostra solo un elenco di tutti i nomi di progetto utilizzati. Deprecato a favore di _unique.

compito _tag
Mostra solo un elenco di tutti i tag utilizzati, ai fini del completamento automatico. Deprecato in
favore di _unico.

compito _urgenza
Visualizza la misura di urgenza di un'attività.

compito _versione
Mostra solo il numero di versione di Taskwarrior.

compito _zshcomandi
Genera un elenco di tutti i comandi, per scopi di completamento automatico di zsh.

compito _zshid
Mostra gli ID e le descrizioni delle attività corrispondenti.

compito _zshuuid
Mostra gli UUID e le descrizioni delle attività corrispondenti.

compito _get [ ...]
Accede e visualizza i riferimenti DOM. Utilizzato per estrarre i singoli valori da
compiti o il sistema. I riferimenti DOM supportati sono:

rc.
contesto.programma
contesto.args
contesto.larghezza
contesto.altezza
versione.sistema
sistema.os
.
.

Nota che il 'rc. ' potrebbe essere necessario sfuggire al riferimento utilizzando '--' per prevenire
il riferimento venga interpretato come un override.

Nota che se il riferimento DOM non è valido, o il riferimento restituisce a
valore mancante, il comando esce con 1.

Inoltre, alcuni componenti degli attributi di tipi particolari possono essere
estratto dai riferimenti DOM.

$ task _get 2.due.anno
2015

Per un elenco completo dei riferimenti DOM specifici per gli attributi supportati, consultare il sito online
documentazione su:http://taskwarrior.org/docs/dom.html>

ATTRIBUTI E METADATA

ID Le attività possono essere specificate in modo univoco dagli ID, che sono semplicemente gli indici delle attività
nel file di dati. L'ID di un'attività può quindi cambiare, ma solo quando un comando
viene eseguito che visualizza gli ID. Quando si modificano le attività, è sicuro fare affidamento sull'ultima
ID visualizzato. Esegui sempre un rapporto per verificare di avere l'ID corretto per un'attività. ID
può essere assegnato al compito come una sequenza, ad esempio,
compito 1,4-10,19 delete

+tag|-tag
I tag sono parole arbitrarie associate a un'attività. Usa + per aggiungere un tag e - per rimuoverlo
un tag da un'attività. Un'attività può avere qualsiasi quantità di tag.

Alcuni tag (chiamati "tag speciali") possono essere utilizzati per influenzare il modo in cui sono le attività
trattato. Ad esempio, se un'attività ha il tag speciale 'nocolor', allora è esente
da tutte le regole del colore. I tag speciali supportati sono:

+nocolor Disabilita l'elaborazione delle regole del colore per questa attività
+nonag Il completamento di questa attività elimina tutti i messaggi fastidiosi
+nocal Questa attività non apparirà sul calendario
+successivo Eleva l'attività in modo che appaia nel rapporto "successivo"

Esistono anche tag virtuali, che rappresentano i metadati dell'attività sotto forma di tag. Questi tag
non esistono, ma possono essere utilizzati per filtrare le attività. I tag virtuali supportati sono:

ATTIVO Corrisponde se l'attività è iniziata
ANNOTATED Corrisponde se l'attività ha annotazioni
BLOCCATO Corrisponde se l'attività è bloccata
BLOCCO Corrisponde se l'attività sta bloccando
BAMBINO Corrisponde se l'attività ha un genitore
COMPLETED Corrisponde se l'attività ha lo stato completato
DELETED Corrisponde se l'attività ha lo stato eliminato
DUE Corrisponde se l'attività è in scadenza
DUETODAY Corrisponde se l'attività è in scadenza oggi
LATEST Corrisponde se l'attività è l'attività aggiunta più recente
MESE Corrisponde se l'attività è prevista per questo mese
ORPHAN Corrisponde se l'attività ha valori UDA orfani
OVERDUE Corrisponde se l'attività è scaduta
GENITORE Corrisponde se l'attività è un genitore
PENDING Corrisponde se l'attività ha lo stato in sospeso
PRIORITÀ Corrisponde se l'attività ha una priorità
PROGETTO Corrisponde se l'attività ha un progetto
PRONTO Corrisponde se l'attività è attuabile
SCHEDULED Corrisponde se l'attività è pianificata
TAGGED Corrisponde se l'attività ha tag
OGGI Corrisponde se l'attività è in scadenza oggi
DOMANI Partite se l'attività è prevista per domani
UDA Corrisponde se l'attività ha valori UDA
UNBLOCKED Corrisponde se l'attività non è bloccata
UNTIL Corrisponde se l'attività scade
IN ATTESA Corrisponde se l'attività è in attesa
SETTIMANA Partite se l'attività è prevista per questa settimana
ANNO Corrisponde se l'attività è prevista per quest'anno
IERI Corrisponde se l'attività era prevista per ieri

Puoi utilizzare +BLOCCATO per filtrare le attività bloccate o -BLOCCATO per le attività sbloccate.
Allo stesso modo, -BLOCKED è equivalente a +UNBLOCKED. È un errore tentare di aggiungere
o rimuovere un tag virtuale.

progetto:
Specifica il progetto a cui è correlata un'attività.

priorità:H|M|L or priorità:
Specifica Alta, Media, Bassa e nessuna priorità per un'attività.

dovuto:
Specifica la data di scadenza di un'attività.

ricorrono:
Specifica la frequenza di una ricorrenza di un'attività.

programmato:
Specifica la data dopo la quale un'attività può essere completata.

Fino a: quando of compito>
Specifica la data di scadenza di un'attività, dopo la quale verrà eliminata.

limite:
Specifica il numero desiderato di attività che un report dovrebbe mostrare, se un numero intero positivo
viene data. Può essere utilizzato anche il valore 'page' e limiterà l'output del report a
tante righe di testo quante possono essere visualizzate sullo schermo. Il valore predefinito è 25 righe.

aspettare:
Quando a un'attività viene assegnata una data di attesa, viene nascosta dalla maggior parte dei rapporti modificandone
stato in "attesa". Quando tale data è trascorsa, lo stato torna a
'in sospeso' e l'attività diventa visibile.

dipende: ...>
Dichiara che questa attività dipende da id1 e id2. Ciò significa che le attività id1
e id2 dovrebbe essere completato prima di questa attività. Di conseguenza, questo compito sarà quindi
comparire nel rapporto "bloccato". Accetta un elenco separato da virgole di numeri ID,
Numeri UUID e intervalli ID. Quando si premette a qualsiasi elemento di questo elenco '-', il
le attività specificate vengono rimosse dall'elenco delle dipendenze.

iscrizione:
Ai fini del rapporto, specifica la data in cui è stata creata un'attività.

ATTRIBUTO MODIFICATORI

I modificatori di attributo migliorano i filtri. I modificatori supportati sono:

prima (sinonimi sotto, di seguito)
dopo (sinonimi al di sopra di, qui sopra)
nessuna
in qualsiasi
is (sinonimo equivale)
isnt (sinonimo non)
ha (sinonimo contiene)
hasnt
inizia con (sinonimo sinistra)
finisce con (sinonimo destra)
parola
non ci sono parole

Per esempio:

task due.before:eom priority.not:L lista

prima il modificatore viene utilizzato per confrontare i valori, preservando la semantica, quindi project.before:B
elenca tutti i progetti che iniziano con 'A'. La priorità "L" è prima della "M" e la scadenza: 2011/01/01 è
prima della scadenza:2011-01-02. I sinonimi "sotto" e "sotto" sono inclusi per consentire i filtri
che leggono in modo più naturale.

dopo il modificatore è l'inverso di prima modificatore.

nessuna il modificatore richiede che l'attributo non abbia un valore. Per esempio:

priorità dell'attività: lista
task priority.none: elenco

sono equivalenti ed elenca le attività che non hanno una priorità.

in qualsiasi il modificatore richiede che l'attributo abbia un valore, ma qualsiasi valore sarà sufficiente.

is modificatore richiede una corrispondenza esatta con il valore.

isnt il modificatore è l'inverso di is modificatore.

ha il modificatore viene utilizzato per cercare una sottostringa, ad esempio:

descrizione dell'attività.ha: elenco pippo
elenco dei compiti da fare

Questi sono equivalenti e restituiranno qualsiasi attività che abbia "foo" nella descrizione o
annotazioni.

hasnt il modificatore è l'inverso di ha modificatore.

inizia con il modificatore corrisponde alla sinistra o all'inizio di un attributo, in modo tale che:

task project.inizia con:H list
progetto compito: lista H

sono equivalenti e corrispondono a qualsiasi progetto che inizia con 'H'. Abbinare tutti i progetti non
iniziando con 'H' è fatto con:

task project.not: elenco H

finisce con il modificatore corrisponde alla destra o alla fine di un attributo.

parola il modificatore richiede che l'attributo contenga l'intera parola specificata, in modo tale che
Questo:

descrizione dell'attività.parola:elenco delle barre

Corrisponde alla descrizione "foo bar baz" ma non corrisponde a "cibo per cani".

non ci sono parole il modificatore è l'inverso di parola modificatore.

ESPRESSIONI E OPERATORI

È possibile utilizzare i seguenti operatori nelle espressioni di filtro:

e o xor! Operatori logici
< <= = == != !== >= > Operatori relazionali
( ) Precedenza

Per esempio:

task due.before:eom priority.not:L lista
task '( due < eom or priority != L )' list
compito '! (progetto:Casa o progetto:Giardino)' elenco

= test dell'operatore per l'uguaglianza approssimativa. Le date sono uguali se sono sul
stesso giorno (ora e minuti vengono ignorati). Le stringhe sono uguali se inizia l'operando di sinistra
con l'operando giusto. Il == l'operatore verifica l'esatta uguaglianza. Il != e ! ==
gli operatori sono la negazione di = e == rispettivamente. L'operatore di negazione è !.

Si noti che le parentesi sono necessarie quando si utilizza un operatore logico diverso da "e"
operatore. Il motivo è che alcuni report contengono filtri che devono essere combinati con il
riga di comando. Considera questo esempio:

progetto compito:Casa o progetto:Elenco giardino

Anche se questo sembra corretto, non lo è. Il rapporto "elenco" contiene un filtro di:

attività mostra report.list.filter

Valore variabile di configurazione
------------------ --------------
report.list.filter status:in attesa

Il che significa che l'esempio è davvero:

stato dell'attività:progetto in sospeso:Casa o progetto:elenco del giardino

L'operatore 'and' implicito lo fa:

stato dell'attività:in attesa e progetto:Casa o progetto:elenco giardino

Questo è un errore di precedenza: "e" e "o" devono essere raggruppati utilizzando parentesi, come
Questo:

stato dell'attività:in attesa e (progetto:Casa o progetto:Giardino) elenco

L'esempio originale quindi deve essere inserito come:

task '( progetto:Casa o progetto:Giardino )' elenco

Questo include le virgolette per sfuggire alle parentesi, in modo che la shell non le interpreti
e nascondili da Taskwarrior.

C'è ridondanza tra operatori, modificatori di attributi e altro zucchero sintattico. Per
esempio, i seguenti sono tutti equivalenti:

elenco dei compiti da fare
compito /pippo/lista
descrizione dell'attività.contiene:lista pippo
descrizione dell'attività.ha: elenco pippo
elenco attività 'descrizione ~ pippo'

SPECIFICANDO DATE E FREQUENZE

DATE
Taskwarrior legge le date dalla riga di comando e visualizza le date nei report. Il
il formato della data previsto e desiderato è determinato dalla variabile di configurazione formato data

Specifiche esatte
compito ... scadenza: 7/14/2008

ISO-8601
task ... due:2013-03-14T22:30:00Z

Formulazione relativa
compito ... dovuto: ora
compito ... dovuto: oggi
compito ... dovuto: ieri
compito ... dovuto:domani

Numero del giorno con ordinale
compito ... scadenza: 23rd
compito ... dovuto: 3 settimane
compito... in scadenza:1giorno
compito ... scaduto: 9 ore

Inizio della prossima settimana (lavorativa) (lunedì), settimana di calendario (domenica o lunedì), mese,
trimestre e anno
compito ... dovuto: seminare
compito ... dovuto:soww
compito ... dovuto:socw
compito ... dovuto:som
compito ... dovuto: soq
compito... causa:soia

Fine della settimana (lavorativa) corrente (venerdì), settimana di calendario (sabato o domenica), mese,
trimestre e anno
compito ... dovuto: eow
compito ... dovuto: eoww
compito ... dovuto: eocw
compito ... dovuto:eom
compito ... dovuto:eoq
compito ... dovuto: eoy

Ad un certo punto o dopo
compito ... aspetta: più tardi
compito ... aspetta: un giorno

Ciò imposta la data di attesa su 1/18/2038.

Giorno della settimana successivo
compito ... dovuto:ven

Vacanze prevedibili
compito ... dovuto:buonvenerdì
compito... per:pasqua
compito ... dovuto: lunedì di Pasqua
compito ... dovuto:ascensione
compito ... causa: pentecoste
compito ... dovuto:midsommar
compito ... dovuto:midsommarafton

FREQUENZE
Periodi di ricorrenza. Taskwarrior supporta diversi modi per specificare il frequenza of
compiti ricorrenti.

quotidiano, giorno, 1da, 2da, ...
Ogni giorno o più giorni.

giorni feriali
Lunedì, martedì, mercoledì, giovedì, venerdì e giorni festivi saltati.

settimanale, 1 sett, 2 sett, ...
Ogni settimana o un numero di settimane.

bisettimanale, quindicina
Ogni due settimane.

mensile, mese, 1 mese, 2 mesi, ...
Ogni mese.

trimestrale, 1qtr, 2qtrs, ...
Ogni tre mesi, un trimestre o un numero di trimestri.

semestrale
Ogni sei mesi.

annuale, annuale, 1 anno, 2 anni, ...
Ogni anno o più anni.

semestrale, biennale, 2 anni
Ogni due anni.

CONTESTO

Il contesto è un filtro definito dall'utente, che viene applicato automaticamente a tutti i comandi che
filtrare l'elenco delle attività. In particolare, qualsiasi comando di report avrà il suo risultato influenzato da
l'attuale contesto attivo.

$ elenco compiti
ID Età Descrizione progetto Urg
1 2d Sport Run 5 miglia 1.42
2 1d Home Pulisci i piatti 1.14

$ contesto dell'attività home
Contesto 'casa' impostato. Utilizzare 'attività contesto nessuno' per rimuovere.

$ elenco compiti
ID Età Descrizione progetto Urg
2 1d Home Pulisci i piatti 1.14
Contesto 'casa' impostato. Utilizzare 'attività contesto nessuno' per rimuovere.

Come visto nell'esempio sopra, il contesto viene applicato specificando il suo nome al "contesto"
comando. Per cambiare il contesto attualmente applicato, passa semplicemente il nome del nuovo contesto a
comando "contesto".

Per annullare l'impostazione di qualsiasi contesto, utilizzare il sottocomando 'none'.

$ contesto dell'attività nessuno
Contesto non impostato.

$ elenco compiti
ID Età Descrizione progetto Urg
1 2d Sport Run 5 miglia 1.42
2 1d Home Pulisci i piatti 1.14

Il contesto può essere definito utilizzando il sottocomando 'define', specificando sia il nome del nuovo
contesto e gli viene assegnato un filtro.

$ contesto dell'attività definisce home
Sei sicuro di voler aggiungere 'context.home' con un valore di 'project:Home'? (si No)
sì
Contesto 'home' definito correttamente.

Per rimuovere la definizione, utilizzare il sottocomando "cancella".

$ contesto dell'attività elimina home
Sei sicuro di voler rimuovere 'context.home'? (sì/no) sì
Contesto 'casa' non definito correttamente.

Per verificare qual è il contesto attualmente attivo, utilizzare il sottocomando 'mostra'.

$ mostra il contesto dell'attività
Al momento è applicato il contesto 'home' con il filtro 'project:Home'.

I contesti possono memorizzare filtri arbitrariamente complessi.

$ contesto dell'attività definire il progetto familiare:Famiglia o +paul o +nancy
Sei sicuro di voler aggiungere 'context.home' con un valore di 'project:Family o +paul?
o +nancy'? (sì/no) sì
Contesto 'famiglia' definito con successo.

I contesti sono permanenti e il nome del contesto attualmente impostato viene memorizzato nel "contesto"
variabile di configurazione. La definizione del contesto è memorizzata nel file "context. "
configurazione variabile.

COMANDO ABBREVIAZIONE

Tutti i comandi di Taskwarrior possono essere abbreviati purché venga utilizzato un prefisso univoco, per
esempio:

$ compito li

è un'abbreviazione univoca per

$ elenco compiti

ma

$ compito l

potrebbe essere list, ls o long.

Tieni presente che puoi limitare la dimensione minima dell'abbreviazione utilizzando l'impostazione di configurazione:

abbreviazione.minimo=3

SPECIFICANDO DESCRIZIONE

Alcune descrizioni delle attività devono essere sfuggite a causa della shell e del significato speciale di
alcuni caratteri alla shell. Questo può essere fatto aggiungendo virgolette alla descrizione
o l'escape del carattere speciale:

$ task add "quoted ' quote"
$ task add escape \' quote

L'argomento -- (un doppio trattino) dice a Taskwarrior di trattare tutti gli altri argomenti come descrizione:

$ task add -- project:Home ha bisogno di programmazione

In altre situazioni, la shell vede gli spazi e suddivide gli argomenti. Ad esempio, questo
comando:

$ task 123 modifica /da questo/a quello/

è suddiviso in diversi argomenti, che viene corretto con virgolette:

$ task 123 modifica "/da questo/a quello/"

A volte è necessario forzare la shell a passare le virgolette a Taskwarrior intatte, quindi
poter usare:

$ task aggiungi progetto:\'Progetto in tre parole\' descrizione

CONFIGURAZIONE RISORSE E OVERRIDE VERSIONI

Taskwarrior memorizza la sua configurazione in un file nella home directory dell'utente: ~/.taskrc.
Il file di configurazione predefinito può essere sovrascritto con:

compito rc: ...
Specifica un file di configurazione alternativo.

TASKRC=/tmp/.taskrc compito ..
La variabile d'ambiente sovrascrive l'impostazione predefinita e la specifica della riga di comando
del file .taskrc.

compito rc. : ...
compito rc. = ... Specifica le sostituzioni dei singoli file di configurazione.

TASKDATA=/tmp/.task compito ...
La variabile di ambiente sovrascrive il valore predefinito, la riga di comando e il
Impostazione di configurazione 'data.location' della directory dei dati dell'attività.

ALTRO ESEMPI

Per esempi, vedere la documentazione in linea a partire da

<http://taskwarrior.org/docs>

Nota che la documentazione online può essere più dettagliata e più aggiornata di quest'uomo
.

Utilizzare l'attività online utilizzando i servizi onworks.net