Редактирование: Справочник автора/MediaWiki

MediaWiki — это открытый сайтовый движок, на котором работает множество википроектов — посмотрелка, википедия, викитропы и пр.

== Серверная часть ==
Тут для работы движка важны по сути '''3 вещи''':
# Интерпретатор php — поскольку php это язык, на котором написана сама MediaWiki. Без комментариев.
# СУБД — система управления базой данных. Именно в ней хранятся правки, статьи, история, ники и прочее. По-умолчанию медиавики в качестве СУБД использует MariaDB или MySQL. Так же поддерживает PostgresSQL и SQLite. В старых версиях поддерживается OracleDB.
# Вебсервер с поддержкой PHP (чаще всего Apache2) — предоставляет файлы сайта для пользователей в интернете. Именно он позволяет получить доступ к сайту его посетителям. Он же может вызывать множество проблем если настроен криво.

От «свежести» этих 3 компонентов зависит какую версию движка можно установить.

'''На что обратить внимание''' будучи на сервере:
* Файл LocalSettings.php — тут содержатся настройки работы медиавики — подключаемые расширения, настройки, интеграция с другими сервисами. В общем, много всего.
* Папка extensions — сюда закидываются расширения, которые планируется установить.
* Папка maintance — тут содержатся скрипты обслуживания медиавики на php. Обновить структуру БД, поменять пароль, много всего.

== Клиентская часть ==
'''NB''': программисты могут смело пропустить, ибо тут общие сведения в основном.

=== HTML ===
HTML — язык гипертекстовой разметки, на котором собственно выводятся все сайты. HTML — это скелет любой страницы, для наведения марафета используется CSS (см. ниже).

В целях безопасности Медиавики поддерживает далеко не все теги. К тому же отдельные расширения добавляют собственные теги, которые отсутствуют в базовом HTML. Например, многим известную связку '''<nowiki><nowiki></nowiki>…<nowiki><&#47;nowiki></nowiki>''' .

=== CSS ===
CSS — каскадная таблица стилей. По сути это, то что превращает голый текст с дозой списков и ссылок в нечто более красивое.

Медиавики по умолчанию поставляется с 3 стилями для проекта. Можно при желании установить и другие.

'''''Что тут есть''''':
* [[MediaWiki:Common.css]] — здесь можно менять общее оформление, а также создавать новые классы CSS для последующего использования в страницах, шаблонах и пр.

Без расширений и ухищрений CSS задается для элементов либо по ссылке выше, либо прямо в html-теге с помощью атрибута '''style'''.

=== JS ===
JavaScript — третий кит современной всемирной паутины. Если HТML это скелет, CSS это внешность, то JS может всем этим управлять, ежели воля программиста на то будет.

'''''Что тут есть''''':
* [[MediaWiki:Common.js]] — тут прописывается js-код, который автоматом подгружается для всех пользователей. Именно сюда записываются разнообразные свистоперделки наподобие реализации шаблона [[Шаблон:Вкладки|Вкладки]]. Доступ к редактированию по умолчанию строго ограничен.
* Пользовательский js-код — позволяет участникам писать свои скрипты на все случаи жизни. На медиавики '''отключен по умолчанию''', поскольку это очевидная дыра в безопасности.

==== jQuery ====
Медиавики по умолчанию подгружает jQuery.

'''jQuery''' — это библиотека на JS, которая фокусируется на взаимодействии JavaScript и HTML. Библиотека jQuery помогает легко получать доступ к любому элементу DOM, обращаться к атрибутам и содержимому элементов DOM, манипулировать ими. Также библиотека jQuery предоставляет удобный API для работы с AJAX.

Если без програмерской зауми, то jQuery упрощает программирование на связке HTML+CSS+JS, но <s>это не точно</s>.

==== Vue ====

== Как тут творить? ==

=== Вики-текст ===
В MediaWiki встроен «язык» позволяющий добавлять различные красивости на страницу — вики-разметка (Wiki markup). Почему в кавычках? Потому что по большому счёту вики-разметка — это надстройка над обычным HTML заменяющая его не понятную большинству нормальных людей систему тегов на более вразумительную (по мнению авторов) систему последовательностей символов. То есть это значит что при большом желании статьи на вики можно форматировать при помощи голого CSS и HTML, что порой приходится делать, когда парсер (часть сайта отвечающая за перевод вики-разметки в HTML и CSS) даёт сбои. Да боже, это даже используется в этом абзаце!<br>

