Global templates/Proposed specification/ru

  Татары, узбеки и ненцы И весь украинский народ, И даже приволжские немцы К себе переводчиков ждут. И может быть в эту минуту Меня на турецкий язык Японец какой переводит И в самую душу проник. —Осип Мандельштам

Это — предложение функциональных требований для глобальных шаблонов и модулей.

Есть также краткое описание этого предложения (длиной в одну страницу).

'''Это не проект, который выполняется сейчас, или планируется к выполнению в определенное время, по крайней мере, на настоящий момент. Это только идея, хотя и довольно подробно описанная.'''

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

Этот документ не пытается углубиться в подробности технической имплементации в смысле хранения, кеширования, доставки, дизайн кода на PHP, и т. д. Он пытается только определить требования того, как эта возможность будет работать с точки зрения пользователей:


 * 1) Людей, создающих и поддерживающих шаблоны и модули.
 * 2) Людей, создающих и правящих страницы, которые содержат шаблоны и модули. Это включает всех редакторов и все виды страниц:
 * 3) * Все уровни опыта: от полных новичков до тех, кто сделал тысячи правок
 * 4) * Все виды инструментов редактирования: редактирование вики-текста, Визуальный редактор, Перевод содержания и другие (даже ботоводы)
 * 5) * Все вики: Википедия, Викисловарь, Викигид, Викиданные, Инкубатор и т. д., и любые новые будущие проекты
 * 6) * Все языки: английский, французский, русский, испанский, армянский, персидский, зулу, манипури и др.
 * 7) * Все виды страниц: статьи Википедии, страницы обсуждения статей, страницы обсуждения пользователей, страницы обсуждения сообщества, страницы Вики-проектов, категории, страницы документации шаблонов и т. д.

«Речь для лифта»
Значительная часть функций сайтов Викимедиа реализована в шаблонах и модулях Lua. В их нынешней форме они не могут быть общими для разных вики-сайтов и языков. Из-за этого их трудно интегрировать с современными способами создания и редактирования статей — Visual Editor, Wikidata и Content Translation — и адаптировать к мобильным устройствам. Это приводит к пустой трате усилий авторов и трудностям для новых редакторов и небольших проектов. Возможность делиться ими между вики-сайтами сделает разработку программного обеспечения более быстрой и надёжной и позволит редакторам лучше сосредоточиться на написании текста.

Проблема
Общее замечание: если не сказано иначе, все упоминания «шаблонов» относятся также к модулям Scribunto на языке Lua.

Шаблоны реализуют функции сайтов Викимедиа. Некоторые из этих функций очень заметны, особенно карточки, сноски, «источник?» и многие другие. Все читатели видят их, и все редакторы сталкиваются с ними почти в каждой правке. Кроме того, они реализуют многие из функций внутреннего управления сообществами сайтов: запросы на удаление, запросы на разблокировку, выражение согласия в обсуждениях, сортировку статей для вики-проектов, и т. д.

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

Редактирующие вики-текстом
Шаблоны часто трудно понять участникам, редактирующим вики-текстом. Люди, имеющие опыт использования определённого шаблона вероятно узнают его и смогут отредактировать включающую его страницу. Однако не знакомые с шаблоном редакторы должны будут искать его документацию когда они столкнутся с ним, даже если у них есть опыт работы с другими шаблонами. Неопытные же редакторы будут озадачены загадочным текстом с фигурными скобками, вертикальными че́ртами, знаками равенства и т. д.

Для использования функции, реализованной в качестве шаблона, необходимо знать имя шаблона и вводить его в фигурных скобках ( – ) или копировать его с другой страницы. Это неочевидно для новых пользователей, и опытные пользователи также должны изучать каждый новый шаблон отдельно.

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

Редактирующие визуальным редактором
У пользователей Визуального редактора есть некоторые преимущества в использовании шаблонов, однако и там с ними связано много сложностей. В частности, существует аналогичная проблема с возможностью обнаружения («discoverability»): в Визуальном редакторе все функции шаблонов скрыты за пунктом меню «Вставить → Шаблон», и пользователь должен знать название шаблона перед его использованием.

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

Есть одно заметное исключение: в некоторых вики есть кнопка «Источник», вставляющая сноски со шаблонами источников. Тем не менее, это исключение, которое подтверждает правило. Эта кнопка требует ручной настройки даже для простейших функций, настройка эта является отдельной в каждом вики-сайте, и, как следствие, во многих вики этой кнопки нет вообще. Другое сопоставимое исключение, добавленное в конце 2019 года, — специальная поддержка шаблонов «Источник?» (Citation needed), но и этой функции требуются некоторые настройки в каждом вики-сайте, для того чтобы она действительно работала.

