tde - En ligne dans le Cloud

PROGRAMME:

Nom

todo - un programme de rappel/tâche destiné aux développeurs

SYNOPSIS

todo []
Sans options, affiche les éléments du répertoire courant.

tda [-p ] [-g ] []
Ajoutez un nouvel élément, en le greffant éventuellement en tant qu'enfant de l'élément donné.

tde
Modifiez l'élément donné.

Tor
Supprimer les éléments donnés.

tdd
Marquez les éléments spécifiés comme étant terminés.

todo --relier [-g ]
Liez la base de données devtodo spécifiée à la base de données actuelle, en la greffant éventuellement comme
un enfant de l'index spécifié.

DESCRIPTION

todo est un programme destiné spécifiquement aux programmeurs (mais utilisable par n'importe qui au
terminal) pour aider au développement quotidien.

Il maintient une liste des éléments qui doivent encore être complétés. Cela permet au programmeur de
suivre les bogues en suspens ou les éléments qui doivent être complétés avec très peu d'efforts.

Les éléments peuvent être hiérarchisés et peuvent également être affichés dans une hiérarchie, de sorte qu'un élément puisse
dépendre d'un autre.

Avec l'utilisation de quelques petits scripts shell (scripts.* dans le répertoire doc de la source
distribution), todo peut également afficher les encours dans un répertoire au fur et à mesure que vous changez
dans ça. Ainsi, par exemple, si vous cd dans le répertoire source pour faire lui-même, vous devriez
voir une liste d'articles en suspens... à moins que tous les bogues aient été corrigés ;).

OPTIONS

Les options peuvent avoir à la fois une forme longue et une forme courte.

Les options courtes peuvent être combinées en un seul argument en utilisant un trait d'union suivi d'une chaîne de
options courtes. Des paramètres d'options courtes peuvent également être ajoutés à cette chaîne.

-dans, --verbeux
Afficher en détail

