Просмотр кода страницы Alteratorctl/editions module

[[Category:Sisyphus]]
[[Category:Alterator_на_D-Bus]]

{| style="border:1px solid #AAA; background:#F9F9F9; width:200px; margin: 0 0 1em 1em; padding:.2em; text-align:center; float: right;" class=noprint
|-
|[[Image:stub.png]]
|-
| '''Данная страница находится в [[:Категория:Неоконченные страницы|разработке]]'''.<br /><small style="line-height:1.1em;">Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.</small>
|}
<noinclude>[[Категория:Неоконченные страницы|{{PAGENAME}}]]</noinclude>

'''Alteratorctl editions''' — модуль консольного приложения [[Alteratorctl|alteratorctl]], предоставляющий возможность выбора редакции и получения информации о составе доступных к выбору редакций.

=== Основная информация ===

Модуль использует интерфейс <tt>org.altlinux.alterator.edition1</tt> объектов из пакетов с редакциями.

Для работы некоторых команд модуля могут потребоваться права администратора.

=== Информация по редакциям ===
Редакция — набор компонентов в составе дистрибутива. Каждая редакция содержит индивидуальный набор предустановленных и доступных для установки компонентов.

Список доступных редакций на данный момент:
# Альт Сервер (edition_server)
# Альт Домен (edition_domain)

=== Структура редакции ===
Структура редакции представляется в формате TOML и имеет следующий вид:
<pre>
type = "Edition"
name = "имя редакции"
display_name.en = "Отображаемое имя редакции на английском"
display_name.ru = "Отображаемое имя редакции на русском"

license = "Имя лицензии/Релиз"
arches = [ "Архитектура 1", "Архитектура 2" ]

desktop_environment = "Графическое окружение"
kflavours = { default = "Версия ядра по умолчанию", options = [ "Версия ядра 1", "Версия ядра 2" ] }
languages = { default = "Язык по умолчанию", options = [ "Язык 1", "Язык 2" ] }

[sections.base]
display_name.en = "Имя базовой секции компонентов, входящих в образ на английском"
display_name.ru = "Имя базовой секции компонентов, входящих в образ на русском"
components = [
    "Компонент 1",
    "Компонент 2",
    "…",
    "Компонент N"
]

[sections.main]
display_name.en = "Имя секции компонентов, доступных к установке на английском"
display_name.ru = "Имя секции компонентов, доступных к установке на русском"
components = [
    "Компонент 1",
    "Компонент 2",
    "…",
    "Компонент N"
]
</pre>

=== Использование модуля ===
Модуль предусматривает использование следующих команд и опций:
<pre>
Команды:
description [название редакции]         получить описание выбранной редакции.
get                                     получить название текущей редакции.
info [название редакции]                вывести информацию о выбранной редакции.
license [название редакции]             вывести информацию о лицензии выбранной редакции.
list [опции]                            вывести список доступных редакций.
set [название редакции]                 установить выбранную редакцию.

Опции:
-d, --display-name-only                 показать только отображаемые имена редакций.
-D, --no-display-name                   скрыть отображаемые имена редакций.
-p, --path-only                         отобразить пути объектов редакций на D-Bus.
-n, --name-only                         отобразить только имена объектов редакций.
-N, --no-name                           скрыть отображение имён объектов редакций.
-h, --help                              показать справку модуля editions.
</pre>

=== Примеры использования модуля ===
# Отображение имени текущей редакции.
#* Команда <code>alteratorctl editions</code> выведет список доступных редакций и покажет текущую:
#: [[Файл:Alteratorctl-editions2.png|безрамки|alteratorctl-editions2.png]]
# Отображение только имени объекта текущей редакции.
#* Команда <code>alteratorctl editions get</code> покажет имя объекта текущей редакции:
#: [[Файл:Alteratorctl-editions3.png|безрамки|alteratorctl-editions3.png]]
# Установка выбранной редакции.
#* Команда <code>alteratorctl editions set edition_domain</code> установит редакцию Альт Домен:
#: [[Файл:Alteratorctl-editions4.png|безрамки|alteratorctl-editions4.png]]
# Получение информации о лицензии выбранной редакции.
#* Команда <code>alteratorctl editions license edition_domain</code> покажет информацию о лицензии редакции Альт Домен:
#: [[Файл:Alteratorctl-editions5.png|900px|alteratorctl-editions5.png]]
#: Конкретно в данном случае вывод команды <code>alteratorctl editions license edition_domain</code> не будет отличаться от вывода команды <code>alteratorctl editions license</code>.