«Site-UP ready» веб-сайт поставляется уже настроенным и готовым к работе, поэтому, в большинстве случаев, не нуждается в дополнительной настройке.
Базовые переменные, описанные здесь, и их значения по умолчанию при необходимости могут быть изменены при помощи конфигурационного файла веб-сайта. По умолчанию этот конфигурационный файл имеет имя .surwsini и должен находится в корневой директории веб-сайта. Файл .surwsini не является обязательным но, как Вы узнаете далее, может понадобиться при создании собственного сайта.
Во время работы «Site-UP ready» веб-сайт пытается найти этот файл и если он найден, выполняет содержащиеся в нем команды. Следует также отметить, что в отличие от конфигурационных файлов директорий файл .surwsini может располагаться только в корневой директории веб-сайта и выполнение этого файла осуществляется до начала подключения плагинов.
Настройка «Site-UP ready» веб-сайта, осуществляется из панели управления веб-сайтом. Исследовав панель управления Вы без труда найдете ссылки для настройки веб-сайта (файл .surwsini) и плагинов (конфигурационные файлы плагинов).
Для изменения базовых переменных изпользуются Perl команды.
Список поддиректорий разделяется запятыми. «Site-UP ready» веб-сайт знает имя корневой директории веб-сайта и в какой директории находится запрошенный веб-браузером файл. Поиск HTML шаблонов и шкурок будет производится в определенных в этой переменной поддиректориях директорий начиная от текущей и закинчивая корневой директорией веб-сайта.
Пример:
Пусть /www/htdocs/ - корневая директория веб-сайта, а переменная HTMLINCDIR определена следующим образом:
HTMLINCDIR = '_html,_myhtml';
Если браузер запросил файл, находящийся в корневой директории веб-сайта, то поиск HTML шаблонов и шкурок (поиск осуществляется при выполнении директив INC и INL) будет производится в директориях:
/www/htdocs/
/www/htdocs/_html/
/www/htdocs/_myhtml/
т.е. сначала поиск будет производится в корневой директории веб-сайта (в этом случае она совпадает с директорией запрошенного файла), а затем в ее поддиректориях.
Если браузер запросил файл, находящийся в поддиректории subdir директории dir (/www/htdocs/dir/subdir/), то поиск HTML шаблонов и шкурок будет производится в директориях:
/www/htdocs/dir/subdir/
/www/htdocs/dir/subdir/_html/
/www/htdocs/dir/subdir/_myhtml/
/www/htdocs/dir/_html/
/www/htdocs/dir/_myhtml/
/www/htdocs/_html/
/www/htdocs/_myhtml/
т.е. сначала поиск будет производится в директории запрошенного файла, затем в ее поддиректориях, затем в поддиректориях всех верхних директорий, а затем в поддиректориях корневой директории веб-сайта.
Таким образом очевидно, что выполнение директивы <%INC:submenu.html%> вызванной из файлов находящихся в разных директориях может приводить к включению различных файлов submenu.html. Эта особенность дает возможность строить контекстно зависимые меню, без необходимости изменения имени файла используемого в директивах INC и INL (другими словами можно сказать что одна шкурка склеивает разные кирпичики в зависимости от того где она используется).
По умолчанию эта переменная установленна в 0 и разрешает поиск HTML шаблонов только в поддиректориях, указанных в HTMLINCDIR. Если переменная установленна в 1, то во втором случае (см. примеры выше) поиск HTML шаблонов будет осуществляться в директориях:
/www/htdocs/dir/subdir/
/www/htdocs/dir/subdir/_html/
/www/htdocs/dir/subdir/_myhtml/
/www/htdocs/dir/
/www/htdocs/dir/_html/
/www/htdocs/dir/_myhtml/
/www/htdocs/
/www/htdocs/_html/
/www/htdocs/_myhtml/
Список поддиректорий разделяется запятыми. Поиск модулей Perl осуществляется аналогично поиску HTML шаблонов, за тем исключением, что поиск в корневой директории веб-сайта и в директории запрошенного браузером файла не осуществляется.
Пример:
Пусть /www/htdocs/ - корневая директория веб-сайта, а переменная PERLINCDIR определена следующим образом:
PERLINCDIR = '_perl,_myperl';
Если браузер запросил файл, находящийся в корневой директории веб-сайта, то поиск Perl модулей (поиск осуществляется при выполнении директив REQ) будет производится в директориях:
/www/htdocs/_perl/
/www/htdocs/_myperl/
Если браузер запросил файл, находящийся в поддиректории (/www/htdocs/dir/subdir/), то поиск будет производится в директориях:
/www/htdocs/dir/subdir/_perl/
/www/htdocs/dir/subdir/_myperl/
/www/htdocs/dir/_perl/
/www/htdocs/dir/_myperl/
/www/htdocs/_perl/
/www/htdocs/_myperl/
т.е. сначала в поддиректориях директории запрошенного файла, затем в поддиректориях всех верхних директорий, а затем в поддиректориях корневой директории веб-сайта.
В указанной поддиректории корневой директории веб-сайта будет производится поиск плагинов. Указание нескольких поддиректорий не допустимо. В большинстве случаев нет необходимости в изменении этой переменной
Указанные здесь расширения (через запятую) будут анализироваться как программные модули а не как HTML файлы. Это позволяет вызывать файлы с указанными расширениями напрямую (по УРЛ вида http://www.mysite.ru/prg.px), не создавая HTML файл с одной лишь директивой <%REQ:prg.px%>.
«Site-UP ready» веб-сайт имеет встроенную защиту от бесконечной рекурсии. При выполнении директив, использующих внешние файлы (например INC, REQ), внешний файл, в свою очередь, может также содержать директивы, использующие внешние файлы. Указанное здесь число указывает максимальную вложенность директив, для того чтобы предотвратить бесконечную рекурсию.
Пример:
Если в файле с именем file.html указать директиву <%INC:file.html%>, то это могло бы привести к бесконечной рекурсии выполнения директивы INC. Однако «Site-UP ready» веб-сайт не позволит этому случится, предкратит рекурсию и предупредит Вас об этом.