# Підручник з &ktimetracker;

Jonathan
Singer

    &Jonathan.Singer.mail;

Mark
Bucciarelli

    mark@hubcapconsulting.com

Sirtaj
Singh
Kang

    &Sirtaj.Singh.Kang.mail;

Lauri
Watts
Рецензент

    &Lauri.Watts.mail;

Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською
2000-2004
&Jonathan.Singer;
2004-2005
Mark Bucciarelli
&FDLNotice;
2009-10-19
4.3.1

&ktimetracker; — інструмент для слідкування за часом, витраченим на різноманітні задачі.

KDE
ktimetracker
kdeutils
час
інструмент спостереження
проект

## Вступ

&ktimetracker; стежить за часом, який ви витрачаєте на роботу над різноманітними задачами. Ця програма корисна для стеження за обліком годин, вона може створювати звіти за даними, записаними для задачі або протягом дня.

Цей журнал розподілу часу можна експортувати як файл тексту, розміченого комами, для наступного імпорту до інших інструментів обліку часу і/або керування проектами.

&ktimetracker; може визначати час, коли клавіатуру та мишу вашого комп’ютера не буде задіяно, а також пов’язувати різні задачі з різними стільницями, ці два інструменти можуть допомогти вам стежити за тим, щоб таймер виконував відлік часу для належної задачі.

Першу версію &ktimetracker; було створено &Sirtaj.Singh.Kang;. Домашню сторінку програми розташовано за адресою http://userbase.kde.org/ktimetracker_(uk).

## Користування &ktimetracker;

### Як запустити &ktimetracker;

Введіть команду `ktimetracker` у командному рядку або оберіть пункт Персональний лічильник часу з групи Інструменти Утиліти у меню запуску KDE. Для запуску програми можна використовувати стандартні параметри &Qt; і &kde; командного рядка, ви можете ознайомитися з цим списком параметрів за допомогою команди ``ktimetracker` `--help``, відданої з командного рядка.

Під час запуску &ktimetracker; можна скористатися додатковим параметром командного рядка, за допомогою якого можна вказати назву файла iCalendar, який використовується для зберігання журналу вашої роботи. Ви можете вказати віддалений файл iCalendar за допомогою частин адрес http або ftp, доданих до назви файла; наприклад, http://www.mysite.com/mydata/mylabor.ics.

### Задачі

Проблема: Ви є консультантом з вільного програмного забезпечення, у вас багато клієнтів. Деякі з клієнтів мають по декілька проектів. Протягом дня ви перемикаєтеся з одного проекту на інший. Вам потрібно стежити за вашим часом, щоб потім створити рахунок за місяць роботи.

Вирішення: Створіть по одній задачі верхнього рівня для кожного з клієнтів і по підзадачі на кожен з проектів клієнта. Для проектів, які потребують докладнішого стеження, створіть список підзадач. Увімкнути стеження за часом можна подвійним клацанням на задачі, над якою ви зараз працюєте.

У &ktimetracker; закладено значну гнучкість у стеженні за розподілом вашого часу, ви можете задавати необмежену кількість задач і необмежену глибину вкладеності підзадач. Ви можете увійти до будь-якої з задач і активізовувати декілька задач одночасно у будь-який момент часу.

У &ktimetracker; передбачено можливість редагування журналу завдань та додавання коментарів щодо кожної зупиненої вами події.

Щоб створити задачу найвищого рівня, скористайтеся пунктом меню &Ctrl;T Задача Створити задачу... . Щоб створити підзадачу, оберіть основну задачу і скористайтеся пунктом меню &Ctrl;&Alt;N Задача Нова підзадача...

Під час виходу з &ktimetracker; список задач зберігається у файлі на диску вашого комп’ютера. Під час наступного запуску програми цей список буде завантажено з вказаного файла.

&ktimetracker; може імпортувати і експортувати задачі, що полегшить вам життя. Див. Інші системи.

### Таймери

Проблема: Щоб мати достатньо грошей, вам слід працювати в середньому п’ять годин на добу. Щоб бути в курсі подій, вам слід переглянути загальні цифри за день і тиждень.

Вирішення: Повертайте таймер сеансу у нульове значення на початку кожного робочого дня і повертайте нульові значення всім таймерам на початку кожного тижня.

З &ktimetracker; слідкувати за часом просто. Щоб розпочати відлік часу для задачі, просто наведіть вказівник на позначку задачі і двічі клацніть лівою кнопкою миші. Щоб зупинити відлік часу, ще раз наведіть вказівник миші на запис задачі і двічі клацніть лівою кнопкою миші. Для активних задач у стовпчику Тривалість сеансу буде показано маленький секундомір.

