Alterator/New/Packages: различия между версиями

Текущая версия от 14:24, 23 сентября 2013

Текущее состояние модулей альтератора

Пакет	Описание	Примечание
alterator-alternatives	alterator module for alternatives package	Допускает ситуации, когда один и тот же файл принадлежит одновременно нескольким пакетам
alterator-asterisk-gateway	Alterator module for E1<->SIP gateway setup
alterator-asterisk-limits	Alterator module for control Asterisk limits
alterator-auth	Alterator module for system wide auth settings
alterator-backend-printer-drivers	Alterator backend for printer drivers maintainance
alterator-backend-x11	Alterator backend for x11 setup and configuration
alterator-backup-server	Backup server management for plain distros. Contains desktop files to bridge alterator-ditro-backup-server to plain distros	В данный момент присутствует в репозиториях, но после обновления будет объединен с пакетом alterator-bacula
alterator-bacula	Module for Bacula backup system	Присутствовал запуск из X11, но в данный момент отключен
alterator-bacula-client	Alterator module for client bacula administration
alterator-bacula-functions	Helper functions for alterator Bacula backup system	В данный момент присутствует в репозиториях, но после обновления будет объединен с пакетом alterator-bacula
alterator-beancounters	OpenVZ beancounter observer module	Устарел, не поддерживается (nobody)
alterator-bind	Alterator module to create and manage dynamic dns
alterator-browser-qt	X11 Qt interface driver for alterator
alterator-ca	Certification Authority Manager for Office Server	Удостоверяющий центр
alterator-cd2	Installer’s step for an additional cdrom installation	Устарел, отсутствует desktop файл
alterator-control	Alterator module for control package
alterator-cyrus	Alterator module for system wide cyrus settings	Настройка Cyrus-IMAP. Ошибки в модуле, не запускается
alterator-datetime	Alterator module for date/time setup
alterator-dhcp	DHCP configuration alterator module
alterator-distro-backup-server	Special alterator modules for ALT Linux Backup Server
alterator-distro-chainmail	Special alterator modules for IVK Chainmail	Конфликт с пакетами alterator-distro-*
alterator-distro-office-server	Special alterator modules for ALT Linux Office Server
alterator-distro-skif	HPC specific tunings	Устарел, отсутствуют desktop файлы
alterator-doc	Documentation and samples for alterator	Документация альтератора с примерами
alterator-etcgit	Alterator module to control versions of configuration files in /etc using git	Использует etcgit
alterator-fbi	This is an alterator based engine (form based interface) to create a simple form based html interface
alterator-firsttime	First time system setup	Возможно конфигурирует сервер перед первым стартом
alterator-grub	Alterator module to setup grub bootloader
alterator-hotstandby	Alterator module for hot standby server	Горячее резервирование
alterator-hw-functions	Helper functions for alterator to retrieve hardware info	Пакет состоит из одного файла
alterator-kdc	Alterator module for Kerberos KDC	Пакет состоит из хуков и набора скриптов для создания сервера c Kerberos
alterator-l10n	Translations for all alterator modules	Справка и перевод для всех модулей альтератора
alterator-ldap-groups	Alterator module for LDAP groups administration
alterator-ldap-users	Alterator module for ldap users administration
alterator-lilo	Alterator module for lilo setup
alterator-livecd	special steps for LiveCD installers
alterator-logs	Alterator module for system logs
alterator-lookout	Dialog based interface for alterator
alterator-ltsconf	Alterator module for ALTSP terminal management	Вываливается с ошибкой
alterator-luks	Alterator module for change LUKS passphrase	Установка пароля на LUKS разделы
alterator-mastercontrol	Alterator module to control configuration profiles on the remote hosts
alterator-mirror	Local mirrors setup and maintainance
alterator-mkbootflash	Create bootable usb storage for installing system or using as live, rescue etc
alterator-mkimage	Create distribution images by means of mkimage-profiles
alterator-mkve	Alterator module for creating/destroing virtual environments	Устарел. Работает нестабильно
alterator-moodle-install	Alterator module for Moodle service configuration
alterator-mysql-functions	Helps the base MySQL server configuration management	Пакет состоит из одного файла
alterator-net-domain	Alterator module to edit system network domain
alterator-net-eth	Alterator module for tcp/ip connections configuration
alterator-net-functions	Helpers for etcnet administration
alterator-netinst	Alterator module for network installations management	Сервер сетевых установок
alterator-net-iptables	Alterator module for simple iptables configuration
alterator-net-openvpn	Alterator module for openvpn connections configuration
alterator-net-pppoe	Alterator module for pppoe connections configuration
alterator-net-pptp	Alterator module for pptp connections configuration
alterator-net-routing	Alterator module for network routing administration
alterator-net-shares	Enable/disable mounting samba shares from "domain" server
alterator-net-wifi	Alterator module for wi-fi connections administration	Возникает ошибка в веб-интерфейсе, если отсутвует устройство wifi
alterator-notes	Alterator module for view license and release notes
alterator-openldap	Alterator module for OpenLDAP server	Сервис slapd не работает с systemd, но модуль рабочий
alterator-openldap-functions	Helper functions for alterator openldap based backends	Пакет состоит из двух файлов
alterator-openvpn-server	Alterator module for openvpn server configuration
alterator-packages	Alterator module for packages installation/removal
alterator-perl-functions	Helper functions for alterator perl based backends	Устаревший пакет
alterator-php-functions	Helps the base PHP configuration management	Пакет состоит из одного файла
alterator-pkcs11	PKCS#11 user certificate management module	Нерабочая ссылка в браузере
alterator-pkg	Additional package installation	Fail test unsafe-tmp-usage-in-scripts
alterator-ports-access	Alterator module to control serial/USB ports access	Устарел. Конфликт с пакетом alterator-l10n-2.9-alt64
alterator-postfix-dovecot	Alterator module for Postfix/Dovecot setup	Почтовый сервер. Устарел. Рабочая версия пока не выложена
alterator-preinstall	Alterator preinstall hooks runner module
alterator-printers	Simple alterator module for printer administration
alterator-quota	Alterator module for managing filesystem quotas
alterator-root	Alterator module for edit system administrator properties	Позволяет сменить пароль root, добавлить/удалить ssh ключ
alterator-service-functions	Helpers for common service management	Пакет состоит из одного файла
alterator-services	Simple SysV services configurator
alterator-setup	Perform initial setup of an OEM installation
alterator-sh-functions	Helper functions for alterator shell based backends
alterator-snort	Alterator module for snort administration	Система обнаружения вторжений
alterator-squid	Alterator module for Squid proxy server configuration	Прокси-сервер
alterator-squidmill	Alterator module for browsing the Squid proxy server statistics	Статистика прокси-сервера. Зависимый от gambit
alterator-sshd	OpenSSHd system configuration module	Сильно устарел. Не устанавливается
alterator-sslkey	Module for manipulations with ssl keys
alterator-standalone	System Management center
alterator-sysconfig	Module for basic system settings (console and X11 keyboard, console font, system locale)	Отображает настройки proxy
alterator-sysinfo	Module to view general system information	Неверно упорядочивает таблицу
alterator-trust	Module for setting one-way trust relationships	Устарел
alterator-ulogd	Module for network traffic statistics
alterator-updates	Dialog based interface for alterator
alterator-users	Module for system users administration
alterator-vm	Module for volume management	Разметка дисков
alterator-vsftpd	Module for vsftpd configuration	FTP-сервер
alterator-witchery	Demo steps for alterator-wizard	Устаревший. Неизвестно
alterator-wizardface	Alterator's wizard like module aggregator
alterator-wizardface-usermode	Usermode bindings for alterator-wizardface
alterator-x11	Module for Xorg setup and configuration
alterator-xinetd	Module for xinetd	Устаревший
alterator-xkb	Module for XKB administration	Настройки клавиатуры
alterator-zabbix-agent	Module for the Zabbix agent configuration	Отсутствует ссылка в меню веб-интерфейса
alterator-zabbix-node	Deployment tool for a Zabbix node

