devtodo - Интернет в облаке

ПРОГРАММА:

ИМЯ

todo - программа-напоминание / задача, предназначенная для разработчиков

СИНТАКСИС

TODO []
Без параметров отображает элементы в текущем каталоге.

TDA [-п ] [-грамм ] []
Добавьте новый элемент, при желании привив его как дочерний элемент данного элемента.

TDE
Отредактируйте данный элемент.

TDR
Удалите указанные предметы.

TDD
Отметьте указанные пункты как выполненные.

TODO --ссылка [-грамм ]
Свяжите указанную базу данных devtodo с текущей, при желании привив ее как
дочерний элемент указанного индекса.

ОПИСАНИЕ

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

Он поддерживает список элементов, которые еще предстоит завершить. Это позволяет программисту
отслеживать нерешенные ошибки или элементы, которые необходимо выполнить с минимальными усилиями.

Элементам можно назначать приоритеты, а также отображать их в иерархии, так что один элемент может
зависеть от другого.

С использованием некоторых небольших сценариев оболочки (scripts. * В каталоге doc исходного кода
распределение), todo может также отображать невыполненные элементы в каталоге при изменении
внутрь. Так, например, если вы cd в исходный каталог для самого дела, вы должны
см. список нерешенных вопросов ... если не исправлены все ошибки;).

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Варианты могут иметь как длинную, так и краткую форму.

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

-в, --подробный
Подробно отображать

-a --Добавить []
Добавьте примечание (запросит примечание, если оно не предоставлено).

-грамм, - трансплантат
В сочетании с --Добавить or --ссылка, привить новый элемент к указанному элементу.

-л, --ссылка
Свяжите указанный файл задачи с телом этого. Если в связанной базе данных есть
набор заголовков, он будет использоваться как тело элемента связи, в противном случае
будет использоваться имя каталога связанной базы данных. Используйте --remove (или tdr), чтобы удалить
связанные базы данных - это делает удаляем саму базу, только ссылку.

-R, - переродитель [, ]
Измените родительский элемент индекса первого элемента на индекс второго элемента. Если нет второго
index дается, элемент переименовывается в корень дерева.

-п, - приоритет
В сочетании с --add или --edit установите приоритет (по умолчанию | очень высокий | высокий |
средний | низкий | очень низко)

-е, --редактировать
Отредактируйте заметку, которая проиндексирована данным номером.

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

-д, --сделано
Отметьте указанные заметки (и их дочерние элементы) как выполненные.

-Д, --не сделано
Отметьте указанные заметки (и все дочерние) как невыполненные.

--global-база данных
Укажите базу данных для использования, если -G or --Глобальный параметры указаны.

-ГРАММ, --Глобальный
Заставить todo использовать базу данных, указанную с помощью --global-база данных. Если это размещено
и на Вашем ~ / .todorc это заставит todo использовать эту базу данных, исключая все
другие.

--база данных
Измените базу данных с любого значения по умолчанию (обычно .todo) на файл
указано.

-Т, --ДЕЛАТЬ
Создайте типичный выходной текстовый файл TODO из базы данных Todo.

-А, --все
Ярлык для фильтра «+ готово, + дети», чтобы показать все заметки.

-ф, --фильтр
Отображать только те заметки, которые прошли фильтр. Пожалуйста, обратитесь к разделу ФИЛЬТРЫ для
больше информации.

--цвет
Переопределить цвета по умолчанию для элементов списка дел. Пожалуйста, обратитесь к разделу ЦВЕТ для большего
Информация.

--force-цвет
Принудительное использование цвета, даже если не выводится в TTY. Это полезно при прокладке труб
в Меньше(1) -r.

--мононуклеоз Удалите из вывода все escape-последовательности ANSI - полезно для цветов с нарушением цвета
терминалы.

--Помогите Отобразите эту справку.

--версия
Показать версию ToDo.

--заглавие []
Задайте заголовок заметок этого каталога.

--Формат даты
Отформатируйте отображение значений времени. Формат используется стрфтайм(3).
формат по умолчанию - "% c". Этот вариант лучше всего указать в ~ / .todorc.

--формат знак равно
Укажите форматирование вывода. Пожалуйста, обратитесь к разделу ФОРМАТИРОВАНИЕ для получения дополнительной информации.
Информация.