Трудности для участников, пишущих в нескольких вики
 Yesterday came suddenly, tomorrow we’ll receive, Today now you’re at the wheel I’ll ask how does it feel.

Yesterday when heaven’s gates I’d contemplate they’d seem so far, Today they ain’t so far away and almost seem ajar.

Keep what ya got by giving it all away. Keep what ya got by giving it all away. Keep what ya got, Hold it, don’t stop, Keep what ya got by giving it all away. —Ian Brown

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

Для людей, редактирующих на разных языках, шаблоны усложняют перевод. При переводе страницы шаблоны гораздо сложнее обрабатывать, чем текст статьи («прозу»), независимо от того, выполняется ли перевод вручную или с помощью Перевода содержания (Content Translation). Пользователи часто должны пропускать шаблон или исправлять его после публикации статьи. Это также приводит к забрасыванию уже начатого перевода, потому что перевод шаблона буквально отпугивает многих участников.

Наиболее часто сообщаемые проблемы в Переводе содержания связаны с шаблонами.

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

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

Шаблон можно экспортировать из одного вики-сайта в другой, но после этого шаблон становится раздвоенной копией (forked). Он либо остаётся в том состоянии, в котором он был экспортирован, либо продолжает разрабатываться отдельно, что приводит к несовместимости. Иногда люди продолжают поддерживать разные копии, но это ненадёжно и не может масштабироваться для сотен вики, которые у нас есть.

Параметры шаблона могут иметь одинаковую функциональность, но разные названия в разных вики-сайтах. Их можно адаптировать, используя псевдонимы (aliases) TemplateData, но это неоптимальный «хак»: это не то, для чего изначально было создано расширение TemplateData, и это нужно делать вручную для каждой пары языков.

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

Трудности для участников меньших вики-сайтов
Новый вики-сайт создаётся путём установки ядра MediaWiki и включения набора расширений по умолчанию. На практике это не создаёт «ровного игрового поля», потому что именно в шаблонах реализовано множество ключевых функций больших вики: карточки, сноски, служебные пометки (таких, как ) и т. д.

Трудности для разработчиков программного обеспечения
Разработчикам ядра, расширений, ботов и других инструментов MediaWiki, которые анализируют, генерируют или изменяют содержимое вики-страниц, сложно разрабатывать функции, которые зависят от наличия в вики определённых шаблонов. Разработчики расширений, таких как GrowthExperiments, PageTriage, ContentTranslation, некоторых компонентов Wikibase и многих других, должны либо тестировать их в рабочей среде, что не очень хорошо, либо импортировать шаблоны в свои локальные вики для разработки или тестовые вики в сети.

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

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

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

Навыки разработки шаблонов и модулей
Есть и ещё один важный набор предположений, на которых основано это предложение:
 * Навыки разработки шаблонов и модулей нетривиальны. И шаблоны, и модули имеют много неясных функций.
 * Хотя многие из наиболее заметных функций сайтов реализованы в виде шаблонов и модулей, люди часто не замечают и недооценивают эти навыки и принимают их как должное.
 * Есть десятки людей, которые имеют эти навыки, и они редактируют много вики-сайтов. Они обычно сосредатачиваются на своём домашнем вики-сайте и относительно редко общаются с участниками из других вики или других языков. Несмотря на то, что базовая технология везде одинакова, не существует настоящего глобального сообщества разработчиков шаблонов, которое было бы сопоставимо с глобальным сообществом разработчиков ядра и расширений MediaWiki. Существуют случаи совместной работы в нескольких вики-сайтах на определённых шаблонах, но это непостоянно и нестандартизованно.
 * Есть также много вики, в которых вообще нет редакторов, обладающих этими навыками. Они либо копируют шаблоны и модули из других вики, не полностью понимая, как они работают, и не имея возможности эффективно их локализовывать и поддерживать, либо не используют шаблоны вообще.

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

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

Предлагаемое решение: Вкратце
Уже сейчас есть много функций MediaWiki, которые являются глобальными для всех вики: изображения (с помощью Викисклада), блокировка, учётные записи пользователей (CentralAuth), настройки, пользовательские страницы, пользовательские страницы JS и CSS и некоторые другие.

