Полиси на создание indexhtml-пакетов

Обсуждение:
http://lists.altlinux.org/pipermail/devel/2008-April/073529.html

Содержание indexhtml-пакета

indexhtml-distro пакеты представляют из себя дистрибутивоспецифичную «приветственную» страничку, которая открывается по умолчанию браузерами.
Кроме этого, ссылка на такую страницу должна находиться в меню (и на рабочем столе?) на случай смены умолчательной домашней страницы пользователем.

Этот простой html-файл содержит как правило:
* приветствие
* ссылки на локально установленную документацию. как минимум:

• выпуск (docs-issue) по данномй дистрибутиву
• страница всех установленных выпусков и модулей

* ссылки на web-ресурсы

indexhtml-пакет должен устанавливать один index.html файл (возможно с дополнительными файлами: стили, логотипы и т.п.) в каталог /usr/share/doc/alt-docs/indexhtml/, который устанавливается по умолчанию в браузерах. (это месторасположение нужно согласовать с мантейнерами браузеров).

Требования к indexhtml-пакетам

Именование пакетов

Пакеты следует именовать по следующей схеме: indexhtml-название_дистрибутива
Группа для указания в spec-файле: System/Base (Books/Other?)

Пример:
Name: indexhtml-server
Group: System/Base

Конфликты

Так как indexhtml-пакеты устанавливают свои файлы в один и тот же каталог, а также по причине того, что indexhtml-пакет дистрибутивоспецифичен, в системе не должно одновременно присутствовать более одного indexhtml-пакета.
Для обеспечения этого пакеты должны иметь конфликты, т.е. содержать в своём spec-файле:

Provides: indexhtml Cоnflicts: indexhtml

Расположение в меню

indexhtml-пакеты должны содержать desktop-файл для интеграции в меню. При этом в desktop-файле указывается:
... Categories=System;Documentation; ...

Многоязычность

Стартовая страница дистрибутива может быть переведена на несколько языков. В этом случае крайне желательно размещать на странице ссылки на другие языковые варианты. При этом важно помнить, что страницой по умолчанию является index.html.

indexhtml-common

Для автоматизации выбора умолчательно страницы, можно вопользоваться скриптом indexhtml-update, входящим в состав пакета indexhtml-common. При этом должны соблюдаться 2 правила:
* для каждого языкового варианта создаётся index-$lang.html, где $lang — друзначный языковой код (en, ru, uk, be,de и тп.). index.html файл будет создан скриптом как символьная ссылка на один из этих файлов
* пакет должен как минимум содержать index-en.html, который и будет использоваться по умолчанию в случае отсутствия нужного index-$lang.html

Пример использования indexhtml-update в spec-файле:
... %post %_sbindir/indexhtml-update ...

Ссылок на эту страницу нет