- Хата
- Новини
- Встановлення
- Інструкція
- Форуми

# Інструкція

## Вкладки :

Кожне вікно може містити кілька терміналів-вкладок. На відміну від gnome-terminal і старіших версій ROXTerm, рядок вкладок при типових налаштуванням відображається завжди (навіть коли вкладка лише одна), щоб уникнути невідповідностей при зміні розміру вікна; старіше відображення можна повернути.

## Меню :

Рядок меню (в цілому непотрібний у терміналі елемент) ховається без шкоди для функціональності, бо спливне меню показує його елементи. Попри це, рядок меню надається для легшого сприйняття ROXTerm новими користувачми. Перемикати його стан можна як для всіх терміналів (шляхом менеджера налаштувань), так і для окремого вікна.

При наведенні вказівника на веб- та е-мейл-адреси спливне меню дозволяє відкривати їх у сторонніх програмах.

## Підсвічування URI :

При наведенні вказівника на набір символів, розпізнаний ROXTerm як URI (наприклад, веб-посилання чи адреса е-пошти), той виділяється підкресленням та зміною форми вказівника. Ви можете відкрити адресу, виконавши правий тиць та вибравши пункт меню «Відкрити...», або затримавши Ctrl і виконавши лівий тиць. Адреси відкриватимуться вказаними робочим середовищем програмами; для кожного виду адрес це можна перевизначити в налаштуваннях профілю. Також можна затиснути Ctrl і перетягти адресу в вікно іншої програми, яка може сприйняти її як текст чи URI; перетягнення адреси в вікно терміналу дублює її.

Якщо вказати на серверну частину посилання, підсвітиться лише вона. Щоб відкрити адресу включно з іменем файлу, пересуньте вказівник на це ім’я. Так само можна використати адресу е-пошти (саму або з префіксом «mailto:» відповідно).

## Покрути, лизни, булькни в молоко :

Пересувайте елементи до вікон терміналу. Текстові об’єкти додаються до поточного рядка, ніби при ручному набиранні. Файли та посилання повертають свої адреси. Вкажіть тло терміналу, перетягнувши графічний файл у відповідний розділ менеджеру налаштувань. При затисканні Ctrl підсвічену в терміналі адресу можна пересунути в іншу програму.

Змінюйте порядок вкладок, перетягуючи їх мітки всередині вікна (або в інше вікно ROXTerm; поміщена поза вікна терміналу мітка створить нове вікно). Перетягуйте неактивну вкладку без її активації, використовуючи праву кнопку миші.

## Налаштування :

Налаштування базуються на йменованих профілях (для зручності перемикання різних конфігурації). Існують профілі для загальних параметрів, колірних схем та «гарячих клавіш» (котрі також називаються «скороченнями»). Колірні схеми та профілі можуть діяти в межах однієї вкладки, але для всіх вкладок одразу застосовуються єдині «гарячі клавіші» (щоб запобігти утворенню плутанини). Нове вікно (чи вкладка) успадковує налаштування вікна (чи вкладки), у якому воно було відкрите.

До версії 1.15.1 усі вкладки використовували єдиний профіль. Зараз глобальними налаштуваннями профілю стають лише ті, що можуть вплинути на розмір терміналу (наприклад, шрифт), з метою забезпечення єдиної геометрії для всіх вкладок вікна.

Тимчасово обирайте потрібний профіль через меню налаштувань. Цей параметр не запам’ятовується, типові набори налаштувань встановлюйте через менеджер налаштувань, де також можна редагувати, копіювати, стирати та перейменовувати профілі й колірні схеми, а також керувати іншими налаштуваннями. Зверніть увагу, керування «гарячими клавішами» й кодуваннями символів відбувається дещо інакше, ніж настроювання профілів та кольорів.

## «Гарячі клавіші» :

Редактора «гарячих клавіш» не існує; змінюйте їх, наводячи вказівник миші на відповідні пункти меню й натискаючи потрібну комбінацію. Типово вимкнений і такий спосіб, ви можете перемкнути його стан опцією «Дозволити редагування» на вкладці «гарячих клавіш» менеджера налаштувань. Спосіб глобально контролюється для всіх GTK-програм налаштуваннями GNOME (приховано, через gconf), XFCE («Зовнішній вигляд») чи іншого використовуваного робочого середовища, що може призвести до конфліктів.

## Керування налаштуваннями :

