Sanitarium WebLoG - документация

Документация:

WebScript.Ru Network

||Редактируем шаблоны

Самый хороший вариант - это сохранить где-нибудь шаблон, поставляемый с системой, потом открыть его файлы и повозиться с этим полуфабрикатом. Там использованы далеко не все возможные спец.теги ,но будет наверняка легче разобраться что к чему, а список тегов и их описание приведены ниже (каждый шаблон обладает определенным списком возможных тегов, например в шаблоне index.txt не получится использовать тег <%related%>, который выводит ссылки по теме для статьи и т.д.)
Перед тем, как перейти к конкретным шаблонам и спец. тегам, нужно рассказать о нескольких группах тегов - авторских, категорий и тегах конфигурационных, впоследствии, когда речь пойдет о конкретных шаблонах

|| include файлов

Вы можете включать (include) в шаблон содержимое других файлов (эти файлы вы должны поместить в папку: template/include)
Встретив в шаблоне строку примерно такого вида: <%include=myfile.txt%> система открывает файл myfile.txt (который лежит в папке template/include) и вставляет его содержимое в шаблон. Удобно применять для стандартных элементов (или баннеров). Подключаемый файл может содержать спец.теги - обработка происходит уже после подключения сторонних файлов.
Разумеется, имя файла и расширение может быть любое, только не стоит ставить никаких пробелов.

include возможен на таких шаблонных файлах: index.txt, search.txt, article.txt, print.txt, mail.txt, view_comments.txt.
В других шаблонных файлах он не обрабатывается (т.к. оставшиеся - это шаблоны отвечающие за мелкие детали).

|| Авторские теги

<%name%>- имя автора
<%author%> - идентификатор автора (не имя!, а нечто вроде auth1), если автор не зарегистрирован, то будет имя.
<%author_foto%> - фото автора (если оно есть)
<%mail%> - e-mail автора (если есть)
<%www%> - www автора
<%signatures%> - сигнатуры автора

Данные теги доступны в шаблонных файлах: preview.txt, article.txt

|| Конфигурационные Теги

<%site_title%> - название сайта
<%public_url%> - URL директории со страницами Sanitarium WebLoG
<%index_url%> - URL индексной страницы системы (по сути тоже самое, что и public_url)
<%view_cgi_url%> - урл к скрипту view.cgi. Очень полезный тег, например если вы используете поиск, то форма поиска ссылается к нему, можно прописать:
и т.д.
<%foto_url%> урл папки, содержащей фото авторов.
<%img_url%> - пример использования см. выше при <%cat_id%>
<%comment_url%> - URL к comments.cgi Это на самом деле не весь список, реально вы можете использовать больше, но нужно ли? На всякий случай, вот полный список: <%site_title%>, <%public_url%>, <%index_page%>, <%ext%>, <%index_url%>, <%entry_per_page%>, <%static_pages%>, <%data%>, <%tmpl_dir%>, <%use_flock%>, <%public_dir%>, <%view_cgi_url%>, <%view_comments%>, <%how_news%>,<%foto_url%>
Т.е. бОльшая часть cfg.cfg - заменяются они как раз тем, что вы там в конфиге написали. Эти теги могут быть использованы во всех шаблонных файлах, кроме comments.txt и view_comments.txt

|| Теги категорий

<%cat_id%> - идентификатор категории (число)
<%cat_name%> - название категории
<%cat_description%> - то, что вы напишете в описании категории (в том числе и HTML)
<%meta_description%> - <%cat_description%>, но без HTML тегов (они вырезаются)
<%cat_keywords%> - ключевые слова категории
<%template%> - используемый шаблон
http://<%public_url%>/<%cat_id%> - URL категории