Packages Internals

Package
alternatives					1		1				1	1							1	1				1
asterisk-gateway
asterisk-limits
auth				1	1		1	1			1	1			1					1
backend-printer-drivers
backend-x11
bacula					1	1	1				1													1
bacula-client				1	1		1	1			1
bacula-functions
beancounters
bind
browser-qt
ca	1
cd2							1				1
control					1		1		1		1								1					1
cyrus
datetime				1	1		1	1			1	1			1				1	1		1	1	1
dhcp					1
distro-office-server	1
distro-skif							1	1			1				1				1					1
doc
etcgit							1
fbi	1	1												1									1
firsttime
grub				1	1		1				1				1					1
hotstandby
hw-functions
kdc
l10n
ldap-groups
ldap-users
lilo					1	1	1	1	1	1	1	1			1				1	1				1
livecd		1					1		1								1										1
logs				1	1		1	1	1						1
lookout	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1
ltsconf				1	1		1	1			1	1			1					1				1
luks					1		1	1			1	1								1
mastercontrol					1		1
mirror
mkbootflash					1		1	1		1	1	1			1					1
mkimage	1			1	1		1	1			1	1			1		1		1	1				1
mkve
moodle-install
mysql-functions
net-domain				1	1		1	1			1									1
net-eth				1	1		1	1	1		1	1			1				1	1				1
net-functions
netinst
net-iptables				1	1	1	1	1			1	1			1				1	1				1		1
net-openvpn				1	1	1	1	1			1	1			1				1	1				1				1			1
net-pppoe				1	1		1	1			1	1			1				1	1				1				1
net-pptp				1	1		1	1			1	1			1				1	1				1				1
net-routing					1		1	1	1		1				1				1	1	1			1
net-shares					1					1	1	1								1
net-wifi					1		1	1		1	1	1			1					1				1
notes							1		1			1
openldap
openldap-functions
openvpn-server
packages			1	1	1		1	1	1	1	1	1		1	1		1							1
perl-functions
php-functions
pkcs11					1		1				1									1				1
pkg		1		1	1		1	1			1		1	1	1		1			1				1		1	1
ports-access					1
postfix-dovecot
preinstall			1				1										1			1
printers			1	1	1		1	1		1					1									1
quota					1		1	1			1				1					1				1
root	1				1		1	1			1	1								1
service-functions
services					1		1		1	1	1	1			1									1
setup									1
sh-functions
snort
squid							1
squidmill
sslkey				1	1		1	1			1	1							1	1				1							1
standalone					1		1				1									1										1
sysconfig				1	1		1	1			1													1
sysinfo							1			1	1								1	1
trust
ulogd
updates				1	1	1	1	1			1				1					1	1		1			1
users				1	1		1	1			1	1			1				1	1				1				1
vm		1	1		1	1	1	1		1	1	1		1	1			1	1		1				1
vsftpd					1							1
witchery				1	1		1					1
wizardface					1		1																						1
wizardface-usermode
x11				1	1		1				1	1			1				1	1	1			1
xinetd					1		1	1	1	1	1	1								1				1				1
xkb				1	1		1				1				1					1				1
zabbix-agent
zabbix-node
zabbix-node-common
zabbix-node-mysql
caterva-kit-sh

