Первые шаги
Эта страница является одновременно и документацией, и навигацией по реальной конфигурации. На вашем новом Rext-сайте, она будет постоянно доступна по адресу ThisSite.ThisSite.
Первым делом
Если вы только что создали этот сайт, сначала установите новый пароль в файле /local/config-ThisSite.php и авторизуйтесь в системе. Вы увидите, что у некоторых элементов сайта появились кнопки управления.
Общие настройки
Основные настройки сайта
Основные настройки сайта находятся на странице ThisSite.Config.
Настройка главного (верхнего) меню
Настройка главного меню производится здесь: ThisSite.MainMenu. Отредактируйте существующее меню, а для создания многоуровнего меню используйте исходный код ThisSite.MainMenu-Template в качестве примера.
Создание бокового меню
Чтобы создать боковое меню сайта, создайте страницу ThisSite.Aside и опишите его прямо там. Можете взять Aside-Template в качестве основы. Созданное меню будет общим для всех страниц сайта. Создавая страницы вида ThisSite/Aside-{$Group}-{$Name},ThisSite/Aside-{$Group}, вы можете генерировать дополнительные независимые меню для соответствующих Групп или Страниц.
Дополнительные меню этого сайта:
Как только вы создадите ThisSite.Aside, у вашего сайта появится боковое меню, в режиме редактирования появится вкладка Карта сайта, содержащая то же меню. В дальнейшем, по мере роста сайта, вы можете отредактировать ThisSite.EditModeSiteMap и сделать более удобную Карту Сайта.
Шаблоны представления контента
PmWiki позволяет шаблонизировать представление собственных страниц, причем сами шабоны также являются обычными страницами:
- ThisSite.GroupsContentTemplates — шаблоны, применяемые при добавлении новых страниц, или при их полном выводе;
- ThisSite.PageListTemplates — шаблоны, применяемые при листинге нескольких страниц с помощью PmWiki:Pagelist ;
- ThisSite.CommentsTemplates — шаблоны, необходимые для реализации Комментариев, оставляемых посетителями сайта, см. Cooks:Comments
Настройки режима редактирования
Расширенный режим редактирования — основное преимущество Rext-сборки над ядром PmWiki. Он предоставляет набор возможностей, существенно упрощающих редактирование страниц при долгосрочном развитии сайта. В режиме редактирования экран разделен на две части. Первая содержит поле для редактирования кода страницы, второе — вспомогательная панель с набором функционалов, упрощающих работу с кодом.
Основные настройки режима редактирования
Основные настройки расположены на странице ConfigEditMode и позволяют включать и выключать функционалы режима редактирования в целом.
Настройки действий со страницей
Расположены на странице PageActions и определяют набор кнопок, доступных редактору сайта при обычном просмотре страниц.
Настройки поля редактирования кода страницы
Расположены на странице EditForm и позволяют изменять основное поле для работы с кодом страницы.
Настройки вспомогательной панели
Расположены на странице HelpDesk и позволяют изменять содержимое вспомогательной панели, т.е. включать и выключать табы с дополнительным функционалами.
Некоторые дополнительные также можно настроить:
- EditModeSiteMap — здесь можно отредактировать метод генерации "Карты Сайта" для режима редактирования, позволяющего удобно вставлять ссылки на другие страницы сайта в код текущей страницы.
- SyntaxMap — здесь определено содержимое вкладки "Синтаксис", позволяющей «держать под рукой» большую часть доступных к применению синтаксических конструкций.
Модальная форма добавления страницы:
Расположена на странице AddObjectModalForm и содержит код всплывающеего при создании новой страницы модального окна.
Вспомогательные страницы
ThisSite.Info — эта страница содержит сводную информацию о сайте. Рекомендуется фиксировать на ней все произведенные существенные программные модификации движка сайта, а также формировать Todo-листы — планы по развитию ресурса.
ThisSite.Resources — на этой странице рекомендуется размещать общие для всего сайта ресурсы: картинки и другие файлы, которые предполагается использовать на многих страницах.
SiteAdmin.NotifyList страница с настройкой автоматических email-оповещений о событиях на сайте (см. Notify)
Советы
Если вы делаете сайт с уникальным дизайном, возможно стоит переименовать pub/skins/thisSite/ во что-то уникальное. Придумайте название и просто переименуйте директорию и все вложенные файлы, в имени которых есть thisSite.
Зачем?
- чтобы не путаться с одинаковыми файлами, если у вас будет несколько сайтов на PmWiki;
- чтобы можно было скопировать/выложить в общий доступ разработанный скин, не опасаясь конфликтов.