 

                                          
                                 Руководство пользователя (User Manual)

  Страничка с руководством на английском
 http://bhdouglass.com/remindor/manual.html 

Автор Brian Douglass http://bhdouglass.com/

   
 
                               Указатель „Напоминатель“ (Indicator Remindor)
                                       
Указатель Напоминатель(Indicator Remindor) равно как и Напоминатель-Qt(Remindor-Qt) являются программными указателями, которые позволяют вам составлять расписание для ваших напоминаний. 
 Напоминание может быть настроено так, чтобы показать уведомление, воспроизвести звук, и/или выполнить команду.
 Напоминания могут быть запланированы на один день, или они могут быть установлены так, чтобы повторяться каждый день, каждый понедельник, через каждые 30 дней, и т.д. Кроме того, они могут быть установлены, чтобы повторяться ежеминутно или ежечасно.


Окно „Добавить Напоминание“ (Add Reminder Window)


       Вкладка „Напоминание“ (Reminder Tab)

  * Метка (Label): название для вашего напоминания
  * Время (Time): время дня, в которое вы хотите запустить напоминание.
  * Дата (Date): даты, в которые вы хотите запустить напоминание.
  * Команда (Command): команда, которая будет запущена вместе с напоминанием (может содержать вставки 
    inserts)
  * Примечания (Notes): примечания для вашего напоминания; отображаются в графе „Примечания“ в окне „Управлять    	
    Напоминаниями“(Manage Reminders)(могут содержать вставки inserts)


      Вкладка „Уведомление“ (Notification Tab)

  * Всплывающее (Popup): включить или нет „Всплывающее“ уведомление.
  * Диалоговое (Dialog): включить или нет появление „Диалогового“ окна.
  * Boxcar(Товарный вагон): включить или нет отправку уведомления через службу Boxcar(комп.термин „Пакет
    импульсов“), адрес http://boxcar.io/ (можно задать в „Предпочтениях“→„Службы“, preferences→services).
  * Pushbullet(Пущу-пулей): Средство для отправки уведомления через службу Pushbullet(Пущу-пулей)
    http://pushbullet.com/ (можно задать в „Предпочтениях“→„Службы“, preferences→services).


       Вкладка „Звук“ (Sound Tab)

  * Воспроизвести звук (Play Sound): включить или нет воспроизведение звука при появлении напоминания.
  * Звуковой файл (Sound File): выбрать музыкальный файл для воспроизведения при запуске напоминания.
  * Время звучания (Play Length): воспроизводить файл в течение „N“ секунд (если „0“ - воспроизвести файл целиком).
  * Повтор звука (Loop Sound): включить или нет повтор звукового файла число раз указанное в предпочтениях  preferences.


    Окно „Простое напоминание“ (Simple Reminder Window)

 Для каждого напоминания [ ] обозначает выбор свойств. Метка(label) - означает любую пометку, которую вы пожелаете.  Дата (date)  - можно использовать любую достоверную и однократную дату single-date. Время (time) - можно использовать любое достоверное и однократное время single-time. „N“ - представляет собой любое натуральное (положительное и целое) число. Если время не определено, то считается что указано текущее время.

 Метка „каждые N (дней|недель|месяцев|лет)“ [время]
 label every X (days|weeks|months|years) [at time]
 
  * Повторяющееся напоминание появляется каждые „N“ дней, недель, месяцев или лет в определённое время.

 Метка „дата“ [время]
 label on date [at time]      

  * Однократное напоминание в определённую дату и время.

 Метка „время“ 
 label at time

  * Однократное напоминание в определённое время на сегодня.
  * Если определённое время уже прошло, то напоминание переносится на завтра.

 Метка „каждые N (минут|часов)“
 label every X (minutes|hours)

  * Повторяющееся напоминание каждые каждые „N“ минут или часов на сегодня.

 Метка „через N (минут|часов)“
 label in X (minutes|hours)

  * Однократное напоминание через „N“ минут или часов от „сейчас“.


    Окно „Предпочтения“ (Preferences Window)


      Обычное напоминание (Standard Reminder)

  * Метка сразу (Default Label): Заголовок для обычного напоминания.
  * Время сразу (Default Time): Время дня, в которое вы хотите запускать напоминания.
  * Дата сразу (Default Date): Сроки в которые вы хотите запускать напоминания.
  * Команда сразу (Default Command): Команда, которую следует запустить при напоминании.
  * Отложить (в минутах) (Minutes to Postpone): Число минут, чтобы отложить напоминания.


      Уведомления (Notifications)

  * Всплывающее (Popup): Включить или нет всплывающее уведомление.
  * Диалоговое (Dialog): Включить или нет появление диалогового окна.
  * Мигание значка Указателя при напоминании (Change Indicator Icon on Reminder): включить или нет мигающий значок указателя во время подачи оповещения (похоже на поведение индикатора „Меню сообщений“(Messaging menu) в Ubuntu при получении новых сообщений; в Linux Mint имеется такой же апплет). Настройка не работает.


       Быстрые напоминания (Quick Reminders)

  * Быстрая метка сразу (Default Quick Label): заголовок для быстрого напоминания сразу.
  * Быстрое время сразу (Default Quick Time): Время сразу (в минутах/часах/днях) для быстрого напоминания начиная 
    с  „сейчас“.
  * Быстрый промежуток сразу (Default Quick Unit): Промежуток времени  сразу для быстрых напоминаний (в минутах/часах/днях).
  * Использовать ползунок (Use Slider): Когда включено, позволяет использовать ползунок для установки минут до быстрого напоминания. Когда выключено используется счётчик цифр.
  * Всплывающее уведомление (Popup Notification): Включить или нет всплывающее уведомление с быстрым напоминанием (это окошко, которое „всплывает“ и висит несколько секунд, а затем само закрывается).
  * Диалоговое уведомление (Dialog Notification): включить или нет диалоговое уведомление с быстрым напоминанием (это окошко, которое появляется и висит, его можно закрыть только принудительно).
  * Использовать настройки звука из „Обычного напоминания“ (Use standard reminder sound settings): Включить или нет  для быстрого напоминания настройки звука из „Обычного напоминания“.
  * Показать данные в диалоге (Show info on dialog): Включить или нет показ данных об уведомлениях в окне быстрого напоминания.


     Звук (Sound)

  * Звуковой файл сразу (Default Sound): установите музыку для напоминаний.
  * Продолжительность звучания сразу (Default Play Length): проигрывать файл в течение „N“ секунд (если 0 - проигрывать весь файл)
  * Повтор звука (Loop Sound): Прокручивать или нет звуковой файл заново.
  * Число повторений (Times to Loop): Сколько раз прокручивать звуковой файл. 


      Внешний вид (Interface Options)

  * Цвет для сегодня (Today's Color): цвет фона для „Напоминаний на сегодня“.
  * Цвет для будущего (Future Color): цвет фона для „Будущих напоминаний“.
  * Цвет для прошлого  (Past Color): цвет фона для „Прошлых напоминаний“.
  * Показывать уведомления о новостях (Show News Notification): Изменяет название кнопки „Новости“ в управляющем окне на „Последние новости!“, когда появляется новая запись в блоге разработчика программы.  
  * Значок индикатора (Indicator Icon): выберите внешний вид для значка индикатора в выпадающем меню; „значок приложения“ - значок с синим фоном и белым рисунком.
  * Скрыть указатель (Hide Indicator): скрывает указатель.(Применяйте эту настройку только если вы понимаете, что вы делаете! Наберите команду "indicator-remindor -p" в терминале, чтобы открыть „Предпочтения“.)


     Ввод даты и времени (Format)

  * Ввод времени (Time Format): способ ввода для отображения времени.
  * Ввод даты (Date Format): способ ввода для отображения и указания даты.

     
     Службы (Services)
  * Здесь можно настроить отправку напоминаний на ваш смартфон через службы Boxcar (Товарный вагон; комп.термин
    „пакет импульсов“) или Pushbullet (Пущу-пулей).


     Вставки (Inserts)

 Вы можете добавлять особые обозначения в „Примечания“ или в  „Команду“, чтобы расширить ваши возможности при запуске напоминания. 

 Например (Ex):

  „Сегодня +dayname+(день недели) и вы слушаете +soundfile+(звуковой файл)!“
  
Означает:

  „Сегодня четверг (Thursday) и вы слушаете alarm01.ogg (+soundfile+).“



+date+ (Дата)

  * Текущая дата на момент напоминания в формате указанном в „Предпочтениях“(Preferences).
  * Пример(Ex): 29-03-2017

+month+ (N месяца)

  * Номер текущего месяца.
  * Пример: 03.

+monthname+ (Месяц)

  * Полное название текущего месяца.
  * Пример: март (March).

+day+ (N дня)

  * Текущий день месяца.
  * Пример: 29.

+dayname+ (день недели)

  * Текущий день недели.
  * Пример: среда (Wednesday).

+yearday+ (N дня в году)

  * Текущий номер дня в году.
  * Пример: 235.

+year+ (год)

  * Текущий год.
  * Пример: 2017.

+time+ (время)

  * Tекущее время в формате указанном в „Предпочтениях“.
  * Пример: 8:44pm (8:44 вечера).

+hour+ (часов (24))

  * Текущий час в 24-часовом формате.
  * Пример: 14 .

+hour12+ (часов (12))

  * Текущий час 12-часовом формате.
  * Пример: 1.

+minute+ (минут)

  * Текущее число минут.
  * Пример: 44.

+second+ (секунд)

  * Текущее число секунд.
  * Пример: 01 .

+microsecond+ (Микросекунды)

  * Текущее число микросекунд.
  * Пример: 023

+soundfullfile+ (расположение звукового файла)

  * Звуковой файл (с указанием полного пути к нему) используемый в даннном напоминании.
  * Пример: /home/user/music/alarm01.ogg.

+soundfile+ (звуковой файл)

  * Звуковой файл ( без пути к нему) используемый в даннном напоминании.
  * Ex: alarm01.ogg

+command+ (команда)

  * Команда, запускаемая вместе с данным напоминанием.
  * Пример: firefox http://google.com
  * Замечание: вы не можете использовать +command+ для вставки в другие команды.


    Допустимые даты (Valid Dates)


    Допустимые однократные даты (Valid Singular Dates)

 Примеры преобразований.
 Предположим, что сегодня 22 апреля 2017 года ( April 22, 2017) и формат даты выбран в виде „22-04-2017“(все названия дней нечуствительны к регистру).

today (сегодня)

  * Означает: 22-04-2017.

tomorrow (завтра)

  * Означает: 23-04-2017.

yesterday (вчера)

  * Перевод: 21-04-2017.

monday (понедельник)

  * Перевод: 24-04-2017.(Ближайший понедельник от текущей даты).	
  * Допускаются названия дней недели.
  * Смотри также  Сокращения (Abbreviations).

next monday (следующий понедельник)

  * Означает: 01-05-2017.(Ближайший второй понедельник от текущей даты).
  * Допускаются названия всех дней недели.
  * Смотри также  Сокращения (Abbreviations).

6 мая 2017 ( May 06, 2017)

  *  Означает: 06-05-2017.

06 май (may 06)

  * Означает: 06-05-2017.

6-5-2017

  * Означает: 06-05-2017.

6-5

  * Означает: 06-05-2017.	

6/5/2017

  * Означает: 06-05-2017.

6/5

  * Означает: 06-05-2017.

10

  * Означает: 02-05-2017.	
  * Через десять дней начиная с сегодня.

-10

  * Означает: 12-04-2017.	
  * Десять дней тому назад.

next 31 (следующий 31)

  * Означает: 31-05-2017 . (По-русски работает „следующий“, но не „следующее“).
  * Следующее 31-ое число ближайшего месяца (поскольку в апреле только 30 дней, им становится 31-ое мая).

christmas (Рождество)

  * Означает: 25-12-2017.
  * По-русски только с заглавной буквы - „Рождество“ .


      Допустимые повторяющиеся даты (Valid Repeating Dates) 

 Для каждой повторяющейся даты [ ] обозначает выбор свойств. Начало (start) и конец (end)
могут быть любыми из описанных выше однократных дат singular. „N“ - представляет собой любое натуральное(положительное и целое) число.
   * Все повторяющиеся даты можно задавать либо вручную, либо автоматически. Открываем окно  „Добавить напоминание“. Находим меню „Дата“. Здесь можем прописать даты вручную. Либо  нажимаем кнопку „Изменить“ напротив „Дата“, затем нажимаем кнопку „Однократно“ и в  выпадающем меню выбираем нужное нам значение из списка выбора. Ниже описываются возможности выбора.

  * В любом случае, когда упоминается слово „месяц“('month') его численное значение запишется как „30 дней“ независимо от того, какой сейчас месяц. (Например задание „каждый месяц“ запишется в таблице напоминаний  как „каждые 30 дней“.) 

 каждый  понедельник [from „начало“ [to „конец“]]
 every monday [from start [to end]]

  * Глюк программы: from(от) и to(до) не переводятся.
  * При использовании автоматического режима меняем „Однократно“ на „Каждый „день нед.“, а затем устанавливаем нужный день недели.
  * Пример того как отразится в таблице смешанная запись: „каждый понедельник from сегодня to 20-05-2017“. 
  * Будет повторяться каждый понедельник начиная  с/после „начала“ и заканчиваясь в „конце“. 
  * Если дата окончания не назначена, то указанная „дата“ будет повторяться всё время.
  * Можно использовать любой день недели.
  * Смотри также Сокращения (Abbreviations).(По-русски не работают, то есть нельзя записать пнд, втр, срд и т.д.).
    Правда в автоматическом режиме и не требуется.) Например „каждый вторник“ придётся записывать как „каждый tues“.
  * Ещё пример: „каждый среда from завтра to Рождество“. Отобразится в программе как: „каждый среда from 23-04-2017
    to 25-12-2017“(при условии, что сегодня у вас 22 апреля 2017 года).

 каждый день|неделя|месяц|год [from „начало“ [to „конец“]]
 every (day|week|month|year) [from start [to end]]

  * При использовании автоматического режима для выбора „каждый день“ меняем „Однократно“ на „Ежедневно“ ; что
    касется выбора из „неделя|месяц|год“, то они в автоматическом режиме отсутствуют. 
  * Будет повторяться каждый день,либо через каждую неделю, месяц или год начиная с „начала“ и заканчиваясь в „конце“. 
  * Если дата окончания не назначена, то указанная „дата“ будет повторяться всё время.
  * В ручном режиме придется писать „каждый day | week | month | year“.По-русски работает только слово
    „ежедневно“(every day). 
  * Пример, допустим вы запишете:  „каждый month from сегодня to 07-11-2017“. Тогда на выходе вы получите запись вида: „каждый 30 days from 22-04-2017 to 09-01-2017“.

 каждый N-ый день мес. [с „начала“ [до „конца“]]
 every  X [from start [to end]]

  * Каждый N-ый день месяца начиная с/после „начала" и заканчиваясь в „конце“.
  * Допустимые целочисленные значения для N находятся между 0 до 31(включая 0 и 31). 
  * Если не указать конечную дату, то задание будет повторяться бесконечно.

 каждые N (дней|недель|месяцев|лет) [с „начала“ [до „конца“]]
 every X (days|weeks|months|years) [from start [to end]]

  * Через каждые N дней, недель, месяцев или лет начиная с „начала" и заканчиваясь в „конце“.
  * Если вы не укажете дату „начала", то текущая дата становится датой „начала".
  * Если не указать конечную дату, то задание будет повторяться бесконечно.
  
  Ниже описываются выборы, которые надо искать во вкладке „Однократно“: 