Ще одним засобом показу спостереження за поточною активністю &ktimetracker; є піктограма системного лотка. Якщо активною є певна задача, друга стрілка годинника на піктограмі рухається. Якщо ви наведете вказівник миші на цю піктограму, у контекстному вікні буде показано назву поточної задачі. Якщо активними є декілька задач, назви задач у контекстному вікні буде відокремлено комами.

У &ktimetracker; кожній задачі відповідають два таймери: один лічить час сеансу, а інший — загальний час. За типового налаштування, &ktimetracker; показує для кожного з таймерів по два стовпчики, що дає нам загалом чотири стовпчики для кожної задачі:

Тривалість сеансу

  Час, витрачений на задачу з початку сеансу.

Час

  Час, витрачений на задачу, з моменту останнього скидання показань таймерів.

Загальна тривалість сеансу

  Час, витрачений на задачу і всі її підзадачі з початку сеансу.

Всього часу

  Час, витрачений на задачу і всі її підзадачі, з моменту останнього скидання показань таймерів.

Щоб розпочати новий сеанс, скористайтеся пунктом меню Файл Запустити новий сеанс

Щоб повернути нульові значення всіх таймерів, скористайтеся пунктом меню Файл Скинути всі таймери

#### Стеження за стільницями

Проблема: Протягом дня ви перемикаєтеся між двома задачами. Для того, щоб впорядкувати вашу роботу, ви зберігаєте файли проекту 1 на Стільниці 1, а файли проекту 2 — на Стільниці 2.

Вирішення: Пов’яжіть задачу проекту 1 зі Стільницею 1, а задачу проекту 2 зі Стільницею 2. Коли ви перемикатиметеся зі Стільниці 2 на Стільницю 1, &ktimetracker; автоматично зупинятиме таймер задачі проекту 2 і запускатиме таймер задачі проекту 1.

Щоб пов’язати задачу з одною або декількома стільницями, скористайтеся пунктом меню &Ctrl;E Задача Редагувати... . Позначте у вікні, що відкриється, пункт Автоматичне стеження, а потім позначте стільницю або стільниці, які буде пов’язано з задачею. Коли ставатиме активною одна з позначених стільниць, протягом короткого проміжку часу &ktimetracker; автоматично розпочинатиме відлік часу для відповідної задачі.

#### Визначення бездіяльності

Проблема: Ви полишили роботу вранці у п’ятницю через важливе доручення і забули зупинити таймер. Коли ви повернулися до роботи у понеділок, таймер все ще продовжував відлік часу.

Вирішення: Увімкніть визначення бездіяльності.

&ktimetracker; можна налаштувати так, щоб програма виявляла відсутність руху миші і натискань клавіш клавіатури. Якщо з боку миші і клавіатури не спостерігається руху протягом вказаної кількості хвилин, &ktimetracker; відкриває таке діалогове вікно:

Визначення бездіяльності у &ktimetracker;
Діалогове вікно визначення бездіяльності &ktimetracker;

Продовжити лічити час

  Застосуйте час бездіяльності до всіх активних таймерів і продовжувати відлік.

  Ви працювали над задачами, доки комп’ютер був бездіяльним, і продовжуєте працювати далі.

Зворотний відлік

  Відняти час бездіяльності від всіх активних таймерів і зупинити їх.

  Ви не працювали над задачами, доки комп’ютер був бездіяльним, і продовжуєте робити інші речі.

### Інші системи

#### &korganizer;

&ktimetracker;, подібно до &korganizer; і Apple iCal, використовує для зберігання даних загальноприйнятий стандартний формат даних iCalendar. &ktimetracker; може читати і записувати списки завдань, створені цими двома програмами.

Якщо у обох програмах, &ktimetracker; і &korganizer; буде відкрито один і той самий файл, і ви редагуватимете файл у &korganizer;, ви ризикуєте втратити дані. Щоб убезпечити ваші дані, редагуйте файл лише у одній з програм.

#### Планувальник

У типовому випадку використання, у вас може виникнути потреба у плануванні проекту за допомогою інструменту для керування проектами Imendio Planner (з live.gnome.org/Planner), а потім імпортувати список задач до &ktimetracker; за допомогою пункту меню Файл Імпорт Імпортувати задачі з плановика..., щоб отримувати їх у загальноприйнятому стандартному форматі iCalendar. Якщо ви зробите це, ви зможете скласти розклад задач у &korganizer;, а потім здійснювати облік за допомогою &ktimetracker;. Таким чином, можна контролювати стан виконання і бюджет проекту.

#### &DBus;

&DBus; — це механізм, за допомогою якого програм &kde; здійснюють обмін інформацією. У кожній програмі &kde; передбачено список функцій, які можуть використовувати інші програми (наприклад, скрипти Bash).

##### Скрипт Bash, який виводить версію &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo "ktimetracker не запущено"

