Шаблон:Портал/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 -->
  | хвост_стиль =
 }}