[docs] freeschool

[Oleg A. Paraschenko]

  Привет!

On Fri, 21 Nov 2003 19:43:12 +0300
Alexandre Prokoudine <avp на altlinux.ru> wrote:

> Michael Shigorin wrote
> > On Fri, Nov 21, 2003 at 07:28:58PM +0300, Alexandre Prokoudine wrote:
> > > В ближайшее время я начну выкладывать в CVS книжку Максима
> > > Отставнова "вободные программы и системы в школе".

  Здорово.

> Хотелось бы
> > > услышать пожелания по политически и технологическому
> > > правильному размещению файлов :)
> > 
> > 644 на файлы, 755 на каталоги!
> 
> А можно посерьёзнее?

  Про 644/755 -- верное замечание.

  Не знаю, будет ли это "правильным", но можно пойти таким путём:

* просмотреть "Принципы создания документов для ALT Linux Team
  Documentation";

* описание новой системы make-файлов (ещё не в главной ветке):
  http://xmlhack.ru/tmp/alt/makefiles/makefiles-html-dir/index.html

* начать работу в DOCS_ROOT/books/freeschool;

* doc_template.xml и Makefile стоит взять из $DOCS_ROOT/doc_template;

* пусть содержимое книги будет разбито на модули, каждый модуль в
  своём  подкаталоге, а главный файл freeschool.xml подключает их;

* для модулей используется <section />, после сборки книги эти <section />
  на этапе тюнинга должны быть заменены на <part />. Соответствующий
  параметр ARRANGE_FLAGS для Makefile можно взять из уже готовой книжки.


> 
> -- 
> Alexandre Prokoudine		| "When you set yourself on fire and aim 
> ALT Linux Documentation Team	|  for the sky, you hope to leave behind 
> E-mail: avp на altlinux.ru		|  some sparks of heat and light"
> JabberID: avp на altlinux.org	|                             Neil Peart
> 


-- 
Oleg