Открываем окно  „Добавить напоминание“. Находим меню „Дата“. Нажимаем кнопку „Изменить“ напротив даты, затем нажимаем кнопку „Однократно“ и в  выпадающем меню выбираем нужное нам значение из списка выбора.

 каждый Будний день [c „начала“ [до „конца“]]
 every weekday [from start [to end]]

  * В автоматическом режиме выбираем „Добавить“→„Дата“→„Изменить“→„Однократно“. В выпадающем окне выбираем
    „Каждый „день нед.“ и далеее „Каждый „Будний день“.
  * Каждый рабочий день недели (с понедельника по пятницу) начиная с/после „начала" и заканчиваясь в „конце“.
  * Если не указать конечную дату, то задание будет повторяться бесконечно. 

  каждые Выходные  [с „начала“ [до „конца“]]
  every weekend [from start [to end]]

  *  В автоматическом режиме выбираем „Добавить“→„Дата“→„Изменить“→„Однократно“. В выпадающем окне выбираем
    „Каждый „день нед.“ и далеее „Выходные“.
  * Каждые выходные дни (в субботу и в воскресенье) начиная с/после „начала" и заканчиваясь в „конце“.
  * Если не указать конечную дату, то задание будет повторяться бесконечно.
 
  
 через день [с „начала“ [до „конца“]]
 every other day [from start [to end]]

  * Автоматическая установка выбора находится во вкладке  „Однократно“. 
    Открываем окно  „Добавить“. Находим меню „Дата“. Нажимаем кнопку „Изменить“ напротив даты, 
    затем нажимаем кнопку „Однократно“ и в  выпадающем меню выбираем нужное нам значение из списка выбора.
  * Через день начиная с „начала" и заканчиваясь в „конце“.
  * Если вы не укажете дату „начала", то текущая дата становится датой „начала".
  * Если не указать конечную дату, то задание будет повторяться бесконечно. 
 
 следующие N дней [от „начала“] 
 next X days [from start]

  * Автоматическая установка выбора находится во вкладке  „Однократно“(см. предыдущий выбор).
  * Каждый день, на протяжении последующих N дней начиная с „начала".
  * Если вы не укажете дату „начала", то текущая дата становится датой „начала".

      Правильные сокращения
      Valid Abbreviations

  * monday - mon      понедельник - 
  * tuesday - tues    вторник - 
  * wednesday - wed   среда - 
  * thursday - thurs  четверг - 
  * friday - fri      пятница - 
  * saturday - sat    суббота - 
  * sunday - sun      воскресенье - 
  * tomorrow - tom    завтра - 
  * every - ev        каждый - 
  * next - nx         следующий - 
  * По-русски сокращений нет.

    Допустимое время
    Valid Times

  * В США, Великобритании и многих других странах используется 12-ти часовой формат времени. Согласно ему сутки разделяются на две половины по 12 часов: до полудня (a.m.) и после полудня (p.m.); тогда полночь - это 12 a.m., а полдень - это 12 p.m.
  Иначе: a.m. длится с 12 часов ночи (полночи) и заканчивается до 12 часов дня (полдень); p.m. длится с 12 часов дня (полдень) и заканчивается до 12 ночи (полночь).

    Допустимое однократное время
    Valid Singular Times


 сейчас / now

  * Текущее время.

 в обед / noon

  * Время 12:00pm иначе 12:00.

 полдень / midday

  * Время 12:00pm иначе 12:00.

 полночь / midnight

  * Время 12:00am, либо 00:00.

