Вступ до написання додатків до RKWard

Thomas Friedrichsmeier

Meik Michalke

Переклад українською: Юрій Чорноіван
версія 0.7.4 (24 квітня 2022 року)

Цей підручник присвячено питанням написання додатків до RKWard.


Зміст

1. Вступ
2. Попередні зауваження. Для чого призначено додатки у RKWard? Як працюють додатки?
3. Створення пунктів меню
Керування порядком пунктів меню
4. Визначення графічного інтерфейсу
Визначення діалогового вікна
Додавання інтерфейсу майстра
Деякі розмірковування щодо компонування інтерфейсу
<radio>, <checkbox> і <dropdown>
5. Створення коду R на основі параметрів графічного інтерфейсу
Використання JavaScript у додатках RKWard
preprocess()
calculate()
printout()
Угоди, правила і основа
Опис середовища local()
Форматування коду
Робота зі складними параметрами
Підказки і рецепти
6. Створення сторінки довідки
7. Логічна взаємодія між елементами графічного інтерфейсу
Логіка графічного інтерфейсу
Керування логікою графічного інтерфейсу за допомогою скриптів
8. Вбудовування додатків до додатків
Випадки застосування вбудовування
Вбудовування до діалогового вікна
Створення коду при вбудовуванні
Вбудовування до майстра
Не таке вбудоване вбудовування: кнопка «Інші параметри»
Вбудовування або визначення незавершених додатків
9. Робота з багатьма подібними додатками
Огляд різних підходів
Використання інструкції include JS
Включення файлів .xml
Використання <snippets>
<include>, <snippets> і <embed>
10. Концепції, якими можна скористатися у спеціалізованих додатках
Додатки для створення графіків
Малювання у вікні виведення результатів
Додавання функціональної можливості попереднього перегляду
Загальні параметри креслення
Канонічний приклад
Панелі перегляду для даних, виведеного та інших результатів
Попередній перегляд результатів (HTML)
Попередній перегляд (імпортованих) даних
Нетипові панелі попереднього перегляду
Додатки, які залежать від контексту
Контекст пристрою X11
Контекст імпортування даних
Надсилання запитів щодо даних до R
Посилання на поточний об’єкт або поточний файл
Повторення (набору) параметрів
«Керовані» optionset-и
Альтернативи: коли не слід використовувати optionset
11. Проблеми залежностей і сумісності
Сумісність із версіями RKWard
Сумісність із версіями R
Залежність від пакунків R
Залежності від інших .pluginmap RKWard
Приклад
12. Переклади додатків
Загальні міркування
i18n у файлах XML RKWard
i18n у файлах і розділах JS RKWard
Інтернаціоналізація і лапки
Супровід перекладів
Створення перекладів додатків
13. Відомості про автора, умови ліцензування та версію
14. Оприлюднення результатів вашої роботи
Зовнішні додатки
Навіщо створювати зовнішні додатки?
Структура пакунка з додатком
Ієрархія файлів
Збирання пакунка з додатком
15. Розробка додатка за допомогою пакунка rkwarddev
Огляд
Практичний приклад
Опис графічного інтерфейсу
Код JavaScript
Карта додатка
Довідкова сторінка
Створення файлів додатка
Скрипт повністю
Додавання сторінок довідки
Переклад додатків
A. Довідник
Типи властивостей/Модифікатори
Елементи загального призначення, які можна використовувати у будь-якому файлі XML (.xml, .rkh, .pluginmap)
Елементи, які буде використано у описі XML додатка.
Загальні елементи
Визначення інтерфейсу
Елементи компонування
Активні елементи
Розділ логіки
Властивості елементів додатка
Вбудовувані додатки, які є частиною офіційного пакунка RKWard
Елементи, які можна використовувати у файлах .pluginmap
Елементи, які можна використовувати у файлах довідки .rkh
Функції для керування логікою графічного інтерфейсу за допомогою скриптів
B. Діагностика проблем при розробці додатків
C. Умови ліцензування