quand - En ligne dans le Cloud

PROGRAMME:

Nom

Quand - un programme de calendrier personnel minimaliste

SYNOPSIS

quand

quand [options] [commandes]

L'idée de base est juste de taper "quand" sur la ligne de commande. La première fois que vous exécutez le
programme, il vous demandera des informations de configuration. Pour modifier votre fichier de calendrier dans votre
éditeur préféré, faites 'quand e'. Le format de base du fichier de calendrier est le suivant :

2003 février 3, Envol pour Stockholm pour recevoir le prix Nobel.

Une fois que vous avez un fichier de calendrier, exécutez le programme en tant que simple "quand" à partir de la commande
line imprimera les choses sur votre calendrier pour les deux prochaines semaines.

COMMANDES

i Imprimez les éléments à venir sur votre calendrier. (C'est la commande par défaut.)

c Imprimer les calendriers (grilles comme sur un calendrier mural, n'affichant pas les éléments) pour le mois dernier,
ce mois-ci et le mois prochain.

e Appelez votre éditeur préféré pour modifier votre fichier de calendrier.

w,m,y Imprimer les éléments pour la semaine, le mois ou l'année à venir, plutôt que pour la valeur par défaut
période de deux semaines.

j Imprimer le jour julien modifié (utile pour trouver l'intervalle de temps entre deux
Rendez-vous).

d N'imprimez rien d'autre que la date du jour.

OPTIONS

Toutes les options suivantes, à l'exception de --help, peuvent être définies dans le fichier de préférences.
Les options vrai/faux peuvent être définies sur la ligne de commande comme --option ou --nooption, et dans le
préférences en définissant l'option sur 0 ou 1.

--help Imprime un bref message d'aide.

--version
Imprime un bref message, y compris une déclaration de la version du logiciel qu'il
est.

--langue=LANG
Réglez la langue sur LANG. Voir la section ci-dessous sur l'internationalisation. Cette
L'option n'est normalement pas nécessaire, car la langue est automatiquement détectée.

--future=JOURS
Combien de jours dans le futur le rapport s'étend. Par défaut : 14

--past=JOURS
Combien de jours dans le passé le rapport s'étend. Comme l'option --future, --past
est interprété comme un décalage par rapport à la date actuelle, donc normalement vous devriez
voulez que ce soit une valeur négative. Par défaut : -1

--calendar=FICHIER
Votre fichier calendrier. La valeur par défaut est d'utiliser le fichier pointé par vos préférences
fichier, qui est configuré la première fois que vous exécutez When.

--editor=COMMANDE
Commande utilisée pour appeler votre éditeur. Par défaut : "emacs -nw" Exemple : quand
--editor="vim"

--wrap=COLONNES
Nombre de colonnes de texte pour la sortie (ou 0 si vous ne voulez pas du tout de wrapping).
Par défaut: 80

--[non]wrap_auto
Essayez de détecter la largeur du terminal et définissez la largeur de la sortie
par conséquent. Cela ne s'applique que si la sortie est un tty, et est soumise à tout
maximum défini par --wrap_max. Remplace toute valeur définie par --wrap. Par défaut : non

--wrap_max=COLONNES
Nombre maximum de colonnes de texte pour la sortie (ou -1 si vous n'en voulez pas
maximum). Utile en combinaison avec --wrap_auto pour préserver la lisibilité sur très
grandes fenêtres de terminal. Par défaut : -1

--rows=COLONNES
Nombre de lignes de texte qui tiendront dans la fenêtre du terminal. Lors de l'inscription de votre
calendrier, la sortie sera tronquée à cette longueur, à moins que cela n'entraîne
inscription moins de trois jours dans le futur. Ce comportement est annulé (le
le nombre maximum de lignes est défini sur l'infini) si l'option --future est donnée
explicitement, ou si la commande m ou y est utilisée. Par défaut : 40

--[no]rows_auto
Essayez de détecter la hauteur du terminal, plutôt que d'utiliser la valeur définie dans
l'option --rows. Cela s'applique uniquement si la sortie est un tty. Remplace n'importe quelle valeur
défini par --rows. Par défaut : oui

--[aucun en-tête
Affiche les en-têtes en haut de la sortie des commandes i, c, w, m et y. Défaut:
Oui

--[pas] de pagination
Lorsque la sortie est plus longue que la valeur définie par rows ou rows_auto, utilisez un pager pour
afficher la sortie. (Les variables d'environnement PAGER et LESS sont respectées. Si
PAGER n'est pas défini, la valeur par défaut est "moins".) Par défaut : oui

--paging_less_options
Options supplémentaires si le téléavertisseur est « moins ». Par défaut : "-rXFE"

--[no]filter_accents_on_output
S'il faut changer les caractères accentués en caractères non accentués. Par défaut : oui, sauf si
la variable d'environnement $TERM est égale à "mlterm" ou "xterm".

--[non]styled_output
Si la sortie est un terminal, devrions-nous utiliser les codes de terminal ANSI pour le style ?
Par défaut : oui

--[no]styled_output_if_not_tty
Stylisez la sortie même s'il ne s'agit pas d'un terminal. Par défaut : non

--calendar_today_style=STYLE
--items_today_style=STYLE
Le premier d'entre eux indique comment styliser la date d'aujourd'hui lors de la création du calendrier (c)
commander. La seconde dit comment styliser le mot « aujourd'hui » lors de la réalisation des éléments (i)
commander. Valeurs par défaut : gras

Le style de la sortie peut être spécifié à l'aide des mots-clés suivants : bold,
souligné, clignotant. Pour changer la couleur du texte, utilisez ceux-ci : fgblack, fgred,
fggreen, fgyellow, fgblue, fgpurple, fgcyan, fgwhite. Pour changer l'arrière-plan
color, utilisez des mots-clés similaires, mais avec bg au lieu de fg. Exemple : quand
--calendar_today_style="bold,fgred,bgcyan" c

--préfiltre
Transférez le fichier de calendrier via un programme avant de le lire. Défaut: ""

--now="AMJ"
Imaginez qu'aujourd'hui soit une autre date.

--[no]neighboring_months
Le comportement par défaut de "lorsque c" est d'imprimer les calendriers du mois dernier, ce
mois, et le mois prochain. En choisissant --noneighboring_months, vous pouvez éviter d'imprimer
sur les mois non inclus dans la plage définie par --past et --future.

--[non]lundi_premier
Commencez la semaine à partir du lundi plutôt que du dimanche. Par défaut : non

--[no]orthodox_easter
Calculez Pâques selon le calendrier de l'Église orthodoxe orientale. Par défaut : non

--[non]ampm
Affichez l'heure de la journée en utilisant l'heure de 12 heures, plutôt que l'heure de 24 heures. Affecte également
l'analyse des temps d'entrée. Par défaut : oui

--auto_pm=x
Lorsque les heures sont saisies avec des heures inférieures à x et que AM ou PM n'est pas
explicitement spécifiés, supposent automatiquement qu'ils sont PM plutôt que AM.
Par défaut: 0

--[non]literal_only
Affichez uniquement les éléments qui sont donnés sous forme de dates littérales, par exemple, "2008 jul 4". Ne pas
afficher des éléments qui sont définis par des expressions, par exemple, des éléments périodiques comme "w=thu".
Par défaut : non

--expression_test
--version_bare
--make_filter_regex
--test_accent_filtering
Ces options sont utilisées en interne pour la construction et les tests.

DESCRIPTION

Quand est un programme de calendrier personnel extrêmement simple, destiné au geek Unix qui veut
quelque chose de minimaliste. Il peut garder une trace des choses que vous devez faire à des dates particulières.
Il existe de nombreux programmes de calendrier et de « gestionnaire d'informations personnelles », alors
quelles sont les raisons d'utiliser Quand?

C'est un programme très court et simple, vous pouvez donc facilement le bricoler vous-même.
Il ne dépend d'aucune bibliothèque, il est donc facile à installer. tu devrais pouvoir installer
sur n'importe quel système où Perl est disponible, même si vous n'avez pas les privilèges d'installation
bibliothèques.
Son format de fichier est un simple fichier texte, que vous pouvez éditer dans votre éditeur préféré.

Bien que Quand devrait fonctionner sur pratiquement n'importe quel système d'exploitation où Perl est disponible, en
ce document, je suppose que vous utilisez une version d'Unix.

INSTALLATION ET OBTENIR A DÉBUTÉ

Une fois connecté en tant que root, exécutez la commande suivante :

make install

Courir Quand pour la première fois en utilisant cette commande :

quand

Vous serez invité à fournir certaines informations nécessaires pour configurer votre fichier de calendrier.

UTILISATION

Si vous courez Quand à nouveau après l'exécution de la configuration initiale, il devrait imprimer une seule ligne de
texte, vous indiquant la date actuelle. Il n'imprimera rien d'autre, car votre
calendrier est vide, vous n'avez donc aucun rendez-vous à venir.

Vous pouvez maintenant commencer à mettre des éléments dans votre fichier de calendrier. Chaque élément est une ligne de texte qui
ressemble à ça:

2003 février 3, Envol pour Stockholm pour recevoir le prix Nobel.

Un moyen pratique de modifier votre fichier de calendrier consiste à utiliser cette commande :

quand e

Cela vous amène dans votre éditeur préféré (celui que vous avez choisi lorsque vous avez exécuté Quand pour le premier
temps).

La date doit être au format année-mois-jour, mais vous pouvez soit épeler le mois, soit lui donner
comme un nombre. (Les noms de mois sont insensibles à la casse, et cela n'a pas d'importance si vous représentez
Février comme F, Fe, Feb, Februa, ou autre. Ce doit juste être un match unique. Vous pouvez
donner une fin ., qui sera ignorée. En tchèque, "cer" peut être utilisé comme abréviation
pour Cerven et "cec" pour Cervenec.) Les espaces supplémentaires sont ignorés jusqu'à ce que vous entriez dans le
texte réel après la virgule. Les lignes vides et les lignes commençant par un signe # sont ignorées.

Si tu cours maintenant Quand, il imprimera une liste de tous les éléments de votre fichier de calendrier qui
tombent dans un certain intervalle de temps. (L'intervalle commence à partir d'hier. Quand essaie de
choisissez la fin de l'intervalle de temps pour que sa sortie s'adapte à la fenêtre de votre terminal, mais il
sera toujours au moins trois jours et pas plus de deux semaines dans le futur.) Pour tout voir
vos articles pour le mois prochain, faites ``quand m'', et de même pour un an, y, ou un seul
semaine, w.

Si vous faites ``quand c'', Quand imprime les calendriers du mois dernier, de ce mois-ci et du suivant
mois.

Vous pouvez combiner ces commandes. Par exemple, ``when cw'' imprimera des calendriers, et
puis vous montrer vos articles pour la semaine prochaine.

Pour les événements qui se produisent une fois par an, comme les anniversaires et les anniversaires, vous pouvez soit utiliser
un * au lieu de l'année,

* 25 déc , Noël

ou utilisez une année avec un astérisque :

1920* 29 août , Charlie Parker tourne \a, né en \y

Dans le deuxième exemple, \a vous indique quel âge aurait Charlie Parker cette année, et \y
reproduit l'année de sa naissance, c'est-à-dire que la sortie serait :

aujourd'hui 2003 août 29 Charlie Parker fête ses 83 ans, né en 1920

Pour les choses que vous devez faire chaque semaine, vous pouvez utiliser une expression de la forme w=xxx, où
xxx correspond aux premières lettres du nom du jour de la semaine dans votre langue. (Tu
doivent fournir suffisamment de lettres pour éliminer l'ambiguïté, par exemple, en anglais, w=th ou w=tu, pas
juste w=t.) Exemple :

w=dim , aller à l'église, 10:00

Vous pouvez également faire des tests plus sophistiqués que celui-ci ; pour plus d'informations, consultez la rubrique
« tests de fantaisie » ci-dessous. Voici comment configurer des jours fériés courants :

m=jan & w=mon & a=3 , Martin Luther King Day
* 14 fév , Saint Valentin
m=fév & w=mon & a=3 , anniversaire de Washington observé
m=mai & w=dim & a=2 , Fête des Mères
m=mai & w=mon & b=1 , Memorial Day
m=jun & w=sun & a=3 , fête des pères
* 4 juil., Jour de l'Indépendance
m=sep & w=mon & a=1 , Fête du Travail
m=oct & w=mon & a=2 , Columbus Day
m=oct & w=mon & a=2 , Thanksgiving (Canada)
* 11 novembre, jour de l'Armistice
m=nov & w=jeu & a=4 , Thanksgiving (États-Unis)
e=47 , Mardi Gras
e=46 , Mercredi des Cendres
e=7 , dimanche des Rameaux
e=0 , dimanche de Pâques
e=0-49 , Pentecôte (49 jours après Pâques)

Aux États-Unis, lorsque certains jours fériés tombent un week-end, les travailleurs fédéraux, ainsi que de nombreux
salariés du privé, bénéficiez d'un congé le lundi ou le vendredi. La liste complète est donnée sur
http://www.opm.gov/operating_status_schedules/fedhol/2011.asp. Si vous voulez un rappel de
à la fois les vacances et le jour où vous quittez le travail, voici un exemple de la façon dont vous définiriez
ça monte :

* 4 juil., Jour de l'Indépendance
m=juil & c=4 , Jour de l'Indépendance (considéré comme un jour férié fédéral)

INTERNATIONALISATION

Quand supporte au moins partiellement le tchèque, le danois, le néerlandais, l'anglais, le français, l'allemand,
grec, hongrois, italien, polonais, roumain, espagnol et ukrainien. Si Quand n'a pas été
traduit dans votre langue, ou n'a été que partiellement traduit, le texte qui n'a pas été
traduit sera affiché en anglais. Quand devrait détecter automatiquement ce
langue que vous utilisez (via votre variable d'environnement $LANG), et si Quand a été traduit
dans cette langue, c'est ce que vous obtiendrez -- Quandla sortie de sera dans votre langue, et
Quand s'attendra également à ce que vous utilisiez cette langue dans votre fichier de calendrier pour les noms des
mois et les jours de la semaine.

Votre fichier de calendrier doit être au format UTF-8 (ou ASCII, qui est un sous-ensemble d'UTF-8). Si votre
le fichier de calendrier est dans un autre codage, tel que ISO-8859, Quand sera généralement en mesure de
détecter cela et refusera de le lire. Les options de ligne de commande peuvent également contenir UTF-8.

Certains émulateurs de terminaux (aterm, ...) affichent les caractères accentués comme des ordures, mais d'autres
(mlterm, xterm...) peuvent les afficher correctement. Quand vérifie l'environnement $TERM
variable, et s'il est égal à "mlterm" ou "xterm", alors les caractères accentués seront
affiché. Sinon, ils sont filtrés de la sortie. Vous pouvez annuler cela en
mettre une ligne comme

filtre_accents_on_output = 0

or

filtre_accents_on_output = 1

dans votre ~/.quand/préférences déposer. Je serais intéressé d'avoir des nouvelles de tous les utilisateurs qui peuvent
suggèrent un meilleur mécanisme pour cela que d'essayer d'interpréter la variable $TERM.

En entrée, les accents sont autorisés, mais pas obligatoires, par exemple, dans un fichier d'entrée en français,
la date 2005 Fev 17 pourrait être donnée avec un e accentué ou un non accentué, et soit
marchera. Si un mois ou un jour de la semaine saisi ne correspond à aucun de ceux de votre
langue, alors Quand essaiera de l'interpréter comme de l'anglais à la place.

Vous pouvez mettre une ligne comme

langue = fr

dans votre fichier de préférences pour définir votre langue, ou fournissez l'option --language sur le
ligne de commande, mais ce n'est pas nécessaire si votre variable d'environnement $LANG est définie
correctement.

Format OF LES Préférences DOSSIER

Chaque ligne se compose de quelque chose comme ceci :

variable = valeur

Les espaces blancs sont ignorés partout sauf à l'intérieur de la valeur. Les noms de variables sont en casse-
insensible. Les lignes vides sont ignorées.

AUTRES EXEMPLES

Une commande utile pour que votre shell s'exécute lorsque vous vous connectez est la suivante :

quand --past=0 --future=1

Pour imprimer un calendrier pour une année complète à venir :

quand --past=0 --future=365 c

ÉCLATER UP VOTRE CALENDRIER QUAND VOUS Se Connecter IN

Votre calendrier ne vous sert à rien si vous oubliez de le regarder tous les jours. Un moyen facile
pour le faire apparaître lorsque vous vous connectez, votre fichier .xsession ou .xinitrc ressemble à
ce:

/usr/bin/when --past=0 --future=1 &>~/quand.aujourd'hui
emacs -géométrie 70x25 -bg bisque ~/quand.aujourd'hui &
startkde

Le fichier .xsession est utilisé si vous avez un gestionnaire de connexion graphique installé sur votre machine,
le .xinitrc si vous ne le faites pas. Dans cet exemple, la première ligne affiche votre calendrier dans un
déposer. Le chemin complet vers le Quand programme est donné, car la variable de chemin de votre shell
ne sera pas encore correctement initialisé lors de son exécution. La deuxième ligne fait apparaître une interface graphique emacs
fenêtre, qui est de couleur distinctive afin d'attirer votre attention. La dernière ligne
démarre votre gestionnaire de fenêtres, KDE dans cet exemple. Quel que soit le gestionnaire de fenêtres que vous utilisez, il suffit
assurez-vous de conserver la ligne préexistante dans le fichier qui la démarre, et assurez-vous que
cette ligne est la toute dernière du fichier.

TRI BY OF JOURNÉE

Si vous voulez que les divers éléments qui se trouvent un même jour soient imprimés dans un certain
ordre, la façon la plus simple de le faire est de les mettre dans cet ordre dans le fichier d'entrée. Cette
La méthode ne fonctionnera pas, cependant, lorsque certains des éléments se trouvent à des dates déterminées par
expressions plutôt que données explicitement. La raison la plus courante pour vouloir faire cela
genre de chose, c'est que vous avez des choses à faire à certains moments de la journée, et
vous voulez qu'ils soient triés dans le temps. Dans cette situation, vous pouvez donner une heure au début
du texte de l'article, et Quand le reconnaîtra et triera les éléments par heure. Les temps peuvent être
au format h:mm ou hh:mm. Si --ampm est défini, alors un suffixe facultatif a ou p peut être utilisé pour
AM ou PM, par exemple, 9h30 pour 9h30. Si vous utilisez l'heure AM/PM, vous pouvez également, par exemple, régler
--auto_pm=9 pour que les heures inférieures à 9 soient automatiquement considérées comme PM. Voici un
Exemple:

2010 avr 25 , 7:00 dîner à la commune anarcho-syndicaliste
w=dim , 10:00 église

Le 25 avril 2010 est un dimanche, donc à cette date, ces deux éléments seront affichés. Si
--auto_pm est défini sur 8 ou plus, alors 7:00 sera automatiquement interprété comme 7:00
PM, et la date du dîner sera affichée sous la cérémonie de l'église du matin.

COLLECTION ÉTINCELANTE ESSAIS

En plus de w, discuté ci-dessus, il y a un tas d'autres variables que vous pouvez tester :

w - jour de la semaine
m - mois
j - jour du mois
y - année
j - numéro de jour julien modifié
a - 1 pour les 7 premiers jours du mois, 2 pour les 7 suivants, etc.
b - 1 pour les 7 derniers jours du mois, 2 pour les 7 précédents, etc.
c - le lundi ou le vendredi, correspond au jour du mois du jour de week-end le plus proche ; sinon -1
e - jours jusqu'à Pâques (occidentale) de cette année
z - jour de l'année (1 le jour du Nouvel An)

Vous pouvez spécifier les mois soit sous forme de nombres, m=2, soit sous forme de noms dans votre langue, m=feb. Tu
peut également utiliser les opérateurs logiques & (et) et | (ou). L'exemple suivant vous rappelle
pour payer vos employés le premier et le quinzième de chaque mois :

d=1 | d=15 , Payer les employés.

Cet exemple vous rappelle de répéter avec votre groupe le dernier samedi de chaque mois :

w=sat & b=1 , Répétez avec le groupe.

Les deux lignes suivantes

* 25 déc , Noël
m=déc & j=25 , Noël

les deux font exactement la même chose, mais la première version est plus facile à comprendre et rend
le programme s'exécute plus rapidement. (Quand vous faites un test, Quand doit traverser tous les jours dans le
plage de dates que vous avez demandée et évaluez le test pour chacun de ces jours. Sur ma machine,
si j'imprime un calendrier pour une année entière, en utilisant un fichier contenant 10 tests simples, il
prend quelques secondes.) Les parenthèses peuvent également être utilisées.

Selon votre nationalité et votre religion, vous avez probablement un tas de vacances qui
ne mentez pas à des dates fixes. Dans le christianisme, nombre d'entre elles (les "fêtes mobiles") sont
calculé par rapport au dimanche de Pâques, c'est pourquoi la variable e est utile.

Il y a un opérateur not, ! :

w=ven & !(m=dec & d=25) , jeu de poker

Il existe un opérateur modulo, %, et un opérateur de soustraction, -. En les utilisant, avec les
j variable, c'est à peine possible pour Quandest un petit parseur pour effectuer ce qui suit
exploit:

!(j%14-1) , fais quelque chose un mercredi sur deux

La logique derrière ce petit morceau de sorcellerie idiot est la suivante. Tout d'abord, nous déterminons,
en utilisant la commande `when j --now="2005 jan 26"', que le premier mercredi sur lequel nous voulons
pour ce faire a un jour julien qui est égal à 1, modulo 14. Ensuite, nous écrivons cette expression ainsi
que si c'est un mercredi dont le jour julien vaut 1, modulo 14, la quantité entre parenthèses
sera zéro, et prendre sa négation logique donnera une valeur vraie.

L'associativité et l'ordre de priorité des opérateurs (du plus élevé au plus bas) sont les suivants :

la gauche %
la gauche -
gauche < > <= >=
gauche = !=
droit !
la gauche &
gauche |

COMPRENANT DES DOSSIERS

Si votre fichier de calendrier devient trop volumineux, vous préférerez peut-être le diviser en plus petits morceaux --
peut-être un pour les anniversaires, un pour les fêtes tibétaines, etc. Un moyen facile d'accomplir
c'est pour installer le programme m4, mettre la ligne

préfiltre = m4 -P

dans votre fichier de préférences, puis mettez des lignes dans votre fichier de calendrier comme ceci :

m4_include(/home/votrenom/.quand/anniversaires)

ENVIRONNEMENT

$LANG pour détecter automatiquement la langue de l'utilisateur

TERME $ pour essayer de savoir si l'émulateur de terminal peut afficher des caractères accentués

À utiliser en ligne à l'aide des services onworks.net