Должно быть также возможно хранить шаблоны и модули в глобальном хранилище и локализовать их так же просто и надёжно, как это делается с расширениями.

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

Глобальные шаблоны и модули дадут бо́льшие возможности переводчикам и локализаторам и позволят им сосредоточиться на переводе строк пользовательского интерфейса («сообщений»), без необходимости искать строки в коде и позволят им использовать одинаковые навыки и инструменты для перевода шаблонов и для расширений MediaWiki.

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

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

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

Локализация шаблонов будет так же удобна, как и локализация расширений MediaWiki.

У шаблонов должна быть возможность быть семантическими и глобальными
Семантические означает, что другие программные компоненты, особенно Визуальный редактор и Перевод содержания, должны иметь обобщённый способ понять, что шаблон существует и что он обеспечивает определённые возможности, чтобы можно было вставить его в страницу как карточку, цитату, сообщение в начале статьи и т. д., а не только как просто шаблон. В настоящее время самое близкое что существует к семантическому описанию шаблонов — TemplateData, но эта технология описывает только параметры шаблона. Например, она не помогает визуальному редактору добавить кнопку «Вставить карточку» на панель инструментов.

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

Как сделать шаблоны семантическими
Шаблоны никогда не были как следует семантическими, в том смысле, что с ними легко обращаться программам, которые обрабатывают страницы.

Есть лишь несколько примеров шаблонов, которые были сделаны семантическими:


 * Различные шаблоны для сносок, которые можно использовать из кнопки «Источник» на панели инструментов Визуального редактора. Они требуют написания большого количества отдельного кода для настройки Citoid на каждом желающем использовать их вики-сайте.
 * Шаблон «Источник?» («citation needed»), которые был адаптирован для Визуального редактора в конце 2019 года. Также требует настройки в каждом вики-сайте. Например: английский, иврит, словенский. На момент написания этой страницы, французский, испанский и большинство других языков не настроены для этого, хотя у них есть такие шаблоны.
 * Шаблоны для упоминания пользователей в расширении Flow, также требующие локальной конфигурации.
 * Некоторые инструменты для обработки дампов и исследований могут анализировать шаблоны оценки страниц вики-проектов Английской Википедии, которые обычно добавляются на страницы обсуждения.
 * Расширение GrowthExperiments предлагает редакторам выполнять определённые задания в статьях на основе включённых в них шаблонов. Названия шаблонов должны быть написаны вручную в JSON-файлах отдельно в каждом вики-сайте. Например: чешский, вьетнамский, корейский, арабский.
 * Расширение PageTriage настроено для работы с шаблонами предупреждений в верхней части статей Английской Википедии (также известными как «tags» и «hatnotes»).

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

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

Хранение и доставка
Глобальные шаблоны и модули могут храниться в центральном вики-сайте (Мета, Викисклад или целый новый сайт), и это может быть даже Gerrit или другой репозиторий.

Наилучшим решением, вероятно, является создание нового вики-сайта, в котором они будут храниться, не смешиваясь с изображениями, общими обсуждениями сообщества и т. д.

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

Глобальные шаблоны и модули должны храниться в общем хранилище, которое может будет редактироваться большинством вики-редакторов. Правила о блокировках и специальных разрешениях изначально должны быть аналогичны правилам в других вики: всё должно быть открыто по умолчанию, и должна быть возможность защитить очень распространённые, чувствительные или часто вандализируемые шаблоны. Более подробные правила об уровнях защиты могут быть разработаны сообществом редакторов позже.

Каким образом шаблоны доставляются в целевые вики — вопрос внутренней инженерии и архитектуры, если учтены другие требования. Эти вопросы обсуждались в прошлом некоторыми разработчиками платформы, например, в рамках проекта Shadow namespaces. Этот документ пытается ответить на связанные вопросы о том, как это работает с точки зрения пользователя, который редактирует страницу, использующую шаблон, или разработчика самого шаблона — как написать его так, чтобы его можно было эффективно локализировать; как он переводится; как это подгоняется под нужды каждого сообщества; и т. д. Эти вопросы не были в достаточной степени рассмотрены в предыдущих архитектурных дискуссиях на эту тему.

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

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

Должно быть возможно сделать некоторые шаблоны неглобальными
Не все шаблоны надо делать глобальными.