--использовать-формат знак равно
Используйте строку формата, обозначенную (определяется с помощью --format) как
строка формата для использования при форматировании с помощью встроенного формата .

--Сортировать
Отсортируйте базу данных по указанному выражению. Обратитесь к разделу СОРТИРОВКА для
более подробная информация.

- параноид
Будьте параноиком в отношении некоторых настроек, включая разрешения.

- загрузчики базы данных <загрузчик список>
Попробуйте форматы базы данных в указанном порядке. Допустимые форматы: XML и двоичный. например.
todo --database-loaders двоичный файл, xml. Формат по умолчанию - XML.

--резервное копирование []
Резервное копирование базы данных до раз, незадолго до того, как он будет записан. Если Не
указано, будет сделана одна резервная копия. Имена файлов, используемые для хранения резервных копий, - это
имя базы данных по умолчанию с добавленной версией, например: .todo.1, .todo.2 и т. д.
Чтобы на самом деле использовать одну из этих резервных копий, вы можете либо перенести ее в .todo, либо использовать
- база данных .todo. чтобы явно указать его использование.

-с, --резюме
Переключите режим «сводки», когда длинные элементы обрезаются до одной строки.

-с, --комментарий
Отредактируйте или покажите комментарии соответственно.

- тайм-аут []
If задано, тайм-аут между отображениями базы данных установлен на это число
секунд. Если нет указан, поведение - отображение базы данных
Важно если он не отображался в течение количества секунд, указанного параметром --timeout
данный. например. TODO - тайм-аут 10 - тайм-аут будет отображать только
база данных не чаще одного раза в 10 секунд. Помещение Тайм-аут 10 и на Вашем ~ / .todorc - это
хороший вариант, тогда --timeout в документ / скрипты. * будет означать, что база данных
не будет отображаться каждый раз, когда вы переходите в каталог.

--purge []
Очистить все завершенные предметы старше . Если опущено, все
завершенные записи удаляются.

ПРИОРИТЕТЫ

Приоритеты можно указать символически с помощью слов по умолчанию, очень высоко, высокая, средний,
низкокачественными и очень низкий.

" по умолчанию приоритет имеет особое значение, так как он будет использовать приоритет по умолчанию для любого
действие. Это означает, что при редактировании существующего элемента его приоритет сохраняется; когда
создавая новый элемент, приоритет будет установлен на средний; при прививке нового предмета его
приоритет будет у его родителя. DevTodo не будет запрашивать приоритет, если это
указан, что делает его удобной функцией для вашего todorc. Как и во всех вариантах, приоритет
можно переопределить в командной строке.

ФИЛЬТРЫ

Фильтры состоят из списка выражений, используемых для определения заметок, которые
отображается.

Общий формат выражения фильтра:

([- | = | +] (все | дети | готово | | )) | (/ выражение>)

Как правило, если перед выражением фильтра стоит префикс '-', оно будет отображать элементы, которые
соответствует выражению, если перед ним стоит префикс '+', будут отображаться элементы, соответствующие этому
выражение в дополнение к другим, или если с префиксом '=' (или без префикса вообще) оно будет
дисплей Важно те элементы, которые соответствуют выражению. Обратите внимание, что это будет только поиск элементов
не исключается другими фильтрами, поэтому для поиска по всей базе данных вам нужно будет выполнить
что-то вроде: TODO --фильтр все, / какая-то-поисковая-строка.

Вторая форма выражения фильтра используется для поиска текста в базе данных. <поиск
выражение> - регулярное выражение, которое сопоставляется с текстовым телом каждого элемента.

Атомы фильтра фильтруются в порядке выполнения, приоритета и поиска. Итак, первые пункты
те, которые не соответствуют фильтру "Готово", будут исключены, затем те, которые не соответствуют фильтру "Готово", будут исключены.
фильтр приоритета и так далее.

Подробно о выражениях:

ВСЕ Принудительно отображает все элементы. Различные префиксы на это не влияют.
выражение.

дети
Свернуть или развернуть дочерние элементы. Если присутствует префикс '-', дочерние элементы
свернута, иначе отображаются дочерние элементы.

сделанный Отфильтруйте, завершен ли элемент или нет.


Индексы нот указаны в виде чисел. Диапазоны могут быть указаны как «1.2.10-20».


