Alteratorctl/editions module: различия между версиями

Текущая версия от 18:17, 23 мая 2025

Данная страница находится в разработке.
Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.

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

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

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

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

Информация по редакциям

Редакция — набор компонентов, которые сопровождаются в продукте. Возможность выбора редакций появилась в Альт Сервер 11.0.

На данный момент в дистрибутиве доступны две редакции:

«Альт Сервер»;
«Альт Домен».

Структура редакции

Структура редакции представляется в формате TOML и имеет следующий вид:

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"
]

Использование модуля

Модуль предусматривает использование следующих команд и опций:

$ alteratorctl editions --help
Использование:
  alteratorctl editions [ОПЦИИ] Вывод списка редакций
  alteratorctl editions [КОМАНДА] [ОПЦИИ] [редакция]

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

Опции:
  -v, --verbose               Добавить к списку редакций пути к объектам на dbus
  -d, --display-name-only     Показать только отображаемые имена редакций
  -D, --no-display-name       Скрыть отображаемые имена редакций
  -p, --path-only             Отобразить только пути объектов редакций на DBus
  -n, --name-only             Отобразить только имена объектов редакций
  -N, --no-name               Скрыть отображение имён редакций
  -h, --help                  Вызов справки модуля editions

Отображение списка редакций и имени текущей редакции:

$ alteratorctl editions
  Альт Домен (edition_domain)
* Альт Сервер (edition_server)

Установка выбранной редакции:

# alteratorctl editions set edition_domain
# alteratorctl editions
* Альт Домен (edition_domain)
  Альт Сервер (edition_server)

@@ Строка 10: / Строка 10: @@
 <noinclude>[[Категория:Неоконченные страницы|{{PAGENAME}}]]</noinclude>
-'''Alteratorctl editions''' — модуль консольного приложения [[Alteratorctl|alteratorctl]], предоставляющий возможность выбора редакции и получения информации о составе доступных к выбору редакций.
+'''Alteratorctl editions''' — модуль консольного приложения [[Alteratorctl|alteratorctl]], предоставляющий возможность выбора '''редакции''' и получения информации о составе доступных к выбору '''редакций'''.
 === Основная информация ===
-Модуль использует интерфейс <tt>org.altlinux.alterator.edition1</tt> объектов из пакетов с редакциями.
+Модуль использует интерфейс <tt>org.altlinux.alterator.edition1</tt> объектов из пакетов с '''редакциями'''.
 Для работы некоторых команд модуля могут потребоваться права администратора.
 === Информация по редакциям ===
-Редакция — набор компонентов в составе дистрибутива. Каждая редакция содержит индивидуальный набор предустановленных и доступных для установки компонентов.
+'''Редакция''' — набор компонентов, которые сопровождаются в продукте. Возможность выбора редакций появилась в [[Альт_Сервер_11|'''Альт Сервер 11.0''']].
-Список доступных редакций на данный момент:
+На данный момент в дистрибутиве доступны две редакции:
-# Альт Сервер (edition_server)
+* «Альт Сервер»;
-# Альт Домен (edition_domain)
+* [[Альт_Домен_11|«Альт Домен»]].
 === Структура редакции ===
-Структура редакции представляется в формате TOML и имеет следующий вид:
+Структура '''редакции''' представляется в формате TOML и имеет следующий вид:
 <pre>
 type = "Edition"
@@ Строка 63: / Строка 63: @@
 === Использование модуля ===
 Модуль предусматривает использование следующих команд и опций:
-<pre>
+<source lang="text" highlight="1">
+$ alteratorctl editions --help
+Использование:
+  alteratorctl editions [ОПЦИИ] Вывод списка редакций
+  alteratorctl editions [КОМАНДА] [ОПЦИИ] [редакция]
 Команды:
-description [название редакции]         получить описание выбранной редакции.
+  description [редакция]      Получить описание выбранной или текущей редакции
-get                                     получить название текущей редакции.
+  get                         Получить имя текущей редакции
-info [название редакции]                вывести информацию о выбранной редакции.
+  info [редакция]             Вывести информацию о выбранной или текущей
-license [название редакции]             вывести информацию о лицензии выбранной редакции.
+                              редакции
-list [опции]                            вывести список доступных редакций.
+  license [редакция]          Вывести лицензию выбранной или текущей редакции
-set [название редакции]                 установить выбранную редакцию.
+  list                        Вывести список редакций
+  set <edition>               Выбрать указанную редакцию
 Опции:
--d, --display-name-only                 показать только отображаемые имена редакций.
+  -v, --verbose               Добавить к списку редакций пути к объектам на dbus
--D, --no-display-name                   скрыть отображаемые имена редакций.
+  -d, --display-name-only     Показать только отображаемые имена редакций
--p, --path-only                         отобразить пути объектов редакций на D-Bus.
+  -D, --no-display-name       Скрыть отображаемые имена редакций
--n, --name-only                         отобразить только имена объектов редакций.
+  -p, --path-only             Отобразить только пути объектов редакций на DBus
--N, --no-name                           скрыть отображение имён объектов редакций.
+  -n, --name-only             Отобразить только имена объектов редакций
--h, --help                              показать справку модуля editions.
+  -N, --no-name               Скрыть отображение имён редакций
-</pre>
+  -h, --help                  Вызов справки модуля editions
+</source>
-=== Примеры использования модуля ===
+Отображение списка '''редакций''' и имени текущей '''редакции''':
-Отображение списка редакций и имени текущей редакции:
 <source lang="text" highlight="1">
 $ alteratorctl editions
@@ Строка 89: / Строка 95: @@
 </source>
-Установка выбранной редакции:
+Установка выбранной '''редакции''':
 <source lang="text" highlight="1, 2">
 # alteratorctl editions set edition_domain