Фактически, некоторые шаблоны должны быть локальными, потому что они реализуют функциональность, которая уникальна для определённого языка. По своей природе такие шаблоны не нужно переводить, и должен быть способ дать подсказку как редакторам-людям, так и инструментам перевода (таким как Перевод содержания), что они не нуждаются в адаптации и могут быть пропущены или подстановлены («subst»). Это часть усилий сделать шаблоны более семантическими.

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

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

Глобальный шаблон должно быть возможно сразу использовать во всех вики
Подобно тому, как глобальная пользовательская страница сразу доступна во всех вики, в которых нет локальной пользовательской страницы, каждый шаблон или модуль, созданный в глобальной инфраструктуре, должно быть возможно немедленно использовать во всех вики.

Это не должно требовать никаких дополнительных шагов, например копирования вики-страниц, создания шаблонов-оболочек с локальным именем, вмешательства администратора, ожидания в течение нескольких часов для обновления кэшей и т. д.

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

Если строки (также известные, как «сообщения») пользовательского интерфейса не были переведены, шаблон всё равно будет пригоден для использования, и строки будут отображаться на резервном языке. Смотрите разделы по локализации для более подробной информации.

Должна быть возможность перевести все строки, обращённые к пользователю
Строки пользовательского интерфейса (сообщения) ядра MediaWiki, расширений и некоторых внешних инструментов, таких как Pageviews, удобно и надёжно переводятся на translatewiki.net. Этот процесс локализации знаком по крайней мере некоторым редакторам на всех языках.

В настоящее время невозможно делать то же самое с шаблонами. На многоязычных сайтах, таких как Викисклад и mediawiki.org, есть система «TNT» для перевода некоторых шаблонов, но она очень сложна и не может быть использована для Википедии, Викитеки и т. д.

В идеале, должна быть возможность переводить шаблоны так же, как ядро и расширения, используя вики с расширением Translate.

Переведённая строка должна стать пригодной для использования сразу после отправки перевода с использованием интерфейса Translate.

Можно позволить редактирование строк пользовательского интерфейса на текстовых вики-страницах, но в идеале они должны редактироваться главным образом через сделанный для этого интерфейс перевода.

Переводчики должны быть в состоянии сосредоточиться на переводе текста. Видя какой-либо код вокруг него, людям, не имеющим опыта с программированием и JSON-файлами, будет трудно вносить свой вклад. Кроме того, редактирование переводов на языки, написанные справа налево в текстовых файлах, крайне неудобно. Расширение Translate уже решает все эти проблемы.

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

Язык, на котором строки показываются пользователю
Шаблоны в основном используются как часть содержания страниц, поэтому по умолчанию переведенные сообщения должны отображаться на языке вики.

Несмотря на это, некоторые шаблоны используются в качестве элементов интерфейса. Поэтому, возможно, имеет смысл также сделать возможным показ переведённых строк на языке пользователя, если он отличается от языка содержания вики. Это может быть особенно актуально для многоязычных сайтов, таких как Викисклад, Викиданные, Мета и mediawiki.org.

Обычные цепочки резервных языков MediaWiki должны использоваться, когда перевод недоступен. Например, если сообщение не переведено на кечуа или гуарани, оно будет отображаться по-испански, если оно не переведено на башкирский или чувашский языки, оно будет отображаться по-русски и т. д. Конечный резервный язык — английский, поэтому, если это сообщение не переведено на испанский или русский, оно будет отображаться на английском языке.

Ключи сообщений
Сообщения должны быть представлены в виде ключей, аналогично тому, как это делается в ядре MediaWiki, расширениях и инструментах.

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

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

Инструменты для переноса
Стоит разработать инструмент, который поможет переносить шаблон или модуль в центральное хранилище. Он сможет сделать следующие шаги:
 * 1) Экспортировать шаблон из локального вики-сайта и импортировать его в глобальный вики-сайт.
 * 2) Экспортировать все шаблоны, которые используются этим шаблоном (каскадно).
 * 3) Определить строки на человеческом языке, преобразовать их в список с ключами и замените их ключами в исходном коде шаблона.
 * 4) Импортировать страницу документации шаблона и TemplateData.

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

Организация сообщений
Расширение Translate организует сообщения по группам, также известным как «проекты», которые могут быть далее объединены по агрегатным группам. Например, Article Placeholder, Score и Poem — все группы, которые представляют соответствующие расширения MediaWiki, и все они включены в агрегатную группу «Extensions used by Wikimedia - Advanced», наряду со многими другими расширениями.

