wanneer - Online in de cloud

PROGRAMMA:

NAAM

Wanneer - een minimalistisch persoonlijk kalenderprogramma

KORTE INHOUD

wanneer

wanneer [opties] [commando's]

Het basisidee is om gewoon `when' in te typen op de opdrachtregel. De eerste keer dat u de
programma, zal het u om wat installatie-informatie vragen. Om je agendabestand in je . te bewerken
favoriete editor, doe `wanneer e'. Het basisformaat van het kalenderbestand is als volgt:

2003 februari 3, Vlieg naar Stockholm om de Nobelprijs in ontvangst te nemen.

Als je eenmaal een kalenderbestand hebt, voer je het programma uit als gewoon oud `wanneer' van het commando
line zal de dingen in je agenda voor de komende twee weken afdrukken.

COMMANDO'S

i Druk aankomende items af in uw agenda. (Dit is de standaardopdracht.)

c Kalenders afdrukken (rasters zoals op een wandkalender, geen items weergeven) voor de afgelopen maand,
deze maand en volgende maand.

e Roep uw favoriete editor op om uw agendabestand te bewerken.

w,m,y Print items voor de komende week, maand of jaar, in plaats van voor de standaard
periode van twee weken.

j Druk de gewijzigde Juliaanse dag af (handig om het tijdsinterval tussen twee te vinden)
data).

d Druk niets anders af dan de huidige datum.

OPTIES

Alle volgende opties, behalve --help, kunnen worden ingesteld in het voorkeurenbestand.
True/false-opties kunnen op de opdrachtregel worden ingesteld als --option of --nooption, en in de
voorkeurenbestand door de optie in te stellen op 0 of 1.

--help Drukt een kort helpbericht af.

--versie
Drukt een kort bericht af, inclusief een verklaring van welke versie van de software het is
hij precies is.

--taal=LANG
Stel de taal in op LANG. Zie de paragraaf hieronder over internationalisering. Dit
optie is normaal gesproken niet nodig, omdat de taal automatisch wordt gedetecteerd.

--toekomst=DAGEN
Hoeveel dagen in de toekomst strekt het rapport zich uit. Standaard: 14

--verleden=DAGEN
Hoeveel dagen in het verleden strekt het rapport zich uit. Zoals de --future optie, --past
wordt geïnterpreteerd als een offset ten opzichte van de huidige datum, dus normaal gesproken zou u:
wil dat dit een negatieve waarde is. Standaard: -1

--calendar=BESTAND
Uw agendabestand. De standaard is om het bestand te gebruiken waarnaar uw voorkeuren verwijzen
bestand, dat wordt ingesteld wanneer u When voor het eerst uitvoert.

--editor=OPDRACHT
Commando gebruikt om uw editor aan te roepen. Standaard: "emacs -nw" Voorbeeld: wanneer
--editor="vim"

--wrap=KOLOMMEN
Aantal kolommen tekst voor de uitvoer (of 0 als u helemaal geen terugloop wilt).
Standaard: 80

--[geen]wrap_auto
Poging om de breedte van de terminal te detecteren en de breedte van de uitvoer in te stellen
overeenkomstig. Dit is alleen van toepassing als de uitvoer een tty is en onderhevig is aan enige
maximum ingesteld door --wrap_max. Overschrijft elke waarde die is ingesteld door --wrap. Standaard: nee

--wrap_max=KOLOMMEN
Maximaal aantal kolommen tekst voor de uitvoer (of -1 als u er geen wilt)
maximaal). Handig in combinatie met --wrap_auto om de leesbaarheid te behouden op zeer
grote terminalvensters. Standaard: -1

--rijen=KOLOMMEN
Aantal rijen tekst dat in het terminalvenster past. Bij het vermelden van uw
kalender, wordt de output afgekapt tot deze lengte, tenzij dat zou resulteren in
notering minder dan drie dagen in de toekomst. Dit gedrag wordt overschreven (de
maximum aantal rijen is ingesteld op oneindig) als de optie --future is opgegeven
expliciet, of als de opdracht m of y wordt gebruikt. Standaard: 40

--[geen]rijen_auto
Probeer de hoogte van de terminal te detecteren in plaats van de waarde te gebruiken die is ingesteld in
de --rows optie. Dit is alleen van toepassing als de uitvoer een tty is. Overschrijft elke waarde
ingesteld door --rijen. Standaard: ja

--[geen]koptekst
Print headers bovenaan de uitvoer van de i, c, w, m en y commando's. Standaard:
ja

--[geen]paging
Als de uitvoer langer is dan de waarde die is ingesteld door rijen of rijen_auto, gebruik dan een semafoon om
de uitvoer weergeven. (De omgevingsvariabelen PAGER en LESS worden gerespecteerd. Als
PAGER is niet ingesteld, de standaard is "minder.") Standaard: ja

--paging_less_options
Extra opties als de pager "minder" is. Standaard: "-rXFE"

--[geen]filter_accenten_op_uitvoer
Of tekens met accenten moeten worden gewijzigd in tekens zonder accent. Standaard: ja, tenzij
de omgevingsvariabele $TERM is gelijk aan "mlterm" of "xterm".

--[geen]opgemaakte_uitvoer
Als de uitvoer een terminal is, moeten we dan ANSI-terminalcodes gebruiken voor styling?
Standaard: ja

--[geen]styled_output_if_not_tty
Style de uitvoer, zelfs als het geen terminal is. Standaard: nee

--calendar_today_style=STIJL
--items_today_style=STIJL
De eerste hiervan zegt hoe je de datum van vandaag kunt stylen bij het doen van de kalender (c)
opdracht. De tweede zegt hoe je het woord ``vandaag'' moet stylen bij het doen van de items (i)
opdracht. Standaardinstellingen: vet

De stijl van de uitvoer kan worden gespecificeerd met behulp van de volgende trefwoorden: vet,
onderstreept, knipperend. Gebruik deze om de kleur van de tekst te wijzigen: fgblack, fgred,
fggroen, fggeel, fgblauw, fgpaars, fgcyaan, fgwit. De achtergrond wijzigen
kleur, gebruik vergelijkbare trefwoorden, maar met bg in plaats van fg. Voorbeeld: wanneer
--calendar_today_style="bold,fgred,bgcyan" c

--voorfilter
Leid het kalenderbestand door een programma voordat u het leest. Standaard: ""

--nu="YMD"
Doe alsof vandaag een andere datum is.

--[geen]buren_maanden
Het standaardgedrag van "wanneer c" is om kalenders voor de afgelopen maand af te drukken, dit
maand en volgende maand. Door --geen aangrenzende_maanden te kiezen, kunt u afdrukken vermijden
out maanden niet inbegrepen in het bereik ingesteld door --verleden en --toekomst.

--[nee]maandag_eerst
Begin de week vanaf maandag in plaats van zondag. Standaard: nee

--[geen]orthodox_pasen
Bereken Pasen volgens de kalender van de Orthodoxe Oosterse Kerk. Standaard: nee

--[nee]ampm
Geef de tijd van de dag weer met 12-uurs tijd in plaats van 24-uurs tijd. Heeft ook invloed op
het ontleden van invoertijden. Standaard: ja

--auto_pm=x
Wanneer tijden worden ingevoerd met uren die kleiner zijn dan x, en AM of PM niet
expliciet gespecificeerd, automatisch aannemen dat ze PM zijn in plaats van AM.
Standaard: 0

--[no]letterlijk_alleen
Geef alleen items weer die zijn opgegeven als letterlijke datums, bijv. "2008 jul 4". niet doen
items weergeven die worden gedefinieerd door uitdrukkingen, bijv. periodieke items zoals "w=thu".
Standaard: nee

--test_expressie
--bare_versie
--make_filter_regex
--test_accent_filtering
Deze opties worden intern gebruikt voor het bouwen en testen.

PRODUCTBESCHRIJVING

. is een uiterst eenvoudig persoonlijk kalenderprogramma, gericht op de Unix-nerd die wil
iets minimalistisch. Het kan dingen bijhouden die u op bepaalde data moet doen.
Er zijn veel agenda- en ``personal information manager''-programma's, dus
welke redenen zijn er om te gebruiken? .?

Het is een heel kort en simpel programma, dus je kunt er makkelijk zelf aan sleutelen.
Het is niet afhankelijk van bibliotheken, dus het is eenvoudig te installeren. Je zou in staat moeten zijn om te installeren
het op elk systeem waarop Perl beschikbaar is, zelfs als u geen installatierechten heeft
bibliotheken.
Het bestandsformaat is een eenvoudig tekstbestand, dat u in uw favoriete editor kunt bewerken.

Hoewel . zou moeten draaien op vrijwel elk besturingssysteem waarop Perl beschikbaar is, in
dit document Ik neem aan dat je een soort Unix draait.

INSTALLATIE EN KRIJGEN BEGONNEN

Terwijl u bent aangemeld als root, voert u de volgende opdracht uit:

make install

lopen . voor de eerste keer met dit commando:

wanneer

U wordt gevraagd om wat informatie die nodig is om uw agendabestand in te stellen.

GEBRUIK

Als je rent . opnieuw na de eerste setup-run, zou het een enkele regel moeten afdrukken met:
tekst, die u de huidige datum vertelt. Er wordt niets anders afgedrukt, omdat uw
agendabestand is leeg, dus er staan ​​geen afspraken op stapel.

Nu kunt u items in uw agendabestand plaatsen. Elk item is een regel tekst die:
het lijkt hierop:

2003 februari 3, Vlieg naar Stockholm om de Nobelprijs in ontvangst te nemen.

Een handige manier om uw agendabestand te bewerken is met deze opdracht:

wanneer e

Hiermee kom je in je favoriete editor (degene die je hebt gekozen toen je draaide) . voor het eerst
tijd).

De datum moet in de notatie jaar-maand-dag zijn, maar je kunt de maand spellen of hem geven
als een nummer. (Maandnamen zijn niet hoofdlettergevoelig, en het maakt niet uit of u vertegenwoordigt
Februari als F, Fe, Feb, Februa of wat dan ook. Het moet gewoon een unieke match zijn. Jij kan
geef een trailing ., die wordt genegeerd. In het Tsjechisch kan "cer" als afkorting worden gebruikt
voor Cerven, en "cec" voor Cervenec.) Extra witruimte wordt genegeerd totdat u in de . komt
werkelijke tekst na de komma. Lege regels en regels die beginnen met een #-teken worden genegeerd.

Als je nu rent ., het zal een lijst afdrukken van alle items in uw agendabestand die
vallen binnen een bepaald tijdsinterval. (Het interval begint vanaf gisteren. . probeert te
kies het einde van het tijdsinterval zodat de uitvoer in uw terminalvenster past, maar het is
zal altijd ten minste drie dagen zijn, en niet meer dan twee weken in de toekomst.) Om alles te zien
uw items voor de volgende maand, doe ``wanneer m'', en op dezelfde manier voor een jaar, y, of een enkele
week, w.

Als u ``wanneer c'' doet, . drukt kalenders af voor vorige maand, deze maand en volgende
maand.

U kunt deze opdrachten combineren. Bijvoorbeeld, ``wanneer cw'' zal kalenders afdrukken, en
laat u vervolgens uw items voor de volgende week zien.

Voor evenementen die één keer per jaar plaatsvinden, zoals verjaardagen en jubilea, kunt u ofwel
een * in plaats van het jaartal,

* 25 december, Kerstmis

of gebruik een jaartal met een asterisk:

1920* 29 aug, Charlie Parker wordt \a, geboren in \y

In het tweede voorbeeld vertelt \a hoe oud Charlie Parker dit jaar zou zijn, en \y
reproduceert het jaar waarin hij werd geboren, dat wil zeggen, de output zou zijn:

vandaag 2003 aug 29 Charlie Parker wordt 83, geboren in 1920

Voor dingen die je elke week moet doen, kun je een uitdrukking van de vorm w=xxx gebruiken, waarbij
xxx zijn de eerste paar letters van de naam van de dag van de week in uw taal. (Jij
moet voldoende letters leveren om dubbelzinnigheid te voorkomen, bijv. in het Engels, w=th of w=tu, not
alleen w=t.) Voorbeeld:

w=zon , ga naar de kerk, 10:00

Je kunt ook liefhebbertesten doen dan dit; voor meer informatie, zie de sectie
'fancy-tests' hieronder. Ga als volgt te werk om een ​​aantal veelvoorkomende feestdagen in te stellen:

m=jan & w=ma & a=3 , Martin Luther King Day
* 14 februari, Valentijnsdag
m=feb & w=ma & a=3 , Washington's verjaardag waargenomen
m=mei & w=zon & a=2 , Moederdag
m=mei & w=ma & b=1 , Memorial Day
m=jun & w=zon & a=3 , Vaderdag
* 4 juli, Onafhankelijkheidsdag
m=sep & w=ma & a=1 , Dag van de Arbeid
m=okt & w=ma & a=2 , Columbusdag
m=okt & w=ma & a=2 , Thanksgiving (Canada)
* 11 nov, Wapenstilstandsdag
m=nov & w=do & a=4 , Thanksgiving (VS)
e=47, Mardi Gras
e=46 , Aswoensdag
e=7 , Palmzondag
e=0 , Paaszondag
e=0-49 , Pinksteren (49 dagen na Pasen)

In de VS, wanneer bepaalde feestdagen in een weekend vallen, hebben federale werknemers, evenals vele
particuliere werknemers, krijg een maandag of vrijdag vrij. De volledige lijst is te vinden op:
http://www.opm.gov/operating_status_schedules/fedhol/2011.asp. Als je een herinnering wilt van
zowel de vakantie als de dag dat u vrijkomt van uw werk, hier is een voorbeeld van hoe u dit zou instellen
dat omhoog:

* 4 juli, Onafhankelijkheidsdag
m=jul & c=4 , Onafhankelijkheidsdag (waargenomen als een federale feestdag)

INTERNATIONALISERING

. heeft ten minste gedeeltelijke ondersteuning voor Tsjechisch, Deens, Nederlands, Engels, Frans, Duits,
Grieks, Hongaars, Italiaans, Pools, Roemeens, Spaans en Oekraïens. Indien . is niet geweest
vertaald in uw taal, of slechts gedeeltelijk is vertaald, de tekst die niet
vertaald is, wordt weergegeven in het Engels. . zou automatisch moeten detecteren wat
taal die u gebruikt (via uw $LANG-omgevingsvariabele), en als . is vertaald
in die taal, dat krijg je -- .'s output zal in jouw taal zijn, en
. verwacht ook dat je die taal in je agendabestand gebruikt voor de namen van de
maanden en de dagen van de week.

Uw agendabestand moet in UTF-8 zijn (of ASCII, een subset van UTF-8). Als jouw
kalenderbestand is in een andere codering, zoals ISO-8859, . zal normaal gesproken in staat zijn om
detecteren dat, en zal weigeren om het te lezen. Opdrachtregelopties kunnen ook UTF-8 bevatten.

Sommige terminalemulators (aterm, ...) geven tekens met accenten weer als rommel, maar andere
(mlterm, xterm...) kunnen ze correct weergeven. . controleert de $TERM-omgeving
variabele, en als het gelijk is aan "mlterm" of "xterm", dan zijn tekens met accenten
weergegeven. Anders worden ze uit de uitvoer gefilterd. U kunt dit overschrijven door:
een regel zetten zoals

filter_accenten_op_uitvoer = 0

or

filter_accenten_op_uitvoer = 1

in ~/.wanneer/voorkeuren het dossier. Ik zou graag willen horen van gebruikers die dat kunnen
suggereren hiervoor een beter mechanisme dan te proberen de $TERM-variabele te interpreteren.

Bij invoer zijn accenten toegestaan, maar niet verplicht, bijv. in een Franstalig invoerbestand,
de datum 2005 februari 17 kan worden gegeven met een e met een accent of een niet-geaccentueerd, en ofwel
zal werken. Als een ingevoerde maand of dag van de week niet overeenkomt met een van de voor uw
taal, dan? . zal proberen het in plaats daarvan als Engels te interpreteren.

Je kunt een regel zetten als

taal = fr

in uw voorkeurenbestand om uw taal in te stellen, of geef de --language optie op de
opdrachtregel, maar dat is niet nodig als uw omgevingsvariabele $LANG is ingesteld
correct.

FORMAT OF HET VOORKEUREN FILE

Elke regel bestaat uit zoiets als dit:

variabele = waarde

Witruimte wordt overal genegeerd, behalve binnen de waarde. Variabele namen zijn hoofdletter-
ongevoelig. Blanco regels worden genegeerd.

MEER Voorbeelden

Een handig commando om je shell te laten uitvoeren wanneer je inlogt is dit:

wanneer --past=0 --future=1

Om een ​​kalender voor een heel jaar uit te printen:

wanneer --past=0 --future=365 c

POPPEN UP JOUW KALENDER WANNEER U LOG IN

Je agenda heeft geen zin als je vergeet er elke dag naar te kijken. Een gemakkelijke manier
om het te laten verschijnen wanneer u zich aanmeldt, is om uw .xsession- of .xinitrc-bestand eruit te laten zien:
deze:

/usr/bin/when --past=0 --future=1 &>~/wanneer.vandaag
emacs -geometrie 70x25 -bg bisque ~/wanneer.vandaag &
startkde

Het .xsession-bestand wordt gebruikt als u een grafische login-manager op uw computer hebt ingesteld,
de .xinitrc als u dat niet doet. In dit voorbeeld voert de eerste regel uw agenda uit naar a
het dossier. Het volledige pad naar de . programma wordt gegeven, omdat de padvariabele van je shell
wordt nog niet goed geïnitialiseerd wanneer dit wordt uitgevoerd. Op de tweede regel verschijnt een GUI emacs
raam, dat opvallend gekleurd is, zodat het in het oog springt. de laatste regel
start uw windowmanager, KDE in dit voorbeeld. Welke windowmanager je ook gebruikt, gewoon
zorg ervoor dat u de reeds bestaande regel behoudt in het bestand waarmee deze begint, en zorg ervoor dat:
die regel is de allerlaatste in het bestand.

SORTEREN BY TIJD OF DAG

Als je wilt dat de verschillende items die op één dag liggen in een bepaalde tijd worden afgedrukt
volgorde, is de eenvoudigste manier om ze in die volgorde in het invoerbestand te plaatsen. Dat
methode werkt echter niet wanneer sommige items op datums liggen die worden bepaald door
uitdrukkingen in plaats van expliciet gegeven. De meest voorkomende reden om dit te willen doen
soort ding is dat je dingen hebt die je op bepaalde tijden van de dag moet doen, en
je wilt dat ze op tijd worden gesorteerd. In deze situatie kunt u aan het begin een tijd geven
van de tekst van het item, en . zal dat herkennen en de items sorteren op tijd. Tijden kunnen zijn
in u:mm of uu:mm formaat. Als --ampm is ingesteld, kan een optioneel achtervoegsel a of p worden gebruikt voor
AM of PM, bijvoorbeeld 9 uur voor 30 uur. Als u AM/PM-tijd gebruikt, kunt u ook bijv
--auto_pm=9 zodat uren minder dan 9 automatisch als PM worden beschouwd. Hier is een
voorbeeld:

2010 apr 25 , 7:00 diner in de anarcho-syndicalistische commune
w=zo , 10:00 kerk

25 april 2010 is een zondag, dus op die datum worden beide items weergegeven. Indien
--auto_pm is ingesteld op 8 of hoger, dan wordt 7:00 automatisch geïnterpreteerd als 7:00
PM, en de dinerdatum wordt weergegeven onder de ochtendkerkceremonie.

ZIN IN HEBBEN PROEVEN

Naast w, hierboven besproken, zijn er nog een aantal andere variabelen die u kunt testen:

w - dag van de week
m - maand
d - dag van de maand
j - jaar
j - gewijzigd Juliaans dagnummer
a - 1 voor de eerste 7 dagen van de maand, 2 voor de volgende 7, enz.
b - 1 voor de laatste 7 dagen van de maand, 2 voor de voorgaande 7, enz.
c - op maandag of vrijdag is gelijk aan de dag van de maand van de dichtstbijzijnde weekenddag; anders -1
e - dagen tot de (westerse) Pasen van dit jaar
z - dag van het jaar (1 op nieuwjaarsdag)

U kunt maanden opgeven als getallen, m=2, of als namen in uw taal, m=feb. Jij
kan ook de logische operatoren & (en) en | . gebruiken (of). Het volgende voorbeeld herinnert u eraan:
om uw werknemers uit te betalen op de eerste en de vijftiende van elke maand:

d=1 | d=15 , Betaal werknemers.

Dit voorbeeld herinnert je eraan om elke laatste zaterdag van de maand met je band te repeteren:

w=sat & b=1 , Repeteren met band.

De volgende twee regels:

* 25 december, Kerstmis
m=dec & d=25 , Kerstmis

beide doen precies hetzelfde, maar de eerste versie is gemakkelijker te begrijpen en maakt
het programma loopt sneller. (Als je een test doet, . moet elke dag doorlopen in de
bereik van datums waar u om hebt gevraagd, en evalueer de test voor elk van die dagen. Op mijn automaat,
als ik een kalender voor een heel jaar uitprint, met een bestand met 10 eenvoudige tests erin, dan is het
duurt een paar seconden.) Haakjes kunnen ook worden gebruikt.

Afhankelijk van je nationaliteit en religie heb je waarschijnlijk een heleboel vakanties die
lieg niet op vaste data. In het christendom zijn veel van deze (de "verplaatsbare feesten"):
berekend ten opzichte van Paaszondag, daarom is de variabele e nuttig.

Er is een niet-operator, !:

w=vr & !(m=dec & d=25) , pokerspel

Er is een modulo-operator, %, en een aftrekkingsoperator, -. Met behulp van deze, samen met de
j variabel, het is gewoon nauwelijks mogelijk voor .'s kleine parser om het volgende uit te voeren:
prestatie:

!(j%14-1), doe om de andere woensdag iets

De logica achter dit dwaze stukje tovenarij gaat als volgt. Eerst bepalen we,
met het commando `when j --now="2005 jan 26"', dat de eerste woensdag is waarop we willen
om dit te doen heeft een Juliaanse dag die gelijk is aan 1, modulo 14. Dan schrijven we deze uitdrukking zo
dat als het een woensdag is waarvan de Juliaanse dag gelijk is aan 1, modulo 14, de hoeveelheid tussen haakjes
zal nul zijn, en het nemen van de logische ontkenning ervan zal een echte waarde opleveren.

De associativiteit en prioriteitsvolgorde van de operators (van hoog naar laag) is als volgt:

links %
links -
links < > <= >=
links = !=
gelijk!
links &
links |

INCLUSIEF FILES

Als je agendabestand te groot wordt, kun je het misschien liever opsplitsen in kleinere stukken --
misschien een voor verjaardagen, een voor Tibetaanse feestdagen, enz. Een gemakkelijke manier om te bereiken
dit is om het programma m4 te installeren, zet de regel

voorfilter = m4 -P

in uw voorkeurenbestand en plaats vervolgens regels in uw agendabestand als volgt:

m4_include(/home/jouwnaam/.wanneer/verjaardagen)

MILIEU

$ LANG om automatisch de taal van de gebruiker te detecteren

$ TERMIJN om te proberen te achterhalen of de terminalemulator tekens met accenten kan weergeven

Gebruik wanneer u online bent met onworks.net-services