Сизиф-на-Куче

• Веб-интерфейс, позволяющий ориентироваться в документах Кучи

Сборочные технологии проекта ALT Docs

• Текущая реализация сборочной технологии

Общая идея:

Публикатор: поступающие в Кучу документы должны проходить сборочную процедуру (сборка в HTML и унификация) и публиковаться в собранном виде в Сети без участия человека (короткий цикл).

Кроме этого предусматривается публикация документов во внешних репозиториях (sisyphus), при минимальном участии человека в тривиальных процедурах (пересборка обновлённого документа) -- это длинный цикл.

Текущая реализация сборочной процедуры (не описано тут), даёт только частичную автоматизацию.

Предлагаемая реализация сборочной процедуры (которкий цикл):

1. Преобразование Кучи в набор git-репозиториев (по одному на каждый документ)

   1. Импорт существующих документов в git утилита git-heapimport

   2. Структура git-Кучи: права доступа, структура каталогов, полиси. формат тегов, запрашивающих пересборку.
2. Сборочная процедура:

   1. Робот по наступлению события (cron) определяет список модулей к сборке

   2. Он же запускает gear, передавая необходимые сборочные параметры (Timestamp, Archive, Comitter)

   3. gear получает тарболл из git-репозитория и запускает скрипт-обвязку, который генерирует спек и выполняет сборку в hasher

   4. собранный rpm-пакет устанавливается в общий chroot с другими подобными (тоже hasher)
   5. часть chroot, содержащая html-файлы модулей, отображается на web

Реорганизация структуры выпуска

См. техзадание

Предложение по структуре выпуска.

• Базовый_каталог -- каталог с документацией (/usr/share/docs/alt-docs)

  • modules/ -- каталог с установленными модулями

    • Модуль_1/ -- некоторый модуль

      • head.html -- стандартная шапка модуля (вариант: генерируется при установке модуля)

      • foot.html -- стандартный подвал модуля (вариант: генерируется при установке модуля)

      • doconfo.html, License.html и пр. -- файлы ALD policy

      • doc/ -- подкаталог с файлами модуля (содержит index.html, в который внедрены head.html и foot.html в виде iFrame-ов

    • Модуль_2/ -- некоторый модуль

    • . . . -- другие модули

    • index.html -- сводный список (обновляется при установке нового модуля)

  • Выпуск_1/ -- каталог с некоторым выпуском, собранным из модулей

    • modules/ -- каталог со ссылками на модули

      • Модуль_1/ -- каталог со ссылкой на Модуль_1

        • head.html -- модифицированная шапка модуля (генерируется при установке либо при сборке выпуска)

        • foot.html -- модифицированный подвал модуля (генерируется при установке либо при сборке выпуска)

        • doc -- символьная ссылка на подкаталог doc Модуля_1 (-> ../../../modules/Модуль_1//doc)

        • . . . -- символьные ссылки на файлы ALD policy

      • Модуль_2/ -- некоторый модуль

      • . . . -- другие модули и левые файлы выпуска, если таковые понадобятся (например, список модулей в выпуске по аналогии с modules/index.html, может генерироваться той же программой)

    • index.html и пр. -- оглавление и другие файлы выпуска, не входящие в модули

Требуется реорганизовать структуру HTML-модуля. Обоснование: не помещать в index.html модуля информацию, зависящую от названия этого модуля (сейчас роль head.html и foot.html играют символьные ссылки вида Модуль_1.next и т. п.). Не устраивать каши в modules/.

Пример структуры

Развитие сайта ALT Docs

Мелкие:

• наладить всё-таки доставку почтовых уведомлений об измениях на wiki-страницах

Покрупнее:

• возможность offline-обновления страниц (подкладывания готовых в формате moin), чтобы такие обновления отслеживались движком и отображались в истории изменений. См. также веб-интерфейс к Куче

Развитие сайта ALT Linux

• Проект информационной структуры сайта ALT Linux