Проекты, которые представляют расширения MediaWiki, настраиваются в файлах YAML в репозитории translatewiki и отображаются в пользовательском интерфейсе Translate в селекторе проектов, также известном как «селектор группы сообщений».

Поскольку шаблонов гораздо больше, чем расширений, могут потребоваться некоторые изменения в том, как расширение Translate обрабатывает группы сообщений, чтобы приспособить его к переводу шаблонов.

Каждый шаблон должен быть группой сообщений. Тесно связанные шаблоны должны быть сгруппированы в агрегатную группу сообщений. Они могут быть похожи на категории, в которых они хранятся, и фактически категории могут даже использоваться для этого. Редактирование файлов в репозитории Git для организации этих групп сообщений, вероятно, нежелательно, потому что это будет слишком сложно и медленно.

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

Шаблоны должны отображаться в виде групп сообщений на специальной странице языковой статистики расширения Translate (Special:LanguageStats). Это поможет локализаторам найти, какие шаблоны нуждаются в переводе. Это должно быть в целом аналогично всем группам сообщений, но есть некоторые особые соображения для шаблонов:
 * Будет несколько тысяч шаблонов, поэтому было бы хорошо, если бы дизайн таблицы как-то соответствовал этому.
 * В таблице должно быть показано, на скольких страницах каждый шаблон используется, и должно быть возможно упорядочить строки по этому числу, чтобы помочь локализаторам выбрать, что важнее перевести.

Как найти, где переводится шаблон
На каждой странице описания шаблона должна быть прямая ссылка на перевод на язык пользователя.

Некоторые шаблоны используют названия (label) из Викиданных как часть своего интерфейса вместо жёстко кодируемых строк. В настоящее время это делается в Infobox Wikidata на Викискладе, Persona Infotaula (универсальная биографическая карточка) в Каталанской Википедии и в нескольких других шаблонах. Эти названия и значения могут быть локализованы в самих Викиданных. Такое использование не может покрыть все потребности локализации шаблонов, но оно является разумным и полезным, и соответствует для определённых целей. Если это внятно описано в документации шаблона, это можно продолжать использовать, и, вероятно, не требует специальной адаптации инфраструктуры. (Возможно, перевод соответствующих меток и значений может быть каким-то образом интегрирован в интерфейс Translate для локализации шаблона, но это необязательно.)

Параметры сообщений и волшебные слова
В ядре MediaWiki и расширениях многие сообщения имеют параметры, иногда также известные как «placeholders». Они называются $1, $2 и т. д., и они заполняются во время выполнения программы. Параметры особенно важны для того, чтобы было возможно правильно переводить сообщения, учитывая то, что в разных языках разный порядок слов.

Нечто подобное необходимо и в шаблонах, хотя, возможно, они будут выглядеть не как $1, $2, а как шаблоноподобные параметры с тройными фигурными скобками ( { – } ). Это должно быть решено в соответствии с соображениями удобства разбора (синтаксического анализа, «парсинга») и локализации.

Волшебные слова PLURAL, GENDER и GRAMMAR должны поддерживаться в сообщениях шаблонов, как в сообщениях MediaWiki.

Документация сообщений
В ядре MediaWiki и расширениях каждое переводимое сообщение документируется для удобства разработчиков и переводчиков. Документация может включать информацию о том, где сообщение показывается, что содержат параметры $1, $2 и т. д., является ли слово глаголом или прилагательным и т. д. Эта документация хранится как псевдо-язык с кодом qqq.

Такая документация будет полезна и для перевода шаблонов. Как она будет храниться — вопрос технической архитектуры. Возможно, её можно комбинировать с TemplateData, возможно, она может храниться как язык qqq, и, возможно, это может делаться как-нибудь ещё.

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

Отметка устаревших сообщений (Fuzzying)
В ядре MediaWiki и расширениях и на переводимых страницах, если исходное сообщение на английском языке изменяется, сообщение автоматически помечается как устаревшее или «fuzzy». Существующие переводы продолжают работать, но показываются переводчикам как «устаревшие» и нуждающиеся в обновлении. (Администратор перевода также может пометить сообщение как не нуждающееся в такой пометке.)

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

