Язык разметки, называемый wikitext , также известный как wiki-разметка или wikicode , состоит из синтаксиса и ключевых слов, используемых программным обеспечением MediaWiki для форматирования страницы. (Обратите внимание на строчное написание этих терминов. [a] ) Чтобы узнать, как увидеть эту гипертекстовую разметку и сохранить редактирование, см. Help:Editing . Как правило, кодирование можно копировать и вставлять, без написания нового кода. На Help:Cheatsheet есть краткий список разметки и советов .
В дополнение к викитексту, некоторые элементы HTML также разрешены для форматирования презентации. См. Help:HTML в викитексте для получения информации об этом.
Разделы статей на странице будут следовать за введением или за введением этой страницы , а если их четыре или более, то за оглавлением .
Сквозная разметка представляет собой заголовки разделов, с которыми они связаны =
.======
[edit]
ссылку. Смотрите этот раздел для соответствующего CSS.
Шаблоны: {{ fake header }} для использования в документации.
Горизонтальная линия представляет собой тематический разрыв на уровне абзаца. Не используйте в содержании статьи, так как линии используются только после основных разделов, и это происходит автоматически.
HTML-эквивалент: <hr />
(который может иметь отступ, но ----
всегда начинается с левого поля.)
Если на странице есть не менее четырех заголовков, оглавление (TOC) автоматически появится после лида и перед первым заголовком. TOC можно контролировать с помощью волшебных слов или шаблонов:
__FORCETOC__
заставляет оглавление отображаться в обычном месте независимо от количества заголовков.__TOC__
заставляет оглавление отображаться в месте вставки волшебного слова, а не в обычном месте.__NOTOC__
полностью отключает TOC.Разрывы строк или новые строки используются для добавления пробелов между строками, например, для разделения абзацев.
HTML-эквивалент: <br>
или <br />
может использоваться для разрыва макета строки.
Шаблоны для переносов строк:
Немаркированный список:
Отступы чаще всего используются на страницах обсуждений.
Шаблоны: {{ outdent }} , {{ outdent2 }}
Когда необходимо разделить блок текста. Это полезно для (как следует из названия) вставки блоков цитируемого (и цитируемого) текста.
Здесь используется HTML-тег; шаблон {{ quote }} приводит к такому же результату визуализации.
Шаблон {{ center }} использует ту же разметку. Чтобы отцентрировать таблицу, см. Help:Table#Centering tables . Пожалуйста, не используйте <center>...</center>
теги, так как они устарели.
Вы можете выровнять содержимое в отдельном контейнере:
Или сделайте так, чтобы текст плавал вокруг него:
Не оставляйте пустые строки между элементами списка, если на то нет причины, так как это приведет к тому, что программное обеспечение MediaWiki будет интерпретировать каждый элемент как начало нового списка.
Чтобы перечислить термины и определения, начните новую строку с точки с запятой (;), за которой следует термин. Затем введите двоеточие (:), за которым следует определение. Формат также можно использовать для других целей, например, для указания марок и моделей транспортных средств и т. д.
Списки описаний (ранее списки определений и также известные как списки ассоциаций ) состоят из имен групп, соответствующих значениям. Имена групп (термины) выделены жирным шрифтом. Значения (определения) имеют отступ. Каждая группа должна включать одно или несколько определений. Для одного или первого значения :
можно разместить на той же строке после ;
–, но последующие значения должны размещаться на отдельных строках.
HTML-эквивалент: <dl>
<dt>...</dt>
,<dd>...</dd>
</dl>
Шаблоны: {{ defn }}
Программное обеспечение MediaWiki подавляет отдельные переводы строк и преобразует строки, начинающиеся с пробела, в предварительно отформатированный текст в пунктирном поле. HTML подавляет множественные пробелы. Часто желательно сохранить эти элементы для поэм, текстов песен, девизов, клятв и т. п. Расширение Poem добавляет HTML-подобные <poem>...</poem>
теги для сохранения перевода строк и пробелов. Эти теги можно использовать внутри других тегов, таких как <blockquote>...</blockquote>
; шаблон предоставляет удобную стенографию. К этому тегу можно применять стили CSS , например: .{{poemquote}}
<poem style="margin-left: 2em;">
Стихи и их перевод могут быть представлены бок о бок, а язык может быть указан с помощью lang="xx"
. После последнего блока бок о бок необходимо использовать для отмены и восстановления нормального потока. Обратите внимание, что этот метод не требует таблицы и ее столбцов для достижения представления бок о бок.{{Clear|left}}
"float:left;"
Разметка
< стихотворение lang = "fr" style = "float:left;" > Брат Жак, брат Жак, Dormez-vous?Sonnez les matines! Sonnez les matines!Динь, дан, дон. Динь, дан, дон. </ poem > < poem style = "margin-left:2em; float:left;" > Ты спишь? Ты спишь? Брат Джон, Брат Джон,Утренний звон колоколов! Утренний звон колоколов!Дин, дан, дон. Дин, дан, дон. </ стихотворение >{{ Очистить | слева }}
Отображается как
Брат Жак, брат Жак,
Дормезву? Дормез-ву?
Sonnez les matines! Sonnez les matines!
Дин, дан, дон. Дин, дан, дон.
Ты спишь? Ты спишь?
Брат Джон, брат Джон,
Утренние колокола звонят! Утренние колокола звонят!
Динь, дань, дон. Динь, дань, дон.
Специальные символы часто могут отображаться с помощью числовых ссылок на символы или ссылок на сущности символов . Для получения дополнительной информации см. раздел Кодировки символов в HTML . Например, À
и À
оба отображают À (A- grave ). Процентное кодирование использовать нельзя, так как оно работает только в URL-адресах .
Диакритические знаки, использующие ссылки на сущности символов.
Использование ссылок на сущности персонажей.
Также доступны теги разметки <pre>, <nowiki> и <code>, например, для написания "[", "{", "&", "}", "]". Эти теги не позволяют распознавать эти символы как вики-разметку, что возможно в некоторых обстоятельствах.
Использование ссылок на сущности персонажей.
Использование ссылок на сущности персонажей.
WikiHiero — это программное расширение, которое преобразует египетские иероглифы в изображения PNG с использованием <hiero>
тегов, подобных HTML.
Пример:
<sub>
и <sup>
, например . Поэтому его следует использовать в большинстве случаев.x<sub>1</sub>
По возможности следует избегать невидимых символов и символов PUA (Private Use Areas) . При необходимости их следует заменять их (шестнадцатеричными) десятичными кодовыми значениями (например, "&#(x)...;"). Это делает невидимые символы видимыми для ручного редактирования и позволяет AWB обрабатывать страницы с символами PUA. Последние также следует помечать шаблоном {{ PUA }} для отслеживания и будущего обслуживания.
×
не должны использовать обычную букву x
. См. форматирование шрифта math . Для полного набора символов и сравнения <math>
тегов и шаблона {{ math }} см. раздел TeX против HTML .<math>
набирает с помощью разметки LaTeX , [b] , которая может отображаться как изображение или как HTML, в зависимости от настроек окружения. Тег <math>
лучше всего подходит для сложной формулы на отдельной строке в формате изображения. Если вы используете этот тег для размещения формулы в строке с текстом, поместите ее в шаблон {{ nowrap }} .=
, поэтому не забудьте заменить =
на во входных данных шаблона или начать ввод с . Используйте разметку wiki и внутри шаблона {{ math }} , а также другие сущности HTML . Шаблон {{ math }} лучше всего подходит для наборных формул в соответствии с текстом.{{=}}
1=
''
'''
для предотвращения переноса строки не требуется; шаблон {{ math }} в любом случае предотвратит переносы строк; вы можете использовать его, <br />
если вам нужен явный перенос строки внутри формулы.<math>
.<math display=block>...</math>
Отступы с использованием символа двоеточия (:) (т. е. использование вместо ) не рекомендуются по соображениям доступности .:<math></math>
<math display=block></math>
Wikilinks используются в разметке wikitext для создания внутренних ссылок между страницами. Вы создаете wikilinks, помещая двойные квадратные скобки вокруг текста, обозначающего заголовок страницы, на которую вы хотите ссылаться. Таким образом, будет отображаться как Texas . При желании вы можете использовать вертикальную черту (|) для настройки заголовка ссылки. Например, ввод создаст Lone Star State , ссылку, которая отображается как " Lone Star State ", но на самом деле ведет на Texas .[[Texas]]
[[Texas|Lone Star State]]
en.wikipedia.org/wiki/Wikipedia:Wikimarkup/Public_transport
, который является статьей Википедии с названием "Общественный транспорт". См. также Канонизация .[[language code:Foreign title]]
[[Category:Example]]
https://
http://
irc://
ircs://
ftp://
news://
mailto:
gopher://
%20
. Кодирование может быть достигнуто следующим образом:{{urlencode:}}
Нотная запись добавляется с помощью тега расширения HTML-like. Например:<score>...</score>
Можно использовать только изображения, загруженные в Wikipedia или Wikimedia Commons. Чтобы загрузить изображения, используйте мастер загрузки Commons для фотографий, которые вы сделали, и страницу загрузки Wikipedia, если могут быть проблемы с авторскими правами. Вы можете найти загруженное изображение в списке изображений .
Политику использования изображений в Википедии можно узнать в ее политике.
Дополнительную справку по изображениям, включая некоторые более универсальные возможности, см. в руководстве по изображениям и расширенном синтаксисе изображений .
Существует два способа построения таблиц:
<table>
, <tr>
, <td>
или <th>
.Для создания столбцов используйте шаблоны {{ colbegin }} и {{ colend }} .
Создание ссылки, ссылающейся на печатный или онлайн-источник, может быть выполнено с использованием <ref>
тегов разметки wiki. Внутри этих тегов добавляются сведения о ссылке.
Подробную информацию о цитировании можно предоставить с использованием структуры, предлагаемой различными шаблонами; в таблице ниже перечислены некоторые типичные компоненты цитирования.
Примеры шаблонов: {{pad|...}}, {{math|...}}, {{as of|...}}, {{edit}}
Шаблоны — это сегменты вики-разметки, которые должны автоматически копироваться («включаться») на страницу. Они указываются путем помещения имени шаблона в {{двойные скобки}}. Большинство шаблонов — это страницы в пространстве имен Template , но можно включить страницы основного пространства (статьи) с помощью {{:colon и двойных скобок}}.
Есть три пары тегов , которые можно использовать в викитексте для управления тем, как включение влияет на части шаблона или статьи. Они определяют, отображается ли викитекст либо в своей собственной статье, которую мы назовем « здесь », либо в другой статье, куда он включен, которую мы назовем « там ».
Может быть несколько таких элементов section ". Кроме того, они могут быть вложенными. Все возможные визуализации достижимы. Например, чтобы визуализировать один или несколько разделов страницы здесь, используйте теги <onlyinclude> . Чтобы добавить текст туда , оберните добавление в теги <includeonly> до, внутри или после раздела. Чтобы опустить части раздела, вложите в него теги <noinclude> .
Если страница включена без разметки включения, это может привести к непреднамеренной категоризации . Любая страница, включающая ее, будет содержать ту же категорию, что и исходная страница. Оберните разметку категории тегами <noinclude> , чтобы предотвратить неправильную категоризацию.Некоторые шаблоны также принимают параметры , которые разделяются символом вертикальной черты |
.
Они, вероятно, будут полезны на страницах обсуждений и проектов .
Семейство шаблонов может использоваться для выделения текста примера . Эти шаблоны не работают в основном пространстве, то есть в обычных статьях, они предназначены для использования на страницах проектов (например, Wikipedia:Manual of Style ), страницах справки и страницах пользователей.{{xt}}
<del>...</del>
<ins>...</ins>
Шаблон {{ Strikethrough }} размечает фрагмент текста с помощью <s>...</s>
тега. Обычно это визуально отображается путем проведения через него горизонтальной линии. За пределами статей его можно использовать для обозначения чего-либо как более неточного или неактуального, не удаляя его из вида. Однако не используйте его для обозначения изменений документа. Для этого используйте <del>...</del>
вместо него тег. Подробнее см. в § Показать удаленный или вставленный текст.
Несколько различных видов форматирования заставят вики отображать информацию так, как вы ее вводите — что видите, то и получаете!
<nowiki>...</nowiki>
(разметка wiki, содержащаяся между этими двумя тегами, отображается как обычный текст)<nowiki />
(разметка wiki, прерываемая этим тегом, отображается как обычный текст, как подробно описано в примерах ниже)Эти два вида nowiki работают по-разному, но оба нейтрализуют отображение вики-разметки, как показано в примерах ниже. Например, символы, имеющие значение вики-разметки в начале строки ( *
, #
, ;
и :
), могут быть отображены в обычном тексте. Редакторы могут нормализовать шрифт символов, завершающих вики-ссылку, которые в противном случае отображались бы в шрифте вики-ссылки. А новые строки, добавленные в вики-текст для удобства чтения, можно игнорировать.
Примечание для редакторов шаблонов: тег <nowiki>
работает только на исходной странице, а не на целевой.
Остальная часть раздела состоит из простых живых примеров, показывающих, как один тег nowiki обходит целые структуры связей, за пределами и :[[wikilink]]
{{template}}
Если вы не используете два «сбалансированных» тега nowiki, устранение ошибок маркера полосы и несоответствий в обработке параметров шаблона является рискованным. Кроме того, ошибка рендеринга может возникнуть, если две [[...]]квадратные скобки находятся на одной строке или две {{...}}фигурные скобки находятся в одном разделе, но только если они имеют непоследовательно размещенную разметку nowiki.
(Все это живые примеры.)
Для вложенных структур выход из внутренней структуры приводит также к выходу из ее внешней структуры.
Для двух первых труб требуются два тега nowiki:
Для шаблонов поместите nowiki перед первой трубой. Если параметр имеет викиссылку, поместите его в нее, в самую внутреннюю позицию.
Для входных параметров {{{1}}}, {{{2}}} просто запишите их, если у них нет значения по умолчанию (которое идет после их конвейера): {{<nowiki />{1|default}}} → {{{1|default}}}
Для функции синтаксического анализатора nowiki помещается между парными скобками или в любом месте перед двоеточием.
Поведенческие переключатели ожидают тег в любом месте:
Теги не отображаются; это просто разметка. Если вы хотите, чтобы они отображались, вставьте их <nowiki />
после <
открывающейся угловой скобки; она идет только в самом начале. Открывающиеся и закрывающиеся теги должны обрабатываться отдельно.
Используйте шаблон {{ tag }} вместо тегов nowiki для отображения тегов парсера:
Символьные сущности , nowiki не могут экранироваться. Чтобы экранировать HTML или специальные символьные сущности, замените &
на &
. Например, &lt;
→<
Чтобы отобразить тег nowiki , вы можете (1) использовать {{ tag }} , (2) заменить левую угловую скобку < на ее HTML-символ или (3) вложить теги nowiki друг в друга:
Теги Nowiki не вкладывают друг в друга, поэтому отображаются второй и четвертый:
Они просто сканируют слева направо. Парные теги не могут перекрываться, потому что самое первое парное совпадение аннулирует любые промежуточные теги внутри. Несбалансированные теги всегда отображаются.
Теги Nowiki не отображают табличную разметку, используйте <pre>...</pre>
.
<pre>
— это тег парсера, который эмулирует <pre>
тег HTML. Он определяет предварительно отформатированный текст, который отображается шрифтом фиксированной ширины и заключен в пунктирную рамку. Теги HTML-подобной и вики-разметки экранируются, пробелы и переносы строк сохраняются, но элементы HTML анализируются.
Как и <pre>
тег парсера, он экранирует теги wikitext и HTML. Этого можно избежать, используя <includeonly></includeonly> внутри <pre>
, что делает его более похожим на его эквивалент HTML:
Невидимые HTML- <pre>
теги также можно вставлять, поставив перед текстом пробел, например:
вики -разметка и
В качестве альтернативы рассмотрите возможность использования шаблона {{ pre }}<syntaxhighlight lang="text">...</syntaxhighlight>
или .
Необычно – но иногда приемлемо для заметок другим редакторам – добавлять скрытый комментарий в текст статьи. Эти комментарии видны только при редактировании или просмотре исходного кода страницы. Большинство комментариев следует размещать на соответствующей странице обсуждения . Формат заключается в том, чтобы окружить скрытый текст " <!--
" и " -->
" и он может охватывать несколько строк, например:
<!-- Пример скрытых комментариев Это не будет видно, за исключением режима «редактирования». -->
Другой способ включить комментарий в разметку вики использует шаблон {{ Void }} , который можно сократить до {{ ^ }} . Этот шаблон «расширяется» до пустой строки, не генерируя вывод HTML; он виден только людям, редактирующим исходный код вики. Таким образом, работает аналогично комментарию . Главное отличие в том, что версия шаблона может быть вложенной, в то время как попытка вложить комментарии HTML приводит к странным результатам.{{^|A lengthy comment here}}
<!-- A lengthy comment here -->
{{NUMBEROFARTICLES}} — это количество страниц в основном пространстве имен, которые содержат ссылку и не являются перенаправлением. Сюда входят полные статьи, заглушки, содержащие ссылку, и страницы с неоднозначностями.
{{CURRENTMONTHNAMEGEN}} — это родительная (притяжательная) грамматическая форма названия месяца, которая используется в некоторых языках, но не в английском; {{CURRENTMONTHNAME}} — это именительная (субъектная) форма, которая обычно используется в английском языке.
В языках, где это имеет значение, можно использовать конструкции типа для перевода слова из именительного падежа в какой-либо другой падеж. Например, означает то же самое, что и . {{grammar:case|word}}
{{grammar:genitive|{{CURRENTMONTHNAME}}}}
{{CURRENTMONTHNAMEGEN}}
Многие HTML- теги могут использоваться в разметке вики. Вы можете проверить свой HTML, используя проверку разметки .
Дополнительные ссылки см. в разделе «Кодирование вики-разметки» навигационной панели «Справка» ниже.