Как добавить каталог к WWW интерфейсу

Раскрываем дерево с нужным интерфейсом. Выбираем каталог, в котором хотим разместить наш новый каталог. При выборе надо помнить, что не все каталоги в дистрибутиве помещаются в дерево документов, при выборе смотрите на установленное дерево документов. В выбранном каталоге добавляем имя нового каталога в строку SUBDIR и создает его. Предмоложим, он будет зваться _somedir. Использовано соглашение, что все локальные имена начинаются с символа _, что бы не случилось совпадения при очередном апгрейде.

Самые важные файлы в новом каталоге - Makefile и def.m4. Вот простой пример def.m4:


               dnl $Id$
        ifdef(PATHNEXT,define(PATHNEXT,PATHNEXT/..),define(PATHNEXT,..))dnl
        include(PATHNEXT/def.m4)dnl
        dnl место для своих макроопределений dnl

Если вам не нужна замена макроопределений или новые макроопределения для трансляции страниц в Вашем каталоге, то и не включайте их.

Makefile выглядит несколько сложнее:


               # $Id$
        TITLE	= "Заголовок индекса"
        DATADIR	= ${ROOTDATA}/путь_к_новому_каталогу
        SUBDIR	= 
        HTML	= 
        MISC	= def.m4 ${M4SRC}

        preall:	../def.m4 def.m4

        .include <define.make>
        .include <shtml.make>
        .include <common.make>

Строка TITLE используется для того, что бы была создана ссылка на этот каталог в индексе каталога предыдущего, и этот же заголовок будет у индекса в этом каталоге. Если ни ссылка в предыдужщем каталоге, ни индекс в этом не нужны, тогда строку TITLE использовать не надо. DATADIR получается добавлением к DATADIR предыдущего каталога имени нашего нового каталога: /_somedir. Если в нашем новом каталоге нет подкаталогов, то SUBDIR не нужна - можно вообще эту строку убрать, или оставить список пустым до возможного будущего расширения. В списке HTML надо перечислить названия .4tml файлов, которые Вы сюда поместите, без расширения. Эти файлы будут перечислены в индексе, если задана TITLE, и оттранслированы в .shtml. Если надо, что бы какие либо .4tml файлы не попали в индекс, то надо воспользоваться советом из описания создания страницы. И вообще, странички в этот каталог Вы будете писать, скорее всего, пользуясь тем описанием.

Строка MISC не меняется, если Вы не добавляете в каталог ничего, кроме .4tml файлов, а если для трансляции нужны будут еще какие-то файлы, то их надо включить в список MISC.

Это описание никак не может заменить изучения make, если потребуется что-то более сложное, чем описано здесь. Также полезно изучить gm4 (GNU m4) для разработок чуть сложнее тривиальной.