Шаблон:Портал/doc
Шаблон {{портал}} создаёт страницу портала — главную для всех статей на определённую тему (например, Математика, Физика).
Использование: {{портал}}
— создаёт пустой макет, страницу без текста в две колонки.
Коробочки[править]
И в правую, и в левую колонку надо добавить т. н. «коробочки» — разделы вроде «Избранная статья портала», «Знаете ли вы», «Помогите вот чем:» и так далее. Вам решать, какие коробочки вам нужны, а какие нет.
Параметр лкор1_тип выбирает тип первой коробочки левой колонки, пкор4_тип — тип четвёртой коробочки правой колонки. И так далее. Поддерживается до 9 коробочек в каждой колонке. Нам известны следующие типы:
- featured
- Коробочка для избранной статьи по теме.
- good
- Коробочка для хорошей статьи.
- image
- Избранное изображение.
- doyouknow
- Рубрика «Знаете ли вы, что».
- articles
- Список статей по теме.
- newpages
- Список новых статей.
- cats
- Список всех категорий, относящихся к теме.
- todo
- Раздел «Чем я могу помочь».
- users
- Список авторов статей по теме (участников портала).
Если вы указали какой-то из перечисленных выше типов, то все остальные параметры (для этой коробочки) необязательны — вы получите оформление и заголовок по умолчанию, красную ссылку на страницу содержимого коробочки (со стандартным названием, например, «/Статья2» для хорошей статьи). Некоторые коробочки даже сами сгенерируют содержимое, см. #Автоматическое заполнение.
Если вы указали в поле «тип» что-нибудь другое (рекомендуется значение generic — другое может случайно совпасть с типом, который добавят в будущем), то на помощь нашего умного кода не рассчитывайте :) Хотя иногда это правда нужно — скажем, сделать коробочку «Интересная задача» для портала Математика.
Итак, какие ещё у коробочки параметры (для примера выберем первую коробочку слева, то есть лкор1)?
- лкор1_заголовок
- Текст над содержимым коробочки (обведён рамкой).
- лкор1_значок
- Название картинки, которая будет слева от заголовка (всегда размером 20px в ширину).
- лкор1_стиль
- Стиль (CSS) рамки над коробочкой. Вы можете тут указать, скажем, параметры background или border, чтобы изменить оформление. Например, в портале Коммунизм (ну, или марксизм-джедаизм, если точнее) вам может понадобиться покрасить их в красный цвет.
- без_лкор1_править=1
- Укажите этот параметр, чтобы убрать ссылку «[править]» из заголовка коробочки. Например, если у вас есть коробочка для новостей и бот, который её обновляет, то людям эту страницу изменять действительно не нужно.
- лкор1_текст
- Собственно содержимое коробочки. Этот параметр рекомендуется тогда и только тогда, когда оно почти никогда не изменяется. Пример: коробочка «Избранное фото» в портале Портал:Детям, её по задумке не нужно менять. Если указан параметр лкор1_шаблон, то этот параметр игнорируется, если не указан — заодно убирается ссылка [править], которая в этом случае и не нужна.
- лкор1_шаблон
- Самый важный параметр. Это название страницы, на которой хранится содержимое коробочки. Если укажете неизвестный нам лкор1_тип коробочки и при этом не будет параметров лкор1_текст и лкор1_шаблон — коробочка вообще не появится.
- лкор1_стиль_текста
- Стиль (CSS), который будет применён к содержимому коробочки. Тут обычно меняют шрифт (параметры font-size, color, font-family и т. д.). Не рекомендуется задавать здесь границы (параметрами вроде border).
Коробочки под колонками[править]
Можно также создать до трёх «нижних» коробочек под колонками (на всю ширину страницы). Для этого используются параметры вида нкор1_тип.
Использование таких коробочек не рекомендуется. Они нужны только в том случае, если в портале должно быть что-то, не вмещающееся в колонку (из-за недостаточной её ширины). Например, крупная таблица матчей для портала Спорт.
Оформление портала[править]
Цвета для порталов удобно подбирать по табличке Абсурдопедия:Цвета
Хотя цвета и рамки по умолчанию выглядят довольно нормально (они примерно такие же, как на заглавной странице), настоятельно рекомендуется чего-нибудь там поменять и перекрасить. Как мы уже говорили чуть выше, порталу Коммунизм разумно где-нибудь добавить красные цвета.
Поддерживаются следующие параметры, относящиеся к оформлению.
- общий_фон
- Цвет фона для всей страницы, кроме колонок, шапки и т. п.
- колонка_стиль
- Стиль колонки.
- лколонка_стиль
- Стиль левой колонки. По умолчанию — значение параметра колонка_стиль, если он есть.
- пколонка_стиль
- Стиль правой колонки (аналогично).
- шрифт_обычный=1
- Не применять шрифты Verdana, Arial, Helvetica (по умолчанию они используются во всём портале — используйте этот параметр, чтобы отключить). Для порталов не рекомендуется, зато пригодилось на Заглавной странице.
Цитата[править]
Внутри шаблона цитаты удобно использовать шаблон {{q2}} для оформления. Также используйте теги <choose> и <option>, чтобы показывать случайную цитату из нескольких заготовленных (пример см. в шаблоне {{ЦитатаЗС}}).
Настройки цитаты (располагается над шапкой портала):
- без_цитаты=1
- Не показывать цитату вообще.
- цитата_текст
- Содержимое (только если цитата будет изменяться чрезвычайно редко, иначе используйте следующий параметр).
- цитата_шаблон
- Название страницы, на которой хранится цитата. По умолчанию «/Цитата», если эта подстраница существует, иначе {{ЦитатаЗС}} (то есть те же самые цитаты, что включаются в заглавную страницу).
- цитата_стиль
- Стиль (CSS) для цитаты (тут можно задать рамку, фон, шрифт и т. п.).
Шапка[править]
Шапка (голова портала) находится под цитатой и над колонками с коробочками. На её отображение влияют следующие параметры:
- без_шапки=1
- Не показывать шапку. Не рекомендуется (по соображениям здравого смысла — у каждого портала должна быть шапка; данный параметр введён для того, чтобы шаблон {{портал}} можно было использовать и для других страниц похожего «коробочного» строения, а не только для порталов).
- шапка_текст
- Содержимое шапки. Используйте этот параметр, если оно практически никогда не будет обновляться.
- шапка_шаблон
- Название страницы, на которой хранится шапка. По умолчанию «/Голова портала».
- шапка_стиль
- Стиль (CSS) для шапки.
- шапка_править=1
- Добавить к шапке ссылку [править]. Используйте этот параметр, если её надо довольно часто менять (например, если в шапке указано количество хороших статей по теме).
- без_шапка_обновить=1
- Убрать ссылку [обновить] из шапки. Обычно так делать не надо (разве только для полностью статических порталов, где везде используются параметры коробочек вида лкор1_текст, а не лкор1_шаблон).
Список порталов[править]
Это навигационный шаблон {{Порталы}} прямо под шапкой. Поддерживаются следующие настройки:
- без_списка_порталов=1
- Вообще убрать список порталов. Не рекомендуется.
- список_порталов_внешний_стиль
- Этот стиль (CSS) влияет на внешнюю таблицу, в которой находится список порталов. В частности, тут можно задать внешнюю границу и отступы (параметры вроде margin-top).
- список_порталов_стиль
- Влияет непосредственно на текст — заголовок «Порталы» и сам список. Здесь можно задать фон под текстом или шрифт.
- список_порталов_рамка_стиль
- Этот параметр влияет на рамку между внешней границей списка и текстом. Здесь есть смысл задавать цвет фона и границу.
Хвост портала[править]
Это текст под колонками. По умолчанию вообще отсутствует (и в большинстве порталов не нужен). Используется в основном для включения навигационных шаблонов (см. пример в портале Математика). Параметры:
- хвост_текст
- Просто текст, который нужно показать.
- хвост_шаблон
- Название страницы с содержимым.
- хвост_править
- Добавить ссылку [править] (работает, если указан параметр хвост_шаблон). По умолчанию такой ссылки нет.
- хвост_стиль
- Оформление всего блока.
Автоматическое заполнение[править]
Шаблон {{портал}} настолько умён, что может сам сгенерировать (и будет обновлять без вашего вмешательства) содержимое коробочек users (участники), cats (категории) и articles (статьи), если у них нет свойств лкор1_текст и лкор1_шаблон. Для этого достаточно указать следующие параметры.
- категория
- Название категории, в которой хранятся статьи проекта. Список статей в этой категории отправится в коробочку articles, а список её подкатегорий — в коробочку cats. Например, для портала Математика это Категория:Математика. Сам портал также будет включён в эту категорию, ключ сортировки — «*».
- категория_участников
- Название категории, в которую включены страницы участников портала. Например, для портала Математика это Категория:Участники-математики.
Служебные параметры[править]
- nocat=1
- Убирает страницу из категорий. Дополнительно передаёт параметр nocat=1 шаблону {{Порталы}} и шаблону хвоста портала (хвост_шаблон, если этот параметр указан). Используйте в случаях, если вы применяете шаблон не на странице портала, на черновике, пока портал ещё не готов и т. д.
- экспериментальный=1
- Если нет параметра nocat, то включает страницу в категорию Порталы в разработке.
Заготовка для копирования[править]
{{портал | категория = | категория_участников = | экспериментальный = 1 | общий_фон = | <!-- без_цитаты = 1 --> | цитата_текст = | цитата_шаблон = | цитата_стиль = | <!-- без_шапки = 1 --> | шапка_текст = | шапка_шаблон = | шапка_стиль = | <!-- шапка_править = 1 --> | <!-- без_шапка_обновить = 1 --> | <!-- без_списка_порталов = 1 --> | список_порталов_внешний_стиль = | список_порталов_стиль = | список_порталов_рамка_стиль = | колонка_стиль = | лколонка_стиль = | пколонка_стиль = | лкор1_тип = (generic / featured / good / image / doyouknow / articles / newpages / cats / todo / users) | лкор1_заголовок = | лкор1_значок = | <!-- без_лкор1_править = 1 --> | лкор1_стиль = | лкор1_текст = | лкор1_шаблон = | лкор2_тип = ... | пкор1_тип = ... | пкор2_тип = ... | хвост_текст = | хвост_шаблон = | <!-- хвост_править = 1 --> | хвост_стиль = }}