VITRAGE: Теория
· Компиляция и установка
· Идеология VITRAGE
· Оптимизация HTML
· Создание виртуальных хостов
· Создание структуры доменов
· Ваш собственный язык гипертекстовой разметки
 
Практика
· Немного о стилях парсинга
· Примеры использования
· Работающие сайты
· Хостинги
· Вопросы и ответы
· Задать вопрос
· E-mail
 
О модуле
· Что такое VITRAGE
· История модуля
· Загрузить модуль
· Документация целиком
· Загрузить документацию в формате MS Word
· Слово автора
· English version
 
Технология VITRAGE
Один из витражей города Иркутска
Исходный код
· VHTML-код этой страницы (в новом окне)
· VHTML-код файла vitrage (в новом окне)
 
· Компиляция и установка

В том случае, если VITRAGE уже скомпилирован и установлен на веб-сервере, которым вы пользуетесь, вы можете сразу перейти к следующему разделу данного руководства, повествующему об использовании модуля. Если компиляция и/или установка вам лишь предстоят, читайте этот раздел далее.

Прежде всего, стоит заметить, что данный модуль (в том виде, в котором он существует в настоящее время), скорее всего, не будет работать со второй версией веб-сервера Apache, которая уже начала распространяться. Во второй версии разработчики Apache внесли значительные изменения в Apache API и в саму идеологию создания модулей. Версия VITRAGE для Apache 2.x, вероятно, будет когда-нибудь создана, а пока речь идет об Apache 1.3.x. На данный момент у автора не возникало никаких проблем с компиляцией и установкой модуля для всех версий Apache 1.3.x.

К сожалению, автор имеет возможность комментировать установку модуля только для Apache под Linux, но это ограничение не представляется автору принципиальным.

Итак, начнем с ситуации, когда модуль еще не скомпилирован и представляет собой файл mod_vitrage.c. Вообще говоря, компиляция модуля VITRAGE аналогична компиляции прочих модулей для Apache: используется gcc с указанием того, что подключаемые (include) файлы следует также искать в каталоге /usr/include/apache (или в ином соответствующем). Автор использует следующие команды для "сборки" модуля:

gcc -DLINUX=2 -DUSE_HSREGEX -DEAPI -DUSE_EXPAT -I../lib/expat-lite -fpic -O2 -DSHARED_MODULE -I/usr/include/apache -c mod_vitrage.c
gcc -shared -o mod_vitrage.so mod_vitrage.o

В подавляющем большинстве случаев компиляция модуля может быть также выполнена при помощи утилиты apxs, входящей в поставку Apache:

apxs -c mod_vitrage.c

После последовательного запуска двух первых команд или запуска apxs в том же каталоге, где находится mod_vitrage.c, будет создан файл mod_vitrage.so, который и предстоит "подключать" к Apache.

Файл mod_vitrage.so следует скопировать в тот каталог, где находятся все прочие модули (это может быть, например, /usr/lib/apache), после чего предстоит последний этап - изменение httpd.conf (конфигурационного файла веб-сервера). В него должны быть добавлены следующие строки (все упоминаемые ключевые слова - LoadModule, AddModule, AddType, AddHandler - подробно описаны в руководстве пользователя Apache, к которому вы можете обратиться в случае возникновения вопросов или проблем):

LoadModule vitrage_module /usr/lib/apache/mod_vitrage.so
AddModule mod_vitrage.c
AddType text/html .vhtml
AddHandler vitrage-parsed .vhtml

Если вы собираетесь использовать VITRAGE в качестве расширения HTML, вы, скорее всего, будете описывать собственные тэги в специальных конфигурационных файлах VITRAGE. Процедура описания новых тэгов и использования конфигурационных файлов будет затронута в разделе "Ваш собственный язык гипертекстовой разметки" руководства. Сейчас же следует знать, что по умолчанию конфигурационные файлы имеют имя vitrage (строчными латинскими буквами без расширения), и эти файлы следует защитить от скачивания следующими строками в httpd.conf:

<Files vitrage>
Order allow,deny
Deny from all
</Files>

В этом же разделе руководства целесообразно отметить, что страницы, при разметке которых использован расширенный с помощью VITRAGE язык HTML, мы будем называть VHTML-страницами (VHTML-файлами, файлами VHTML), а соответствующие им файлы будут иметь расширение ".vhtml", например, index.vhtml. В связи с этим может оказаться полезной мысль о дополнении значения параметра DirectoryIndex в файле httpd.conf именем "index.vhtml", например:

DirectoryIndex index.htm index.html index.php index.shtml index.php3 index.vhtml index.cgi

Кроме всего этого, на данном этапе можно осуществить настройку параметров модуля для всего веб-сервера в целом (то есть установить параметры по умолчанию), а также для отдельных виртуальных хостов (секции VirtualHost конфигурационного файла) и каталогов (секции Directory). Список ключевых слов, отвечающих за настройку возможностей VITRAGE, комментарии и рекомендации приведены в данном руководстве в разделе "Идеология VITRAGE. Ключевые слова и их использование".

После компиляции и настройки можно запускать (или перезапускать) Apache. VITRAGE готов к плодотворной работе.