Запускайте менеджер налаштувань, обираючи «Налаштувати...» в меню ROX для програми ROXTerm (або запускаючи roxterm-config, якщо ROXTerm використовується незалежно).

Файлами налаштувань просто обмінюватися з іншими користувачами. На кожен профіль, кожну колірну схему й кожну схему «гарячих клавіш» виділяється один файл; його збереження у потрібну теку надасть відповідну конфігурацію (назва відповідає імені файлу).

Розташування конфігураційних файлів відповідає специфікації XDG Base Directory. Ось їх список у порядку спадання пріоритету:

1. ${XDG_CONFIG_HOME}/roxterm.sourceforge.net (зазвичай ~/.config/roxterm.sourceforge.net)
2. ${XDG_CONFIG_DIRS}/roxtem.sourceforge.net (зазвичай /etc/xdg/roxtem.sourceforge.net)
3. ROXTerm/Налаштування (для користувачів ROX) або ${datadir}/roxterm/Config (для інших); ${datadir} зазвичай відповідає /usr/share (при самостійній збірці з джерела — /usr/local/share)

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

Незалежно від розташування, профілі зберігаються до теки «Profiles», колірні схеми — до «Colours», а набори скорочень — до «Shortcurs». Файл, названий «Globals», містить опції, що не стосуються трьох основних категорій (назва типового профілю тощо).

## Параметри командного рядка :

ROXTerm підтримує кілька параметрів командного рядка. Виконайте:

roxterm --help

для отримання повного списку

Починаючи з версії 1.1.0 ROXTerm типово використовує єдиний процес для всіх терміналів, що дозволяє пересувати вкладки між вікнами. Повторно запущений ROXTerm надсилає через D-Bus відкритому процесові команду відкрити новий термінал і завершується. Щоб запустити ROXTerm окремим процесом, використовуйте параметр --separate.

У версії 1.7.0 замість параметрів --colour_scheme та --shortcut_scheme введено --colour-scheme та --shortcut-scheme відповідно (нижні риски замінено на дефіси). Старіші варіанти все ще підтримуються для зворотньої сумісності.

## Просунуте використання D-Bus :

Починаючи з версії 1.14.0, досвідчені користувачі можуть контролювати термінали з інших програм та скриптів через D-Bus. Для цього існують три D-Bus-методи. Їм необхідний індекс потрібного терміналу; його можна взяти з ROXTERM_ID, змінної оточення, в запущеній у терміналі оболонці чи іншій програмі. Шлях до об’єкту D-Bus та інтерфейс для методів — це «net.sf.roxterm.Options» та «/net/sf/roxterm/Options» відповідно. Методами є:

SetProfile("id", "profile_name")

— просить термінал використати на всіх вкладках терміналу названий профіль.

SetColourScheme("id", "scheme_name")

— просить термінал використати на вкладці названу колірну схему.

SetShortcutScheme("id", "scheme_name")

— просить термінал використати на всіх вкладках названу схему «гарячих клавіш».

Приклад використання dbus-send у скрипті:

dbus-send --session /net/sf/roxterm/Options \ net.sf.roxterm.Options.SetColourScheme string:$ROXTERM_ID string:GTK

Надсилайте D-Bus сигнали для зміни певних опцій у межах профілю чи колірної схеми методами StringOption, IntOption (також використовується для булевих опцій) та FloatOption. Тимчасово впливаються всі термінали, що використовують названий профіль чи колірну схему. Опції не зберігаються для нових терміналів. Усіма методами використовуються три аргументи:

- Повна назва профілю, включно з префіксом «Profiles/» чи «Colours/».
- Назва опції
- Значення

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

Приклад використання dbus-send у скрипті:

dbus-send --session /net/sf/roxterm/Options \ net.sf.roxterm.Options.StringOption \ string:Colours/GTK string:background 'string:#ffffff'

Третій варіант використання полягає в сповіщенні ROXTerm про модифікацію профілю, колірної схеми чи набору «гарячих клавіш» сторонньою програмою й необхідність перезавантаження відповідних налаштувань терміналами, що їх використовують.

OptionsChanged("family_name", "profile_name")

family_name — «Profiles», «Colours» чи «Shortcuts». Наприклад:

dbus-send --session /net/sf/roxterm/Options \ net.sf.roxterm.Options.OptionsChanged \ string:Profiles string:Default