=== Шаблоны ===
{{q|Любая достаточно сложная платформа содержит заново написанную, неспецифицированную, глючную и медленную реализацию половины Common Lisp|Сжатая цитата для иллюстрации подраздела}}

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

В простейшем виде шаблоны умеют только подставлять данные, которые в них передали. Такого функционала явно не хватало и [[По нарастающей|пошло-поехало]].
* Одни начали "ломать" этот язык, используя неочевидную логику шаблонов для работы. Условные ветвления, обход ограничения на рекурсию<ref>Запрет нужен, чтобы страница и сервер не зависли.</ref> – по сути это хакерство<ref>Небольшой ликбез: Хакерство многозначный термин. В данном случае подразумевается использование языка не по прямому назначению, что вызывает сложности в понимании, поддержке и пр.</ref>
* Другие начали подключать расширения, которые добавляли языку шаблонов новые управляющие конструкции. 

==== Синтаксис ====

==== Сложности и ограничения ====

== Основные понятия ==

=== Пространство имён ===
Все страницы на вики разделены по группам называемыми «пространствами имён». Сделано это чтобы люди читающие страницы могли сходу понимать к чему они имеют отношение. Всего на вики изначально таких групп 18, но ничего не запрещает расширениям добавлять новые. Про пространства имён можно почитать [https://www.mediawiki.org/wiki/Help:Namespaces/ru тут]. А [https://www.mediawiki.org/wiki/Extension_default_namespaces тут] можно найти список уже существующих в различных расширениях пространств имён.

=== [[Справка:Справка по редактированию|Язык разметки]] ===
В MediaWiki встроен «язык» позволяющий добавлять различные красивости на страницу — вики-разметка (Wiki markup). Почему в кавычках? Потому что по большому счёту вики-разметка — это надстройка над обычным HTML заменяющая его не понятную большинству нормальных людей систему тегов на более вразумительную (по мнению авторов) систему последовательностей символов. То есть это значит что при большом желании статьи на вики можно форматировать при помощи голого CSS и HTML, что порой приходится делать, когда парсер (часть сайта отвечающая за перевод вики-разметки в HTML и CSS) даёт сбои. Да боже, это даже используется в этом абзаце!<br>
Относительно полный гайд по разметке можно почитать в [https://www.mediawiki.org/wiki/Help:Formatting/ru официальном руководстве].

==== [[/Шаблоны 101|Шаблоны]] ====
Иногда возникают ситуации когда нужно один и тот же кусок использовать в нескольких местах или разбить что-то больше на маленькие. В нормальных языках программирования для этого используются функции, в вики-разметке используются шаблоны. Шаблон представляет собой статью находящуюся в специально выделенном пространстве имён и подготовленную специальным образом для вставки.<br>
Список того что тут можно использовать:
* Разметка, [https://htmlbook.ru/html HTML] и [https://htmlbook.ru/css CSS]. Так как шаблон является обычной статьёй, то он поддерживает всё тоже самое что и обычная статья.
* [https://www.mediawiki.org/wiki/Help:Magic_words#Parser_functions Функции парсера]. Так же фича которую можно использовать в обычных статьях, но чаще находит своё применение именно здесь.
* [https://www.mediawiki.org/wiki/Help:Templates#Parameters Параметры]. При помощи специальных конструкций можно оставлять поля в которые при размещении шаблона можно указать нужный вам кусок. Почти ничем не ограничены и могут подставляться буквально целые куски разметки, главное чтобы итоговый результат для парсера сошёлся.
* На нашей вики используется [https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions расширение фунций парсера]. Математические действия, сравнения, отработка исключений, сложные условия и многое другое. Мощный инструмент позволяющий создавать гараздо более комплексные шаблоны чем обычно.

=== Lua ===

=== Экзотика ===

== Примечания ==
{{примечания}}