Официальный сайт TextCMS
TextCMS — все просто!





Рассказать



Интеграция собственного шаблона для сайта

Если вы хотите использовать собственный шаблон для сайта, выполните следующие действия:

  1. Подготовьте шаблон в виде статической HTML-страницу (вручную, с помощью визуальных HTML-редакторов или других средств) и убедитесь, что она отображается корректно. Стили могут находиться как внутри шаблона, так и в отдельном CSS-файле.
  2. Расставьте в HTML ключевые последовательности — строки, которые при рабте TextCMS заменяются на реальное содержимое. В настоящее время используются следующие ключевые последовательности:
    • ##CONTENT# — основная последовательность, которая должна быть в любом шаблоне. На ее место вставляется собственно текст Web-страницы.
    • <!--##DEBUG#--> — отладочные сообщения, если отладочный режим включен. При отсутствии этой последовательности они выводятся непосредственно перед тегом </body>
    • <!--##COPYRIGHT#--> — copyright-сообщение движка. В случае его отсутствия выводится перед тегом </body>
    • ##PAGE_NAME# — название текущей страницы сайта (может вставляться в любое место, включая тег TITLE).
    • ##SITE_NAME# — название сайта (может вставляться в любое место, включая тег TITLE).
    • <!--##STATS#--> — статистика времени выполнения скрипта. Необязательная последовательность.
    • <!--##JAVASCRIPT#--> — вставляет теги для подключения JavaScript-файлов, запрошенных модулями. Должен быть в секции </head>.
    • <!--##CSS#--> — место вставки ссылки на CSS. Должна находиться в секции <head>. Необязательная последовательность в случае, если CSS-стили встроены прямо в шаблон.
    • ##block[модуль_функция,параметры]# — вызывает функцию с именем модуль_функция из модуля модуль и вставляет в данное место возвращенное этой функцией значение. В случае отсутствия модуля блок оказывается пустым, а в отладочное сообщение выдается информация о том, что такого модуля нет. Если указано только имя модуля, вызывается функция модуль_main. Параметры перечисляются через запятую, в случае их отсутствия запятую после функция можно не ставить. (Пример: ##block[menu]# — вставка одноуровневого динамически генерируемого меню.)
    • ##url[адрес]# — преобразует адрес относительно корня CMS в адрес относительно корня сайта, что требуется при включенной поддержке URL, когда не известен путь, куда будет установлена CMS. Например, ##url[template/images/pic.gif]# в случае если TextCMS установлена в каталог /textcms/, будет преобразовано в /textcms/template/images.gif. Используйте эту ключевую последовательность для ссылки на файлы графики и другие статические файлы.
    • ##hurl[адрес]# — преобразует адрес в HURL станицы, построенный в соответствии с выбранным в данный момент режимом построения HURLs. Используйте для ссылки на другие Web-страницы сайта.
    • ##include[файл]#— вставляет вместо себя содержимое файла файл, который должен находиться в каталоге данного стиля (т. е. там же, где лежит template. htm). Это единственная директива, которая обрабатывается рекурсивно!
  3. Создайте в каталоге templates каталог с названием шаблона (желательно без символов кириллицы и пробелов во избежание проблем с кодировками).
  4. Скопируйте статический HTML-файл в этот каталог под именем template.htm, а CSS-файл (если он есть) — под именем style.css.
  5. Название нового шаблона появится в списке стилей в настройках «стиля по умолчанию» в параметрах сайта, а также в настройках новых страниц. Задайте его там, где это вам необходимо. После этого страница станет отображаться уже в новом стиле.
» » Интеграция шаблона сайта