Особенности локализации модулей
Модули на Lua могут загружать и анализировать переводимые строки MediaWiki, но не существует определённого способа хранения этих строк для модулей Lua, которые хранятся как вики-страницы. Можно паковать модули Lua как части расширений, и тогда они смогут загружать сообщения из файлов i18/*.json, но в настоящее время это делается в очень немногих расширениях. Переписывание шаблонов в Lua может быть более надёжным решением с инженерной точки зрения, но Lua не обязательно будет принят всеми нынешними разработчиками шаблонов, а их сотрудничество будет иметь решающее значение для успеха проекта, поэтому это нельзя сделать со всеми шаблонами.

Некоторые очень внутренние, технические модули, которые часто используются, редко меняются и не требуют интернационализации, могут быть безболезненно перенесены в само расширение Scribunto. Вот некоторые примеры: No globals и Arguments.

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

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

Подобно названиям параметров, шаблоны тоже могут иметь разные названия на разных языках, и эту возможность необходимо сохранить. Должен быть структурированный способ перевода названий шаблонов. Возможно, ссылки на сайты (sitelinks) через Wikidata могут сыграть роль в этом, но не обязательно.

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

Названия шаблонов должны быть переведены только на языки, которые могут быть языками содержания вики. Перевод на «формальный немецкий» или «британский английский», вероятно, не нужен. Может быть способ иметь псевдонимы или перенаправления. Языковые варианты, например для сербского и китайского, должны поддерживаться в соответствии с потребностями этих языков.

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

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

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

В идеале, глобальный шаблон должен иметь обобщённые внутренние названия параметров, имеющие переводы на разные языки. Это несколько похоже на названия свойств Викиданных, но может быть проще: поскольку английский язык является «лингва франка» для разработчиков программного обеспечения, а шаблоны являются своего рода программным обеспечением, вероятно, возможно использовать английский в качестве исходного языка по умолчанию, а не обобщённые числа, как в Викиданных.

Эти обобщённые названия параметров будут общими названиями по умолчанию. Они будут работать в вики-сайтах на всех языках. Локализованные имена будут работать в вики-сайтах, у которых этот язык является языком содержания.

Эти переводы названий параметров должны проверяться:


 * Они не должны содержать недопустимые символы
 * они не должны повторяться в одном шаблоне на одном языке
 * Что-нибудь ещё?

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

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

Ввод:

Вывод:

В Переводе содержания это будет основным способом адаптации шаблонов. В отличие от нынешнего способа адаптации шаблона в Переводе содержания, это будет точным и полным, а не основанным на догадках.

При визуальном редактировании и при редактировании в Новом режиме вики-текста («2017»), простое копирование и вставка шаблона из вики на другом языке автоматически выполнит перевод параметров.

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

В обоих случаях будут переведены только названия шаблона и параметров. Перевод значений параметров обсуждается отдельно.

Безымянные параметры
Безымянные нумерованные параметры, конечно, должны продолжить работать.

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

Перевод значений параметров
Вдобавок к совместному использованию функциональности и дизайна шаблонов, необходимо подумать о том, как позволить вики-сайтам делиться значениями параметров, а также не делиться ими.

Некоторые значения параметров одинаковы во всех языках по своей сущности. Например, произношение в МФА названия места на местном языке (например, [dɛn ˈɦaːx] для Гааги), год основания города, химическая формула соединения, и т. д. По крайней мере, некоторые из них, вероятно, должны храниться в Викиданных и легко загружаться в шаблон.

Некоторые значения параметров должны быть переведены или транслитерированы, например, имена людей, переводы девизов стран и т. д.

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

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

Допустимые и функционирующие значения параметров должны быть используемы на нескольких языках и не должны зависеть от языка. Например, использование «yes» и «no» в качестве логических значений слишком ориентировано на английский язык. Вероятно, это не должно требовать изменений в инфраструктуре, а в основном соглашения в сообществе разработчиков шаблонов для разных вики о хороших практиках адаптации ко многим языкам.

Направление текста
Шаблоны должны адаптироваться к направлению текста (слева направо / справа налево) языка вики—сайта, в котором они отображаются.

Должно быть удобно писать шаблон так, что направление будет нейтральным, с как можно меньшим количеством явного выравнивания вправо и влево.

Боты
Многие шаблоны во многих вики регулярно редактируются ботами. Эта возможность должна быть сохранена.

Для этого, видимо, не понадобится менять что-либо в программной инфраструктуре, но это упоминается здесь для полноты, потому что это важный вид использования шаблонов.

Перенос шаблонов из крупных вики-сайтов в центральное хранилище
 וּמֵעֵבֶר לְשׁוּרַת הַבְּרוֹשִׁים עָבְרָה הָרַכֶּבֶת אֲבָל אֲנַחְנוּ רַק שָׁמַעְנוּ אוֹתָהּ, וְלֹא רָאִינוּ. וְכָל הַדְּבָרִים שֶׁדִּבָּרְנוּ בֵּינֵינוּ הִתְחִילוּ בַּמִּלִּים, „אֲבָל אֲנַחְנוּ”. —יהודה עמיחי Самый популярный исходный язык в перевода в Переводе содержания — английский, с большим отрывом. За ним следуют испанский, русский, французский, немецкий, каталанский, украинский, итальянский, китайский и португальский. Учитывая это, ясно что часто используемые шаблоны в Википедиях на этих наиболее распространённых языках, особенно на английском, являются теми, что наиболее важно сделать глобальными в пользу всех других языков.

Однако, как это ни парадоксально, редакторы на этих крупнейших языках менее всего заинтересованы в том, чтобы делать их глобальными:


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

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

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

Темпы переноса шаблонов из больших вики—сайтов в центральное хранилище может стать одним из показателей успеха проекта.

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

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

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

Ядро MediaWiki
Должны быть встроенные в вики инструменты, показывающие хотя бы базовый анализ использования шаблонов и модулей на страницах: количество включений и вызовов, сгруппированных по вики, и списки страниц, использующих шаблоны и модули. Функция, которая показывает во время редактирования страницы, какие шаблоны включены в неё, должна продолжить работать с глобальными шаблонами.

Страница «Ссылки сюда» должна продолжать работать и оставаться полезной для глобальных включений.

TemplateData

 * Описания шаблонов и параметров можно переводить в TemplateData, и переводы отображаются на языке интерфейса в диалоговом окне вставки шаблонов в Визуальном редакторе. Это хорошо, и должно быть сохранено. Интерфейс перевода может быть улучшен, но начало хорошее. Решением этой проблемы может быть добавление поддержки TemplateData в расширение Translate, но могут быть и другие решения.
 * Предлагаемое форматирование викитекста (внутристрочный, блочный, настраиваемый) должно продолжить работать. Должно быть также возможно настроить их на каждом вики: некоторые вики могут предпочесть видеть определённый шаблон, написанный в синтаксисе вики, как одну строку, а некоторые могут предпочесть несколько строк.

TemplateStyles

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

TemplateSandbox

 * Служебная страница Special:TemplateSandbox должна продолжить работать.
 * Должна быть возможность отредактировать шаблон в центральном хранилище и просмотреть его на странице целевого вики-сайта.

TemplateWizard

 * Текущая система использует стандартный поиск вики для поиска шаблонов. Результаты представлены в списке, который может потребоваться изменить, чтобы сделать глобальный или локальный статус видимым.
 * TemplateWizard получает информацию о шаблонах из TemplateData API, а потому, пока он возвращает ту же структуру, проблем не должно быть, и интернационализация уже работает.

Wikibase

 * Викиданные могут быть использованы для показывания некоторых значений параметров из центрального хранилища в локальных вики. Это продуктивно используется в Википедии на нескольких языках, среди которых французский, иврит, баскский, русский, каталанский, эстонский и некоторые другие, а также в Викискладе, хотя фактическая реализация может отличаться. Это, конечно, должно продолжить работать. Объединение того, как это делается в разных вики, может стать одной из наиболее важных исходов этого проекта.
 * Это также может упростить реализацию Wikidata Bridge, проекта, позволяющего редактировать значения шаблонов из вики. Модификации самих шаблонов должны будут быть сделаны только один раз в глобальных шаблонах, а не на каждом сайте по отдельности.

VisualEditor (Визуальный редактор)

 * Визуальный редактор, конечно, должен будет иметь возможность вставлять как глобальные, так и локальные шаблоны.
 * Визуальный редактор показывает ссылку на страницу описания шаблона в диалоговом окне редактирования шаблона. Эта ссылка должна указывать непосредственно на глобальный шаблон, когда он используется.

Может быть желательно сделать шаблоны используемыми и на сайтах, не связанных с Викимедиа
Несмотря на то, что это не приносит прямой выгоды проектам Викимедиа, возможно, имеет смысл подумать о том, чтобы сделать шаблоны легко пригодными для использования не только в проектах Викимедиа, но и на других сайтах, использующих движок MediaWiki. Выполнение этого, вероятно, потребует некоторой дополнительной работы, но это может способствовать улучшенной модульности, и это, в свою очередь, может в конечном итоге принести пользу и проектам Викимедиа.

Это сопоставимо с возможностью прямого встраивания изображений из Викисклада на сайты, не принадлежащие Викимедиа.

Представьте себе мир
Представьте себе мир, в котором каждый человек может свободно делиться всей суммой накопленных человечеством знаний, и это оказывается очень простой задачей благодаря тому, что шаблоны стали глобальными:

(Примечание: В столбце «» предполагается, что инфраструктура развёрнута во всех сайтах Викимедиа, и что наиболее часто используемые шаблоны перемещены в центральную инфраструктуру.)

Состояние
 А мы всё молчим, Мы всё считаем и ждём; Мы всё поём о себе, О чём же нам петь ещё? —Борис Гребенщиков Как отмечалось выше, по состоянию на октябрь 2019 года эта страница является лишь идеей, а не обязательством по реализации проекта.

Подобные идеи предлагались в прошлом. Самое старое из известных предложений по использованию шаблонов для повторного использования в разных вики было внесени в декабре 2004 года в Багзилле: Interwiki templates. Несколько других подобных идей были подняты позже, например, Phabricator. В феврале 2017 года аналогичное предложение под названием Global-Wiki было закрыто как «консенсус». Некоторые из его компонентов были реализованы, например глобальные настройки, но не были реализованы глобальные шаблоны.

Желание «Создать централизованный глобальный репозиторий для всех шаблонов, гаджетов и модулей на Lua» попало на третье место в Опросе о пожеланиях сообщества — 2015, а «Глобальные гаджеты» попало на первое место в Опросе о пожеланиях сообщества — 2016. Несмотря на поддержку сообщества, ни одно из них не было реализовано, потому что они не подходили для команды Community Tech, и они не были переведены в другую команду.

Проект Platform Evolution (2018) указал на некоторые намерения иметь поддержку глобальных шаблонов в будущем. На странице Platform Evolution/Recommendations обсуждаются идеи по обновлению модульности содержания и говорится:
 * ... «коробки» являются идеальной областью фокусировки для создания модульности. Они представляют собой автономные функции и дают возможность обеспечить равноправный обмен пользовательскими функциями между проектами и языками, создавая межпроектную службу для обмена шаблонами. Этот проект также заставит нас задуматься о том, как обрабатывать оформление и структуру содержания отдельно от частей самого содержания.

На тесно связанной странице Platform Evolution/Goals это упомянуто как одна из целей:
 * Увеличить равенство и силу инструментов вклада. Мы хотим поддерживать вклад большего количества видов содержания, в том числе медиа, в более интерактивных формах и во все проекты. Это означает, что некоторые существующие инструменты, такие как шаблоны, будут сделаны доступны для последовательного повторного использования во всех проектах и языках. Это также означает усовершенствование инструментов перевода для удаления разрозненности содержания. Наконец, мы также хотим, чтобы участники могли легко создавать новые межпроектные, локализуемые инструменты для содержания.

Однако, кроме этих целей, нет подробного плана работы такой функции. Эта страница является попыткой предложить такой план и выслушать отзывы редакторов.

Полезные ссылки
Некоторые относящиеся к этой теме страницы:
 * Platform Evolution/Goals
 * Platform Evolution/Recommendations
 * Multilingual Templates and Modules — Попытка реализовать подобную функцию с помощью ботов
 * meta:Community Wishlist Survey 2015/Results - Central Global Repository for Templates, Lua modules, and Gadgets Это желание заняло третье место в списке желаний сообщества. Внесено в список «В разработке - команда Parsing», но не выполнено.
 * meta:Which templates should be global? — неофициальный список, составленный различными редакторами
 * Requests for comment/Shadow namespaces — бездействующий RFC об одном из предложений по технической реализации такой инфраструктуры
 * Manual:$wgEnableScaryTranscluding — существующий элементарный механизм для переноса содержания между проектами. Считается неэффективным и небезопасным, и отключен на проектах Викимедиа.
 * meta:Global-Wiki — похожее предложение, с более широким охватом. Было открыто для обсуждения в течение нескольких лет и закрыто с пометкой «есть консенсус». Некоторые вещи из него были реализованы, такие, как глобальные пользовательские страницы и настройки, но там есть также глобальные шаблоны, которые ещё не сделаны.