2.3. Парсер страниц

Для упрощения добавления страниц на сайт можно воспользоваться парсером.

В качестве входных данных для парсера используется один файл с описанием всех страниц.

Описание каждой страницы начинается с символов решётки «#» (диез). Текст после этих символов будет использоваться в качестве заголовка браузера (свойство страницы @@title)

Две решётки указывают на страницу первого уровня, три — дочерняя страница предыдущей страницы второго уровня, четыре — дочерняя страница предыдущей страницы третьего уровня и так далее.

Пример 2.2. Содержимое файла с описанием страниц сайта

Текст с аннотациями для парсера из четырёх страниц.

##Главная страница Страница первого уровня
@@keywords=главная, страница Свойство страницы
текст страницы 

##Новости сайта Страница первого уровня
@@menu=Новости Название пункта меню
@@module=zmodule_listpages Использовать модуль для вывода списка дочерних страниц
@@file=news Название файла страницы

###Старая новость Дочерняя страница раздела "Новости сайта"
текст старой новости

###Вот это новость! Дочерняя страница раздела "Новости сайта"
@@publish=2009-11-03 Появится на сайте только 3 ноября 2009 года
текст будущей новости


Для того, чтобы запустить парсер, нужно создать файл pages.txt в папке tools, открыть страницу http://mysite.ru/tools/parser.php в браузере и нажать на кнопку «Начать импорт».

[Замечание]Замечание

В целях безопасности рекомендуется переименовать папку tools или ограничить доступ к ней по логину и паролю.

Результатом выполнения парсера будет список адресов страниц и ссылка на корень сайта. Сам файл pages.txt будет переименован (если у скрипта есть права на изменение этого файла). Для повторного запуска парсера потребуется либо положить в папку новый файл, либо переименовать старый.

По умолчанию парсер настроен на работу с pages.txt в кодировке UTF-8. Текущее наполнение сайта будет полностью удалено и название файла первой страницы будет index.

За настройки парсера отвечает файл tools/parser.ini. В нём можно указать кодировку файла pages.txt (например, Windows-1251), создавать ли первую страницу с названием файла index и требуется ли удалять старые страницы, уже присутствующие на сайте.