Просмотр кода страницы Lurkmore:Шаблоны

'''Шаблоны''' в первом приближении являются автоматизированным копипастом. Однако они позволяют невозбранно достичь
большего, чем позволяет копипаст. А ещё говорят, что они [[brainfuck|полны по Тьюрингу]].
[[Быдлокодер|Разработчикам ПО]] это может [[C++#Шаблоны|что-то напоминать]].

Следует обратить внимание на то, что шаблоны могут не только копипастить текст, но и оказывать другое влияние на страницу, в частности, относить её к какой-либо категории.

== Как луркать ==
Язык разметки, включая разметку шаблонов, описан на [http://www.mediawiki.org сайте MediaWiki.org]. Там описаны различные версии медиавики и различные расширения. Наша версия {{CURRENTVERSION}} (берётся из магического слова, см. код страницы), а из полезных для разметки расширений имеются [http://meta.wikimedia.org/wiki/ParserFunctions ParserFunctions] и [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite]. Так-то!

Кстати, [[ENGLISH MOTHERFUCKER DO YOU SPEAK IT|понимаете ли вы по-английски]]?

Шаблоны же находятся непосредственно здесь, в [{{fullurl:Special:AllPAges|namespace=10}} пространстве имён «Шаблон»].
Участник, даже если он [[Анонимус]], может невозбранно создать собственный или отредактировать имеющийся шаблон. Ну, кроме защищённых названий.

== [[How do I shot web|Как вставлять]] ==
Шаблоны вставляются двойными фигурными скобками. Вот такое {{tc|TeX}} вставляет в текущую страницу содержимое страницы [[:Шаблон:TeX]], и получается вот так: {{TeX}}. «Шаблон:» — пространство имён, в котором берутся шаблоны.

Можно вставлять и страницы из других пространств имён, добавив двоеточие в начало — {{tc|:Goatse.cx/ASCII}} вставляет {{NSFW|так|{{:Goatse.cx/ASCII}}}}. Помните про фигурные скобки? Алсо, можно начинать на [[слеш]] для вставки подстраницы: на странице [[Goatse.cx]] можно написать просто {{tc|/ASCII}}. Обычно нет причин держать шаблон не в пространстве имён «Шаблон».

На примере goatse и TeX был рассмотрен просто копипаст, но шаблоны могут быть контекстнозависимыми через параметры и магические слова.

=== Параметры ===
Могут иметь либо порядковый номер, либо имя. Например, {{tp|delete|хуита|todo{{=}}апстена >>}}. Здесь «хуита» — параметр с номером 1, а «апстена >>» — параметр с именем todo. В самом шаблоне они используются как <code><nowiki>{{{1}}}</nowiki></code> и <code><nowiki>{{{todo}}}</nowiki></code> соответственно. Или чаще <code><nowiki>{{{1|}}}</nowiki></code> и <code><nowiki>{{{todo|написать нормальную статью}}}</nowiki></code>. То, что после вертикальной черты, подставляется, если параметр не задан. В одном шаблоне тот же параметр можно использовать любым способом любое число раз.

ACHTUNG: незаданный параметр и пустой параметр — две большие разницы. {{tc|xyz{{!}}}} — первый параметр пустой, {{tc|xyz}} — первый параметр не задан, {{tc|xyz|{{!}}abc}} — второй параметр abc, первый пустой, {{tc|xyz|2{{=}}abc}} — второй параметр abc, первый не задан.

=== Магические слова ===
[http://www.mediawiki.org/wiki/Help:Magic_words Много их]. Некоторые из:

; Имя страницы
{{tc|PAGENAME}}, {{tc|SUBPAGENAME}}, etc. — эти позволяют получить имя текущей страницы в разных форматах.

Не шаблона, а именно текущей. Если шаблон foo вставлен в шаблон bar и всё это вставлено в страницу FUBAR, то {{tc|PAGENAME}}, который находится на foo, выдаст на странице [[FUBAR]] не foo и не bar, а именно FUBAR.

Варианты этого магического слова с примерами, как оно работало бы, находясь на странице <code>Участник:Test/Testspace</code> вот:
{|
|-
! Разметка||Результат
|-
|{{tc|FULLPAGENAME}}
|Участник:Test/Testspace/Place
|-
|{{tc|PAGENAME}}
|Test/Testspace/Place
|-
|{{tc|BASEPAGENAME}}
|Test/Testspace
|-
|{{tc|SUBPAGENAME}}
|Place
|-
|{{tc|SUBJECTPAGENAME}}
|Участник:Test/Testspace
|-
|{{tc|TALKPAGENAME}}
|Обсуждение участника:Test/Testspace
|-
|{{tc|NAMESPACE}}
|Участник
|}

Чтобы использовать имена страниц в ссылках, надо на конце добавлять ещё одно E, например, {{tc|TALKPAGENAMEE}}.

; Дата и время 
{{tc|CURRENTYEAR}}, {{tc|CURRENTMONTH}}, etc. Используются системные настройки. Если нужны ваши дата и время, заданные в настройках пользователя, то CURRENT заменяется на LOCAL.

; Форматирование
* {{tc|lc:БуКаВкИ}} — букавки,
* {{tc|uc:БуКаВкИ}} — БУКАВКИ.
* {{tc|lcfirst:БуКаВкИ}} и
* {{tc|ucfirst:БуКаВкИ}} изменяют только первую букву.

; Арифметика и логика
* {{tc|'''#expr''':''выражение''}} — умеет делать арифметические и логические действия, округлять, возводить в степень, находить логарифм, применять тригонометрические функции. Не умеет [[деление на ноль|делить на ноль]] и находить [[армия|арксинус четырёх]]. Операторы пишутся так же, как на калькуляторе или английском экселе. Очень нужная вещь.

* {{tc|'''#if''':''текст''|''что выдать, если непусто''|''что выдать, если пусто''}} — проверяет, пустой ли текст. Разумеется, с неизменной строкой не очень полезно, и туда как ''текст'' обычно запиливают параметры или магические слова. Например {{tc|#if:<nowiki>{{NAMESPACE}}</nowiki>|Это хуита|Это основное пространство}} — например, используется в {{tp|notcrap}}.

* {{tc|'''#ifeq''':''что''|''чему''|''если равно''|''если не равно''}} — проверяет равенство строк ''что'' и ''чему''. Регистрозависимое, что позволяет юзать вместе со всякими lcfirst. Пример в {{tp|Языки}}, {{tp|Девайс}}.

* '''#switch'''
 <nowiki>{{</nowiki>#switch: ''что''
 | ''равно-чему1''=''выдать1''
 | ''равно-чему2''
 | ''равно-чему3''=''выдать3''
 |#default = ''выдать в остальных случаях''}}

Сравнивает ''что'' с вариантами ''равно-чемуn'' и выдаёт соответствующий результат. В случаях, где нет знака равно, как здесь с ''равно-чему2'', берётся следующий, то есть ''выдать3''. ''равно-чемуn'' или ''выдатьn'' вполне может быть пустой строкой. Применяется дохуя где. Аналог if-then-else.

* {{tc|'''#ifexpr''':''условие''|''если выполняется''|''если не выполняется''}} — очень полезная функция для проверки выполнения условия. В условие можно поставить, например, {{tc|значение1}} < {{tc|значение2}}, то есть все условия, в которых можно применить арифметическую проверку.

[http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions Больше луркать здесь]

=== Теги ===
Некоторые теги имеют отношение к шаблонам:
* &lt;nowiki></nowiki&gt; — отключает обработку шаблонов, как и всю остальную обработку вики-разметки.
* &lt;noinclude></noinclude&gt; — позволяет включить в шаблон что-то, что не будет включено при его подстановке. Полезно для включения шаблона в категорию, документации шаблона, плашек для шаблона.
* &lt;includeonly></includeonly&gt; — позволяет включить в шаблон что-то, что будет включено при его подстановке, но не в самой странице шаблона. На первый взгляд бесполезно, однако может быть нужно прописать категорию к месту включения шаблона, но не к шаблону.
'''Внимание!''' Вики-теги очень чувствительны к переносу строки, поэтому их желательно не отрывать от содержимого.<br />
Например:
<pre><nowiki><includeonly><b>Here be dragons.</b></includeonly></nowiki></pre>
будет нормально;
<pre><nowiki><includeonly><b>
Here be dragons.
</b></includeonly></nowiki></pre>
тоже будет нормально;
<pre><nowiki><includeonly>
<b>Here be dragons.</b>
</includeonly></nowiki></pre>
а это даст пустой параграф (<p>) до и после Here be dragons.

=== Мнемоники ===
Чтобы не пихать всё время тег &lt;nowiki>, особенно если нужно сослаться лишь на одиночный тег или символ без обработки или вставить юникод-символ, который с клавы сложно набрать, достаточно произвести замену спецсимвола на его аналог. Например:

{| align="center" border="2px"
! Символ !! Назначение !! Мнемоника !! Код
|-
| [ || левая квадратная скобка || || &amp;#91;
|-
| ] || правая квадратная скобка || || &amp;#93;
|-
| < || левая угловая скобка, знак меньше || &amp;lt; || &amp;#60;
|-
| > || правая угловая скобка, знак больше|| &amp;gt; || &amp;#62;
|-
|   || неразрывный пробел || &amp;nbsp; || &amp;#160;
|-
| & || амперсанд|| &amp;amp; || &amp;#38;
|-
| « || левая угловая кавычка || &amp;laquo; || &amp;#171;
|-
| » || правая угловая кавычка || &amp;raquo; || &amp;#187;
|-
| ' || одинарная кавычка || &amp;apos; || &amp;#39;
|-
| " || двойная кавычка || &amp;quot; || &amp;#34;
|-
| ‘ || одиночная левая кавычка-лапка|| &amp;lsquo; || &amp;#8216;
|-
| ’ || одиночная правая кавычка-лапка|| &amp;rsquo; || &amp;#8217;
|-
| “ || двойная левая кавычка-лапка|| &amp;ldquo; || &amp;#8220;
|-
| ” || двойная правая кавычка-лапка || &amp;rdquo; || &amp;#8221;
|-
|  ́ || аку́т, знак ударения|| || &amp;#769;
|-
| £ || фунт || &amp;pound; || &amp;#163;
|-
| € || евро || &amp;euro; || &amp;#8364;
|-
| ¥ || иена || &amp;yen; || &amp;#165;
|-
| ƒ || знак функции || &amp;fnof; || &amp;#402;
|-
| ∀ || всё множество|| &amp;forall; || &amp;#8704;
|-
| ∃ || существует || &amp;exist; || &amp;#8707;
|-
| ∅ || пустое множество || &amp;empty; || &amp;#8709;
|-
| ∂ || частичный дифференциал|| &amp;part; || &amp;#8706;
|-
| ∑ || сумма || &amp;sum; || &amp;#8721;
|-
| √ || квадратный корень или радикал || &amp;radic; || &amp;#8730;
|-
| ∫ || интеграл || &amp;int; || &amp;#8747;
|-
| ∠ || угол || &amp;ang; || &amp;#8736;
|-
| ∞ || бесконечность || &amp;infin; || &amp;#8734;
|-
| [[Æ]] || заглавная латинская лигатура || &amp;AElig; || &amp;#198;
|-
| [[æ]] || строчная латинская лигатура || &amp;aelig; || &amp;#230;
|-
|}

Мнемоники и коды взаимозаменяемы. '''Обратите внимание, что мнемоники игнорируют любое вики-форматирование.''' Больше луркать [[:w:Мнемоники в HTML|здесь]].

=== Фичи ===
* Вложенность — да.
* [[Рекурсия]] — да.

=== Комментарии ===
В вике используются html'ные комментарии:<br />
<pre><nowiki><!-- Здесь был Вася. --></nowiki></pre>
При создании своего [[Неведомая Ёбаная Хуйня|премудрого шаблона]] обязательно надо писать, как он работает! Для юзеров есть шаблон {{tp|doc}}, а для [[программист|интересующихся]] есть комменты. Хорошие комменты растят [[fallout|карму]], я гарантирую это!

== Какие шаблоны есть ==

=== Плашки ===
{{main|ЛМ:плашки}}

=== Шаблоны-списки ===
Версия «см. также», обладающая большей функциональностью. Также её проще поддерживать — достаточно добавить ссылку в шаблон, а не искать все статьи, куда её нужно добавить. Алсо, навязывает категории, которые обычно лень проставлять. Словом, [[кошер]]ная вещь. Полный список [[:Категория:Lurkmore:Шаблоны:Списки|здесь]].

=== Прочие полезности ===
* {{tp|tp}} — кошерно сослаться на шаблон
* {{tp|NSFW|title=''название''|content=''содержимое''}} — скрывает NSFW-контент типа [[Гуро]], [[Goatse]], [[говно|tubgirl]]. На самом деле [[NSFW]] чаще скрывает говно, на которое не стоит [[tl;dr|тратить время]]. Параметр ''title'' можно опустить. Используются также неименованные значения.
: {{tc|NSFW|title{{=}}высер|content{{=}}{{tp|хуита}} … }} — здесь плашка сломается, первый символ после знака равенства не должен быть {. Вот так, [[например]], обходится: {{tc|NSFW|title{{=}}высер|content{{=}}<nowiki><nowiki></nowiki>{{хуита}}</nowiki> … }}
: <nowiki>[[Файл:Example.jpg|thumb|NSFW]]</nowiki> — скрывает изображение с шок-материалом, вместо него пишется надпись «not safe for work». Изображение становится видно, если на него один раз кликнуть.
* {{tp|Spoiler}} — {{Spoiler|да, таки действительно спойлер}}.
* {{tp|video}} — вставка видео с [[YouTube]] и не только.
* {{tp|ET}} -
* {{tp|note}} — вставка висящей справа свёрнутой заметки.
* {{tp|Q}}, {{tp|Цитата}} — цитирование. Первый параметр — цитата, второй — автор, автор по умолчанию Анонимус. Больше шаблонов [[:Категория:Lurkmore:Шаблоны:Цитирование|здесь]].
* {{tp|Acronym}}, {{tp|Укроним}} — тултип. Acronym для {{Acronym|JAFA|Just Another Fucking Acronym}}, Укроним для {{Укроним|Інших мов|Других языков}}. Первым полезно помечать отдельные слова, вторым — длинные куски текстов.
* {{tp|ascii}} — для оформления [[ASCII-арт]]а моноширинным шрифтом на чёрном фоне.
* {{tp|Lj comm}}, {{tp|Lj user}} — ссылки на ЖЖшку. Другие шаблоны для внешних ссылок [[:Категория:Lurkmore:Шаблоны:Внешние ссылки|здесь]].
* {{tp|lolwhat}}, {{tp|prooflink}}, {{tp|proofpic}} — выражает сомнение{{Lolwhat}} в достоверности информации{{Fact}} в самом тексте. Другие варианты [[Шаблон:R|тут]].
* {{tp|doc}} — для описания к шаблонам. Идея в том, что doc к залоченному шаблону может редактировать даже анонимус.
* {{tp|Main}} — ссылается на основную статью. Как здесь в [[#Плашки]].
* {{tp|Stub}} — для недописанных разделов статьи.
* Остальные [[Категория:Lurkmore:Шаблоны|тут]].


{{Луркоморье|Lurkmore:Справка}}