Приоритеты указаны, как описано в ПРИОРИТЕТЫ раздел. Префикс '-'
отобразит все элементы с приоритетом, меньшим или равным заданному приоритету.
С префиксом '+' все элементы с приоритетом больше или равным заданному
показаны приоритеты. Если '=' или не указан префикс, будут отображаться только элементы с указанным
отображается приоритет.

Примеры:

todo --filter done, -children, + low

Это отобразит только те элементы, которые выполнены и имеют низкий или высокий приоритет. В
Кроме того, дети будут свернуты.

todo / [Tt] он

Отображать только те элементы, в которых есть слово 'the', где первая буква может быть меньше
или верхний регистр. Может потребоваться процитировать выражение поиска, чтобы оболочка
не интерпретируйте их.

ФОРМАТИРОВАНИЕ

Вывод задачи можно изменить по своему усмотрению, указав свой собственный
форматирование строк. Эти строки похожи на те, что используются в Printf(3) и стрфтайм(3).

Следующие примеры, которые можно разместить в ~ / .todorc, будет имитировать значение по умолчанию
поведение:

# Отображать в формате по умолчанию
формат отображения =% i% [информация]% f% 2n.% [приоритет]% T

# Отображать в формате по умолчанию
сгенерированный формат =% 2i-% T% 2i (добавлен% d, приоритет% p) \ n \ n

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

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

format full-report =% i% [info]% f% 2n.% [priority]% + 1T% + 1i% [info] Добавлено:% [normal]% c
% [info] Выполнено:% [normal]% d \ n% + 1i% [info] Продолжительность:% [normal]% D% [info] Приоритет:
% [нормальный]% p \ n \ n
# Переопределите формат отображения, чтобы использовать «полный отчет».
use-format display = полный отчет

Доступны следующие флаги:

% > " > флаг устанавливает количество пробелов использовать для всех будущих отступов.

% [+ | -] [ ]я
Отступ до глубины текущего элемента. определяет глубину отступа. Если is
опущено, используется текущий уровень. Можно использовать относительные значения. например. "% + 1T" будет
отступ на один уровень выше текущего уровня отступа.

% [+ | -] [ ] T
Отобразить текст элемента, заключенный в 80 символов и с отступом до
указанный уровень. Семантика как с %i. Обратите внимание, что переносимый текст
автоматически добавляет '0 в конец текста, тогда как %t не буду.

%t Неформатированный текст элемента без оболочки.

%s Сводный текст (т. Е. Только одна строка, что эквивалентно --резюме).

%p Уровень приоритета текущего элемента.

%c Текущая дата создания элементов в формате --date-format.

%d Дата, когда элемент был отмечен как выполненный, отформатированный в соответствии с --date-format.

%D Продолжительность элемента в формате --date-format.

% [ ] п
Номер индекса текущего элемента. Необязательное числовое значение указывает на
количество знаков, которое должно занимать число. Номер дополнен пробелами.
чтобы заполнить это количество символов.

%f Государственный флаг текущего элемента. Отображаемые значения для этого флага - '+'
означает «дети», «-» означает «готово», «*» означает «сделано с детьми».

%F Удобочитаемый флаг состояния текущего элемента. Отображаемые значения для этого
flag - это «дети», «готово» означает «готово», «готово, дочерние элементы» и «открыто».

% [ ]
С помощью этого флага можно указать цвета. Допустимые значения для составляют:
очень низкий, низкокачественными, средний, высокая, очень высоко, название, infoи приоритет. Это довольно
говорит само за себя, за исключением приоритет изменяет цвет приоритета текущего элемента. например.
% [приоритет]

Обратите внимание, что при отступе вы будете типично хотите использовать значение префикса "+1"
с% T. т.е. % + 1Т. Это заставляет текст отступать на один уровень глубже, чем текущий
уровень, отстраняя его от любого другого форматирования, которое вы, возможно, использовали.

СОРТИРОВКА

Отображение элементов в базе данных можно сортировать по множеству ключей. Учитывая серию
keys todo сортирует по каждому последующему ключу, переходя к следующему, только если предыдущий ключ
сравнение было равным. Например:

todo --sort -done, текст

Это будет сортировать, во-первых, завершен ли элемент, а во-вторых, по их тексту. Этот
эффективно группирует элементы в два блока - завершенные и незавершенные.