У поточній версії &ktimetracker; інтерфейс &DBus; використовується в основному з метою автоматизації перевірки, він є дуже обмеженим. Повний опис інтерфейсу можна знайти у розділі Додаток з інтерфейсу &DBus;.

Щоб ознайомитися з повним переліком інтерфейсів &DBus;, які надає у ваше розпорядження версія &ktimetracker;, встановлена у вашій системі, виконайте такий скрипт Bash:

##### Показує список інтерфейсів &DBus; &ktimetracker; у консолі

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "ktimetracker не запущено"

#### Експорт загальних даних до CSV

&ktimetracker; може експортувати як підсумкові дані, так і дані журналу у текстовому форматі з відокремленням комами. Щоб експортувати підсумкові дані, скористайтеся пунктом меню Файл Експорт Експортувати час... , &ktimetracker; відкриє таке діалогове вікно експорту:

Діалогове вікно експорту до CSV &ktimetracker;
Діалогове вікно експорту до CSV &ktimetracker;

Введіть назву файла, до якого ви бажаєте експортувати дані, і, за потреби, змініть інші типові параметри з діалогового вікна. Натисніть кнопку Експортувати, &ktimetracker; експортує загальний журнал задач до вказаного вами файла.

Щоб експортувати часові дані до буфера обміну даними, натисніть кнопку Експортувати до буфера

Ось приклад формату виведення:

    "kde",,,,,0.00,0.00,6.88,9.83
    ,"ktimetracker",,,,6.88,8.70,6.88,9.83
    ,,"3.2 feature plan",,,0.00,0.00,0.00,0.00
    ,,"bugs",,,0.00,1.13,0.00,1.13
    ,,"checkin changes - translation strings",,,0.00,0.00,0.00,0.00
    ,,"time card report",,,0.00,0.00,0.00,0.00
    ,"kopete",,,,0.00,0.00,0.00,0.00
    ,"promo",,,,0.00,0.00,0.00,0.00
    ,"web stuff",,,,0.00,0.00,0.00,0.00

Задачі верхнього рівня буде виведено до першого стовпчика, підзадачі — до другого тощо. Дані щодо часу буде наведено після найглибшої задачі у ієрархії задач (у нашому прикладі у п’ятому стовпчику). Перший стовпчик з часом буде мати назву Тривалість сеансу, другий — Час, третій — Загальна тривалість сеансу, а четвертий — Загальна тривалість.

#### Експорт історії до CSV

Щоб експортувати історію задачі, скористайтеся пунктом меню Файл Імпорт/Експорт Експортувати журнал... , &ktimetracker; відкриє те саме діалогове вікно, що і показане вище.

Введіть назву файла, до якого ви бажаєте експортувати дані, і оберіть діапазон дат, для якого буде створено історію задачі. За потреби, змініть інші типові параметри з діалогового вікна. Натисніть кнопку Експортувати, &ktimetracker; експортує історію всіх задач до вказаного вами файла.

Щоб експортувати журнал до буфера обміну даними, натисніть кнопку Експортувати до буфера

Ось приклад формату виведення:

    Історія задач
    З Вівторок 06 липня 2004 до Вівторок 13 липня 2004
    Надруковано: 2004-07-13 18:10
    2004-07-06,2004-07-07,2004-07-08,2004-07-09,2004-07-10,2004-07-11,2004-07-12,2004-07-13,
    ,,,,,,,,0.00,"kde"
    ,,1.77,3.23,1.73,,1.37,0.82,8.95,,"ktimetracker"
    ,,,,,,,,0.00,,,"3.2 feature plan"
    ,1.13,,,,,,,1.13,,,"bugs"
    ,,,,,,,,0.00,,,"checkin changes - translation strings"
    ,,,,,,,,0.00,,,"time card report"
    ,,,,,,,,0.00,,"kopete"
    ,,,,,,,,0.00,,"promo"
    ,,,,,,,,0.00,,"web stuff"

Перші три рядки вказують на те, коли було створено звіт, і для якого проміжку часу його було створено. У четвертому рядку буде показано список дат у діапазоні дат, у форматі ISO 8601 (РРРР-ММ-ДД). У наступних рядках списку буде показано час, відлічений для кожної з задач. У останньому стовпчику буде показано загальний підсумок для всіх днів. Назву задачі буде виведено за останнім стовпчиком з відступом, який позначатиме зв’язок задача-підзадача. Назви задач верхнього рівня буде показано у першому стовпчику після підсумків.

## Інтерфейс &ktimetracker;

Головне вікно &ktimetracker; складається з таких елементів: смужки меню, панелі інструментів, вікна задач і відліку часу і смужки стану.

Вікно &ktimetracker;
Вікно &ktimetracker;

### Вікно «Задача/Час»

