kapan - Online di Cloud

PROGRAM:

NAMA

Kapan - program kalender pribadi minimalis

RINGKASAN

ketika

ketika [opsi] [perintah]

Ide dasarnya hanyalah mengetik `kapan' di baris perintah. Pertama kali Anda menjalankan
program, itu akan meminta Anda untuk beberapa informasi pengaturan. Untuk mengedit file kalender Anda di
editor favorit, lakukan `kapan e'. Format dasar file kalender adalah seperti ini:

2003 Februari 3, Terbang ke Stockholm untuk menerima Hadiah Nobel.

Setelah Anda memiliki file kalender, jalankan program seperti biasa `kapan' dari perintah
line akan mencetak hal-hal di kalender Anda selama dua minggu ke depan.

PERINTAH

i Cetak item yang akan datang di kalender Anda. (Ini adalah perintah default.)

c Cetak kalender (grid seperti pada kalender dinding, tidak menampilkan item) untuk bulan lalu,
bulan ini, dan bulan depan.

e Panggil editor favorit Anda untuk mengedit file kalender Anda.

w,m,y Cetak item untuk minggu, bulan, atau tahun mendatang, bukan untuk default
jangka waktu dua minggu.

j Cetak hari Julian yang dimodifikasi (berguna untuk menemukan interval waktu antara dua
tanggal).

d Cetak apa-apa selain tanggal saat ini.

PILIHAN

Semua opsi berikut, kecuali --help, dapat diatur dalam file preferensi.
Opsi benar/salah dapat diatur pada baris perintah sebagai --option atau --nooption, dan di
preferensi file dengan mengatur opsi ke 0 atau 1.

--help Mencetak pesan bantuan singkat.

--Versi: kapan
Mencetak pesan singkat, termasuk pernyataan versi perangkat lunaknya
adalah.

--bahasa=LANG
Setel bahasa ke LANG. Lihat bagian di bawah tentang internasionalisasi. Ini
opsi biasanya tidak diperlukan, karena bahasa terdeteksi secara otomatis.

--masa depan=HARI
Berapa hari ke depan laporan diperpanjang. Standar: 14

--lalu=HARI
Berapa hari ke masa lalu laporan diperpanjang. Seperti opsi --future, --past
ditafsirkan sebagai offset relatif terhadap tanggal sekarang, jadi biasanya Anda akan
ingin ini menjadi nilai negatif. Standar: -1

--kalender=FILE
File kalender Anda. Standarnya adalah menggunakan file yang ditunjuk oleh preferensi Anda
file, yang diatur saat pertama kali Anda menjalankan When.

--editor=PERINTAH
Perintah yang digunakan untuk memanggil editor Anda. Default: "emacs -nw" Contoh: ketika
--editor="vim"

--wrap=KOLOM
Jumlah kolom teks untuk output (atau 0 jika Anda tidak ingin membungkus sama sekali).
Standar: 80

--[tidak]wrap_auto
Mencoba mendeteksi lebar terminal, dan mengatur lebar output
demikian. Ini hanya berlaku jika outputnya adalah tty, dan tunduk pada sembarang
maksimum yang ditetapkan oleh --wrap_max. Mengganti nilai apa pun yang ditetapkan oleh --wrap. Standar: tidak

--wrap_max=KOLOM
Jumlah maksimum kolom teks untuk output (atau -1 jika Anda tidak menginginkannya
maksimum). Berguna dalam kombinasi dengan --wrap_auto untuk menjaga keterbacaan dengan sangat
jendela terminal besar. Standar: -1

--baris=KOLOM
Jumlah baris teks yang akan muat di jendela terminal. Saat mendaftar Anda
kalender, output akan dipotong sepanjang ini, kecuali jika itu akan menghasilkan
daftar kurang dari tiga hari ke depan. Perilaku ini ditimpa (the
jumlah maksimum baris diatur ke tak terhingga) jika opsi --future diberikan
eksplisit, atau jika perintah m atau y digunakan. Standar: 40

--[tidak]baris_otomatis
Cobalah untuk mendeteksi ketinggian terminal, daripada menggunakan nilai yang ditetapkan dalam
opsi --rows. Ini hanya berlaku jika outputnya adalah tty. Mengganti nilai apa pun
diatur oleh --rows. Standar: ya

--[tidak]tajuk
Cetak header di bagian atas output dari perintah i, c, w, m dan y. Bawaan:
iya nih

--[tidak]halaman
Ketika output lebih panjang dari nilai yang ditetapkan oleh rows atau rows_auto, gunakan pager untuk
menampilkan keluaran. (Variabel lingkungan PAGER dan KURANG dihormati. Jika
PAGER tidak disetel, defaultnya adalah "kurang.") Default: yes

--paging_less_options
Opsi tambahan jika pager "kurang". Bawaan: "-rXFE"

--[tidak]filter_accents_on_output
Apakah akan mengubah karakter beraksen menjadi yang tidak beraksen. Default: ya, kecuali
variabel lingkungan $TERM sama dengan "mlterm" atau "xterm".

--[tidak]gaya_output
Jika outputnya adalah terminal, haruskah kita menggunakan kode terminal ANSI untuk penataan?
Standar: ya

--[tidak]styled_output_if_not_tty
Gaya output meskipun itu bukan terminal. Standar: tidak

--calendar_today_style=GAYA
--items_today_style=GAYA
Yang pertama mengatakan bagaimana gaya tanggal hari ini ketika melakukan kalender (c)
memerintah. Yang kedua mengatakan bagaimana menata kata ``hari ini'' ketika melakukan item (i)
memerintah. Default: tebal

Gaya keluaran dapat ditentukan menggunakan kata kunci berikut: tebal,
digarisbawahi, berkedip. Untuk mengubah warna teks, gunakan ini: fgblack, fgred,
fggreen, fgyellow, fgblue, fgpurple, fgcyan, fgwhite. Untuk mengubah latar belakang
warna, gunakan kata kunci yang serupa, tetapi dengan bg alih-alih fg. Contoh: kapan
--calendar_today_style="bold,fgred,bgcyan" c

--prafilter
Pipa file kalender melalui program sebelum membacanya. Bawaan: ""

--sekarang="YMD"
Berpura-pura hari ini adalah tanggal lain.

--[tidak]tetangga_bulan
Perilaku default "ketika c" adalah mencetak kalender untuk bulan lalu, ini
bulan, dan bulan depan. Dengan memilih --noneighboring_months, Anda dapat menghindari pencetakan
keluar bulan tidak termasuk dalam kisaran yang ditetapkan oleh --past dan --future.

--[tidak]senin_pertama
Mulailah minggu dari Senin, bukan Minggu. Standar: tidak

--[tidak]ortodoks_paskah
Hitung Paskah menurut kalender Gereja Timur Ortodoks. Standar: tidak

--[tidak]ampm
Menampilkan waktu dalam sehari menggunakan waktu 12 jam, bukan waktu 24 jam. Juga mempengaruhi
penguraian waktu input. Standar: ya

--auto_pm=x
Ketika waktu dimasukkan dengan jam yang kurang dari x, dan AM atau PM tidak
ditentukan secara eksplisit, secara otomatis menganggap bahwa mereka adalah PM daripada AM.
Standar: 0

--[tidak]literal_only
Hanya tampilkan item yang diberikan sebagai tanggal literal, misalnya, "2008 Juli 4". jangan
menampilkan item yang ditentukan oleh ekspresi, misalnya item periodik seperti "w=thu".
Standar: tidak

--test_ekspresi
--bare_version
--make_filter_regex
--test_accent_filtering
Opsi ini digunakan secara internal untuk membangun dan menguji.

DESKRIPSI

Ketika adalah program kalender pribadi yang sangat sederhana, ditujukan untuk geek Unix yang ingin
sesuatu yang minimalis. Itu dapat melacak hal-hal yang perlu Anda lakukan pada tanggal tertentu.
Ada banyak program kalender dan ``manajer informasi pribadi' di luar sana, jadi
alasan apa yang ada untuk digunakan Ketika?

Ini adalah program yang sangat singkat dan sederhana, sehingga Anda dapat dengan mudah mengotak-atiknya sendiri.
Itu tidak tergantung pada perpustakaan apa pun, jadi mudah dipasang. Anda harus dapat menginstal
itu di sistem mana pun di mana Perl tersedia, bahkan jika Anda tidak memiliki hak istimewa untuk menginstal
perpustakaan.
Format filenya adalah file teks sederhana, yang dapat Anda edit di editor favorit Anda.

Meskipun Ketika harus berjalan di hampir semua sistem operasi di mana Perl tersedia, di
dokumen ini saya akan menganggap Anda menjalankan beberapa rasa Unix.

INSTALASI DAN MENDAPATKAN DIMULAI

Saat masuk sebagai root, jalankan perintah berikut:

make install

Run Ketika untuk pertama kalinya menggunakan perintah ini:

ketika

Anda akan diminta untuk beberapa informasi yang diperlukan untuk menyiapkan file kalender Anda.

GUNAKAN

Jika kamu lari Ketika lagi setelah pengaturan awal dijalankan, itu harus mencetak satu baris
teks, memberi tahu Anda tanggal saat ini. Itu tidak akan mencetak apa pun, karena Anda
file kalender kosong, jadi Anda tidak memiliki janji yang akan datang.

Sekarang Anda dapat mulai memasukkan item ke dalam file kalender Anda. Setiap item adalah baris teks yang
terlihat seperti ini:

2003 Februari 3, Terbang ke Stockholm untuk menerima Hadiah Nobel.

Cara mudah untuk mengedit file kalender Anda adalah dengan perintah ini:

kapan e

Ini memunculkan Anda ke editor favorit Anda (yang Anda pilih saat berlari Ketika untuk yang pertama
waktu).

Tanggal harus dalam format tahun-bulan-hari, tetapi Anda dapat mengeja bulan atau memberikannya
sebagai angka. (Nama bulan tidak peka huruf besar/kecil, dan tidak masalah jika Anda mewakili
Februari sebagai F, Fe, Feb, Februa, atau apa pun. Itu hanya harus menjadi pertandingan yang unik. Kamu bisa
berikan trailing ., yang akan diabaikan. Dalam bahasa Ceko, "cer" dapat digunakan sebagai singkatan
untuk Cerven, dan "cec" untuk Cervenec.) Spasi ekstra diabaikan sampai Anda masuk ke
teks sebenarnya setelah koma. Baris kosong dan baris yang diawali dengan tanda # diabaikan.

Jika sekarang kamu lari Ketika, itu akan mencetak daftar semua item dalam file kalender Anda yang
jatuh dalam selang waktu tertentu. (Interval dimulai dari kemarin. Ketika Mencoba untuk
pilih akhir interval waktu sehingga outputnya sesuai dengan jendela terminal Anda, tetapi itu
akan selalu setidaknya tiga hari, dan tidak lebih dari dua minggu di masa depan.) Untuk melihat semua
item Anda untuk bulan berikutnya, lakukan ``ketika m'', dan sama untuk satu tahun, y, atau satu
minggu, w.

Jika Anda melakukan ``ketika c'', Ketika mencetak kalender untuk bulan lalu, bulan ini, dan selanjutnya
bulan.

Anda dapat menggabungkan perintah-perintah ini. Misalnya, ``ketika cw'' akan mencetak kalender, dan
kemudian tunjukkan barang-barang Anda untuk minggu depan.

Untuk acara yang terjadi setahun sekali, seperti ulang tahun dan hari jadi, Anda dapat menggunakan
a * sebagai pengganti tahun,

* 25 Desember, Natal

atau gunakan tahun dengan tanda bintang:

1920* 29 agustus , Charlie Parker ternyata \a, lahir di \y

Pada contoh kedua, \a memberi tahu Anda berapa umur Charlie Parker tahun ini, dan \y
mereproduksi tahun kelahirannya, yaitu, hasilnya adalah:

hari ini 2003 29 Agustus Charlie Parker berusia 83 tahun, lahir tahun 1920

Untuk hal-hal yang harus Anda lakukan setiap minggu, Anda dapat menggunakan ekspresi bentuk w=xxx, di mana
xxx adalah beberapa huruf pertama dari nama hari dalam bahasa Anda. (Anda
harus menyediakan huruf yang cukup untuk menghilangkan ambiguitas, misalnya, dalam bahasa Inggris, w=th atau w=tu, not
hanya w=t.) Contoh:

w=matahari , pergi ke gereja, 10:00

Anda sebenarnya dapat melakukan tes yang lebih menarik dari ini juga; untuk informasi lebih lanjut, lihat bagian
'tes mewah' di bawah ini. Berikut cara mengatur beberapa hari libur umum:

m=jan & w=mon & a=3 , Hari Martin Luther King
* 14 Februari, Hari Valentine
m=feb & w=mon & a=3 , Ulang Tahun Washington diamati
m=mei & w=matahari & a=2 , Hari Ibu
m=mei & w=mon & b=1 , Hari Peringatan
m=jun & w=matahari & a=3 , Hari Ayah
* 4 Juli, Hari Kemerdekaan
m=sep & w=mon & a=1 , Hari Buruh
m=okt & w=sen & a=2 , Hari Columbus
m=okt & w=mon & a=2 , Thanksgiving (Kanada)
* 11 November, Hari Gencatan Senjata
m=nov & w=kam & a=4 , Thanksgiving (AS)
e=47 , Mardi Gras
e=46 , Rabu Abu
e=7 , Minggu Palma
e=0, Minggu Paskah
e=0-49 , Pentakosta (49 hari setelah paskah)

Di AS, ketika hari libur tertentu jatuh pada akhir pekan, pekerja federal, serta banyak lainnya
karyawan swasta, mendapatkan hari Senin atau Jumat libur. Daftar lengkapnya ada di
http://www.opm.gov/operating_status_schedules/fedhol/2011.asp. Jika Anda ingin pengingat
baik hari libur maupun hari Anda pulang kerja, inilah contoh bagaimana Anda akan mengaturnya
itu:

* 4 Juli, Hari Kemerdekaan
m=jul & c=4 , Hari Kemerdekaan (diperingati sebagai hari libur federal)

PENGINTERNASIONALAN

Ketika memiliki setidaknya sebagian dukungan untuk bahasa Ceko, Denmark, Belanda, Inggris, Prancis, Jerman,
Yunani, Hongaria, Italia, Polandia, Rumania, Spanyol, dan Ukraina. Jika Ketika belum pernah
diterjemahkan ke dalam bahasa Anda, atau hanya sebagian diterjemahkan, teks yang belum
telah diterjemahkan akan ditampilkan dalam bahasa Inggris. Ketika harus secara otomatis mendeteksi apa
bahasa yang Anda gunakan (melalui variabel lingkungan $LANG Anda), dan jika Ketika telah diterjemahkan
ke dalam bahasa itu, itulah yang akan Anda dapatkan -- Ketikakeluaran akan dalam bahasa Anda, dan
Ketika juga akan mengharapkan Anda untuk menggunakan bahasa itu di file kalender Anda untuk nama
bulan dan hari dalam seminggu.

File kalender Anda harus dalam format UTF-8 (atau ASCII, yang merupakan bagian dari UTF-8). Jika Anda
file kalender dalam beberapa pengkodean lain, seperti ISO-8859, Ketika biasanya akan dapat
mendeteksi itu, dan akan menolak untuk membacanya. Opsi baris perintah juga dapat berisi UTF-8.

Beberapa emulator terminal (aterm, ...) menampilkan karakter beraksen sebagai sampah, tetapi yang lain
(mlterm, xterm...) dapat menampilkannya dengan benar. Ketika memeriksa lingkungan $TERM
variabel, dan jika sama dengan "mlterm" atau "xterm", maka karakter beraksen akan menjadi
ditampilkan. Jika tidak, mereka disaring dari output. Anda dapat menimpa ini dengan
menempatkan garis seperti

filter_accents_on_output = 0

or

filter_accents_on_output = 1

di Anda ~/.kapan/preferensi mengajukan. Saya akan tertarik untuk mendengar dari pengguna mana pun yang bisa
menyarankan mekanisme yang lebih baik untuk ini daripada mencoba menafsirkan variabel $TERM.

Pada input, aksen diperbolehkan, tetapi tidak diperlukan, misalnya, dalam file input berbahasa Prancis,
tanggal 2005 Februari 17 dapat diberikan dengan aksen e atau tanpa aksen, dan juga
akan bekerja. Jika input bulan atau hari dalam seminggu tidak cocok dengan salah satu input untuk Anda
bahasa, maka Ketika akan mencoba menafsirkannya sebagai bahasa Inggris.

Anda dapat menempatkan garis seperti

bahasa = fr

di file preferensi Anda untuk mengatur bahasa Anda, atau berikan opsi --language di
baris perintah, tetapi itu tidak perlu jika variabel lingkungan $LANG Anda disetel
benar.

FORMAT OF THE PREFERENSI FILE

Setiap baris terdiri dari sesuatu seperti ini:

variabel = nilai

Spasi diabaikan di mana-mana kecuali di dalam nilai. Nama variabel adalah kasus-
tidak peka. Garis kosong diabaikan.

LEBIH CONTOH

Perintah yang berguna untuk menjalankan shell Anda saat Anda masuk adalah ini:

ketika --masa lalu=0 --masa depan=1

Untuk mencetak kalender untuk satu tahun penuh yang akan datang:

ketika --masa lalu=0 --masa depan=365 c

muncul UP ANDA KALENDER KAPAN ANDA LOG IN

Kalender Anda tidak ada gunanya jika Anda lupa melihatnya setiap hari. Cara yang mudah
untuk membuatnya muncul saat Anda masuk adalah membuat file .xsession atau .xinitrc Anda terlihat seperti
ini:

/usr/bin/when --past=0 --future=1 &>~/kapan.hari ini
emacs -geometri 70x25 -bg bisque ~/kapan.hari ini &
mulai

File .xsession digunakan jika Anda memiliki manajer login grafis yang diatur di mesin Anda,
.xinitrc jika tidak. Dalam contoh ini, baris pertama menampilkan kalender Anda ke a
mengajukan. Jalan lengkap menuju Ketika program diberikan, karena variabel jalur Shell Anda
belum akan diinisialisasi dengan benar saat ini berjalan. Baris kedua muncul emacs GUI
jendela, yang berwarna khas sehingga akan menarik perhatian Anda. Baris terakhir
memulai window manager Anda, KDE dalam contoh ini. Manajer jendela apa pun yang Anda gunakan, cukup
pastikan untuk mempertahankan baris yang sudah ada sebelumnya di file yang memulainya, dan pastikan bahwa
baris itu adalah yang terakhir dalam file.

PENYORTIRAN BY WAKTU OF HARI

Jika Anda ingin berbagai item yang ada dalam satu hari dicetak dalam waktu tertentu
agar, cara paling sederhana untuk melakukannya adalah dengan menempatkannya dalam urutan itu di file input. Itu
metode tidak akan bekerja, namun, ketika beberapa item terletak pada tanggal yang ditentukan oleh
ekspresi daripada diberikan secara eksplisit. Alasan paling umum untuk ingin melakukan ini
semacam itu adalah bahwa Anda memiliki hal-hal yang perlu Anda lakukan pada waktu-waktu tertentu di siang hari, dan
Anda ingin mereka diurutkan berdasarkan waktu. Dalam situasi ini, Anda dapat memberikan waktu di awal
dari teks item, dan Ketika akan mengenalinya dan mengurutkan item berdasarkan waktu. Waktu bisa
dalam format j:mm atau jj:mm. Jika --ampm diatur, maka sufiks opsional a atau p dapat digunakan untuk
AM atau PM, misalnya, 9:30 untuk 9:30. Jika Anda menggunakan waktu AM/PM, maka Anda juga dapat, misalnya, menyetel
--auto_pm=9 sehingga jam kurang dari 9 secara otomatis dianggap sebagai PM. Berikut ini adalah
contoh:

2010 25 april, 7:00 makan malam di komune anarko-sindikalis
w=matahari , 10:00 gereja

25 April 2010 adalah hari Minggu, maka pada tanggal tersebut kedua item tersebut akan ditampilkan. Jika
--auto_pm diatur ke 8 atau lebih tinggi, maka 7:00 secara otomatis akan ditafsirkan sebagai 7:00
PM, dan tanggal makan malam akan ditampilkan di bawah upacara gereja pagi.

FANCY UJI

Selain w, yang dibahas di atas, ada banyak variabel lain yang dapat Anda uji:

w - hari dalam seminggu
m - bulan
d - hari dalam sebulan
y - tahun
j - nomor hari Julian yang dimodifikasi
a - 1 untuk 7 hari pertama setiap bulan, 2 untuk 7 hari berikutnya, dst.
b - 1 untuk 7 hari terakhir dalam sebulan, 2 untuk 7 hari sebelumnya, dst.
c - pada hari Senin atau Jumat, sama dengan hari pada hari akhir pekan terdekat; jika tidak -1
e - hari sampai Paskah (Barat) tahun ini
z - hari dalam setahun (1 pada hari Tahun Baru)

Anda dapat menentukan bulan sebagai angka, m=2, atau sebagai nama dalam bahasa Anda, m=feb. Anda
juga dapat menggunakan operator logika & (dan) dan | (atau). Contoh berikut mengingatkan Anda
untuk membayar karyawan Anda pada hari pertama dan kelima belas setiap bulan:

d=1 | d=15 , Bayar karyawan.

Contoh ini mengingatkan Anda untuk berlatih dengan band Anda pada hari Sabtu terakhir setiap bulan:

w=sat & b=1 , Berlatih dengan band.

Dua baris berikut

* 25 Desember, Natal
m=des & d=25 , Natal

keduanya melakukan hal yang persis sama, tetapi versi pertama lebih mudah dipahami dan dibuat
program berjalan lebih cepat. (Ketika Anda melakukan tes, Ketika harus dijalankan setiap hari di
rentang tanggal yang Anda minta, dan evaluasi tes untuk setiap hari itu. Di mesin saya,
jika saya mencetak kalender selama setahun penuh, menggunakan file dengan 10 tes sederhana di dalamnya, itu
membutuhkan waktu beberapa detik.) Tanda kurung juga dapat digunakan.

Tergantung pada kebangsaan dan agama Anda, Anda mungkin memiliki banyak hari libur yang
jangan berbohong pada tanggal yang sudah ditentukan. Dalam Kekristenan, banyak dari ini ("pesta bergerak") adalah
dihitung relatif terhadap Minggu Paskah, itulah sebabnya variabel e berguna.

Ada bukan operator, !:

w=jum & !(m=des & h=25), permainan poker

Ada operator modulo, %, dan operator pengurangan, -. Menggunakan ini, bersama dengan
variabel j, hampir tidak mungkin untuk Ketikaparser kecil untuk melakukan yang berikut
prestasi:

!(j%14-1) , lakukan sesuatu setiap hari Rabu

Logika di balik sihir kecil yang konyol ini seperti ini. Pertama, kita tentukan,
menggunakan perintah `when j --now="2005 jan 26"', pada hari Rabu pertama yang kita inginkan
untuk melakukan ini memiliki hari Julian yang sama dengan 1, modulo 14. Kemudian kami menulis ekspresi ini jadi
bahwa jika itu hari Rabu yang hari Julian-nya sama dengan 1, modulo 14, jumlah dalam tanda kurung
akan menjadi nol, dan mengambil negasi logisnya akan menghasilkan nilai sebenarnya.

Keterkaitan operator dan urutan prioritas (dari tertinggi ke terendah) adalah seperti ini:

kiri %
kiri -
kiri < > <= >=
kiri = !=
Baik !
kiri &
kiri |

TERMASUK FILE

Jika file kalender Anda terlalu besar, Anda mungkin lebih suka membaginya menjadi beberapa bagian yang lebih kecil --
mungkin satu untuk ulang tahun, satu untuk liburan Tibet, dll. Cara mudah untuk mencapainya
ini untuk menginstal program m4, letakkan baris

prafilter = m4 -P

di file preferensi Anda, lalu letakkan baris di file kalender Anda seperti ini:

m4_include(/home/namaanda/.kapan/ulang tahun)

LINGKUNGAN

$LANG untuk secara otomatis mendeteksi bahasa pengguna

$JANGKA untuk mencoba mencari tahu apakah emulator terminal dapat menampilkan karakter beraksen

Gunakan saat online menggunakan layanan onworks.net