Организация шкур, перечни файлов и краткий алгоритм создания
Шаблоны шкуры
Ключевое для переделки
| html.html | Основной шаблон, определяющий какие доп. css подключать и скрипты и всё такое |
| record.html |
Заглавный шаблон работы с одной записью, использует следующие подшаблоны:
- record.announce.html — для размещения информации об анонсах документа
- record.ref.html — панели рефов, публикации в сообществах, модеративные
- record.stats.html — набор шаблонок, используемых для формирования заголовка записи
Все они используются из магиков шкуры и, будучи оттуда удалены, удаляются и из шкуры |
| comments.show.tree.html | Отображение дерева комментариев |
Шаблоны, появившиеся в шкуре МИНИКУИ только для удобства
| copyrights.html | вынесенный из record.html блок копирайтов |
| journal.head.html | вынесенный оттуда же блок шапки журнала, собираемой соотв. магиком |
| panel.html | шаблоны типовых панелей, используются магиками опять |
Поправить HTML
| profile.html | Шаблон сборки страницы профиля — kuso@npj:profile |
| user_pictures.html | Шаблон сборки страницы юзерпиков — kuso@npj:profile/pictures |
В большинстве случаев это править не придётся
| 404.account.html | Как выглядит сообщение о том, что такого аккаунта нет |
| 404.record.html | Как выглядит сообщение о том, что такой записи нет |
| 404.common.html | Как выглядит сообщение о том, что чего-то нет в общем виде |
| forbidden.common.html | Как выглядит сообщение о том, что доступ запрещён по какой-то причине |
| roubric.html | Так выводится ключ-слово — снизу дописываются связанные с ним записи * |
| comments.html | Разнообразные значения, принимаемые строкой внизу записи, говорящей о том, есть ли у неё комментарии, сколько, можно ли комментировать |
| friends.html | Дизайн ленты корреспондентов может отличаться от записи, но сейчас он такой же как record.html |
| versions.diff.html | Оформление результатов сравнения версий * |
| versions.one.html | Оформление отображения одной версии * |
* — помеченные звёздочкой вставляются внутрь record.html вместо тела записи.
Магики шкуры
Все магики тем или иным образом вызываются из шаблонов, поэтому их набор строго говоря произволен.
Странные
- CommunityJoin.php — не знаю зачем нужен. Придётся разобраться
Те, что рождены дизайном MINIKUI
Панели и меню
- NodeMenu.php — вывод меню из четырех основных ссылок по узлу в шапку
- ControlPanel.php — вывод управляющей панели внизу
- NovicePanel.php — вывод панели для новичков справа (с лампочкой)
- UserMenu.php — вывод юзерского меню рядом с панелью для новичков
- ContextMenu.php — вывод контекстного акшна под панелью для новичков
- PrintMenu.php — вывод сервисного меню (сейчас забит)
Сложное оформление
- JournalHead.php — вывод шапки журнала — для разных журналов разные основные закладки
- UserInfo.php — вывод блока с информацией о том, кто вы. Вы — kuso@npj
- TextSearch.php — форма текстового поиска сразу под тем кто мы.
Отладочные
- Debug.php — используется разработчиками, чтобы выводить какую-нибудь вспомогательную информацию
- KeepAlive.php — раньше использовался, чтобы сессия не падала, а теперь — чтобы делать запрос в систему статистики
Организующие сборку шапочной/подножной части записи
- RecordRef.php — вывод нижних или кажется верхних рефов, вызывает следующий
- RecordStats.php — вывод блока с информацией об записи — это в шапке записи. Кто когда менял её, всё такое.
Алгоритм создания новой шкуры
- Копирование существующей
- Новый «оформительский» CSS практически с нуля
- Картинки практически с нуля, возможно использование того, что есть, если оно подходит
- Переделка ключевых шаблонов, затирание «шаблонов для удобства», если они мешаются
- Правка прочих CSS-ов
- служебный нужен, чтобы легко переоформлять шаблоны, html которых в рефакторинге не нуждается
- вики-ксс — его нужно править, чтобы задавать оформление внутри тела страницы
- actions css описывает оформление actions. В большинстве случае actions не нуждается в рефакторинге HTML
- Тестирование и вылизывание дыр
Как используются магики и нужно ли
- Для каждой шкуры придётся писать свои магики
- Эти магики будут использовать SkinUtility, если выводят что-то сложное
- Магики писать просто, если вы умеете их писать.
версия
