[docs] Re: требования к формату модуля документации
Vitaly Ostanin
vyt на vzljot.ru
Ср Янв 12 00:21:12 MSK 2005
Alexandre Prokoudine пишет:
> Vitaly Ostanin пишет:
>
>>Kirill Maslinsky пишет:
>>
>>
>>>Ещё раз всем привет. Продолжение.
>>>Требования к разметке модуля DOCS =================================
>>>
>>>DocBook не очень годится в качестве формата для модуля документации в
>>>DOCS: он слишком велик (около 400 элементов), требует долгого и
>>>внимательного изучения. Кроме того, многие полагают разметку в XML
>>>неудобной.
>>>Задача: разработать (или выбрать) формат, в котором
>>>будет вся необходимая и достаточная логическая информация для сборки
>>>конечных форматов.
>>>Постулат: такой формат может и должен содержать не более 7--12 элементов.
>>
>>Блажен кто верует :) Вы, конечно, можете попробовать, но это 100%
>>очередной велосипед.
>
> Кстати, интересно твоё мнение: Simplified DocBook -- это тоже велосипед?
Нет, это ПЕАР :) Удобно ведь думать, что "нас заставляют!!", хотя
на самом деле брать можно только те теги, которые реально
занадобились, благо стили их понимают. Стили, кстати, одни и те
же для всего DocBook, и для упрощённого.
Но чтобы не заставляли, мы возьмём чуть-чуть тегов и объявим
независимость :) IMHO, это просто психологический ход -
кастрированный DocBook, не пугающий количеством возможностей.
> http://www.docbook.org/specs/wd-docbook-simple-1.1CR2.html
PS Ресурсов мало, инструментов мало, но мы придумали выход! Мы
придумаем свой формат :) Это не сарказм, это просто смешно :)
<skipped/>
--
Regards, Vyt
mailto: vyt at vzljot.ru
JID: vyt at vzljot.ru
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 256 bytes
Desc: OpenPGP digital signature
Url : http://lists.altlinux.ru/pipermail/docs/attachments/20050112/02397d92/signature.bin
Подробная информация о списке рассылки docs