Доступные ключи: создали, завершенный, текст, приоритет, продолжительность, нет и
сделанный. Каждая клавиша, кроме нет может иметь префикс -, чтобы изменить порядок по умолчанию и
несколько ключей должны быть разделены знаком,.

Если встречается несколько параметров --sort, используется последний. Это означает, что
'сортировать' запись в ~ / .todorc будет заменено любым в командной строке.

ИНДЕКСЫ

Индикаторы используются как опции для множества аргументов командной строки. Индексы нескольких нот
разделяются запятыми (пробелы разрешается). Дети ограничиваются с помощью символа '.'.

Например, учитывая следующие примечания:

1. Сделайте страницы руководства
1. Сделайте их красивее.
2. Сделайте также HTML-документацию.

Второй подпункт будет представлен так: 1.2.

Подстановочный знак «*» может использоваться для представления всех дочерних узлов узла. например. 1. *

Диапазоны нот можно указать с помощью знака « - ». Например, чтобы отметить заметки 10.1.2,
10.1.3 и 10.3.4, вы можете сделать: todo --done 10.1.2-4

ЦВЕТ

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

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

Цвета указываются так:

=[+]

Если необязательный + в этом выражении он выделит элемент жирным шрифтом.

Например, строка в вашем ~ / .todorc может выглядеть так:

цвет средний = + белый

Что сделало бы средний текст булавка белый.

ТОДОРК

todo может загружать параметры из ряда файлов ресурсов. Порядок, в котором они анализируются
заключается в следующем:

1. Файл, указанный в переменной окружения. ТОДОРК или, если таковой не существует,
/ и т.д. / todorc.
2. ~ / .todorc

Параметры являются кумулятивными в том смысле, что те, которые загружены из $ TODORC, будут переопределены или добавлены к
те, в ~ / .todorc.

Эти параметры указываются в виде пар ключ / значение, по одной на строку. Ключ - это длинное имя
аргумент командной строки, а значение является параметром этого аргумента, если таковой имеется. Кроме того,
переменные среды расширены.

Например, аргумент командной строки --filter принимает параметр, который является фильтром.
выражение. Фильтр по умолчанию можно добавить к ~ / .todorc файл так:

# Не отображать дочерние элементы по умолчанию
фильтр -дети

Единственная разница между параметрами, указанными в файле rc, и параметрами в командной строке
в том, что параметры в файле rc не имеют префикса -.

Кроме того, в файле RC доступны две команды, которых нет в
командная строка. Они есть:

Первая команда, on, используется для условного добавления определенных команд. Формат этого
команда является: on [ ]. Допустимые события , удаление, view, отредактировать ,
порождать, сделанный, не сделано, название, возродить, загрузка, спасти, ссылке., Создайте и чистка, множественный
команды могут быть переданы on заключив их в фигурные скобки (между
жетоны). Полный пример ниже.

Вторая команда Exec <оболочка команда>. Эта команда выполнит аргумент, который он
дано в оболочке. Переменная окружения $ TODODB содержит имя файла текущего
база данных. например. Exec CHMOD 600 $ TODODB

В подкаталоге doc исходного дистрибутива есть пример rc-файла.

ПРИМЕРЫ

Чтобы отобразить все незавершенные элементы в текущем каталоге, просто введите:

TODO

Чтобы удалить примечания 1, 2 и 4:

todo - удалить 1,2,4

Чтобы отобразить ВСЕ элементы:

делать все

Чтобы отображать только элементы верхнего уровня, а не их дочерние элементы:

todo -дети

(даже не смотря на -дети не является допустимым аргументом, это работает, потому что todo интерпретирует любые
аргументы командной строки, которые он не распознает как часть выражения фильтра)

Более сложный пример. Это добавляет новый элемент с текстом элемента, указанным в
командная строка с приоритетом высокая как дочерний элемент третьего дочернего элемента второго элемента (если
это имеет смысл):

todo -a "Исправить страницу руководства" -p high -g 2.3

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

todo --фильтровать все --TODO

В этом примере показано хорошее использование триггеров событий. Когда создается новая база данных, она
заставит свои разрешения до 0600.

при создании {
подробный
exec chmod 600 .todo
}

Используйте devtodo онлайн с помощью сервисов onworks.net