-une, --ajouter []
Ajouter une note (demandera une note si elle n'est pas fournie).

-g, --greffer
En conjonction avec --ajouter or --relier, greffez le nouvel élément sur l'élément spécifié.

-l, --relier
Liez le fichier todo spécifié dans le corps de celui-ci. Si la base de données liée a
un jeu de titres, celui-ci sera utilisé comme corps de l'élément de liaison, sinon le
le nom du répertoire de la base de données liée sera utilisé. Utilisez --remove (ou tdr) pour supprimer
bases de données liées - cela ne pas supprimer la base de données elle-même, seul le lien.

-R,--reparent [, ]
Remplacez le parent du premier index d'élément par le deuxième index d'élément. Si pas de seconde
index est donné, l'élément est réapparenté à la racine de l'arbre.

-p, --priorité
En conjonction avec --add ou --edit, définissez la priorité (par défaut | veryhigh | high |
moyen | bas | très lent)

-e, --modifier
Modifiez la note qui est indexée par le numéro donné.

--supprimer
Supprimez la note indexée par les numéros donnés, y compris les enfants.

-ré, --terminé
Marquez les notes spécifiées (et leurs enfants) comme terminées.

-RÉ, --pas fini
Marquez les notes spécifiées (et tous les enfants) comme non terminées.

--base de données globale
Spécifiez la base de données à utiliser si le -G or --mondial les options sont spécifiées.

-G, --mondial
Forcer todo à utiliser la base de données spécifiée avec --base de données globale. Si celui-ci est placé
dans votre ~/.todorc il obligera à utiliser cette base de données à l'exclusion de tout
autres.

--base de données
Changez la base de données quelle que soit la valeur par défaut (généralement '.todo') vers le fichier
spécifié.

-T, --À FAIRE
Générez un fichier texte de sortie TODO typique à partir d'une base de données Todo.

-UNE, --tout
Raccourci pour le filtre '+done,+children' pour afficher toutes les notes.

-F, --filtre
Affichez uniquement les notes qui passent le filtre. Veuillez vous référer à la rubrique FILTRES pour
pour en savoir davantage.

--Couleur
Remplacer les couleurs par défaut des éléments à faire. Veuillez vous référer à la rubrique COULEUR pour plus d'
</br>L’Information.

--force-couleur
Forcer l'utilisation de la couleur même lorsque la sortie n'est pas vers un TTY. Ceci est utile lors de la tuyauterie
à moins(1) -r.

--mono Supprimer toutes les séquences d'échappement ANSI de la sortie - utile pour les personnes ayant des problèmes de couleur
terminaux.

--Aidez-moi Affichez cette aide.

--version
Afficher la version de ToDo.

--Titre []
Définissez le titre des notes de tâches de ce répertoire.

--format de date
Formatez l'affichage des valeurs de temps. Le format est celui utilisé par strftime(3). le
le format par défaut est '%c'. Cette option est mieux spécifiée dans le ~/.todorc.

--format =
Spécifiez le formatage de la sortie. Veuillez vous référer à la section FORMATAGE pour plus
</br>L’Information.

--use-format =
Utilisez la chaîne de format identifiée par (défini avec --format) comme
chaîne de format à utiliser lors du formatage avec le format intégré .

--sorte
Trie la base de données avec l'expression spécifiée. Référez-vous à la rubrique TRI pour
informations plus détaillées.

--paranoïaque
Soyez paranoïaque à propos de certains paramètres, y compris les autorisations.

--database-loaders <chargeur liste>
Essayez les formats de base de données dans l'ordre indiqué. Les formats valides sont xml et mes binaire. par exemple.
todo --database-loaders binaire,xml. Le format par défaut est XML.

--sauvegarde []
Sauvegardez la base de données jusqu'à fois, juste avant qu'il ne soit écrit. Si n'est pas
spécifié, une sauvegarde sera effectuée. Les noms de fichiers utilisés pour stocker les sauvegardes sont les
nom de base de données par défaut avec leur révision ajoutée comme suit : .todo.1, .todo.2, etc.
Pour utiliser réellement l'une de ces sauvegardes, vous pouvez soit la transférer vers .todo, soit utiliser
--base de données .todo. pour spécifier explicitement son utilisation.

-Oui, --sommaire
Basculez en mode « résumé », où les éléments longs sont tronqués à une seule ligne.

-c, --commenter
Modifier ou afficher les commentaires respectivement.

--temps libre []
If est spécifié, le délai entre les affichages de la base de données est défini sur ce nombre
de secondes. Sinon est spécifié, le comportement est d'afficher la base de données
uniquement s'il n'a pas été affiché pendant le nombre de secondes spécifié par --timeout
avec le étant donné. par exemple. todo --temps libre 10 --temps libre afficherait uniquement le
base de données au plus une fois toutes les 10 secondes. Mettre un temps mort 10 dans votre ~/.todorc est une
bonne option, puis le --timeout dans le doc/scripts.* signifiera que la base de données
ne sera pas affiché à chaque fois que vous entrez dans un répertoire.

--purge []
Purger tous les éléments terminés antérieurs à . Si est omis, tout
les enregistrements complétés sont purgés.

PRIORITÉS

Les priorités peuvent être spécifiées symboliquement en utilisant les mots défaut, très haut, Élevée, moyenne,
faible et mes très lent.

Pour défaut priorité a une signification particulière en ce sens qu'il utilisera la priorité par défaut pour tout
action. Cela signifie que lors de la modification d'un élément existant, sa priorité est conservée ; lorsque
création d'un nouvel élément, la priorité sera définie sur moyenne; lors du greffage d'un nouvel élément, son
la priorité sera celle de son parent. DevTodo ne demandera pas la priorité si cela est
spécifié, ce qui en fait une fonctionnalité pratique pour votre todorc. Comme pour toutes les options, la priorité
peut être remplacé sur la ligne de commande.

FILTRES

Les filtres sont constitués d'une liste d'expressions utilisées pour définir les notes qui sont
affiché.

Le format général d'une expression de filtre est :

([-|=|+](tous|enfants|fait| | )) | (/ expression>)

Généralement, si une expression de filtre est préfixée par un '-', elle sera pas afficher des éléments qui
correspond à l'expression, si elle est préfixée par un '+', elle affichera les éléments qui correspondent à cette
expression en plus des autres, ou si elle est préfixée par un '=' (ou pas de préfixe du tout), elle sera
l’affichage uniquement les éléments qui correspondent à l'expression. Notez que cela ne recherchera que les éléments
pas exclu par d'autres filtres, donc pour rechercher dans toute la base de données, vous devrez faire
quelque chose comme: todo --filtre tout,/une-chaîne-de-recherche.

La deuxième forme d'expression de filtre est utilisée pour rechercher du texte dans une base de données. <recherche
expression> est une expression régulière qui est comparée au corps de texte de chaque élément.

Les atomes de filtre sont filtrés dans l'ordre par état terminé, priorité, puis recherche. Alors premiers éléments
qui ne correspondent pas au filtre "done" seront exclus, alors ceux qui ne correspondent pas au
filtre prioritaire, et ainsi de suite.

Les expressions en détail :

tous Force l'affichage de tous les éléments. Les différents préfixes n'ont aucun effet sur ce
expression.

les enfants
Réduire ou développer les éléments enfants. Si le préfixe '-' est présent, les enfants sont
réduit, sinon les enfants sont affichés.

fait Filtrez si un élément est terminé ou non.


Les indices de note sont spécifiés sous forme de nombres. Les plages peuvent être données ala « 1.2.10-20 ».


Les priorités sont spécifiées comme décrit dans le PRIORITÉS section. Un préfixe de '-'
affichera tous les éléments avec des priorités inférieures ou égales à la priorité donnée.
Avec un préfixe '+', tous les éléments avec des priorités supérieures ou égales à la donnée
priorité sont affichés. Si '=' ou aucun préfixe n'est donné, seuls les éléments avec le
priorité sont affichés.

Exemples :

todo --filter fait,-enfants,+faible

Cela affichera uniquement les éléments qui sont terminés et qui ont une priorité faible ou supérieure. Dans
De plus, les enfants seront effondrés.

faire /[Tt]il

Afficher uniquement les éléments contenant le mot « le », où la première lettre peut être inférieure
ou majuscule. Il peut être nécessaire de citer l'expression de recherche pour s'assurer que le shell ne
pas les interpréter.

MISE EN PAGE

La sortie de todo peut être modifiée pour être plus à votre goût en définissant votre propre
chaînes de formatage. Ces chaînes sont similaires à celles utilisées dans printfde Géographie (3) et avec la strftime (3).

Les exemples suivants, qui peuvent être placés dans ~/.todorc, imitera la valeur par défaut
comportement:

# Affichage au format par défaut
format d'affichage=%i%[info]%f%2n.%[priority]%T

# Affichage au format par défaut
format généré=%2i-%T%2i (ajouté %d, priorité %p)\n\n

Il existe quatre options de format distinctes : l’affichage, généré, affichage-verbeux et mes verbeux-
généré. Les deux derniers sont utilisés pour formater leur texte respectif lorsque --verbose est
spécifié comme argument à faire.

De plus, les utilisateurs peuvent créer leurs propres chaînes de format en passant simplement un autre
identifiant à le format. Cela peut ensuite être activé en utilisant --use-format. par exemple.

format full-report=%i%[info]%f%2n.%[priority]%+1T%+1i%[info]Ajouté : %[normal]%c
%[info]Terminé : %[normal]%d\n%+1i%[info]Durée : %[normal]%D %[info]Priorité :
%[normal]%p\n\n
# Remplacez le format d'affichage pour utiliser "full-report".
use-format display=rapport complet

Les différents drapeaux disponibles sont :

% > Pour > flag définit le nombre d'espaces à utiliser pour tous les futurs indentations.

%[+|-][ ]je
Retrait de la profondeur de l'élément actuel. spécifie la profondeur d'indentation. Si is
omis, le niveau actuel est utilisé. Des valeurs relatives peuvent être utilisées. par exemple. '%+1T' serait
retrait à un niveau supérieur au niveau de retrait actuel.

%[+|-][ ]T
Afficher le texte de l'élément, enveloppé à 80 caractères et en retrait à la
niveau spécifié. Sémantique de sont comme avec %i. Notez que le texte enveloppé
ajoute automatiquement un '0 à la fin du texte, alors que %t ne sera pas.

%t Texte non emballé et non formaté de l'élément.

%s Texte de synthèse (c'est-à-dire une seule ligne, équivalent à --sommaire).

%p Le niveau de priorité de l'élément actuel.

%c La date de création des éléments actuels, formatée selon --date-format.

%d La date à laquelle l'élément a été marqué comme terminé, formaté selon --date-format.

%D La durée de l'élément, formatée selon --date-format.

%[ ]n
Le numéro d'index de l'élément actuel. La valeur numérique facultative précise le
nombre de caractères que le nombre doit occuper. Le numéro est rempli d'espaces
de manière à remplir ce nombre de caractères.

%f L'indicateur d'état de l'élément actuel. Les valeurs affichées pour ce drapeau sont '+'
signifie enfants, '-' signifie terminé', '*' signifie terminé avec les enfants.

%F L'indicateur d'état lisible par l'homme de l'élément actuel. Les valeurs affichées pour ce
flag sont 'enfants', 'fait' signifie fait', 'fait, enfants' et 'ouvert'.

%[ ]
Les couleurs peuvent être spécifiées avec ce drapeau. Les valeurs valides pour sont:
très lent, faible, moyenne, Élevée, très haut, titre, info et priorité. Ce sont assez
explicite, sauf priorité change la couleur de priorité des éléments actuels. par exemple.
%[priorité]

Veuillez noter que lors de l'indentation, vous typiquement voulez utiliser une valeur de préfixe de '+1'
avec %T. c'est à dire. %+1T. Cela force le texte à être indenté à un niveau plus profond que le niveau actuel
niveau, en l'éloignant de tout autre formatage que vous pourriez avoir utilisé.

TRI

L'affichage des éléments dans la base de données peut être trié sur une variété de clés. Étant donné une série de
keys todo trie sur chaque clé successive, en passant à la suivante uniquement si la clé précédente
la comparaison était égale. Par exemple:

todo --sort -done,texte

Cela triera d'une part par si un élément est complété et d'autre part par son texte. Cette
regroupe efficacement les éléments en deux blocs - ceux qui sont complets et ceux qui ne le sont pas.

Les clés disponibles sont créée, terminé, texte, priorité, durée, aucun et mes
fait. Chaque touche, sauf aucun peut être précédé d'un - pour inverser son ordre par défaut et
plusieurs clés doivent être séparées par un ,.

Si plusieurs paramètres --sort sont rencontrés, le dernier est utilisé. Cela signifie qu'un
entrée 'trier' dans ~/.todorc sera remplacé par tout sur la ligne de commande.

INDICES

Les indices sont utilisés comme options pour une variété d'arguments de ligne de commande. Index de notes multiples
sont séparés par des virgules (les espaces sont pas autorisé). Les enfants sont délimités à l'aide d'un '.'.

Par exemple, étant donné les notes suivantes :

1. Faire des pages de manuel
1. Rendez-les plus beaux.
2. Créez également une documentation HTML.

Le deuxième sous-élément serait représenté comme ceci : 1.2

Le caractère générique '*' peut être utilisé pour représenter tous les enfants d'un nœud. par exemple. 1.*

Les plages de notes peuvent être spécifiées en utilisant ' - '. Par exemple, pour marquer les notes 10.1.2,
10.1.3 et 10.3.4 comme terminé, vous pouvez faire : todo --done 10.1.2-4

COULEUR

Divers articles peuvent être colorisés. Les articles qui peuvent être très haut, Élevée, moyenne, faible, très lent,
titre et mes info. info est utilisé pour afficher les numéros d'article et les informations générales.

Ces éléments peuvent être réglés sur l'une des huit couleurs. Ces couleurs sont noir, rouge, et une transition qui soit juste.,
jaune, Bleu, magenta, cyan, blanc et mes défaut. La couleur défaut est utilisé pour spécifier le
couleur du terminal de premier plan par défaut.

Les couleurs sont spécifiées comme ceci :

=[+]

Si l'optionnel + dans cette expression est utilisée, l'élément deviendra gras.

Par exemple, une ligne dans votre ~/.todorc pourrait ressembler à:

moyen de couleur=+blanc

Ce qui ferait moyenne texte goupille blanc.

TODORC

todo peut charger des options à partir d'un certain nombre de fichiers de ressources. L'ordre dans lequel ils sont analysés
est comme suit:

1. Le fichier spécifié dans la variable d'environnement TODORC ou, si cela n'existe pas,
/etc/todorc.
2. ~/.todorc

Les options sont cumulatives en ce sens que celles chargées à partir de $TODORC seront remplacées ou ajoutées par
ceux en ~/.todorc.

Ces options sont spécifiées sous forme de paires clé/valeur, une par ligne La clé est le nom long d'un
argument de ligne de commande et la valeur est le paramètre de cet argument, le cas échéant. En outre,
les variables d'environnement sont développées.

Par exemple, l'argument de ligne de commande --filter accepte un paramètre qui est un filtre
expression. Un filtre par défaut pourrait être ajouté au ~/.todorc fichier comme ceci :

# Ne pas afficher les éléments enfants par défaut
filtre -enfants

La seule différence entre les options spécifiées dans le fichier rc et celles de la ligne de commande
est que les options dans le fichier rc ne sont pas préfixées par --.

De plus, il y a deux commandes disponibles dans le fichier RC qui ne sont pas disponibles sur le
ligne de commande. Elles sont:

La première commande, on, est utilisé pour ajouter conditionnellement des commandes spécifiques. Le format de ce
la commande est: on [ ]. Les événements valides sont ajouter, supprimez, vue, éditer,
générer, fait, pas fini, titre, réparer, charge, enregistrer, lien, engendrent et mes purge. Plusieurs
les commandes peuvent être passées à on en les mettant entre accolades (un espace est requis entre
jetons). Exemple complet ci-dessous.

La deuxième commande est exec <coquille commande>. Cette commande exécutera l'argument c'est
donné dans une coquille. La variable d'environnement $TODODB contient le nom du fichier actuel
base de données. par exemple. exec chmod 600 $TODODB

Il existe un exemple de fichier rc dans le sous-répertoire doc de la distribution source.

EXEMPLES

Pour afficher les éléments en suspens dans le répertoire actuel, tapez simplement :

todo

Pour supprimer les notes 1, 2 et 4 :

à faire --supprimer 1,2,4

Pour afficher TOUS les éléments :

tout faire

Pour afficher uniquement les éléments de niveau supérieur et non leurs enfants :

todo -enfants

(bien que -enfants n'est pas un argument valide, cela fonctionne car todo interprète n'importe quel
arguments de ligne de commande qu'il ne reconnaît pas comme faisant partie d'une expression de filtre)

Un exemple plus complexe. Cela ajoute un nouvel élément, avec le texte de l'élément spécifié sur le
ligne de commande, avec une priorité de Élevée en tant qu'enfant du troisième enfant du deuxième élément (si
ça a du sens):

todo -a "Réparer la page de manuel" -p high -g 2.3

Ceci est un exemple d'utilisation de la fonction TODO de todo. Cela permet de générer un nouveau
TODO à partir des informations stockées dans la base de données. Cet exemple particulier génère tous
éléments dans le fichier TODO, même ceux marqués comme terminés.

todo --filter tout --TODO

Cet exemple montre une bonne utilisation des déclencheurs d'événements. Lorsqu'une nouvelle base de données est créée, elle
forcera ses autorisations à 0600.

sur créer {
verbeux
exec chmod 600 .todo
}

Utilisez tde en ligne en utilisant les services onworks.net