kiedy - Online w chmurze

PROGRAM:

IMIĘ

Kiedy - minimalistyczny program kalendarza osobistego

STRESZCZENIE

jeśli chodzi o komunikację i motywację

kiedy [opcje] [polecenia]

Podstawową ideą jest po prostu wpisanie „kiedy” w wierszu poleceń. Przy pierwszym uruchomieniu
program, wyświetli monit o podanie pewnych informacji konfiguracyjnych. Aby edytować plik kalendarza w pliku
ulubiony redaktor, wykonaj „When e”. Podstawowy format pliku kalendarza wygląda następująco:

2003 lutego 3, lot do Sztokholmu, aby odebrać Nagrodę Nobla.

Kiedy już będziesz mieć plik kalendarza, uruchom program w zwykły sposób „when” z polecenia
line wydrukuje rzeczy z Twojego kalendarza na następne dwa tygodnie.

POLECENIA

i Wydrukuj nadchodzące pozycje w swoim kalendarzu. (To jest polecenie domyślne.)

c Drukuj kalendarze (siatki jak w kalendarzu ściennym, nie pokazując pozycji) za ostatni miesiąc,
w tym i następnym miesiącu.

e Wywołaj swojego ulubionego edytora, aby edytować plik kalendarza.

w,m,y Drukuj elementy na nadchodzący tydzień, miesiąc lub rok, a nie ustawienia domyślne
okres dwóch tygodni.

j Wydrukuj zmodyfikowany dzień juliański (przydatny do znalezienia odstępu czasu między dwoma
Daktyle).

d Drukuj tylko bieżącą datę.

OPCJE

Wszystkie poniższe opcje, z wyjątkiem --help, można ustawić w pliku preferencji.
Opcje prawda/fałsz można ustawić w wierszu poleceń jako --option lub --nooption oraz w pliku
preferencji, ustawiając opcję na 0 lub 1.

--help Wyświetla krótką wiadomość pomocy.

--wersja
Drukuje krótki komunikat zawierający informację, jaką wersję oprogramowania posiada
jest.

--język=JĘZYK
Ustaw język na LANG. Zobacz poniższą sekcję dotyczącą internacjonalizacji. Ten
opcja nie jest zwykle potrzebna, ponieważ język jest wykrywany automatycznie.

--przyszłość=DNI
O ile dni w przyszłość rozciąga się raport. Wartość domyślna: 14

--przeszłe=DNI
O ile dni w przeszłości rozciąga się raport. Podobnie jak opcja --future, --past
jest interpretowane jako przesunięcie w stosunku do bieżącej daty, więc zwykle tak jest
chcę, żeby to była wartość ujemna. Wartość domyślna: -1

--calendar=PLIK
Twój plik kalendarza. Domyślnie używany jest plik wskazany w Twoich preferencjach
plik konfigurowany przy pierwszym uruchomieniu When.

--editor=POLECENIE
Polecenie używane do wywołania edytora. Wartość domyślna: „emacs -nw” Przykład: kiedy
--editor="vim"

--wrap=KOLUMNY
Liczba kolumn tekstu wyjściowego (lub 0, jeśli w ogóle nie chcesz zawijać).
Domyślnie: 80

--[nie]wrap_auto
Spróbuj wykryć szerokość terminala i ustaw szerokość wyjścia
odpowiednio. Ma to zastosowanie tylko wtedy, gdy wyjściem jest tty i podlega any
maksimum ustawione przez --wrap_max. Zastępuje dowolną wartość ustawioną przez --wrap. Domyślnie: nie

--wrap_max=KOLUMNY
Maksymalna liczba kolumn tekstu w wynikach (lub -1, jeśli ich nie chcesz
maksymalny). Przydatne w połączeniu z --wrap_auto, aby zachować czytelność na bardzo
duże okna terminala. Wartość domyślna: -1

--rows=KOLUMNY
Liczba wierszy tekstu, które zmieszczą się w oknie terminala. Podczas wystawiania swojego
kalendarz, dane wyjściowe zostaną obcięte do tej długości, chyba że spowodowałoby to
wybiegając w przyszłość za mniej niż trzy dni. To zachowanie jest zastępowane (plik
maksymalna liczba wierszy jest ustawiona na nieskończoność), jeśli podano opcję --future
jawnie lub jeśli użyto polecenia m lub y. Wartość domyślna: 40

