[Comm] Re: FAQ - майнтейнер нужен?

[Vitaly Ostanin <vyt@vzljot.ru>]

[-- Attachment #1: Type: text/plain, Size: 1842 bytes --]

On Tue, 29 Oct 2002 23:05:20 +0300
Mikhail Ramendik <mr@ramendik.ru> wrote:

> Hello Vitaly,
> 
> Tuesday, October 29, 2002, 11:11:22 AM, you wrote:
> 
> >> Если никто более квалифицированный и опытный не согласится
> >стать> майнтейнером, могу им стать, только тогда прошу
> >отвечать на вопросы> для FAQ - а я его буду оперативно
> >выкладывать.
> 
> VO> Такое начинание уже было, и FAQ какое-то время вёлся.
> VO> Вообще я планировал сделать FAQ в DocBook/XML для
> VO> docs.altlinux.ru.
> 
> ОК, сдаюсь, ты круче - я DocBook не знаю.

Это не крутость :)

Для создания FAQ достаточно базовых тегов, пример (неработающий):

<title>Заголовок</title>
<qandaset>
  <para>
    Параграф (абзац) внутри набора QandA - вопросов и ответов.
  </para>
</qandaset>

Тут знать нечего, было бы желание писать и время попариться с
тегами, а главное, со структурой FAQ.

> VO> Пока что я просто собираю кандитатов на вопросы
> VO> и ответы, потом оформлю в DocBook. Если есть желающие
> VO> помочь в_этом_ - welcome.
> 
> Готов оказать любую посильную помощь.

Дел очень много, поэтому лучше Вам выбрать, чем именно Вы хотите
заняться. Нужны авторы, интересные статьи, редакторы,
тех.редакторы, знание макросов TeX для passivetex или стилей
XSLT, или чего-нибудь ещё, что может пригодиться.

Если Вы напишете документацию в обычном plain text для начала,
тех.редакторы переведут его в DocBook.

PS DocBook действительно не сложен, но полностью удобного
инструмента для него нет, даже среди коммерческого софта -
слишком много возможностей. А DocBook/XML позволяет использовать
технологии XML - включения, ссылки и т.д. Так что (не для флейма)
можно попробовать писать в emacs-psgml, или поискать аналогичный
режим в vi.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]