Index.html Policy — различия между версиями

Материал из ALT Linux Wiki
Перейти к: навигация, поиск
(использование шаблона DraftPolicy)
Строка 1: Строка 1:
 
{{Stub}}
 
{{Stub}}
  
[[Category:Policy]]
+
{{DraftPolicy
{{MovedFromFreesourceInfo|AltLinux/Policy/drafts/indexhtml}}
+
|responsible=Артём Золочевский (azol@)
 +
|discussion_link=http://lists.altlinux.org/pipermail/devel/2008-April/073529.html
 +
}}
  
 
== Полиси на создание indexhtml-пакетов ==
 
== Полиси на создание indexhtml-пакетов ==
 
{| border="1"
 
|-
 
|
 
Статус
 
|
 
отправлено на доработку
 
|-
 
|
 
Автор
 
|
 
Артём Золочевский (azol@)
 
|-
 
|
 
Обязательно в
 
|
 
''не применимо''
 
|-
 
|
 
Метабаг
 
|
 
''отсутствует''
 
|}
 
 
 
Обсуждение:
 
[http://lists.altlinux.org/pipermail/devel/2008-April/073529.html http://lists.altlinux.org/pipermail/devel/2008-April/073529.html]
 
 
__TOC__
 
  
  
 
=== Содержание indexhtml-пакета ===
 
=== Содержание indexhtml-пакета ===
indexhtml-distro пакеты представляют из себя дистрибутивоспецифичную "приветственную" страничку, которая открывается по умолчанию браузерами.
+
indexhtml-distro пакеты представляют из себя дистрибутивоспецифичную «приветственную» страничку, которая открывается по умолчанию браузерами.
 
Кроме этого, ссылка на такую страницу должна находиться в меню (и на рабочем столе?) на случай смены умолчательной домашней страницы пользователем.
 
Кроме этого, ссылка на такую страницу должна находиться в меню (и на рабочем столе?) на случай смены умолчательной домашней страницы пользователем.
  
Строка 50: Строка 23:
  
 
=== Требования к indexhtml-пакетам ===
 
=== Требования к indexhtml-пакетам ===
 +
 
==== Именование пакетов ====
 
==== Именование пакетов ====
 
Пакеты следует именовать по следующей схеме: indexhtml-<''название_дистрибутива''>
 
Пакеты следует именовать по следующей схеме: indexhtml-<''название_дистрибутива''>
Строка 59: Строка 33:
  
 
==== Каталог установки ====
 
==== Каталог установки ====
Файлы indexhtml-пакета (html, стили, логотипы и т.п.) устанавливаются в каталог /usr/share/doc/alt-docs/indexhtml/
+
Файлы indexhtml-пакета (html, стили, логотипы и т. п.) устанавливаются в каталог /usr/share/doc/alt-docs/indexhtml/
 
Совместимость со старым месторасположением index.html файла (/usr/share/doc/HTML/index.html) на переходный период обеспечивается indexhtml-common пакетом.
 
Совместимость со старым месторасположением index.html файла (/usr/share/doc/HTML/index.html) на переходный период обеспечивается indexhtml-common пакетом.
  
 
==== Именование html-файлов ====
 
==== Именование html-файлов ====
html-файлы именуются по следующей схеме: index-$lang.html, где $lang -- друзначный языковой код (en, ru, uk, be, de и тп.)
+
html-файлы именуются по следующей схеме: index-$lang.html, где $lang — друзначный языковой код (en, ru, uk, be, de и тп.)
По крайней мере index-en.html файл обязан присутсвовать в пакете, так как именно он будет использован по умолчанию в случае ненахождения подходящего index-$lang.html файла.
+
По крайней мере index-en.html файл обязан присутсвовать в пакете, так как именно он будет использован по умолчанию в случае ненахождения подходящего index-$lang.html файла.
  
 
==== Конфликты ====
 
==== Конфликты ====
 
Так как indexhtml-пакеты устанавливают свои файлы в один и тот же каталог, а также по причине того, что indexhtml-пакет дистрибутивоспецифичен, в системе не должно одновременно присутствовать более одного indexhtml-пакета.
 
Так как indexhtml-пакеты устанавливают свои файлы в один и тот же каталог, а также по причине того, что indexhtml-пакет дистрибутивоспецифичен, в системе не должно одновременно присутствовать более одного indexhtml-пакета.
Для обеспечения этого пакеты должны иметь конфликты на каждый indexhtml-distro пакет, т.е. содержать в своём spec-файле:
+
Для обеспечения этого пакеты должны иметь конфликты на каждый indexhtml-distro пакет, то есть содержать в своём spec-файле:
  
 
<pre>Provides: indexhtml
 
<pre>Provides: indexhtml

Версия 16:24, 9 сентября 2008

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


Stub.png
Черновик политики Sisyphus
Автор(ы) — Артём Золочевский (azol@)
Обсуждение в devel@


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

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

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

Этот простой html-файл содержит как правило:

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

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

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

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

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

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

Каталог установки

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

Именование html-файлов

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

Конфликты

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

Provides: indexhtml
Cоnflicts: indexhtml-firstdistro, indexhtml-seconddistro, indexhtml-thirddistro

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

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

...
Categories=System;Documentation;
...

Использование пакета indexhtml-common

Скрипт indexhtml-update, входящий в состав пакета indexhtml-common, создаёт ссылку (index.html) на нужный языковой вариант приветственной страницы и должен использоваться в %post-секциях spec-файла. Важно помнить, что именно index.html файл является файлом, открываемым по умолчанию браузерами. Поэтому наличие этого файла является обязательным.

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

...
%files
%ghost %_indexhtmldir/index.html
...
%post
%_sbindir/indexhtml-update
...

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