[docs] Re: workflow

Prokudin Alexander AProkudin на croc.ru
Ср Авг 4 12:06:05 MSD 2004


 

> -----Original Message-----
> From: docs-bounces at altlinux.ru 
> [mailto:docs-bounces at altlinux.ru] On Behalf Of Oleg A. Paraschenko
> Sent: Wednesday, August 04, 2004 9:38 AM
> To: ALT Linux Documentation project mailling list
> Subject: Re: [docs] Re: workflow
> 
>   Привет!
> 
> On Tue, 03 Aug 2004 12:07:44 +0400
> Vitaly Ostanin <vyt at vzljot.ru> wrote:
> 
> > Oleg A. Paraschenko пишет:
> > >   Привет!
> > > 
> > >   Во время Феста были обсуждения организационных проблем alt-docs.
> > > На их основе я прикинул возможный вариант распределённого 
> написания 
> > > документации. Комментарии приветствуются.
> > 
> > Звучит красиво.
> > 
> > Подозреваю, что на практике обнаружатся, как минимум, два 
> узких места 
> > - ограниченность ресурсов техписов по переводу во внутренний формат,
> 
>   Я подозреваю, что перевод во внутренний формат иногда 
> делается руководителями проекта alt-docs. Александр, Кирилл, 
> это так? Если да, насколько это большой объём работ?

Мне приходилось иметь дело, в основном, с SXW. Я упростил себе жизнь, написав достаточно тупой и прямой сценарий на bash, который использовал XSL Антона Бояршинова для преобразования SXW в docbook и делал кое-какую послеобработку. Однако, даже после этого много времени уходило именно на разметку. Впрочем, часть разметки после исполнения сценария делалась методом find/replace, где найденный текст заменялся им же, но с тем или иным открывающим или закрывающим тэгом.

Такая методика позволяла получать за рабочий день от 20 до 60 Кбайт размеченного DB/XML текста. Но помните, что "your mileage may vary" (c) :-)

А.П.


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