Таблица виджетов

Widget

X11

Qt

ncurses

Описание

box
Attributes	Events
orientation

in_test

box

button
Attributes	Events
pixmap
text

in_test

button

centerface

in_test

centerface

checkbox
Attributes	Events
state
text
value

in_test

checkbox

checklistbox
Attributes		Events
append-row		changed
columns		clicked
count		double-clicked
current		selected
enumref		return-pressed
header
remove
row-item
rows
text
value

in_test

checklistbox

checktree

in_test

checktree

colorselect

in_test

colorselect

combobox
Attributes	Events
alterability
append-row
count
current
enumref
remove
row-item
rows
text

in_test

combobox

dateedit
Attributes	Events
expanded

in_test

dateedit

edit
Attributes	Events
alterability
echo
value

in_test

edit

fileselect
Attributes	Events
filter
hints
title
url

in_test

fileselect

gridbox
Attributes	Events
columns

in_test

gridbox

groupbox
Attributes	Events
checked
orientation
state
title

in_test

groupbox

hbox

in_test

hbox

label
Attributes	Events
text
text-wrap
value

in_test

label

linkbutton

in_test

linkbutton

listbox
Attributes		Events
append-row		changed
columns		clicked
count		double-clicked
current		selected
enumref		return-pressed
header
remove
row-item
rows
text

in_test

multilistbox

in_test

multilistbox

progressbar
Attributes	Events
maximum
minimum
text
value

in_test

progressbar

radio
Attributes	Events
state
text
value

in_test

radio

radiolistbox
Attributes	Events
current
rows

in_test

radiolistbox

root

in_test

root

separator

in_test

separator

slider

in_test

slider

slideshow

in_test

slideshow

spacer

in_test

spacer

spinbox
Attributes	Events
maximum
minimum
step
value

in_test

spinbox

splitbox
Attributes	Events
columns

in_test

splitbox

tabbox

in_test

tabbox

textbox
Attributes	Events
alterability
append-text
text
url

in_test

textbox

timeedit
Attributes	Events
expanded
start
stop
value

in_test

timeedit

tree
Attributes	Events
columns
current
expanded
header
tree-items
tree-text

in_test

tree

undefined

in_test

undefined

vbox

in_test

vbox

wizardface

in_test

wizardface

Таблица общих атрибутов для всех виджетов

Attribute	Значения	Описание
align	"left" "right" "middle" "hmiddle" "center" "top" "bottom"	выравнивание внутри ячейки «сетки»
activity	#t #f	активирует/отключает виджет
visibility	#t #f	видимость/невидимость виджета
colspan	<число>	количество столбцов "сетки" под данный виджет
rowspan	<число>	количество строк "сетки" под данный виджет
tooltip	<текст>	справочная информация, выводимая во всплывающей подсказке
focus	#t #f	атрибут только для записи, помещает фокус на виджет для которого указано значение #t
width	<число>	ширина виджета
height	<число>	высота виджета
title	<текст>	заголовок родительского контейнера
name	<текст>	имя виджета
nameref	<текст>	аналог name (?)
margin	<число>	ширина "рамки" вокруг контейнера
spacing	<число>	промежуток между виджетами (применим только к контейнерам)

Описание виджетов и их атрибутов

Корневой виджет

Именно в этот виджет вставляются все остальные. Имеет следующие атрибуты:

title — заголовок окна
width — ширина окна
height — высота окна

Box

Контейнер для других виджетов.

orientation «horizontal» — это развернутый вариант виджета hbox;
orientation «vertical» — развернутый вариант виджета vbox (по умолчанию).

Button

Кнопка с текстом и картинкой.

Атрибуты:

text — текст на кнопке;
pixmap — картинка из списка.

События:

clicked — вызывается при нажатии кнопки.

CheckBox

Кнопка-флажок с двумя состояниями true или false.

text — описание кнопки;
state — состояние флажка. Если значение #t, то флажок выставлен. При значении #f флажок отсутствует;
value — то же, что и state.

DateEdit

