Параметри командного рядка
Якщо буде вказано параметри командного рядка, KAlarm не показуватиме списку запланованих нагадувань, як це описано у розділі Користування KAlarm. Параметрами командного рядка, специфічними для KAlarm, можна скористатися для виконання таких дій:
запланувати нове нагадування
керувати режимом показу KAlarm
отримати довідку
Додаткові параметри командного рядка передбачено передусім для того, щоб надати змогу іншими програмам взаємодіяти з KAlarm. Ці параметри описано у главі Інструкція розробника для KAlarm.
Командний рядок має містити параметри, які стосуються однієї дії, виконаної з KAlarm. Якщо ви бажаєте виконати декілька дій, вам слід викликати KAlarm декілька разів з окремим набором параметром кожного разу.
Під час додавання до розкладу нового нагадування можна використовувати такі параметри:
| Параметр | Опис |
|---|---|
-a, --ack-confirm | Надіслати користувачеві запит щодо ознайомлення з повідомленням нагадування. |
-A, --attach | Вказати шлях або адресу URL файла, який буде долучено до повідомлення електронної пошти. Цей параметри можна за потреби повторювати. Цей параметр слід використовувати лише разом з --mail. |
--auto-close | Автоматично закрити повідомлення нагадування після завершення періоду, вказано за допомогою параметра --late-cancel. Цей параметр слід використовувати лише разом з параметром --late-cancel. |
-b, --beep | Відтворити системний гудок під час показу повідомлення. Разом з цим параметром не можна вказувати параметри --speak, --play і --play-repeat. |
--bcc | Надіслати приховану копію повідомлення електронної пошти на свою адресу. Цей параметр слід використовувати лише разом з параметром --mail. |
-c, --color, --colour | Встановити колір тла повідомлення за вказаною назвою Qt™ у форматі шістнадцяткового коду 0xRRGGBB. |
-C, --colorfg, --colourfg | Встановити колір тексту повідомлення за вказаною назвою Qt™ у форматі шістнадцяткового коду 0xRRGGBB. |
-d, --disable | Вимкнути нагадування. Цю дію можна увімкнути лише вручну. |
-e, --exec | Визначити команду оболонки, яку слід виконати. Якщо ви маєте намір скористатися цим параметром, його слід вказати останнім у рядку команди KAlarm. Всі наступні параметри і аргументи команди вважатимуться параметрами рядка команди, яку буде виконано. Разом з цим параметром не можна вказувати параметри --file, --exec-display і --mail. Якщо буде вказано цей параметр, параметри --ack-confirm, --beep, --color і --colorfg буде проігноровано. |
-E, --exec-display | Вказати команду оболонки, яку слід виконати для створення тексту повідомлення нагадування. Якщо ви маєте намір скористатися цим параметром, його слід вказати останнім у рядку команди KAlarm. Всі наступні параметри і аргументи команди вважатимуться параметрами рядка команди, яку буде виконано. Разом з цим параметром не можна вказувати параметри --exec, --file і --mail. |
-f, --file | Вказати шлях або адресу URL текстового файла або файла з зображенням, чий вміст сформує повідомлення нагадування. Разом з цим параметром не можна вказувати параметри --exec, --exec-display і --mail, не можна також вказувати аргументу повідомлення. |
-F, --from-id | Використовувати вказаний екземпляр програми KMail для надсилання повідомлень електронної пошти. Цим параметром можна скористатися лише разом з параметром --mail. |
-i, --interval | Встановити інтервал між повтореннями нагадування. Години і хвилини слід вказувати у форматі nHnM, де n відповідне число, наприклад, 3H30M. Інші проміжки часу слід вказувати у форматі nX, де n відповідне число, а X одна з таких літер: Y (роки), M (місяці), W (тижні), D (дні). Якщо вказано також параметр --recurrence, Y (роки) і M (місяці) не можна вказувати. Цей параметр є обов’язковим, якщо вказано параметр --repeat або --until. |
-k, --korganizer | Показувати нагадування як подію у активному календарі KOrganizer. |
-l, --late-cancel | Скасувати нагадування, якщо його не вдасться увімкнути протягом вказаного за допомогою параметра період часу. Формат параметра період збігається з описаним форматом параметра --reminder. Типовим значенням параметра період є 1 хвилина. |
-L, --login | Вмикати нагадування кожного разу, коли ви входите до системи. Разом з цим параметром не можна вказувати параметри --interval, --repeat і --until. |
-m, --mail | Надіслати повідомлення електронної пошти за вказаною адресою. За потреби, можна повторювати цей параметр. Разом з цим параметром не можна вказувати параметри --exec, --exec-display і --file. За використання цього параметра програма ігноруватиме параметри --ack-confirm, --beep, --color і --colorfg. |
-p, --play | Вказати шлях або адресу URL звукового файла, який буде відтворено як звукове нагадування або під час показу повідомлення нагадування. Разом з цим параметром не можна вказувати параметри --play-repeat, --beep і --speak. |
-P, --play-repeat | Вказати шлях або адресу URL звукового файла, який циклічно відтворюватиметься до наказу Зупинити відтворення або протягом показу повідомлення нагадування. Разом з цим параметром не можна вказувати параметри --play, --beep і --speak. |
--recurrence | Встановити повторення нагадування. Ви можете вказати параметри повторення за допомогою синтаксису iCalendar (його визначено у RFC2445), наприклад, “FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO”. Разом з цим параметром не можна використовувати параметр --until. |
-r, --repeat | Встановити кількість вмикань нагадування або, якщо задано разом з параметром --recurrence, кількість разів, які слід вмикати нагадування кожного разу, коли його активує параметр --recurrence (тобто регулярне повторення). Якщо параметр не було вказано --recurrence, аргумент -1 призведе до нескінченного повторення нагадування. Разом з цим параметром слід вказувати параметр --interval і не слід вказувати параметр --until. |
-R, --reminder | Вивести завчасне нагадування за вказаний час до основного нагадування і кожного з його повторень (якщо такі було вказано). Години і хвилини слід вказувати у форматі nHnM, де n відповідне число, наприклад, 3H30M. Інші проміжки часу слід вказувати у форматі nX, де n відповідне число, а X одна з таких літер: Y (роки), M (місяці), W (тижні), D (дні). Цей параметр не можна вказувати разом з параметрами --exec, --mail і --reminder-once. |
--reminder-once | Вивести завчасне нагадування один раз за вказаний проміжок часу перед першим повтором нагадування. Наступні повторення (якщо такі налаштовано) не будуть супроводжуватися завчасними нагадуваннями. Цей параметр не можна вказувати разом з параметрами --exec, --mail і --reminder. |
-s, --speak | Вимовити повідомлення під час його показу. Для того, щоб мати змогу використовувати цей параметр, вам слід встановити і налаштувати KTTSD, а також сумісний з ним синтезатор мовлення. Разом з цим параметром не можна вказувати параметрів --beep, --play and --play-repeat. |
-S, --subject | Рядок теми повідомлення електронної пошти. Разом з цим параметром слід вказати параметр --mail. |
-t, --time | Увімкнути нагадування у вказану дату або дату/час. Вказати дату без часу можна у форматі рррр-мм-дд [ЧП]; вказати дату з часом можна у форматі [[[рррр-]мм-]дд-]гг:хх [ЧП] (де пропущені поля дати буде заповнено даними поточного дня). Якщо не буде вказано часового поясу, буде використано локальний часовий пояс. Якщо ви бажаєте вказати позначку ЧП, її слід вказати у вигляді назви системного часового поясу (наприклад, Europe/London), UTC відповідає часовому поясу всесвітнього часу. Якщо ви вкажете параметр Clock, буде використано локальний годинник комп’ютера, часові пояси буде проігноровано. |
-v, --volume | Встановити гучність звуку для відтворення звукових файлів. Цей параметр можна використовувати лише разом з параметром --play або --play-repeat. |
-u, --until | Повторювати нагадування до вказаної дати або дати і часу. Вказати дату або дату і час можна з використання того самого синтаксису, який використовується для параметра --time. Зауважте, що, якщо вказано параметр --time, значення часового поясу буде взято з його значення, і жодного часового поясу не може бути включено до значення --until. Разом з цим параметром слід вказувати параметр --interval і не слід вказувати параметри --repeat і --recurrence. |
повідомлення | Текст повідомлення, яке буде показано, або, якщо вказано параметр --mail, текст повідомлення електронної пошти. |
Разом з цим параметром слід вказувати текст повідомлення, параметри --file, --exec, --exec-display, --play або --play-repeat. Окрім цих параметрів, всі інші параметри є необов’язковими.
Два наведених нижче приклади є варіантами створення нагадування з показом багаторядкового повідомлення з червоним тлом о 10 вечора 27 числа кожного місяця.
%kalarm-cred-t27-22:00"Час завершувати\nРОБОТУ"%kalarm-c0xFF0000-t27-22:00"Час завершувати\nРОБОТУ"