Примеры написания времени:

 1:00pm   - 1:00 ; час дня

 1:00 pm  - 1:00 ; час дня

 13:00    - 13:00 часов

 13       - 13 часов

 1300     - 13:00 часов

 1pm      - 1 ; час дня


      Допустимое повторяющееся время
      Valid Repeating Times

 Для каждого повторяющегося времени „[ ]“ обозначает выбор свойств. „Начало“ (start) и „конец“ (end)
могут быть любыми из описанных выше однократных значений времени single-time. „N“ - представляет собой любое натуральное(положительное и целое) число.
For each repeating time the [ ] denote option attributes. start and end
can be any of the above singular times single-time. X is any positive
integer.

 каждый час [с „начала“ до „конца“]
 every hour [from start to end]

 каждую минуту [с „начала“ до „конца“]
 every minute [from start to end]

 каждые N минут [с „начала“ до „конца“]
 every X minutes [from start to end]

 каждые N часов [от „начала“ до „конца“]
 every X hours  [from start to end]


        // Загрузить

// GitHub <https://github.com/bhdouglass>
// Launchpad <https://code.launchpad.net/~bhdouglass/>
// NPM <https://www.npmjs.com/~bhdouglass>


        // Контакты

// Email <http://bhdouglass.com/contact.html>
// Twitter <https://twitter.com/bhdouglass>
// Careers 2.0 <http://careers.stackoverflow.com/bhdouglass>
// LinkedIn <http://www.linkedin.com/pub/brian-douglass/36/8a5/b0>


        // Местоположение

DuBois, PA - США, [ˈduːbɔɪz] - город Дуба́(фр.Дерево), округ Clearfild(Чистоеполе)-[клирфилд],
в штате Пенсильвания(Пенсовые леса; от имени правителя - Пенна, также пенс-мелкая монета), США.

