коли - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

Коли - мінімалістична персональна календарна програма

СИНТАКСИС

коли

коли [параметри] [команди]

Основна ідея полягає в тому, щоб просто ввести `when' у командному рядку. Перший раз, коли ви запускаєте
програмі, вона запропонує вам надати деяку інформацію про налаштування. Щоб відредагувати файл календаря у вашому
улюблений редактор, зробіть `коли e'. Основний формат файлу календаря виглядає так:

2003 лютого 3 року летіть до Стокгольма, щоб прийняти Нобелівську премію.

Коли у вас є файл календаря, запустіть програму як звичайне старе `when' з команди
рядок роздрукує речі у вашому календарі на наступні два тижні.

КОМАНДИ

i Роздрукуйте майбутні записи у своєму календарі. (Це команда за замовчуванням.)

c Друк календарів (сітки, як на настінному календарі, без показу елементів) за минулий місяць,
цього місяця і наступного місяця.

e Викличте свій улюблений редактор, щоб відредагувати файл календаря.

w,m,y Друкуйте елементи для наступного тижня, місяця чи року, а не за умовчанням
період у два тижні.

j Надрукуйте змінений юліанський день (корисно для пошуку інтервалу часу між двома
дати).

d Не друкуйте нічого, крім поточної дати.

ВАРІАНТИ

Усі наведені нижче параметри, крім --help, можна встановити у файлі налаштувань.
Параметри true/false можна встановити в командному рядку як --option або --nooption, а також у файлі
налаштувань, встановивши для параметра значення 0 або 1.

--help Друкує коротке повідомлення довідки.

-- версія
Друкує коротке повідомлення, у тому числі відомості про версію програмного забезпечення
є.

--language=LANG
Встановіть мову на LANG. Дивіться розділ нижче про інтернаціоналізацію. Це
Параметр зазвичай не потрібен, оскільки мова визначається автоматично.

--майбутнє=ДНІ
Скільки днів у майбутньому поширюється звіт. За замовчуванням: 14

--мінулий=ДНІ
Скільки днів у минуле поширюється звіт. Як і параметр --future, --past
інтерпретується як зміщення відносно поточної дати, як зазвичай
хочуть, щоб це було від’ємне значення. За замовчуванням: -1

--calendar=ФАЙЛ
Ваш файл календаря. За замовчуванням використовується файл, на який вказують ваші налаштування
файл, який налаштовується під час першого запуску When.

--редактор=КОМАНД
Команда, яка використовується для виклику вашого редактора. За замовчуванням: "emacs -nw" Приклад: when
--editor="vim"

--wrap=Стовпці
Кількість стовпців тексту для виводу (або 0, якщо ви не хочете обтікання взагалі).
Default: 80

--[no]wrap_auto
Спробуйте визначити ширину терміналу та встановити ширину виводу
відповідно. Це застосовується лише в тому випадку, якщо вихід є tty і підлягає будь-якому
максимум, встановлений --wrap_max. Замінює будь-яке значення, встановлене параметром --wrap. За замовчуванням: ні

--wrap_max=Стовпці
Максимальна кількість стовпців тексту для виведення (або -1, якщо вони не потрібні
максимум). Корисно в поєднанні з --wrap_auto для збереження розбірливості на дуже
великі вікна терміналу. За замовчуванням: -1

--rows=Стовпці
Кількість рядків тексту, які поміщаються у вікні терміналу. При перерахуванні ваших
calendar, вихід буде скорочено до цієї довжини, якщо це не призведе до
перерахування менше ніж за три дні в майбутнє. Ця поведінка відхиляється (
максимальна кількість рядків встановлюється на нескінченність), якщо дано параметр --future
явно, або якщо використовується команда m або y. За замовчуванням: 40

--[ні]рядків_авто
Спробуйте визначити висоту терміналу, а не використовувати встановлене значення
параметр --rows. Це застосовується лише в тому випадку, якщо вихідним є tty. Перевизначає будь-яке значення
встановлюється --рядками. За замовчуванням: так

--[ні]заголовок
Друкуйте заголовки у верхній частині виводу команд i, c, w, m і y. За замовчуванням:
так

--[ні]пейджинг
Якщо вихідний результат довший за значення, задане параметрами rows або rows_auto, використовуйте пейджер для
відобразити вихід. (Змінні середовища PAGER і LESS дотримуються. Якщо
PAGER не встановлено, за замовчуванням є "менше".) За замовчуванням: так

--pageing_less_options
Додаткові параметри, якщо пейджер «менше». За замовчуванням: "-rXFE"

--[no]filter_accents_on_output
Чи змінювати наголошені символи на ненаголошені. За замовчуванням: так, якщо
змінна середовища $TERM дорівнює "mlterm" або "xterm".

--[no]styled_output
Якщо вихід є терміналом, чи варто використовувати коди терміналів ANSI для стилізації?
За замовчуванням: так

--[no]styled_output_if_not_tty
Стилізуйте вихід, навіть якщо це не термінал. За замовчуванням: ні

--calendar_today_style=СТИЛЬ
--items_today_style=СТИЛЬ
Перший з них говорить про те, як стилізувати сьогоднішню дату під час виконання календаря (c)
команда. У другому вказано, як стилізувати слово ``сьогодні'' під час виконання завдань (i)
команда. Значення за замовчуванням: жирний

Стиль виводу можна вказати за допомогою таких ключових слів: жирний,
підкреслений, миготливий. Щоб змінити колір тексту, використовуйте такі: fgblack, fgred,
fggreen, fgyellow, fgblue, fgpurple, fgcyan, fgwhite. Щоб змінити фон
color, використовуйте схожі ключові слова, але з bg замість fg. Приклад: коли
--calendar_today_style="жирний,fgred,bgcyan" c

-- попередній фільтр
Перед читанням проведіть файл календаря через програму. За замовчуванням: ""

--now="YMD"
Уявіть, що сьогодні якась інша дата.

--[ні]сусідні_місяці
Поведінка за замовчуванням "when c" - це роздрукувати календарі за останній місяць, це
місяць і наступний місяць. Вибравши --noneighboring_months, ви можете уникнути друку
місяці, які не входять до діапазону, встановленого --минулим і --майбутнім.

--[ні]понеділок_перший
Почніть тиждень з понеділка, а не з неділі. За замовчуванням: ні

--[ні]православна_пасха
Обчисліть Великдень за календарем Православної Східної Церкви. За замовчуванням: ні

--[ні]ампер
Відображайте час доби, використовуючи 12-годинний, а не 24-годинний час. Також впливає
аналіз часу введення. За замовчуванням: так

--auto_pm=x
Коли час вводиться з годинами, меншими за x, а AM або PM – ні
явно вказані, автоматично припускають, що вони є PM, а не AM.
Default: 0

--[no]лише буквальний
Відображати лише елементи, які вказані як буквальні дати, наприклад, «2008 липня 4 року». Не треба
відображати елементи, які визначаються виразами, наприклад, періодичні елементи, як-от "w=thu".
За замовчуванням: ні

--тестовий_вираз
--гола_версія
--make_filter_regex
--test_accent_filtering
Ці параметри використовуються внутрішньо для створення та тестування.

ОПИС

Коли — це надзвичайно проста персональна програма календаря, орієнтована на тих, хто хоче Unix
щось мінімалістичне. Він може відстежувати речі, які вам потрібно зробити в певні дати.
Існує багато календарних програм і програм «менеджера особистої інформації».
які причини є для використання Коли?

Це дуже коротка і проста програма, тому ви можете легко повозитися з нею самостійно.
Він не залежить від жодних бібліотек, тому його легко встановити. Ви повинні мати можливість встановити
у будь-якій системі, де доступний Perl, навіть якщо у вас немає прав на встановлення
бібліотеки.
Його формат файлу – це простий текстовий файл, який ви можете редагувати у своєму улюбленому редакторі.

хоча Коли має працювати практично в будь-якій операційній системі, де доступний Perl, в
У цьому документі я припускаю, що ви використовуєте якусь різновид Unix.

УСТАНОВКА І ВІДТВОРЕННЯ ПОЧАТОК

Увійшовши в систему як root, виконайте таку команду:

зробити установку

прогін Коли вперше використав цю команду:

коли

Вам буде запропоновано надати деяку інформацію, необхідну для налаштування файлу календаря.

ВИКОРИСТАННЯ

Якщо ти біжиш Коли знову після початкового запуску налаштування, він повинен роздрукувати один рядок
текст із зазначенням поточної дати. Він не друкуватиме нічого іншого, тому що ваш
файл календаря порожній, тому у вас немає жодних зустрічей.

Тепер ви можете почати розміщувати елементи у файлі календаря. Кожен пункт являє собою рядок тексту, який
виглядає так:

2003 лютого 3 року летіть до Стокгольма, щоб прийняти Нобелівську премію.

Зручний спосіб редагувати файл календаря – це команда:

коли e

Це перенесе вас у ваш улюблений редактор (той, який ви вибрали під час запуску Коли для першого
час).

Дата має бути у форматі рік-місяць-день, але ви можете вказати місяць або вказати його
як число. (Назви місяців не чутливі до регістру, і не має значення, чи представляєте ви
Лютий як F, Fe, Feb, Februa чи що завгодно. Просто це має бути унікальний матч. Ти можеш
дайте кінцевий ., який буде проігноровано. У чеській мові «cer» можна використовувати як абревіатуру
для Cerven і "cec" для Cervenec.) Зайві пробіли ігноруються, доки ви не потрапите в
фактичний текст після коми. Порожні рядки та рядки, що починаються зі знака #, ігноруються.

Якщо зараз бігти Коли, він роздрукує список усіх елементів вашого календарного файлу, які
потрапляють у певний проміжок часу. (Інтервал починається з вчорашнього дня. Коли намагається
виберіть кінець інтервалу часу так, щоб його вихід поміщався у вікні терміналу, але це
завжди буде не менше трьох днів і не більше двох тижнів у майбутньому.) Щоб побачити все
ваші елементи на наступний місяць, виконайте ``when m'' і аналогічним чином протягом року, y або одного
тиждень, с.

Якщо ви робите ``коли c'', Коли роздруковує календарі за минулий, цей та наступний місяць
місяць.

Ви можете комбінувати ці команди. Наприклад, ``when cw'' друкуватиме календарі та
потім покажіть вам свої речі на наступний тиждень.

Для подій, які відбуваються раз на рік, наприклад, дні народження та річниці, ви можете використовувати будь-який
a * замість року,

* 25 грудня, Різдво

або використовувати рік із зірочкою:

1920* 29 серпня, Чарлі Паркер виявляється \a, народився \y

У другому прикладі \a розповідає, скільки років буде Чарлі Паркеру цього року, і \y
відтворює рік його народження, тобто вихід буде:

сьогодні, 2003 серпня 29 року, Чарлі Паркеру виповнюється 83 роки, він народився в 1920 році.

Для речей, які ви повинні робити щотижня, ви можете використовувати вираз у вигляді w=xxx, де
xxx – це кілька перших літер назви дня тижня вашою мовою. (Ти
має надати достатньо літер, щоб усунути двозначність, наприклад, англійською, w=th або w=tu, не
просто w=t.) Приклад:

ш=сонце , йти до церкви, 10:00

Насправді ви можете зробити більш витончені тести, ніж це; для отримання додаткової інформації див. розділ
"вишукані тести" нижче. Ось як налаштувати деякі звичайні свята:

m=jan & w=mon & a=3 , День Мартіна Лютера Кінга
* 14 лютого, День Святого Валентина
m=feb & w=mon & a=3 , День народження Вашингтона
m=травень & w=сонце & a=2 , День матері
m=травень & w=пн & b=1 , День пам'яті
m=jun & w=sun & a=3 , День батька
* 4 липня, День Незалежності
m=вер & w=пн & a=1 , День праці
m=жовт. & w=пн & a=2, День Колумба
m=oct & w=mon & a=2 , День подяки (Канада)
* 11 листопада, День перемир'я
m=nov & w=thu & a=4 , День подяки (США)
e=47 , Марді Гра
e=46 , Попельна середа
e=7 , Вербна неділя
e=0 , Пасхальна неділя
e=0-49 , П'ятидесятниця (49 днів після Великодня)

У США, коли певні свята припадають на вихідні, федеральні працівники, а також багато хто
приватні працівники, отримайте вихідні понеділок або п’ятницю. Повний список наведено за адресою
http://www.opm.gov/operating_status_schedules/fedhol/2011.asp. Якщо ви хочете нагадувати про
як свято, так і день, коли ви йдете з роботи, ось приклад того, як ви встановите
що вгору:

* 4 липня, День Незалежності
m=jul & c=4 , День незалежності (відзначається як федеральне свято)

ІНТЕРНАЦІОНАЛІЗАЦІЯ

Коли має принаймні часткову підтримку чеської, датської, голландської, англійської, французької, німецької,
грецька, угорська, італійська, польська, румунська, іспанська та українська. Якщо Коли не був
перекладений вашою мовою або був лише частково перекладений текстом, який не був перекладений
перекладено буде відображатися англійською мовою. Коли має автоматично визначити, що
мову, яку ви використовуєте (через змінну середовища $LANG), і if Коли було перекладено
цією мовою, це те, що ви отримаєте -- КолиВихід 's буде на вашій мові, і
Коли також очікує, що ви використовуватимете цю мову у файлі календаря для назв
місяців і днів тижня.

Файл календаря має бути в UTF-8 (або ASCII, який є підмножиною UTF-8). Якщо ти
файл календаря має інше кодування, наприклад ISO-8859, Коли зазвичай зможе
виявить це і відмовиться читати. Параметри командного рядка також можуть містити UTF-8.

Деякі емулятори терміналів (aterm, ...) відображають акцентовані символи як сміття, але інші
(mlterm, xterm...) може відображати їх правильно. Коли перевіряє середовище $TERM
змінної, і якщо вона дорівнює "mlterm" або "xterm", то символи з наголосом будуть
відображається. В іншому випадку вони відфільтровуються з виходу. Ви можете змінити це за допомогою
поставивши рядок лайк

filter_accents_on_output = 0

or

filter_accents_on_output = 1

у вашому ~/.коли/налаштування файл. Мені було б цікаво почути від усіх користувачів, які можуть
пропонують кращий механізм для цього, ніж спроби інтерпретувати змінну $TERM.

Під час введення наголоси дозволені, але не обов’язкові, наприклад, у вхідному файлі французькою мовою,
дата 2005 лютого 17 року може бути подана з наголошеним e або без наголосу, і або
буду працювати. Якщо введений місяць або день тижня не відповідає жодному з ваших
тоді мова Коли спробує інтерпретувати його як англійську.

Можна поставити лайк

мова = фр

у файлі налаштувань, щоб встановити свою мову, або введіть параметр --language на
командного рядка, але це не обов’язково, якщо встановлено змінну середовища $LANG
правильно

ФОРМАТ OF THE ПРЕФЕРЕНЦІЇ Фото

Кожен рядок складається з такого:

змінна = значення

Пробіли ігноруються скрізь, окрім значення. Назви змінних - це регістр
нечутливий. Порожні рядки ігноруються.

БІЛЬШЕ ПРИКЛАДИ

Корисна команда, щоб ваша оболонка виконувала під час входу в систему:

коли --минуле=0 --майбутнє=1

Щоб роздрукувати календар на наступний рік:

коли --минуле=0 --майбутнє=365 c

МІКУВАННЯ UP ПЕЖО КАЛЕНДАР КОЛИ ВИ ВХІД IN

Ваш календар не принесе вам ніякої користі, якщо ви забуваєте переглядати його щодня. Легкий спосіб
щоб він з'являвся під час входу в систему, це означає, що ваш файл .xsession або .xinitrc виглядає так
це:

/usr/bin/when --past=0 --future=1 &>~/коли.сьогодні
emacs -geometry 70x25 -bg бісквіт ~/коли.сьогодні &
startkde

Файл .xsession використовується, якщо на вашому комп’ютері налаштовано графічний менеджер входу,
.xinitrc, якщо ви цього не зробите. У цьому прикладі перший рядок виводить ваш календар на a
файл. Повний шлях до Коли Програма надається, оскільки змінна шляху вашої оболонки
ще не буде належним чином ініціалізовано, коли це запуститься. У другому рядку з’являється графічний інтерфейс emacs
вікно, яке яскраво забарвлене, щоб привернути увагу. Останній рядок
запускає ваш віконний менеджер, KDE у цьому прикладі. Яким би віконним менеджером ви не користувалися, просто
переконайтеся, що збережено вже існуючий рядок у файлі, який його починає, і переконайтеся, що це
цей рядок є останнім у файлі.

СОРТУВАННЯ BY ЧАС OF ДЕНЬ

Якщо ви хочете, щоб різні елементи, які лежать в один день, були роздруковані в певному
порядку, найпростіший спосіб зробити це – розмістити їх у такому порядку у вхідному файлі. Це
метод не працюватиме, однак, якщо деякі елементи лежать на датах, які визначаються
вирази, а не дані явно. Найпоширеніша причина бажання це зробити
річ у тому, що у вас є речі, які вам потрібно зробити в певний час протягом дня, і
ви хочете, щоб вони були впорядковані за часом. У цій ситуації ви можете дати час на початку
тексту елемента, і Коли розпізнає це і сортує елементи за часом. Часи можуть бути
у форматі h:mm або hh:mm. Якщо встановлено --ampm, тоді можна використовувати необов'язковий суфікс a або p
AM або PM, наприклад, з 9:30 до 9:30. Якщо ви використовуєте час AM/PM, ви також можете, наприклад, встановити
--auto_pm=9, щоб години менше 9 автоматично розглядалися як PM. Ось
приклад:

2010 25 квітня, 7:00 вечеря в комуні анархо-синдикалістів
ж=нд , 10:00 церква

25 квітня 2010 року — неділя, тому в цей день обидва ці елементи будуть відображатися. Якщо
--auto_pm встановлено на 8 або вище, тоді 7:00 буде автоматично інтерпретовано як 7:00
PM, а дата вечері буде відображена під ранковою церковною церемонією.

УЯВА ВИПРОБУВАННЯ

На додаток до w, обговорюваного вище, є купа інших змінних, які ви можете перевірити:

w - день тижня
м - місяць
д - число місяця
у - рік
j - змінений номер юліанського дня
а - 1 для перших 7 днів місяця, 2 для наступних 7 і т.д.
б - 1 за останні 7 днів місяця, 2 за попередні 7 і т.д.
в - у понеділок або п'ятницю, дорівнює дню місяця найближчого вихідного дня; інакше -1
е - дні до цьогорічного (західного) Великодня
z - день року (1 на Новий рік)

Ви можете вказати місяці у вигляді цифр, m=2, або як назви вашою мовою, m=feb. ти
також можна використовувати логічні оператори & (і) і | (або). Наступний приклад нагадує вам
виплачувати працівникам перше та п’ятнадцяте число кожного місяця:

d=1 | d=15 , Оплата праці працівників.

Цей приклад нагадує вам репетирувати зі своїм гуртом в останню суботу кожного місяця:

w=sat & b=1, репетируйте з оркестром.

Наступні два рядки

* 25 грудня, Різдво
m=dec & d=25 , Різдво

обидва роблять те саме, але перша версія легша для розуміння та робиться
програма працює швидше. (Коли ви робите тест, Коли має проходити щодня в
діапазон дат, які ви просили, і оцініть тест для кожного з цих днів. На моїй машині,
якщо я роздрукую календар на цілий рік, використовуючи файл із 10 простими тестами, це
займає кілька секунд.) Дужки також можна використовувати.

Залежно від вашої національності та релігії, у вас, напевно, є купа свят
не брехати у визначені дати. У християнстві багато з них («рухомих свят») є
обчислюється відносно Великодня, тому змінна e є корисною.

Існує оператор not, !:

w=fri & !(m=dec & d=25) , гра в покер

Є оператор за модулем % і оператор віднімання -. Використовуючи ці разом із
j змінної, це навряд чи можливо для Коли' Маленький синтаксичний аналізатор для виконання наступного
подвиг:

!(j%14-1) , робіть щось кожну другу середу

Логіка цього дурного маленького чаклунства виглядає так. Спочатку визначаємо,
за допомогою команди `when j --now="2005 jan 26"', що перша середа, коли ми хочемо
для цього має юліанський день, що дорівнює 1, за модулем 14. Потім запишемо цей вираз так
що якщо це середа, юліанський день якої дорівнює 1, за модулем 14, кількість в дужках
буде дорівнювати нулю, а взяття його логічного заперечення дасть істинне значення.

Асоціативність операторів і порядок пріоритету (від найвищого до нижчого) виглядає так:

лівий %
ліворуч -
вліво < > <= >=
ліворуч = !=
правильно !
ліворуч і
ліворуч |

ВКЛЮЧАЮЧИ ФАЙЛИ

Якщо ваш файл календаря завеликий, ви можете розділити його на менші частини --
можливо, одна на дні народження, одна для тибетських свят тощо. Простий спосіб досягти
це щоб встановити програму m4, поставити рядок

попередній фільтр = m4 -P

у файлі налаштувань, а потім розмістіть рядки у файлі календаря таким чином:

m4_include(/home/yourname/.when/birthdays)

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

$LANG для автоматичного визначення мови користувача

$TERM щоб спробувати з'ясувати, чи може емулятор терміналу відображати наголошені символи

Використовуйте в режимі онлайн, використовуючи служби onworks.net