Как настроить праздники в timewarrior

Вопрос или проблема

Я использую taskwarrior с timewarrior и хочу настроить праздники. В документации говорится, что файлы праздничных дней могут находиться по пути /usr/local/share/doc/timew/doc/holidays/holidays.en-US, но путь зависит от платформы, поэтому используйте соответствующий путь для вашей системы.
На моей системе этот путь не существует. Я установил timew из community-repo

Как мне узнать, где на моей системе находятся файлы с праздничными днями?

Поискать timew на странице поиска пакетов arch linux: https://www.archlinux.org/packages/ На странице пакета timew, нажмите “просмотреть список файлов” внизу страницы. Это покажет вам все установленные файлы вместе с их путями по умолчанию. Выглядит так, что файл holidays.en-US установлен по пути /usr/share/doc/timew/doc/holidays/holidays.en-US

Вы также можете использовать команду find find / -name holidays.en-US 2>/dev/null

Возможно, файл праздничных дней для вашего региона не существует или устарел.

Taskwarrior включает скрипт для генерации этих файлов праздничных дней. На моей системе (Linux Mint) он находится по пути /usr/local/share/doc/task/scripts/add-ons/update-holidays.pl. Вы можете использовать его следующим образом:

./update-holidays.pl --locale en-US --file holidays.en-US.rc

Ответ или решение

Установка и настройка праздников в Timewarrior — важный шаг для эффективного управления временем и зафиксированных задач, связанных с рабочими и выходными днями. Вопрос актуален для тех, кто использует связку Taskwarrior и Timewarrior и хочет адаптировать свои инструменты к локальным или персональным календарям. Давайте подробно разберем, как можно установить и настроить файлы праздников на примере системы Arch Linux.

Теория: Зачем нужны файлы праздников в Timewarrior

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

Пример: Поиск расположения файлов праздников

Как упоминалось в документации Timewarrior, файлы с информацией о праздниках могут находиться, к примеру, по следующему пути: /usr/local/share/doc/timew/doc/holidays/holidays.en-US. Однако этот путь зависит от конкретной платформы и дистрибутива, поэтому его может не существовать на вашей системе. Для пользователей Arch Linux, поддержка такого пути может отсутствовать в репозитории. Один из методов, как это выяснить, является использованием указанных путей на странице пакета в Arch Linux.

Следуйте этим шагам:

Перейдите на страницу Arch Linux package search.
Найдите timew в списке пакетов.
На странице пакета найдите ссылку для просмотра списка файлов (скроллите вниз, где указаны списки инсталляции).
Ознакомьтесь с приведенным списком файлов; возможно, вы найдете файл праздников в /usr/share/doc/timew/doc/holidays/holidays.en-US.

Альтернатива — использование команды поиска в командной строке:

find / -name holidays.en-US 2>/dev/null

Эта команда поможет вам обнаружить файл праздников в стандартной файловой системе.

Применение: Создание и настройка пользовательских файлов праздников

Если на вашей системе отсутствуют специально настроенные файлы праздников, а необходимость в них есть, Taskwarrior может помочь в их создании. В Taskwarrior включен скрипт для генерации файлов праздников. Этот скрипт может быть полезен, если дополнительные наборы праздников не поставляются вместе с вашей установкой Timewarrior.

На примере Linux Mint, файл скрипта находится по адресу: /usr/local/share/doc/task/scripts/add-ons/update-holidays.pl. Чтобы создать файл для вашей локали, воспользуйтесь следующим примером использования:

./update-holidays.pl --locale en-US --file holidays.en-US.rc

Здесь --locale en-US указывает на нужную локаль, а --file holidays.en-US.rc устанавливает имя выходного файла.

Заключение: Обзор и рекомендации

Чтобы полностью интегрировать файлы праздников в вашу ежедневную практику использования Timewarrior, выполните следующие шаги:

Найдите или создайте файл праздников для своей локали.
Проверьте корректность указанных точек установки и, при необходимости, скорректируйте пути до места хранения ваших файлов конфигурации.
Регулярно обновляйте файлы, учитывая изменения в праздничных датах.
Документируйте изменения для лучшего отслеживания.

Настройка этих файлов позволяет учесть нерабочие дни автоматически, что деликатно влияет на вашу продуктивность и планирование задач.