Справка:Продвинутое редактирование

Тут пишется про продвинутое редактирование текста на движке MediaWiki в общем и на нашем тропопроекте Posmotrelisu в частности.
Если вы новичок во всём этом, то для начала изучите страницу Справка по редактированию.

Предполагается, что тут у нас курс молодого бойца. Поэтому материалы, как правило, расположены в порядке возрастания сложности. Советы, вопросы и критика приветствуются.

Легенда:

• Расширение – для работы требуется расширение. Без него на вашей вики код работать не будет.
• Шаблоны – функционал работает с помощью шаблона. Требуется установка шаблона на ваш вики-проект.
• JS – для работы требуется прописать JS-код на страницу MediaWiki:Common.js на вашей вики.
• СSS – для работы требуется прописать CSS на страницу MediaWiki:Common.css на вашей вики.
• Если ничего не указано, то это базовый функционал движка MediaWiki.

Особенности работы шаблонов

Раскрыть текст

В шаблонах есть 2 вида параметров:

• Именнованые — для использования надо задать с помощью знака =. Например, так {{Название шаблона|параметр_шаблона= какое-то значение…
• Неименнованные — идут последовательно в шаблоне. Пример {{Название шаблона|параметр1|параметр2|параметр3…

Таким образом, если в неименнованном параметре встречается знак =, то вики-движок воспринимает выражение как именнованный параметр.

Пример с ошибкой:

• {{q|Крестокрылы отстой|(=)}}

«	Крестокрылы отстой	»

Как видите, подпись СИД-истребителя почему-то потерялась, как и Звезда Смерти. Есть 3 способа как обойти проблему.

• Обратиться к неименнованному параметру как к именнованному по его номеру.

  {{q|Крестокрылы отстой|2=(=)}}

«	Крестокрылы отстой	»
— (=)

• Использовать именнованный параметр, который может быть в шаблоне как раз на такой случай.

  {{q|Крестокрылы отстой|sign=(=)}}

«	Крестокрылы отстой	»
— (=)

Этот способ подразумевает, что в шаблоне можно использовать именнованные параметры вместо неименнованных. Если это не так, обратитесь к админам, чтобы они улучшили шаблон.

• Экранировать символ = с помощью шаблона {{=}}

  {{q|Крестокрылы отстой|({{=}})}}

«	Крестокрылы отстой	»
— (=)

Обратите особое внимание на {{=}}. Экранированный знак равенства по умолчанию есть в версиях MediaWiki 1.39 и выше. В иных версиях надо самостоятельно делать соответствующий шаблон.

Вкладки (шаблоны)

ПримерРезультат

{{Вкладки
|Лор|
* [[Антисеттинг]]
* [[Магия]]
|Роли|
* Злодей британец
* Конченный идиот
* Пубертатная язва
|Актёры|
* Трус
* Балбес
* Бывалый
}}

ЛорРолиАктёры

• Антисеттинг
• Магия

• Злодей британец
• Конченный идиот
• Пубертатная язва

• Трус
• Балбес
• Бывалый

---

Используется для группировки информации. Чаще всего, вероятно, вы могли видеть шаблон в действии на главной странице проекта.

Здесь же шаблон упомятут в самом начале, чтобы было понятно, как сделаны примеры в следующих разделах.

Волшебные слова

Основная статья по теме.

Если вкратце, волшебные слова выводят различную информацию. Название страницы, текущий год, неделю, месяц, и т.д.
Есть ещё слова, меняющие отображение страницы и пр.

Обычно сами по себе они малополезны, но в комбинации с другими элементами волшебные слова незаменимы при создании различных приколюх.

Пример №1Результат № 1Пример № 2Результат № 2

Сегодня на дворе {{CURRENTMONTHNAME}}

Сегодня на дворе сентябрь

Я {{#expr: {{CURRENTYEAR}} - 2003}} года жду выхода Half Life 3!

Я 23 года жду выхода Half Life 3!

Форматирование (расширение)

Если вам нужно без лишних сложностей написать текст без лишних отступов и <br>, то используйте теги <poem> … </poem>

ПримерРезультатЧто будет без тега

<poem>
Замученный дорогой
Я выбился из сил
И в доме лесника я
Ночлега попросил
С улыбкой добродушной
Старик меня пустил
И жестом дружелюбным
На ужин пригласил
</poem>

Замученный дорогой
Я выбился из сил
И в доме лесника я
Ночлега попросил
С улыбкой добродушной
Старик меня пустил
И жестом дружелюбным
На ужин пригласил

Замученный дорогой Я выбился из сил И в доме лесника я Ночлега попросил С улыбкой добродушной Старик меня пустил И жестом дружелюбным На ужин пригласил

---

Для работы нужно расширение Poem. Оно есть в поставке Медиавики. Так что его надо просто включить.

P.S.
Если что, в примере начало песни «Лесник» от группы «Король и Шут».

Рандомное содержимое (расширение)

Выводит на странице случайной содержимое, которые вы заранее задали.

Для чего можно использовать:

• Мелкие советы.
• Случайные приветствия.
• Разнообразие оформления.

ПримерРезультат

Рандомная цитата:
<choose uncached>
<option>{{q|Используй мои ловушки, но смотри сам не попадись в них|Отец Григорий, Half Life 2}}</option>
<option>{{q|Синие тарелки красивые но коричневые прослужат дольше|Обыватель Морровинда}}</option>
<option>{{q|Порой я задумываюсь, может быть я не прав? Но, видя такую отупевшую рожу, я понимаю – надо идти до конца|Хакер, Код доступа: Рай}}</option>
<option>{{q|pre=1|Работа не волк. 
Никто не волк. 
Только волк — волк|Приписывается Стэтхему}}</option>
<option>{{q|pre=1|Женись непременно.
Попадется хорошая жена — станешь счастливым. 
Плохая — станешь философом|Сократ}}</option>
</choose>

Рандомная цитата:

«	Синие тарелки красивые но коричневые прослужат дольше	»
— Обыватель Морровинда

---

Перезагруите страницу для иного результата.

Боевые примеры можете увидеть в статьях Неизвестность пугает больше, Проблема Тома Бомбадила и Factorio.

Чтобы функционал был на вашей вики, подключите расширение RandomSelection.

NB: Желательно не использовать внутри тега ссылки. Это может мешать поисковикам в их работе.

Скрытый текст

В MediaWiki зашит механизм для сокрытия текста. За это отвечают классы

• mw-collapsible — даёт элементу возможность свернуться
• mw-collapsed — делает элемент по умолчанию свёрнутым.

Простейший пример:

КодРезультат

<span class="mw-collapsible mw-collapsed" >Свёрнутый текст</span>

Свёрнутый текст

---

Как можно заметить, специфическая приблуда, ориентированная больше на таблицы. Но это только начало. Ведь дальше начинаются цыганские фокусы.

Можно задать особый класс вида mw-customtoggle-blablabla. После можно в теге, где есть классы mw-collapsible и mw-collapsed указать id mw-customtoggle-blablabla. Ничего непонятно? Ну, рассмотрим на примере:

КодРезультат

<span class="mw-customtoggle-clickme">Кликни на меня, чтобы увидеть скрытый текст</span>

<span class="mw-collapsible mw-collapsed" id="mw-customcollapsible-clickme"><span class="mw-collapsible-content">Свёрнутый текст</span></span>

Кликни на меня, чтобы увидеть скрытый текст Свёрнутый текст

---

Примеры использования можно глянуть в статьях Экзистенция и ВандаВижен.

details и summary (шаблоны/расширение)

Для скрытия информации также можно использовать Шаблон:Скрыто. В отличие от варианта выше функционал работает на тегах HTML, которые подавлены в стандартном вики-движке.

Простейший кодРезультат

{{Скрыто
|Тут скрытый текст
}}

Тут скрытый текст

Таблицы

Таблицы, как правило, нечасто используются пользователями на вики-проектах. Чаще они юзаются разработчиками шаблонов. Например, шаблон цитат.

В МедиаВики есть 2 способа задания таблиц:

1. С помощью встроенной вики-разметки.
2. Непосредственно html-кодом.

NB: Внимание, таблицы созданные с помощью html обрабатываются парсером вики-движка иначе – в частности, такие таблицы ломают отображение списков. Это, кстати, та причина, по которой шаблон Q сделан с помощью вики-разметки.

Вариант с вики-кодом:

{| class="wikitable"
|- 
|В || '''В'''ысшее
|- 
|У || '''У'''чебное
|- 
|З || '''З'''аведение
|}

В	Высшее
У	Учебное
З	Заведение

Вариант с html:

<table class="wikitable">
<tr>
<td>В</td>
<td>'''В'''ысшее</td>
</tr>
<tr>
<td>У</td>
<td>'''У'''чебное</td>
</tr>
<tr>
<td>З</td>
<td>'''З'''аведение</td>
</tr>
</table>

В	Высшее
У	Учебное
З	Заведение

Если вам требуется вставить таблицу с кучей данных на Posmotrelisu, то лучше воспользоваться шаблоном Таблица с ключами. За счёт параметризации полученные таблицы удобнее поддерживать в актуальном состоянии.

Рамка вокруг изображения (CSS)

Для создания миниатюры при указании файла обычно используются параметры thumb, frame или frameless. Но иногда хочется поиграться с размером изображения.

Для этого можно вставить параметр class=insertwidth вмести с тегами <div>...</div> и некоторыми параметрами стиля.

Кусок кода из MediaWiki:Common.css

/* Для встройки изображений  */
img.insertwidth {
    width: 100%;
    height: auto;
}

---

Пример 10-процентной гипножабы)

<div style="float: right; width:10%; " >
[[Файл:Гипножаба.gif|справа|class=insertwidth]]
</div>

---

Пример 15-процентной гипножабы)

<div style="float: left; width:15%; " >
[[Файл:Гипножаба.gif|cлева|class=insertwidth]]
</div>

---