У цьому вікні буде показано різноманітні задачі разом з часом, який було відлічено для кожної з них протягом поточного сеансу і загалом. Задачі, для яких виконується відлік, буде позначено маленьким годинничком поряд з часом сеансу.

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

### Панель інструментів і смужка стану

На панелі інструментів (пеналі) буде показано піктограми для таких команд:

(Результат дії цих команд повністю збігається з відповідними командами меню.)

- Почати

- Зупинити

- Створити

- Нова підзадача

- Вилучити

- Змінити

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

## Подяки і ліцензія

&ktimetracker;

Авторські права на програму:

- 1997-2000 &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

- 2001-2002 Tomas Pospisek tpo_deb@sourcepole.ch

- 2003-2004 Mark Bucciarellimark@hubcapconsulting.com

Учасники розробки (за абеткою)

- Allen Winter winter@kde.org

- &David.Faure; &David.Faure.mail;

- &Espen.Sand; espen@kde.org

- Gioele Barabucci gioele@gioelebarabucci.com

- Jan Schaumann jschauma@netmeister.org

- &Jesper.Pedersen; blackie@ifad.dk

- Kalle Dalheimer &Matthias.Kalle.Dalheimer.mail;

- Klarälvdalens Datakonsult AB

- Mark Bucciarelli mark@hubcapconsulting.com

- Thorsten Stärk dev@staerk.de

- Tomas Pospisek tpo_deb@sourcepole.ch

- Willi Richert w.richert@cox.net

Ідею &ktimetracker; було запозичено з дуже корисної програми Harald Tveit Alvestrand з назвою titrax, єдиним недоліком якої було те, що її було засновано на наборі інструментів Xt.

Авторські права на документацію до програми належать &Jonathan.Singer; &Jonathan.Singer.mail; і &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;, ©2000–2004

Переклад українською: Юрій Чорноіванyurchor@ukr.net

&underFDL; &underGPL;
активна задача

  Задача, для якої запущено таймер.

&DBus;

  Протокол взаємодії між процесами, який використовується у &kde;. Назва є скороченням від Desktop Bus (шина стільниці).

стільниця

  У &GNU;/&Linux;, FreeBSD та інших системах, де працює X-Window існує декілька стільниць. Типово, буде встановлено чотири різних стільниці. На кожній зі стільниць може бути показано власний набір програм і файлів. Після першого запуску &kde; ви побачите Стільницю 1. Якщо натиснути комбінацію клавіш &Ctrl;F2, ви побачите Стільницю 2. Натискання комбінації клавіш &Ctrl;F1 поверне вас на Стільницю 1.

журнал

  Якщо &ktimetracker; налаштовано на запис історії, програма запише кожну подію з запуску/зупинки таймера. Ця історія не спорожнюється під час скидання значень таймерів і залишається записаною у файлі до того часу, доки ви не вилучите задачу.

сеанс

  Визначена користувачем точка запуску таймерів сеансу. Розпочати новий сеанс можна розпочати за допомогою пункту меню Файл Запустити новий сеанс . Дані сеансу не зберігаються під час створення нового сеансу.

Тривалість сеансу

  Час, витрачений на задачу з початку сеансу.

системний лоток

  Системний лоток — це панель, яка (типово) розташовується в нижній частині екрана. У цьому системному лотку піктограма &ktimetracker; розташовується праворуч.

задача найвищого рівня

  Задача, у якої немає батьківських задач.

Загальна тривалість сеансу

  Час, витрачений на задачу і всі її підзадачі з початку сеансу.

Час

  Час, витрачений на задачу, з моменту останнього скидання показань таймерів.

Всього часу

  Час, витрачений на задачу і всі її підзадачі, з моменту останнього скидання показань таймерів.

## Встановлення

### Як отримати &ktimetracker;

&install.intro.documentation; &install.compile.documentation;

## Інтерфейс &DBus;

version

### version

Повертає версію &ktimetracker;.

    QString version()

#### Опис

Функція `version()` — це виклик &DBus;, який повертає номер версії &ktimetracker;, наприклад, 4.3.1. Номер версії повертається як рядок у типовому форматі &GNU;, основна.додаткова.виправлення.

quit

### quit

Повертає стан виходу з &ktimetracker;.

    QString quit()

#### Опис

`quit()` — це виклик &DBus;, за допомогою якого зовнішня програма може належним чином завершити роботу &ktimetracker;.

addtodo

### addTask

Додати нову задачу.

    QString addTask(QString назва_задачі)

#### Параметри

`назва_задачі`

  Назва нової задачі.

#### Опис

Функція `addTask(QString назва_задачі)` — це виклик &DBus;, який додає нове завдання найвищого рівня до поточного списку. Функція поверне унікальний ідентифікатор (UID) створеної задачі.

&documentation.index;