Виджет отображения даты, календаря.

expanded — со значением #t дополнительно отображает календарь;
value — атрибут для задания даты (строка формата ГГГГ-ММ-ДД).

TimeEdit

Отображает время.

expanded — со значением #t добавляет графические часы;
stop — остановка счета времени;
start — запуск счета времени;
value — задание времени.

Radio

Радиокнопка позволяет выбрать один пункт из набора, в пределах одного контейнера.

state — состояние пункта. Данный пункт выбран при значении #t;
text — описание пункта;

Edit

Однострочное текстовое поле ввода.

echo — режим отображения. Возможные варианты: normal (по умолчанию), stars (звёздочки, для паролей), no (ввод не отображается);
alterability — разрешение на изменение текста. Если значение #f, содержимое поля доступно только для чтения;
text — содержимое поля;
value — то же, что и text.

GridBox

Вертикальный контейнер «сетки». Основой способ организации виджетов на экране.

columns — ширина стобцов сетки в процентном соотношении от общей ширины.

Label

Предназначен для отображения какой-либо надписи без возможности редактирования.

text-wrap — отображение одной длинной строки в виде многострочного текста (#t/#f);
text — отображаемый текст.

GroupBox

Объединение группы виджетов в один контейнер.

checked — в случае значения #t рядом с заголовком отображается checkbox (если он не выделен, то содержимое группы неактивно и недоступно для работы);
orientation — ориентация контейнера (horizontal/vertical);
state — состояние checkbox в случае режима checked;
title — заголовок группы.

ProgressBar

Строка прогресса некоторого процесса.

maximum — максимальное допустимое значение, соответствует 100 %;
minimum — минимальное допустимое значение, соответствует 0 %;
text — информация в строке прогресса;
value — текущее значение прогресса.

SpinBox

Поле со счетчиком для ввода чисел.

maximum — максимальное допустимое значение;
minimum — минимальное допустимое значение;
step — шаг приращения значения;
value — текущее значение.

TextBox

Многострочное текстовое поле ввода.

alterability — разрешение на изменение текста. Если значение #f, содержимое поля доступно только для чтения;
text — содержимое поля;
append-text — добавить текст в конец поля;
url — показать содержимое указанного файла.

FileSelect

Выбор файла из файловой системы, для дальнейшей работы с ним.

filter — допустимые расширения файлов;
hints — условие выбора файла (обычно используется значение existing_file для проверки на существование выбранного файла);
title — заголовок;
url — путь поиска файлов.

Пример:

(document:surround "/std/frame")

(define fileselect (make-widget 'fileselect))
(define url (make-attribute 'url))
(define filter (make-attribute 'filter))
(define hints (make-attribute 'hints))

(gridbox columns "100"
    margin "100"
    (vbox 
    (label text "Simple import certificate")
    (fileselect title (_"Import CA certificate")
                url "/"
                filter "*.cert *.crt *.pem"
                hints "existing_file")))

SplitBox

Контейнер с изменяемой шириной колонок.

columns — изначальная ширина колонок.

ListBox

Прокручиваемый список, с возможностью создания нескольких столбцов.

Атрибуты

columns — количество колонок в списке;
header — заголовок таблицы, вектор из строк с названиями колонок;
enumref — адрес списка данных;
rows — возвращает список значений в виде единой строки;
rows-clear — очищает список;
append-row — добавление в конец списка новой строки;
row-item — работа с отдельным полем в списке. Координаты задаются списком из двух значений '(строка столбец) или указанием порядкового номера строки;
row-remove — удаляет строку с указанным порядковым номером;
text — возвращает строку с содержимым первого поля активной строки;
current — номер выделенной строки. Если ничего не выделено, то значение равно −1;
count — возвращает количество строк в таблице.

События Желательно использовать только одно событие.

clicked — одинарный щелчок правой кнопки мышки по элементу списка;
double-clicked — двойной щелчок правой кнопки мышки по элементу списка;
selected — изменение активной строки;
return-pressed — нажатиe Enter на активной строке списка;
changed — любое действие с виджетом (не рекомендуется использовать).

ComboBox

Выпадающий список. Поддерживает все события и атрибуты виджета listbox в одноколоночном режиме, а также:

Атрибуты

alterability - значение #t переключает строку в редактируемый режим.

RadioListBox

Список с возможностью выбора одного значения, где каждый элемент является радио-кнопкой. Атрибуты и события заимствованы из виджета listbox. Некоторые проблемы возникают с атрибутом enumref при формировании списка из backend.

CheckListBox

Прокручиваемый список с возможностью множественного выбора. Является объединением двух виджетов: listbox и checkbox. Таким образом, поддерживает атрибуты и события обоих виджетов.

Tree

Древообразный список элементов.

@@ Строка 211: / Строка 211: @@
 {| class="wide sortable collapsible collapsed" style="text-align:center"
 |-
-!Package||root||box||vbox||hbox||button||linkbutton||radio||label||edit||textbox||groupbox||gridbox||checkbox||checktree||tree||combobox||tabbox||progressbar||slider||separator||spacer||spinbox||dateedit||timeedit||listbox||radiolistbox||multilistbox||checklistbox||slideshow||splitbox||wizardface||centerface||colorselect||fileselect||undefined
+!Package||[[Файл:Root.svg]]||[[Файл:Box.svg]]||[[Файл:Vbox.svg]]||[[Файл:Hbox.svg]]||[[Файл:Button.svg]]||[[Файл:Linkbutton.svg]]||[[Файл:Radio.svg]]||[[Файл:Label.svg]]||[[Файл:Edit_alterator.svg]]||[[Файл:Textbox.svg]]||[[Файл:Groupbox.svg]]||[[Файл:Gridbox.svg]]||[[Файл:Checkbox.svg]]||[[Файл:Checktree.svg]]||[[Файл:Tree.svg]]||[[Файл:Combobox.svg]]||[[Файл:Tabbox.svg]]||[[Файл:Progressbar.svg]]||[[Файл:Slider.svg]]||[[Файл:Separator.svg]]||[[Файл:Spacer.svg]]||[[Файл:Spinbox.svg]]||[[Файл:Dateedit.svg]]||[[Файл:Timeedit.svg]]||[[Файл:Listbox.svg]]|| [[Файл:RadioListBox.svg]]||[[Файл:Multilistbox.svg]]||[[Файл:Checklistbox.svg]]||[[Файл:Slideshow.svg]]||[[Файл:Splitbox.svg]]||[[Файл:Wizardface.svg]]||[[Файл:Centerface.svg]]||[[Файл:Colorselect.svg]]||[[Файл:Fileselect.svg]]||[[Файл:Undefined.svg]]
 |-
 |alternatives || || || || ||<span style="display:none">1</span>{{Есть}}|| || ||<span style="display:none">1</span>{{Есть}}|| || || ||<span style="display:none">1</span>{{Есть}}||<span style="display:none">1</span>{{Есть}}|| || || || || || ||<span style="display:none">1</span>{{Есть}}||<span style="display:none">1</span>{{Есть}}|| || || ||<span style="display:none">1</span>{{Есть}}|| || || || || || || || || ||
@@ Строка 411: / Строка 411: @@
 |}
+== Таблица виджетов ==
-==Таблица виджетов==
 {| class="wikitable" style="text-align: center"
@@ Строка 419: / Строка 418: @@
   |
   {| class="wide collapsible collapsed"
-   !box
+   ![[#Box|box]]
    |-
    !Attributes||Events
@@ Строка 425: / Строка 424: @@
    |orientation||
   |}
-  |{{Есть}}||{{Нет}}||in_test||box
+  |{{Есть}}||{{Есть}}||in_test||box
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !button
+   ![[#Button|button]]
    |-
    !Attributes||Events
@@ Строка 437: / Строка 436: @@
    |text||
   |}
-  |{{Есть}}||{{Нет}}||in_test||button
+  |{{Есть}}||{{Есть}}||in_test||button
   |-
   |centerface ||{{Есть}}||{{Нет}}||in_test||centerface
@@ Строка 443: / Строка 442: @@
   |
   {| class="wide collapsible collapsed"
-   !checkbox
+   ![[#CheckBox|checkbox]]
    |-
    !Attributes||Events
@@ Строка 453: / Строка 452: @@
    |value||
   |}
-  |{{Есть}}||{{Нет}}||in_test||checkbox
+  |{{Есть}}||{{Есть}}||in_test||checkbox
-  |-
+  |- valign="top"
-  |checklistbox ||{{Есть}}||{{Нет}}||in_test||checklistbox
+ |
+  {| class="wide collapsible collapsed"
+  ![[#CheckListBox|checklistbox]]
+  |-
+  !Attributes||||Events
+  |-
+  |append-row||||changed
+  |-
+  |columns||||clicked
+  |-
+  |count||||double-clicked
+  |-
+  |current||||selected
+  |-
+  |enumref||||return-pressed
+  |-
+  |header||
+  |-
+  |remove||
+  |-
+  |row-item||
+  |-
+  |rows||
+  |-
+  |text||
+  |-
+  |value||
+ |}
+ |{{Есть}}||{{Есть}}||in_test||checklistbox
   |-
   |checktree ||{{Есть}}||{{Нет}}||in_test||checktree
@@ Строка 463: / Строка 490: @@
   |
   {| class="wide collapsible collapsed"
-   !combobox
+   ![[#ComboBox|combobox]]
    |-
    !Attributes||Events
@@ Строка 485: / Строка 512: @@
    |text||
   |}
-  |{{Есть}}||{{Нет}}||in_test||combobox
+  |{{Есть}}||{{Есть}}||in_test||combobox
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !dateedit
+   ![[#DateEdit|dateedit]]
    |-
    !Attributes||Events
@@ Строка 495: / Строка 522: @@
    |expanded||
   |}
-  |{{Есть}}||{{Нет}}||in_test||dateedit
+  |{{Есть}}||{{Есть}}||in_test||dateedit
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !edit
+   ![[#Edit|edit]]
    |-
    !Attributes||Events
@@ Строка 509: / Строка 536: @@
    |value||
   |}
-  |{{Есть}}||{{Нет}}||in_test||edit
+  |{{Есть}}||{{Есть}}||in_test||edit
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !fileselect
+   ![[#FileSelect|fileselect]]
    |-
    !Attributes||Events
@@ Строка 525: / Строка 552: @@
    |url||
   |}
-  |{{Есть}}||{{Нет}}||in_test||fileselect
+  |{{Есть}}||{{Есть}}||in_test||fileselect
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !gridbox
+   ![[#GridBox|gridbox]]
    |-
    !Attributes||Events
@@ Строка 535: / Строка 562: @@
    |columns||
   |}
-  |{{Есть}}||{{Нет}}||in_test||gridbox
+  |{{Есть}}||{{Есть}}||in_test||gridbox
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !groupbox
+   ![[#GroupBox|groupbox]]
    |-
    !Attributes||Events
@@ Строка 551: / Строка 578: @@
    |title||
   |}
-  |{{Есть}}||{{Нет}}||in_test||groupbox
+  |{{Есть}}||{{Есть}}||in_test||groupbox
   |-
-  |hbox ||{{Есть}}||{{Нет}}||in_test||hbox
+  |[[#Box|hbox]] ||{{Есть}}||{{Нет}}||in_test||hbox
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !label
+   ![[#Label|label]]
    |-
    !Attributes||Events
@@ Строка 567: / Строка 594: @@
    |value||
   |}
-  |{{Есть}}||{{Нет}}||in_test||label
+  |{{Есть}}||{{Есть}}||in_test||label
   |-
   |linkbutton ||{{Есть}}||{{Нет}}||in_test||linkbutton
@@ Строка 573: / Строка 600: @@
   |
   {| class="wide collapsible collapsed"
-   !listbox
+   ![[#ListBox|listbox]]
    |-
-   !Attributes||Events
+   !Attributes||||Events
    |-
-   |append-row||
+   |append-row||||changed
    |-
-   |columns||
+   |columns||||clicked
    |-
-   |count||
+   |count||||double-clicked
    |-
-   |current||
+   |current||||selected
    |-
-   |enumref||
+   |enumref||||return-pressed
    |-
    |header||
@@ Строка 597: / Строка 624: @@
    |text||
   |}
-  |{{Есть}}||{{Нет}}||in_test||listbox
+  |{{Есть}}||{{Есть}}||in_test||
   |-
   |multilistbox ||{{Есть}}||{{Нет}}||in_test||multilistbox
@@ Строка 603: / Строка 630: @@
   |
   {| class="wide collapsible collapsed"
-   !progressbar
+   ![[#ProgressBar|progressbar]]
    |-
    !Attributes||Events
@@ Строка 615: / Строка 642: @@
    |value||
   |}
-  |{{Есть}}||{{Нет}}||in_test||progressbar
+  |{{Есть}}||{{Есть}}||in_test||progressbar
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !radio
+   ![[#Radio|radio]]
    |-
    !Attributes||Events
@@ Строка 629: / Строка 656: @@
    |value||
   |}
-  |{{Есть}}||{{Нет}}||in_test||radio
+  |{{Есть}}||{{Есть}}||in_test||radio
   |- valign="top"
   |
   {| class="wide collapsible collapsed"
-   !radiolistbox
+   ![[#RadioListBox|radiolistbox]]
    |-
    !Attributes||Events
@@ Строка 683: / Строка 710: @@
   |
   {| class="wide collapsible collapsed"
-   !textbox
+   ![[#TextBox|textbox]]
    |-
    !Attributes||Events
@@ Строка 699: / Строка 726: @@
   |
   {| class="wide collapsible collapsed"
-   !timeedit
+   ![[#TimeEdit|timeedit]]
    |-
    !Attributes||Events
@@ Строка 711: / Строка 738: @@
    |value||
   |}
-  |{{Есть}}||{{Нет}}||in_test||timeedit
+  |{{Есть}}||{{Есть}}||in_test||timeedit
   |- valign="top"
   |
@@ Строка 735: / Строка 762: @@
   |undefined ||{{Есть}}||{{Нет}}||in_test||undefined
   |-
-  |vbox ||{{Есть}}||{{Нет}}||in_test||vbox
+  |[[#Box|vbox]] ||{{Есть}}||{{Есть}}||in_test||vbox
   |-
   |wizardface ||{{Есть}}||{{Нет}}||in_test||wizardface
@@ Строка 742: / Строка 769: @@
-===Таблица общих атрибутов для всех виджетов===
+=== Таблица общих атрибутов для всех виджетов ===
 {| class="wikitable" style="text-align: left"
@@ Строка 777: / Строка 804: @@
-==== корневой виджет ====
-Именно в этот виджет вставляются все остальные. Имеются следующие атрибуты:
+=== Описание виджетов и их атрибутов ===
-* <tt>title</tt> -- заголовок окна
-* <tt>width</tt> -- ширина окна
-* <tt>height</tt> -- высота окна
+==== Корневой виджет ====
+Именно в этот виджет вставляются все остальные. Имеет следующие атрибуты:
+* '''title''' — заголовок окна
+* '''width''' — ширина окна
+* '''height''' — высота окна
 ==== Box ====
 Контейнер для других виджетов.
-* <tt>orientation</tt> -- со значением <tt>horizontal</tt> - это развернутый вариант виджета <tt>hbox</tt>. Аналогично, со значением <tt>vertical</tt> - развернутый вариант виджета <tt>vbox</tt>.
+* '''orientation''' «''horizontal''» — это развернутый вариант виджета '''hbox''';
+* '''orientation''' «''vertical''» — развернутый вариант виджета '''vbox''' (по умолчанию).
+==== Button ====
+Кнопка с текстом и картинкой.
+<u>Атрибуты:</u>
+* '''text''' — текст на кнопке;
+* '''pixmap''' — картинка из списка.
+<u>События:</u>
+* '''clicked''' — вызывается при нажатии кнопки.
+==== CheckBox ====
+Кнопка-флажок с двумя состояниями ''true'' или ''false''.
+* '''text''' — описание кнопки;
+* '''state''' — состояние флажка. Если значение ''#t'', то флажок выставлен. При значении ''#f'' флажок отсутствует;
+* '''value''' — то же, что и '''state'''.
+==== DateEdit ====
+Виджет отображения даты, календаря.
+* '''expanded''' — со значением ''#t'' дополнительно отображает календарь;
+* '''value''' — атрибут для задания даты (строка формата ГГГГ-ММ-ДД).
+==== TimeEdit ====
+Отображает время.
+* '''expanded''' — со значением ''#t'' добавляет графические часы;
+* '''stop''' — остановка счета времени;
+* '''start''' — запуск счета времени;
+* '''value''' — задание времени.
+==== Radio ====
+Радиокнопка позволяет выбрать один пункт из набора, в пределах одного контейнера.
+* '''state''' — состояние пункта. Данный пункт выбран при значении ''#t'';
+* '''text''' — описание пункта;
+==== Edit ====
+Однострочное текстовое поле ввода.
+* '''echo''' — режим отображения. Возможные варианты: ''normal'' (по умолчанию), ''stars'' (звёздочки, для паролей), ''no'' (ввод не отображается);
+* '''alterability''' — разрешение на изменение текста. Если значение ''#f'', содержимое поля доступно только для чтения;
+* '''text''' — содержимое поля;
+* '''value''' — то же, что и '''text'''.
+==== GridBox ====
+Вертикальный контейнер «сетки». Основой способ организации виджетов на экране.
+* '''columns''' — ширина стобцов сетки в процентном соотношении от общей ширины.
+==== Label ====
+Предназначен для отображения какой-либо надписи без возможности редактирования.
+* '''text-wrap''' — отображение одной длинной строки в виде многострочного текста (''#t''/''#f'');
+* '''text''' — отображаемый текст.
+==== GroupBox ====
+Объединение группы виджетов в один контейнер.
+* '''checked''' — в случае значения #t рядом с заголовком отображается checkbox (если он не выделен, то содержимое группы неактивно и недоступно для работы);
+* '''orientation''' — ориентация контейнера (''horizontal''/''vertical'');
+* '''state''' — состояние checkbox в случае режима checked;
+* '''title''' — заголовок группы.
+==== ProgressBar ====
+Строка прогресса некоторого процесса.
+* '''maximum''' — максимальное допустимое значение, соответствует 100 %;
+* '''minimum''' — минимальное допустимое значение, соответствует 0 %;
+* '''text''' — информация в строке прогресса;
+* '''value''' — текущее значение прогресса.
+==== SpinBox ====
+Поле со счетчиком для ввода чисел.
+* '''maximum''' — максимальное допустимое значение;
+* '''minimum''' — минимальное допустимое значение;
+* '''step''' — шаг приращения значения;
+* '''value''' — текущее значение.
+==== TextBox ====
+Многострочное текстовое поле ввода.
+* '''alterability''' — разрешение на изменение текста. Если значение ''#f'', содержимое поля доступно только для чтения;
+* '''text''' — содержимое поля;
+* '''append-text''' — добавить текст в конец поля;
+* '''url''' — показать содержимое указанного файла.
+==== FileSelect ====
+Выбор файла из файловой системы, для дальнейшей работы с ним.
+* '''filter''' — допустимые расширения файлов;
+* '''hints''' — условие выбора файла (обычно используется значение ''existing_file'' для проверки на существование выбранного файла);
+* '''title''' — заголовок;
+* '''url''' — путь поиска файлов.
+<u>Пример:</u>
+<pre style="width:30em">
+(document:surround "/std/frame")
+(define fileselect (make-widget 'fileselect))
+(define url (make-attribute 'url))
+(define filter (make-attribute 'filter))
+(define hints (make-attribute 'hints))
+(gridbox columns "100"
+    margin "100"
+    (vbox
+    (label text "Simple import certificate")
+    (fileselect title (_"Import CA certificate")
+                url "/"
+                filter "*.cert *.crt *.pem"
+                hints "existing_file")))
+</pre>
+==== SplitBox ====
+Контейнер с изменяемой шириной колонок.
+* '''columns''' — изначальная ширина колонок.
+==== ListBox ====
+Прокручиваемый список, с возможностью создания нескольких столбцов.
+<u>Атрибуты</u>
+* '''columns''' — количество колонок в списке;
+* '''header''' — заголовок таблицы, вектор из строк с названиями колонок;
+* '''enumref''' — адрес списка данных;
+* '''rows''' — возвращает список значений в виде единой строки;
+* '''rows-clear''' — очищает список;
+* '''append-row''' — добавление в конец списка новой строки;
+* '''row-item''' — работа с отдельным полем в списке. Координаты задаются списком из двух значений '(строка столбец) или указанием порядкового номера строки;
+* '''row-remove''' — удаляет строку с указанным порядковым номером;
+* '''text''' — возвращает строку с содержимым первого поля активной строки;
+* '''current''' — номер выделенной строки. Если ничего не выделено, то значение равно −1;
+* '''count''' — возвращает количество строк в таблице.
+<u>События</u>
+Желательно использовать только одно событие.
+* '''clicked''' — одинарный щелчок правой кнопки мышки по элементу списка;
+* '''double-clicked''' — двойной щелчок правой кнопки мышки по элементу списка;
+* '''selected''' — изменение активной строки;
+* '''return-pressed''' — нажатиe ''Enter'' на активной строке списка;
+* '''changed''' — любое действие с виджетом (не рекомендуется использовать).
+{| style="align:left;"
+|
+{{Навигационная таблица
+|state                     = collapsed
+|заголовок                 = Пример 1
+|стиль_четных              = background:#f0f0f0
+|заголовок1   = Описание
+|список1      =
+В данном примере событие ''return-pressed'' срабатывает при ''double-clicked''. Исправляется использованием ''clicked'' вместо ''double-clicked''.
+|заголовок2   = index.scm
+|список2      =
+<pre style="width:70em">
+(document:surround "/std/frame")
+(define (ui-list)
+  (let ((list_one_fn (woo-call "/simple_list/list_one")))
+    (form-update-enum "name_one" list_one_fn)
+    (or (null? list_one_fn)
+        (let ((name (woo-get-option (car list_one_fn) 'name)))
+          (form-update-value "name_one" name) ))))
+(document:root
+    (when loaded (ui-list)))
+(gridbox columns 100
+         margin 100
+         align "center"
+         (label align "center" text "Simple label")
+         (document:id list_one (listbox columns 3
+                                     focus #t
+                                     name "name_one"
+                                     enumref "/simple_list/list_one"
+                                     row '#((column0 . "") (column2 . "") (column3 . ""))
+                                     header (vector "column 0" "column 2" "column 3")
+                                     (when selected
+                                           (testlist  value (list_one current))
+                                           (testlist2 value (list_one text))
+                                           (testlist3 value (list_one rows))
+                                           (testlist4 value (list_one row-item (list (list_one current) 2) )))
+                                     (when double-clicked
+                                           (list_one row-remove (list_one current)))
+                                     (when return-pressed
+                                           (list_one append-row '#("new-row" "test" "123"))) ))
+         (gridbox columns "0;100"
+               align "left"
+               width 200
+               (label colspan 2)
+               (label align "left" text "current")
+               (document:id testlist (edit name "testlist" value (list_one current)))
+               (label value "text")
+               (document:id testlist2 (edit name "testlist2"))
+               (label text "count")
+               (document:id testlist3 (edit name "testlist3"))
+               (label value "row-item")
+               (document:id testlist4 (edit name "testlist4")) ) )
+</pre>
+|заголовок3   = backend/simple_list
+|список3      =
+<pre style="width:70em">
+#!/bin/sh
+alterator_api_version=1
+. alterator-sh-functions
+list_one()
+{
+        for i in 0 1 2 3 4
+        do
+           write_table_item column0 "row-$i" \
+                            column1 "$i" \
+                            column2 "$(($i+$i))" \
+                            column3 "$(($i+12))"
+        done
+}
+alterator_export_proc list_one
+message_loop
+</pre>
+|заголовок4   = simple_list.desktop
+|список4      =
+<pre style="width:70em">
+[Desktop Entry]
+X-Alterator-URI=/simple_list
+</pre>
+}}
+|
+|}
+<br/>
+==== ComboBox ====
+Выпадающий список. Поддерживает все события и атрибуты виджета [[#ListBox|''listbox'']] в '''одноколоночном''' режиме, а также:
+<u>Атрибуты</u>
+* '''alterability''' - значение #t переключает строку в редактируемый режим.
+<br/>
+==== RadioListBox ====
+Список с возможностью выбора одного значения, где каждый элемент является радио-кнопкой.
+Атрибуты и события заимствованы из виджета [[#ListBox|''listbox'']]. Некоторые проблемы возникают с атрибутом ''enumref'' при формировании списка из ''backend''.
+==== CheckListBox ====
+Прокручиваемый список с возможностью множественного выбора. Является объединением двух виджетов: [[#ListBox|''listbox'']] и [[#CheckBox|''checkbox'']]. Таким образом, поддерживает атрибуты и события обоих виджетов.
+==== Tree ====
+Древообразный список элементов.