Участник:Виталик Штепсель/Абсурдопедия:Техническое руководство
 |
Это незаконченное техническое руководство Быть может, автор ленивая задница. Вы можете помочь Абсурдопедии, дав ему пинка.
|
 |
Это просто черновик руководства, пока что он официально не принят. Но шаблон поставил какой-то дурак. Приносим извинения за причинённые неудобства.
|
Это официальное техническое руководство™, предназначенное для тех, кто создаёт и редактирует шаблоны, для тех, кто загружает файлы, для админов, для шпионов с других википроектов, желающих внаглую стащить это руководство к себе и для прочих любопытных носов и глаз.
Оформление кода[править]
 |
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
CSS[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
- Не стоит использовать устаревшие свойства и значения свойств CSS. Не буди Ктулху, пока оно тихо.
Комментарии[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Пример[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
/* Шапка портала
*/
.portal-header-box {
background-color: black;
color: white;
border: 2px solid white; /* с такой границей нормально смотрится */
}JS (JavaScript)[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Комментарии[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Вики-разметка[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Глобальные страницы пространства MediaWiki (CSS и JS)[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Глобальные страницы пространства MediaWiki — это Common.css, Common.js и другие, подробный список есть в документации Mediawiki: Interface/Stylesheets и Interface/JavaScript.
Как правило размещать в глобальных страницах стоит только тот код, который используется практически везде. В остальных случаях лучше использовать стили шаблонов или гаджеты.
Гаджеты[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Список гаджетов прописывается на странице MediaWiki:Gadgets-definition (редактировать могут только админы). Подробная информация по гаджетам есть в официальной документации к расширению Gadgets.
Обычно у гаджета может быть таблица на языке CSS и скрипт на языке JavaScript.
Шаблоны[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Список шаблонов для использования в статьях есть на странице Абсурдопедия:Шаблоны.
Базовые шаблоны[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Конкретные информационные и тому подобные шаблоны лучше делать не с нуля, а на основе базовых шаблонов:
- {{Ambox}}
- {{RightBox}}
- {{Userbox}}
- {{Message}}
- {{Right-uppermost image}}
и прочих…
Стили CSS и параметры HTML[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
- Не стоит использовать устаревшие параметры элементов.
- Не стоит использовать устаревшие свойства и значения свойств CSS.
- Лучше всего прописывать свойства CSS в классах на отдельной странице с CSS-кодом шаблона и подключать её через расширение TemplateStyles.
Пример использования TemplateStyles[править]
На странице шаблона вставляется тег templatestyles:
<templatestyles src="Шаблон:MyCoolTemplate/styles.css" />Где вместо MyCoolTemplate следует указать имя шаблона.
У шаблона создаётся подстраница /styles.css, там и прописывается CSS-код для стилей.
Документация к шаблонам[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
В шаблонах следует делать ссылку на документацию через шаблон {{doc}}, например:
<noinclude>{{doc}}</noinclude>В самой документации стоит указать:
- Шаблон {{docpage}} — просто потому что надо, и всё тут.
- Зачем нужен шаблон, где его использовать;
- Какие у шаблона параметры (через список);
- Примеры использования;
- При необходимости — дополнительную техническую информацию: как реализован шаблон, где лежат стили CSS, и так далее.
Пример[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
В качестве примера можно глянуть на документацию шаблона {{Цитата}}: {{Цитата/doc}}.
Порталы[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Ненавижу порталы!~ Геральт про трудности работы с вики-разметкой
Порталы должны лежать в пространстве имён «Портал:» (Правда, что-ли?).
Оформление порталов и заглавной страницы[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Файлы[править]
|
Этот раздел ещё не готов. Тот, кто поставил здесь этот шаблончик, уже почти придумал, что написать. Но решил пока попить чаю.
|
Для файла следует указывать лицензию (это можно сделать через выбор на странице загрузки), а если он откуда-то взят, то хорошо бы и источник, иначе придёт авторское право с бейсбольной битой, аки Фрэнки Ниагара из Max Payne.