--[nie]wiersze_auto
Spróbuj wykryć wysokość terminala, zamiast używać ustawionej wartości
opcję --rows. Ma to zastosowanie tylko wtedy, gdy wyjściem jest tty. Zastępuje dowolną wartość
ustawiony przez --rows. Domyślnie: tak

--[bez nagłówka
Drukuj nagłówki na górze wyników poleceń i, c, w, m i y. Domyślny:
tak

--[nie]stronicowania
Jeśli wynik jest dłuższy niż wartość ustawiona przez rows lub rows_auto, użyj pagera
wyświetlić dane wyjściowe. (Respektowane są zmienne środowiskowe PAGER i LESS. If
PAGER nie jest ustawiony, wartość domyślna to „mniej.”) Wartość domyślna: tak

--opcje_bez_stronicowania
Dodatkowe opcje, jeśli pager jest „mniejszy”. Wartość domyślna: „-rXFE”

--[nie]filter_accents_on_output
Określa, czy zmienić znaki akcentowane na znaki bez akcentu. Domyślnie: tak, chyba że
zmienna środowiskowa $TERM jest równa „mlterm” lub „xterm”.

--[nie]stylizowane_wyjście
Jeśli wyjściem jest terminal, czy powinniśmy używać kodów terminali ANSI do stylizacji?
Domyślnie: tak

--[nie]styled_output_if_not_tty
Stylizuj dane wyjściowe, nawet jeśli nie jest to terminal. Domyślnie: nie

--calendar_today_style=STYL
--items_today_style=STYL
Pierwsza z nich mówi, jak stylizować dzisiejszą datę podczas tworzenia kalendarza (c)
Komenda. Drugi mówi, jak nadać styl słowu „dzisiaj” podczas wykonywania zadań (i)
Komenda. Wartość domyślna: pogrubiona

Styl wydruku można określić za pomocą następujących słów kluczowych: pogrubienie,
podkreślone, migające. Aby zmienić kolor tekstu użyj: fgblack, fgred,
fgzielony, fgżółty, fgniebieski, fgfioletowy, fgcyjan, fgbiały. Aby zmienić tło
color, użyj podobnych słów kluczowych, ale z bg zamiast fg. Przykład: kiedy
--calendar_today_style="pogrubienie,fgred,bgcyan" c

--filtr wstępny
Przepuść plik kalendarza przez program przed jego przeczytaniem. Domyślny: ""

--teraz="YMD"
Udawaj, że dzisiaj jest jakiś inny dzień.

--[no]sąsiedzkie_miesiące
Domyślnym zachowaniem „When c” jest drukowanie kalendarzy za ostatni miesiąc
miesiąc i następny miesiąc. Wybierając --noneighboring_months, możesz uniknąć drukowania
miesiące poza zakresem ustawionym przez --past i --future.

--[nie]poniedziałek_pierwszy
Zacznij tydzień od poniedziałku, a nie od niedzieli. Domyślnie: nie

--[nie]ortodoksyjna_wielkanoc
Oblicz Wielkanoc według kalendarza prawosławnego Kościoła wschodniego. Domyślnie: nie

--[nie]amp
Wyświetlaj godzinę w formacie 12-godzinnym, a nie 24-godzinnym. Wpływa również
parsowanie czasów wejściowych. Domyślnie: tak

--auto_pm=x
Gdy czasy są wprowadzane z godzinami mniejszymi niż x, a przed południem lub wieczorem nie
wyraźnie określone, automatycznie zakładają, że są to PM, a nie AM.
Domyślnie: 0

--[nie]tylko_literalne
Wyświetlaj tylko pozycje podane w formie dosłownej, np. „2008 lipca 4 r.”. Nie
wyświetla elementy zdefiniowane za pomocą wyrażeń, np. elementy okresowe, takie jak „w=czw”.
Domyślnie: nie

--wyrażenie_testowe
--bare_version
--make_filter_regex
--test_akcent_filtrowania
Opcje te są używane wewnętrznie do tworzenia i testowania.

OPIS

Kiedy to niezwykle prosty program do osobistego kalendarza, przeznaczony dla maniaków Uniksa, którzy chcą
coś minimalistycznego. Może śledzić rzeczy, które musisz zrobić w określonych dniach.
Istnieje wiele programów do zarządzania kalendarzami i informacjami osobistymi, więc
jakie są powody, aby skorzystać Kiedy?

Jest to bardzo krótki i prosty program, więc bez problemu poradzisz sobie z nim samodzielnie.
Nie zależy od żadnych bibliotek, więc jest łatwy w instalacji. Powinieneś móc zainstalować
go w dowolnym systemie, w którym dostępny jest Perl, nawet jeśli nie masz uprawnień do instalacji
biblioteki.
Jego format pliku to prosty plik tekstowy, który możesz edytować w swoim ulubionym edytorze.

Chociaż Kiedy powinien działać na praktycznie każdym systemie operacyjnym, w którym dostępny jest Perl, w
w tym dokumencie Zakładam, że używasz jakiejś wersji Uniksa.

PORADY ROLNICZE DOSTAĆ ZACZĘŁA SIĘ

Będąc zalogowanym jako root, wykonaj następujące polecenie:

make install

run Kiedy po raz pierwszy używając tego polecenia:

jeśli chodzi o komunikację i motywację

Zostaniesz poproszony o podanie informacji niezbędnych do skonfigurowania pliku kalendarza.

UŻYWAĆ

Jeśli biegniesz Kiedy ponownie po uruchomieniu wstępnej konfiguracji, powinien wydrukować pojedynczą linię
SMS informujący o aktualnej dacie. Nie wydrukuje niczego innego, ponieważ Twój
plik kalendarza jest pusty, więc nie masz żadnych zbliżających się spotkań.

Teraz możesz zacząć umieszczać elementy w pliku kalendarza. Każdy element to wiersz tekstu, który
wygląda tak:

2003 lutego 3, lot do Sztokholmu, aby odebrać Nagrodę Nobla.

Wygodnym sposobem edycji pliku kalendarza jest użycie tego polecenia:

kiedy e

Spowoduje to przejście do Twojego ulubionego edytora (tego, który wybrałeś podczas uruchamiania Kiedy dla pierwszego
czas).

Data musi być w formacie rok-miesiąc-dzień, ale można przeliterować miesiąc lub go podać
jako liczba. (W nazwach miesięcy wielkość liter nie jest rozróżniana i nie ma znaczenia, czy reprezentujesz
Luty jako F, ​​Fe, Feb, Februa lub cokolwiek innego. To po prostu musi być wyjątkowy mecz. Możesz
podaj końcówkę ., która zostanie zignorowana. W języku czeskim „cer” może być używane jako skrót
dla Cerven i „cec” dla Cervenec.) Dodatkowe białe znaki są ignorowane, dopóki nie przejdziesz do
właściwy tekst po przecinku. Puste linie i linie zaczynające się od znaku # są ignorowane.

Jeśli teraz biegniesz Kiedy, wydrukuje listę wszystkich pozycji w pliku kalendarza
przypadać w określonym przedziale czasu. (Przerwa zaczyna się od wczoraj. Kiedy próbuje
wybierz koniec przedziału czasu, aby jego wynik zmieścił się w oknie terminala, ale tak
zawsze będzie wynosić co najmniej trzy dni i nie więcej niż dwa tygodnie w przyszłości.) Aby zobaczyć wszystko
swoje pozycje na następny miesiąc, wykonaj „kiedy m” i podobnie przez rok, y lub pojedynczy
tydzień, w.

Jeśli zrobisz „kiedy c”, Kiedy drukuje kalendarze na ostatni miesiąc, ten i następny miesiąc
miesięcy.

Możesz połączyć te polecenia. Na przykład „kiedy cw” wydrukuje kalendarze, a
następnie pokaż swoje przedmioty na następny tydzień.

W przypadku wydarzeń odbywających się raz w roku, takich jak urodziny i rocznice, możesz użyć jednego z nich
a * w miejscu roku,

* 25 grudnia, Boże Narodzenie

lub użyj roku z gwiazdką:

1920* 29 sierpnia, Charlie Parker kończy rok, urodził się w roku

W drugim przykładzie \a informuje, ile lat będzie miał Charlie Parker w tym roku, oraz \y
odtwarza rok urodzenia, tj. wynikiem będzie:

dzisiaj 2003 sierpnia 29 Charlie Parker kończy 83 lata, urodził się w 1920 roku

W przypadku rzeczy, które musisz robić co tydzień, możesz użyć wyrażenia w postaci w=xxx, gdzie
xxx to kilka pierwszych liter nazwy dnia tygodnia w Twoim języku. (Ty
należy podać wystarczającą liczbę liter, aby wyeliminować dwuznaczność, np. w języku angielskim, w=th lub w=tu, not
po prostu w=t.) Przykład:

w=niedziela, idź do kościoła o 10:00

Możesz także przeprowadzić bardziej wyszukane testy; więcej informacji znajdziesz w dziale
„fantazyjne testy” poniżej. Oto jak skonfigurować niektóre typowe święta:

m=sty & w=mon & a=3 , Dzień Martina Luthera Kinga
* 14 lutego, Walentynki
m=luty i w=mon i a=3, obchodzono urodziny Waszyngtona
m=maj & w=słońce & a=2 , Dzień Matki
m=maj i w=poniedziałek i b=1 , Dzień Pamięci
m=cze & w=słońce & a=3 , Dzień Ojca
* 4 lipca, Święto Niepodległości
m=sep & w=mon & a=1 , Święto Pracy
m=październik i w=poniedziałek i a=2, Dzień Kolumba
m=październik i w=poniedziałek i a=2 , Święto Dziękczynienia (Kanada)
* 11 listopada, Dzień zawieszenia broni
m=listopad i w=czw i a=4, Święto Dziękczynienia (USA)
e=47, Mardi Gras
e=46 , Środa Popielcowa
e=7, Niedziela Palmowa
e=0 , Niedziela Wielkanocna
e=0-49 , Pięćdziesiątnica (49 dni po Wielkanocy)

W USA, gdy niektóre święta przypadają w weekend, pracownicy federalni, a także wielu
pracownicy prywatni, dostaną wolny poniedziałek lub piątek. Pełna lista znajduje się pod adresem
http://www.opm.gov/operating_status_schedules/fedhol/2011.asp. Jeśli chcesz przypomnienia
zarówno w święto, jak i dzień, w którym kończysz pracę, oto przykład, jak możesz to ustawić
to w górę:

* 4 lipca, Święto Niepodległości
m=jul i c=4, Dzień Niepodległości (obchodzony jako święto federalne)

UMIĘDZYNARODOWIENIE

Kiedy ma przynajmniej częściowe wsparcie dla języka czeskiego, duńskiego, holenderskiego, angielskiego, francuskiego, niemieckiego,
grecki, węgierski, włoski, polski, rumuński, hiszpański i ukraiński. Jeśli Kiedy nie była
przetłumaczony na Twój język lub został przetłumaczony tylko częściowo, a tekst nie został przetłumaczony
zostały przetłumaczone, zostaną wyświetlone w języku angielskim. Kiedy powinien automatycznie wykryć co
język, którego używasz (poprzez zmienną środowiskową $LANG) i if Kiedy zostało przetłumaczone
na ten język, to właśnie otrzymasz... Kiedydane wyjściowe będą w Twoim języku i
Kiedy będzie również oczekiwać, że użyjesz tego języka w pliku kalendarza w nazwach
miesiące i dni tygodnia.

Plik kalendarza musi być w formacie UTF-8 (lub ASCII, który jest podzbiorem UTF-8). Jeżeli twój
plik kalendarza ma inne kodowanie, na przykład ISO-8859, Kiedy zazwyczaj będzie w stanie
wykryje to i odmówi przeczytania. Opcje wiersza poleceń mogą również zawierać kod UTF-8.

Niektóre emulatory terminali (aterm, ...) wyświetlają znaki akcentowane jako śmieci, ale inne
(mlterm, xterm...) może je poprawnie wyświetlić. Kiedy sprawdza środowisko $TERM
zmienna i jeśli jest ona równa „mlterm” lub „xterm”, wówczas znaki akcentowane będą
wystawiany. W przeciwnym razie są one filtrowane z danych wyjściowych. Możesz to zastąpić
umieszczając linię jak

filter_accents_on_output = 0

or

filter_accents_on_output = 1

w telefonie ~/.kiedy/preferencje plik. Chętnie wysłucham opinii wszystkich użytkowników, którzy mogą to zrobić
sugerują lepszy mechanizm niż próba interpretacji zmiennej $TERM.

Na wejściu akcenty są dozwolone, ale nie wymagane, np. w pliku wejściowym w języku francuskim,
datę 2005 lutego 17 r. można podać z akcentowanym e lub bez akcentu i albo
będzie działać. Jeśli wprowadzony miesiąc lub dzień tygodnia nie pasuje do żadnego z podanych przez Ciebie
język, zatem Kiedy spróbuję zamiast tego zinterpretować to jako angielski.

Możesz umieścić linię np

język = fr

w pliku preferencji, aby ustawić język, lub podaj opcję --language w pliku
wiersza poleceń, ale nie jest to konieczne, jeśli ustawiona jest zmienna środowiskowa $LANG
prawidłowo.

FORMAT OF THE PREFERENCJE FILE

Każda linia składa się z czegoś takiego:

zmienna = wartość

Białe znaki są ignorowane wszędzie z wyjątkiem wnętrza wartości. Nazwy zmiennych są wielkością liter
niewrażliwy. Puste linie są ignorowane.

WIĘCEJ PRZYKŁADY

Przydatnym poleceniem uruchamiającym powłokę podczas logowania jest:

kiedy --przeszłość=0 --przyszłość=1

Aby wydrukować kalendarz na cały nadchodzący rok:

kiedy --przeszłość=0 --przyszłość=365 c

WYKRYWAJĄCY UP TWÓJ KALENDARZ KIEDY TY LOG IN

Twój kalendarz na nic się nie zda, jeśli zapomnisz na niego patrzeć codziennie. Łatwy sposób
aby wyświetlał się po zalogowaniu, należy nadać plikowi .xsession lub .xinitrc wygląd
to:

/usr/bin/when --past=0 --future=1 &>~/kiedy.dzisiaj
emacs -geometria 70x25 -bg bisque ~/kiedy.dzisiaj &
startkde

Plik .xsession jest używany, jeśli na komputerze masz skonfigurowanego graficznego menedżera logowania,
.xinitrc, jeśli tego nie zrobisz. W tym przykładzie pierwsza linia wyświetla kalendarz w formacie a
plik. Pełna ścieżka do Kiedy program jest podany, ponieważ zmienna ścieżki powłoki
nie zostanie jeszcze poprawnie zainicjowany po uruchomieniu. W drugiej linii pojawi się emacs z interfejsem GUI
okienko, które ma charakterystyczny kolor, dzięki czemu przyciąga wzrok. Ostatnia linia
uruchamia menedżera okien, w tym przykładzie KDE. Niezależnie od tego, jakiego menedżera okien używasz, po prostu
pamiętaj, aby zachować istniejącą linię w pliku, który ją rozpoczyna, i upewnij się, że
ta linia jest ostatnią linią w pliku.

SORTOWANIE BY CZAS OF DZIEŃ

Jeśli chcesz, aby różne pozycje z jednego dnia zostały wydrukowane w określonym terminie
kolejności, najprostszym sposobem, aby to zrobić, jest umieszczenie ich w tej kolejności w pliku wejściowym. To
metoda nie będzie jednak działać, gdy niektóre elementy leżą w datach określonych przez
wyrażeń, a nie wprost. Najczęstszy powód, dla którego chcesz to zrobić
Rzecz w tym, że masz rzeczy, które musisz zrobić w określonych porach dnia i
chcesz, żeby zostały uporządkowane według czasu. W tej sytuacji możesz dać sobie czas na początek
tekstu elementu oraz Kiedy rozpozna to i posortuje elementy według czasu. Czasy mogą być
w formacie h:mm lub gg:mm. Jeśli ustawiono --ampm, można użyć opcjonalnego przyrostka a lub p
AM lub PM, np. 9:30 zamiast 9:30. Jeśli korzystasz z czasu AM/PM, możesz także np. ustawić
--auto_pm=9, więc godziny mniejsze niż 9 są automatycznie przyjmowane jako godziny popołudniowe. Oto
przykład:

2010 kwi 25 , 7:00 kolacja w komunie anarchosyndykalistycznej
w=niedziela, 10:00 kościół

25 kwietnia 2010 r. wypada w niedzielę, więc w tym dniu zostaną wyświetlone oba elementy. Jeśli
--auto_pm jest ustawione na 8 lub więcej, wtedy 7:00 zostanie automatycznie zinterpretowane jako 7:00
PM, a data kolacji zostanie wyświetlona pod poranną ceremonią kościelną.

FANTAZYJNY TESTY

Oprócz w, omówionego powyżej, istnieje kilka innych zmiennych, które możesz przetestować:

w - dzień tygodnia
m - miesiąc
d - dzień miesiąca
y - rok
j - zmodyfikowany numer dnia juliańskiego
a - 1 przez pierwsze 7 dni miesiąca, 2 przez kolejne 7 itd.
b - 1 za ostatnie 7 dni miesiąca, 2 za poprzednie 7 itd.
c - w poniedziałek lub piątek oznacza dzień miesiąca najbliższego weekendu; w przeciwnym razie -1
e - dni do tegorocznej (zachodniej) Wielkanocy
z - dzień roku (1 w Nowy Rok)

Możesz określić miesiące jako liczby, m=2, lub jako nazwy w swoim języku, m=feb. Ty
można także używać operatorów logicznych & (i) i | (Lub). Poniższy przykład przypomina
płacić swoim pracownikom pierwszego i piętnastego dnia każdego miesiąca:

d=1 | d=15 , Płacić pracownikom.

Ten przykład przypomina Ci o próbach ze swoim zespołem w ostatnią sobotę każdego miesiąca:

w=sat & b=1 , Próba z zespołem.

Następne dwie linijki

* 25 grudnia, Boże Narodzenie
m=grudzień i d=25, Boże Narodzenie

oba robią dokładnie to samo, ale pierwsza wersja jest łatwiejsza do zrozumienia i sprawia, że
program działa szybciej. (Kiedy robisz test, Kiedy musi przebiegać każdego dnia w
zakres dat, o który prosiłeś, i oceń test dla każdego z tych dni. Na mojej maszynie
jeśli wydrukuję kalendarz na cały rok, korzystając z pliku z 10 prostymi testami, to tak
zajmuje kilka sekund.) Można także używać nawiasów.

W zależności od narodowości i religii prawdopodobnie masz mnóstwo świąt
nie kłam co do ustalonych dat. W chrześcijaństwie jest ich wiele („święta ruchome”)
obliczana w odniesieniu do Niedzieli Wielkanocnej, dlatego zmienna e jest przydatna.

Istnieje operator not, !:

w=piątek i !(m=grudzień i d=25) , gra w pokera

Istnieje operator modulo, % i operator odejmowania, -. Używanie ich wraz z
j, jest to po prostu ledwo możliwe Kiedymały parser, aby wykonać następujące czynności
wyczyn:

!(j%14-1) , rób coś co drugą środę

Logika stojąca za tym głupim kawałkiem magii jest następująca. Najpierw ustalamy,
za pomocą polecenia `when j --now="2005 jan 26"', że pierwsza środa, w którą chcemy
aby to zrobić, ma dzień juliański równy 1, modulo 14. Następnie zapisujemy to wyrażenie tak
że jeśli jest środa, której dzień juliański jest równy 1, modulo 14, ilość w nawiasach
będzie wynosić zero, a przyjęcie jego logicznej negacji da prawdziwą wartość.

Łączność operatorów i kolejność priorytetów (od najwyższego do najniższego) wygląda następująco:

lewy %
lewy -
w lewo < > <= >=
w lewo = !=
racja!
lewo &
lewo |

WŁĄCZNIE Z AKTA

Jeśli plik kalendarza stanie się zbyt duży, możesz podzielić go na mniejsze części —
może jeden na urodziny, drugi na święta tybetańskie itp. Łatwy sposób na osiągnięcie
to jest instalacja programu m4, wstaw linię

filtr wstępny = m4 -P

w pliku preferencji, a następnie umieść linie w pliku kalendarza w następujący sposób:

m4_include(/home/twoje imię/.kiedy/urodziny)

ŚRODOWISKO

$LAN aby automatycznie wykryć język użytkownika

$TERMIN aby spróbować dowiedzieć się, czy emulator terminala może wyświetlać znaki akcentowane

Używaj w trybie online, korzystając z usług onworks.net