[docs] Как нам реорганизовать heap

Mikhail Gusarov =?iso-8859-1?q?dottedmag_=CE=C1_altlinux=2Eorg?=
Вс Окт 5 17:32:10 MSD 2008


Twas brillig at 16:26:58 05.10.2008 UTC+03 when artem.zolochevskiy на gmail.com did gyre and gimble:

 AZ> Кое-какой опыт очень даже понравился (fedorа-шный).

URL?

 AZ> - разнобой входных форматов влечёт ужасный вид результирующего html
 AZ> (стоит посмотреть на любой выпуск документации)

Это исправлябельно per-format. Кроме того, можно на некоторые форматы
слегка "положить" и рекомендовать (не заставлять) использовать тот же
docbook.

 AZ> - ограничения на структуру хранения исходников влечёт за собой
 AZ> неудобства работы с внешними источниками. У нам исходник
 AZ> обязательно должен лежать в каталоге doc. Если импортируем исходные
 AZ> тексты, то надо ещё выкручиваться, чтоб они там оказались.

Это надо исправлять.

 AZ> - есть проблемы с кодировками: docinfo обязательно в koi

При избавлении от spec можно будет и docinfo переделать как угодно.

 AZ> - есть проблемы с зависимостями. В выпусках проставляется
 AZ> зависимость на модуль, но без версии.

Решается при переделке docinfo.

 AZ> - есть проблемы с переводами (проблема кучи входных форматов).

Аналогично, решается per-format.

-- 
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 196 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/docs/attachments/20081005/3de71ed0/attachment.bin>


Подробная информация о списке рассылки docs