[docs] Re: makefile rework intro

[Vitaly Ostanin]

On Mon, 27 Oct 2003 19:56:46 +0300
Oleg A.Paraschenko <olpa на xmlhack.ru> wrote:

>   Всем привет,
> 
>   появилась возможность попробовать заняться make-файлами.
>   Прежде, чем приступить к этому, вкратце описываю цели и
>   методы. Жду комментарии.
> 
> ---
> 
> Цели переработки:
> * перейти на "шаблонный" стиль вместо "декларативного". Это
> позволит упростить make-фалы и сделать их более гибкими;*
> добавить "профилирование";* дать возможность экспериментировать
> с различными fop-процессорами.
> 
> В этой версии не будет поддержки .chm (Html Help).
> 
> ---
> 
> make targets:
> 
> all       - по умолчанию. Сборка html-dir, html-file и print
> clean     - удаление сгенерированных файлов, в том числк и
> временных distclean - ещё сильнее, чем просто clean. Может
> быть, и не требуется dist      - приготовить результаты all для
> распространения check     - проверить корректности исходного
> файла html-dir  - создать документ, состоящий из нескольких
> html-файлов html-file - создать документ в виде одного
> html-файла print     - создать печатную версию документа (pdf)

Желательно ещё view-result, по аналогии с текущим.

Есть предложение вместо "print" держать цели
pdf-<suffix>
, где <suffix> - средство, с помощью которого получен pdf.

Сразу добавлю, что сейчас в Makefiles разброд с переменными - они
могут быть "параметр значение", а могут быть просто "значение".

Лучше в новых Makefiles использовать только "параметр значение",
чтобы можно было использовать переменную, даже если "значение" не
определено.

> 
> ---
> 
> Расположение файлов:
> 
> ./module/
>  module.xml  - исходный файл
>  tmp/        - папка для временных файлов

Можно пример временных файлов?

>  out/        - папка для готовых документов

Может, лучше "output" ? Кстати, для термина directory лучше
употреблять перевод "каталог". "Папка" - это folder. В архивах
было обсуждение.

>   module-html-dir/   - тут результат "make html-dir"
>   module-html-file/  - тут результат "make html-file"
>   module-print/      - тут результат "make print"

То же самое насчёт "print"

>   module.tgz         - архив готовых документов

Может, лучше module.tar.bz2 ?

> Общий подход:
> * всё, что создаётся, оказывается либо в "tmp", либо в "out". В

Есть сложности, например, с emacs-mode-psgml. Его
предкомпилированные DTD должны лежать рядом с документом.

> результате:
>  * хлам не смешивается с важными файлами;
>  * для "make clean" достаточно "rm -rf tmp out".
> * Если файл входит в состав итоговых документов, то он лежит в
> "out", иначе он лежит в "tmp".
> 
> ---
> 
> Цепочка преобразований.
> 
> Общее начало:
> .xml -> xinclude -> profiling+tuning (A)

XInclude незачем выделять в отдельный этап, IMHO.

> Далее, для html:
> всё, как сейчас
> 
> Далее, для print:
> -> fo  (B) -> pdf (C) или
> -> tex (D) -> pdf

FO может (и должен) быть разным для каждого FO-процессора.

> Возможности:
> (A) можно варьировать
> (B) можно варьировать, например, брать стиль для A4, letter, B5
> etc.(C) можно варьировать, например, использовать fop, xep,
> passiveTeX etc.(D) можно варьировать, например, использовать
> dblatex или db2latex (или что там есть)

Желательно не просто варьировать, а иметь возможность собирать
PDF каждым способом рядом, а не вместо.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031027/1f43e738/attachment.bin