когда - Онлайн в облаке

ПРОГРАММА:

ИМЯ

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

СИНТАКСИС

когда

когда [параметры] [команды]

Основная идея состоит в том, чтобы просто набрать «когда» в командной строке. При первом запуске
программа запросит у вас некоторую информацию по настройке. Чтобы отредактировать файл календаря в вашем
любимый редактор, делай "when e". Базовый формат файла календаря выглядит так:

2003 г. 3 февраля. Вылет в Стокгольм для получения Нобелевской премии.

Если у вас есть файл календаря, запустите программу как простой старый `when 'из команды
line распечатает дела вашего календаря на следующие две недели.

КОМАНДЫ

i Распечатайте предстоящие события в своем календаре. (Это команда по умолчанию.)

c Распечатать календари (сетки, как на настенном календаре, без отображения элементов) за последний месяц,
в этом месяце и в следующем месяце.

e Вызовите свой любимый редактор, чтобы отредактировать файл календаря.

w,m,y Печатать элементы для предстоящей недели, месяца или года, а не для заданий по умолчанию
срок две недели.

j Выведите измененный юлианский день (полезно для определения временного интервала между двумя
даты).

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

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Все следующие параметры, кроме --help, можно установить в файле настроек.
Параметры True / false могут быть установлены в командной строке как --option или --nooption, а в параметре
Preferences, установив для параметра значение 0 или 1.

--help Печатает краткое справочное сообщение.

--версия
Печатает краткое сообщение с указанием версии программного обеспечения.
есть.

--language = LANG
Установите язык на LANG. См. Раздел об интернационализации ниже. Этот
опция обычно не требуется, потому что язык определяется автоматически.

--future = ДНИ
На сколько дней в будущем продлится отчет. По умолчанию: 14

--past = ДНЕЙ
На сколько дней в прошлом распространяется отчет. Как и опция --future, --past
интерпретируется как смещение относительно текущей даты, поэтому обычно
хотите, чтобы это было отрицательное значение. По умолчанию: -1

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

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

--wrap = КОЛОННЫ
Количество столбцов текста для вывода (или 0, если вам вообще не нужен перенос).
По умолчанию: 80

- [нет] wrap_auto
Попытайтесь определить ширину терминала и установить ширину вывода
соответственно. Это применимо только в том случае, если вывод - tty, и зависит от любых
максимум устанавливается --wrap_max. Переопределяет любое значение, установленное --wrap. По умолчанию: нет

--wrap_max = КОЛОННЫ
Максимальное количество столбцов текста для вывода (или -1, если вы не хотите
максимум). Полезно в сочетании с --wrap_auto для сохранения разборчивости на очень
большие окна терминала. По умолчанию: -1

--rows = КОЛОННЫ
Количество строк текста, которые уместятся в окне терминала. При перечислении вашего
календарь, вывод будет обрезан до этой длины, если это не приведет к
листинг менее чем на три дня в будущее. Это поведение отменяется (
максимальное количество строк установлено на бесконечность), если задана опция --future
явно, или если используется команда m или y. По умолчанию: 40

- [нет] rows_auto
Попытайтесь определить высоту терминала вместо того, чтобы использовать значение, установленное в
параметр --rows. Это применимо, только если вывод - tty. Переопределяет любое значение
устанавливается --rows. По умолчанию: да

--[нет заголовка
Печатать заголовки в верхней части вывода команд i, c, w, m и y. Дефолт:
Да

- [нет] пейджинг
Когда вывод длиннее, чем значение, установленное строками или rows_auto, используйте пейджер для
отобразить вывод. (Переменные среды PAGER и LESS соблюдаются. Если
PAGER не задан, по умолчанию «меньше».) По умолчанию: да

--paging_less_options
Дополнительные параметры, если пейджер «меньше». По умолчанию: "-rXFE"

- [нет] filter_accents_on_output
Следует ли менять символы с диакритическими знаками на безударные. По умолчанию: да, если только
переменная окружения $ TERM равна "mlterm" или "xterm".

- [нет] styled_output
Если вывод - это терминал, должны ли мы использовать коды терминалов ANSI для стилизации?
По умолчанию: да

- [нет] 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, вы можете избежать печати
месяцев, не включенных в диапазон, установленный параметрами --past и --future.

- [нет] понедельник_первый
Начинайте неделю с понедельника, а не с воскресенья. По умолчанию: нет

- [нет] orthodox_easter
Рассчитайте Пасху по календарю Православной Восточной Церкви. По умолчанию: нет

- [нет] ampm
Отображение времени суток в 12-часовом формате, а не в 24-часовом. Также влияет
анализ времени ввода. По умолчанию: да

--auto_pm = x
Когда время вводится с часами меньше x, а AM или PM не
явно указанные, автоматически предполагают, что это PM, а не AM.
По умолчанию: 0

- [нет] literal_only
Отображать только те элементы, которые указаны как буквальные даты, например, «2008 июля 4 г.». Не надо
отображать элементы, которые определены выражениями, например периодические элементы, такие как «w = thu».
По умолчанию: нет

--test_expression
--bare_version
--make_filter_regex
--test_accent_filtering
Эти параметры используются внутри компании для сборки и тестирования.

ОПИСАНИЕ

После появления это чрезвычайно простая программа персонального календаря, предназначенная для компьютерных фанатов Unix, которые хотят
что-то минималистичное. Он может отслеживать дела, которые вам нужно сделать в определенные даты.
Существует множество программ календаря и `` менеджера личной информации '', поэтому
какие есть причины использовать После появления?

Это очень короткая и простая программа, поэтому вы легко можете с ней повозиться самостоятельно.
Он не зависит от каких-либо библиотек, поэтому его легко установить. У вас должна быть возможность установить
это в любой системе, где доступен Perl, даже если у вас нет прав для установки
библиотеки.
Формат файла - простой текстовый файл, который вы можете редактировать в своем любимом редакторе.

Несмотря на то, что После появления должен работать практически в любой операционной системе, в которой доступен Perl, в
В этом документе я предполагаю, что вы используете некоторую разновидность Unix.

МОНТАЖ И ПОЛУЧЕНИЕ НАЧАЛ

Войдя в систему как root, выполните следующую команду:

сделать установку

Run После появления впервые с помощью этой команды:

когда

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

ИСПОЛЬЗОВАНИЕ

Если вы запустите После появления снова после запуска начальной настройки он должен распечатать одну строку
текст, сообщающий вам текущую дату. Больше он ничего не распечатает, потому что ваш
Файл календаря пуст, поэтому у вас нет предстоящих встреч.

Теперь вы можете добавлять элементы в файл календаря. Каждый элемент представляет собой строку текста,
выглядит так:

2003 г. 3 февраля. Вылет в Стокгольм для получения Нобелевской премии.

Удобный способ редактировать файл календаря с помощью этой команды:

когда е

Вы попадете в ваш любимый редактор (тот, который вы выбрали при запуске После появления для первого
времени).

Дата должна быть в формате год-месяц-день, но вы можете указать месяц по буквам или указать его.
как число. (В названиях месяцев не учитывается регистр, и не имеет значения, представляете ли вы
Февраль как F, Fe, Feb, Februa или что-то еще. Это просто должно быть уникальное совпадение. Вы можете
дать завершающий., который будет проигнорирован. В чешском языке "cer" может использоваться как аббревиатура.
для Cerven и "cec" для Cervenec.) Лишние пробелы игнорируются, пока вы не попадете в
фактический текст после запятой. Пустые строки и строки, начинающиеся со знака #, игнорируются.

Если ты сейчас бежишь После появления, он распечатает список всех элементов в файле календаря, которые
попадают в определенный временной интервал. (Интервал начинается со вчерашнего дня. После появления пытается
выберите конец временного интервала так, чтобы его вывод поместился в окне вашего терминала, но он
всегда будет не менее трех дней и не более двух недель в будущем.) Чтобы увидеть все
ваши товары на следующий месяц, сделайте `` когда m '', и то же самое для года, y или одного
неделя, ж.

Если вы сделаете `` когда с '', После появления распечатывает календари за последний месяц, этот месяц и следующий
месяц.

Вы можете комбинировать эти команды. Например, по команде when cw будут распечатаны календари, а
затем покажу вам свои товары на следующую неделю.

Для событий, которые происходят один раз в год, таких как дни рождения и годовщины, вы можете использовать
a * вместо года,

* 25 декабря, Рождество

или используйте год со звездочкой:

1920 * 29 авг, Чарли Паркеру исполняется \ год, родился в \ год

Во втором примере \ a сообщает вам, сколько лет Чарли Паркеру будет в этом году, а \ y
воспроизводит год его рождения, т. е. вывод будет:

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

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

w = вс, пойти в церковь, 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 = sep & w = mon & a = 1, День труда
m = oct & w = mon & a = 2, День Колумба
m = oct & w = mon & a = 2, День Благодарения (Канада)
* 11 ноя, День перемирия
m = nov & w = thu & a = 4, День Благодарения (США)
e = 47, Марди Гра
e = 46, Пепельная среда
e = 7, Вербное воскресенье
e = 0, пасхальное воскресенье
е = 0-49, Пятидесятница (49 дней после Пасхи)

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

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

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

После появления хотя бы частично поддерживает чешский, датский, голландский, английский, французский, немецкий,
Греческий, венгерский, итальянский, польский, румынский, испанский и украинский. Если После появления Не было
переведен на ваш язык или переведен частично, текст, который не
Переведено будет отображаться на английском языке. После появления должен автоматически определять, что
язык, который вы используете (через переменную среды $ LANG), и если После появления был переведен
на этот язык, вот что вы получите - После появлениявывод будет на вашем языке, а
После появления также будет ожидать, что вы будете использовать этот язык в файле календаря для имен
месяцы и дни недели.

Ваш файл календаря должен быть в кодировке 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 Fev 17 может быть дана с ударением e или без ударения, и либо
буду работать. Если введенный месяц или день недели не совпадают ни с одним из
язык, тогда После появления вместо этого попытается интерпретировать его как английский.

Вы можете поставить строку вроде

язык = фр.

в файле настроек, чтобы указать язык, или укажите параметр --language в
командная строка, но это не обязательно, если установлена ​​переменная среды $ LANG
правильно.

ФОРМАТ OF ПРЕДПОЧТЕНИЯ ФАЙЛОВ

Каждая строка состоит примерно из этого:

переменная = значение

Пробелы игнорируются везде, кроме внутри значения. Имена переменных записываются в регистр-
нечувствительный. Пустые строки игнорируются.

Подробнее ПРИМЕРЫ

Полезная команда для выполнения вашей оболочки при входе в систему:

когда --прошлое = 0 --будущее = 1

Чтобы распечатать календарь на год вперед:

когда --прошлое = 0 --будущее = 365 c

ВЫСКАКИВАЮТ UP ВАШ КАЛЕНДАРЬ КОГДА ВЫ ВХОД IN

Ваш календарь не принесет вам никакой пользы, если вы забудете смотреть его каждый день. Легкий способ
чтобы он всплывал при входе в систему, чтобы ваш файл .xsession или .xinitrc выглядел как
это:

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

Файл .xsession используется, если на вашем компьютере установлен графический менеджер входа в систему,
.xinitrc, если вы этого не сделаете. В этом примере первая строка выводит ваш календарь в
файл. Полный путь к После появления дается программа, потому что переменная пути вашей оболочки
при этом еще не будет правильно инициализирован. Во второй строке появляется графический интерфейс emacs
окно, которое ярко окрашено, чтобы привлекать ваше внимание. Последняя строка
запускает ваш оконный менеджер, в данном примере KDE. Какой бы оконный менеджер вы ни использовали, просто
убедитесь, что вы сохранили уже существующую строку в файле, который ее запускает, и убедитесь, что
эта строка является самой последней в файле.

СОРТИРОВКА BY ВРЕМЯ OF ДНЕЙ

Если вы хотите, чтобы различные элементы, относящиеся к одному дню, распечатывались в определенный
порядок, самый простой способ сделать это - поместить их в этом порядке во входном файле. Что
метод не будет работать, однако, когда некоторые элементы находятся в датах, определенных
выражения, а не даны явно. Самая распространенная причина этого
дело в том, что у вас есть дела, которые вам нужно делать в определенное время в течение дня, и
вы хотите отсортировать их по времени. В этой ситуации вы можете дать время в начале
текста элемента и После появления распознает это и отсортирует элементы по времени. Времена могут быть
в формате ч: мм или чч: мм. Если установлен --ampm, то необязательный суффикс a или p может использоваться для
AM или PM, например, с 9:30 до 9:30. Если вы используете время AM / PM, вы также можете, например, установить
--auto_pm = 9, поэтому часы меньше 9 автоматически считаются PM. Вот
пример:

2010 апреля 25 г., 7:00 ужин в коммуне анархо-синдикалистов.
w = вс, 10:00 церковь

25 апреля 2010 г. - воскресенье, поэтому в этот день будут отображаться оба этих элемента. Если
--auto_pm имеет значение 8 или выше, тогда 7:00 автоматически интерпретируется как 7:00.
После полудня и дата ужина будут отображаться под утренней церковной церемонией.

FANCY ИСПЫТАНИЯ

Помимо w, о которой говорилось выше, вы можете протестировать множество других переменных:

w - день недели
м - месяц
d - день месяца
y - год
j - модифицированный номер дня по юлианскому календарю
а - 1 в течение первых 7 дней месяца, 2 в течение следующих 7 и т. д.
б - 1 за последние 7 дней месяца, 2 за предыдущие 7 и т. д.
в - в понедельник или пятницу, равняется дню месяца ближайшего выходного дня; иначе -1
e - количество дней до (западной) Пасхи в этом году
z - день года (1 в день Нового года)

Вы можете указать месяцы в виде чисел, m = 2, или в виде названий на вашем языке, m = feb. Ты
также можно использовать логические операторы & (и) и | (или). Следующий пример напоминает вам
платить своим сотрудникам первого и пятнадцатого числа каждого месяца:

d = 1 | d = 15, Оплата работникам.

Этот пример напоминает вам репетировать со своей группой в последнюю субботу каждого месяца:

w = sat & b = 1, Репетируйте с группой.

Следующие две строки

* 25 декабря, Рождество
m = dec & d = 25, Рождество

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

В зависимости от вашей национальности и вероисповедания у вас, вероятно, будет много праздников,
не лгите в установленные даты. В христианстве многие из них («подвижные праздники»)
вычисляется относительно пасхального воскресенья, поэтому полезна переменная e.

Есть оператор not,!:

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

Есть оператор по модулю% и оператор вычитания -. Используя их вместе с
j, это едва ли возможно для После появлениямаленький синтаксический анализатор для выполнения следующих
подвиг:

! (j% 14-1), делайте что-нибудь каждую вторую среду

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

Ассоциативность операторов и порядок их приоритета (от высшего к низшему) таковы:

левый %
оставил -
слева <> <=> =
слева =! =
Правильно !
левый &
слева |

ВКЛЮЧАЯ FILES

Если ваш файл календаря становится слишком большим, вы можете разделить его на более мелкие части -
возможно, один на дни рождения, один на тибетские праздники и т. д. Простой способ достижения
это установить программу m4, поставить строчку

предварительный фильтр = m4 -P

в вашем файле настроек, а затем поместите строки в свой файл календаря следующим образом:

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

ОКРУЖАЮЩАЯ СРЕДА

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

$ TERM чтобы попытаться выяснить, может ли эмулятор терминала отображать символы с диакритическими знаками

Использовать при подключении к сети с помощью сервисов onworks.net