Jump to content

Справка:Форматирование

From mediawiki.org
This page is a translated version of the page Help:Formatting and the translation is 97% complete.
Outdated translations are marked like this.
PD Примечание: Редактируя эту страницу, вы соглашаетесь на передачу своего вклада по лицензии CC0.
Подробнее — в проекте Помощь с общественным достоянием.
PD
См. также: Help:Advanced editing

Вы можете форматировать текст с помощью вики-разметки. Она состоит из обычных символов, таких как звездочки, апострофы или знак «равно», иногда, в зависимости от их позиции в тексте, имеющих в вики специальные функции. Например, для форматирования слова курсивом вам надо заключить его в две пары одиночных апострофов — вот ''так''.

Разметка для форматирования текста

Описание Вы вводите Вы получаете
Форматирование символов (в строке) — действует везде
Курсивный текст
''Курсив''

Курсив

Полужирный текст
'''Полужирный'''

Полужирный

Полужирный курсив
'''''Полужирный курсив'''''

Полужирный курсив

Отключение вики-разметки
<nowiki>без [[wiki|вики]] ''разметки''</nowiki>

без [[wiki|вики]] ''разметки''

Форматирование заголовка раздела — только в начале строки
Заголовки разных уровней
== Уровень 2 ==

=== Уровень 3 ===

==== Уровень 4 ====

===== Уровень 5 =====

====== Уровень 6 ======

  • Пропуск 1-го уровня, уровень заголовка страницы.
  • это уровень заголовка страницы.
  • В статьях с четырьмя и более заголовками разделов автоматически создаётся таблица содержания (если не установлено волшебное слово __NOTOC__).

Уровень 2

Уровень 3

Уровень 4

Уровень 5
Уровень 6
Горизонтальная черта
Текст до
----
Текст после

Текст до


Текст после

Маркированный список
* Начало каждой строки
* со звезды [[Wikipedia:asterisk|asterisk]] (*).
** Следующая звезда создаст следующий уровень вложенности
*** и еще более глубокий.
* Перенос строки <br> не прерывает уровни вложенности.
*** Однако, если пропустить уровень — создастся пустое пространство.
Любое другое начало строки закончит список.

* сочетание маркированного списка
** с определением
::- определение
** создаёт пустое пространство

* сочетание маркированного списка
** с определением
*:- определение
** без пустого пространства

*маркированный список
:- определение
:* подстановка, которая не создаёт пустые
:* пространства после определения
  • Начало каждой строки
  • со звезды asterisk (*).
    • Следующая звезда создаст следующий уровень вложенности
      • и еще более глубокий.
  • Перенос строки
    не прерывает уровни вложенности.
      • Однако, если пропустить уровень - создастся пустое пространство.

Любое другое начало строки закончит список.

  • сочетайте маркированный список
    • с определением
- определение
    • создаёт пустое пространство
  • сочетайте немаркированный список
    • с определением
    - определение
    • без пустых пространств
  • маркированный список
- определение
  • подпункты, которые не содержат пустых
  • пространств после определения
Нумерованный список
# Начинайте каждую строку
# со [[Wikipedia:Number_sign|знака решётки]] (#)
##  Чем больше знаков решётки,
### Тем большим будет
### отступ.
# Перевод строки <br> не нарушает отступов.
### Но переход через несколько отступов создаёт пустое пространство.
# Пустые строки.

# заканчивайте список и начинайте новый.
Любое другое начало строки также заканчивает список.

<nowiki>#</nowiki> используйте теги "nowiki" для отображения литерала (#) в начале строки, не интерпретируя его как нумерованный список
  1. Начинайте каждую строку
  2. со знака решётки (#)
    1. Чем больше знаков решётки,
      1. Тем большим будет
      2. отступ.
  3. Перевод строки
    не нарушает отступов.
      1. Но переход через несколько отступов создаёт пустое пространство.
  4. Пустые строки.
  1. заканчивайте список и начинайте новый.

Любое другое начало сроки также заканчивает список.

# используйте теги "nowiki" для отображения литерала (#) в начале строки, не интерпретируя его как нумерованный список

Список определений
;пункт 1
: определение 1
;пункт 2
: определение 2-1
: определение 2-2
Если строка начинается с точки с запятой (;), любое двоеточие (:) в конце строки не будет отображаться. Если вы хотите, чтобы двоеточие отображалось, используйте &#58;.
пункт 1
определение 1
пункт 2
определение 2-1
определение 2-2
Отступ текста
: Один отступ
:: Двойной отступ
::: Много отступов

При использовании этого форматирования может нарушаться доступность.
Один отступ
Двойной отступ
Много отступов
Смесь различных типов списков
# один
# два
#* два точка один
#* два точка два
# три
#; элемент три точка один
#: определения для элемента три точка один
# четыре
#: четыре точка один
#: это выглядит как продолжение
#: и часто используется
#: вместо <br> и <nowiki><br></nowiki>
# пять
## пять, подпункт 1 для 
### пять, подпункт 1 для подпункта 1 
## пять, подпункт 2

Использование #: и *: ля разрыва строки внутри элемента также может повредить доступности.
  1. один
  2. два
    • два точка один
    • два точка два
  3. три
    элемент три точка один
    определения для элемента три точка один
  4. четыре
    четыре точка один
    это выглядит как продолжение
    и часто используется
    вместо
    и <br>
  5. пять
    1. пять, подпункт 1 для
      1. пять, подпункт 1 для подпункта 1
    2. пять, подпункт 2
Преформатированный текст
 Каждая строка начинается с пробела.
 Текст '''преформатирован''' и при этом
 '''''может''''' включать ''разметку''.

Этот способ предварительного форматирования применим только к форматированию разделов. Разметки форматирования символов по-прежнему эффективны.
Каждая строка начинается с пробела.
Текст преформатирован и при этом
может включать разметку.
Блоки преформатированного текста
 <nowiki>Начните с пробела в первом столбце,
(до <nowiki>).

Тогда ваш формат блока будет
    сохранён.

Это хорошо для копирования в кода блоков:

def function():
    """строка документации"""

    if True:
        print True
    else:
        print False</nowiki>
Начните с пробела в первом столбце,
(до <nowiki>).

Тогда ваш формат блока будет
    сохранён.

Это хорошо для копирования в кода блоков:

def function():
    """строка документации"""

    if True:
        print True
    else:
        print False

Абзацы

MediaWiki игнорирует одиночные переносы строки. Чтобы начать новый абзац оставьте пустую строку. Вы можете принудительно вставить разрыв строки HTML тегом ‎<br />.

Теги HTML

Некоторые теги HTML разрешены в MediaWiki, например, ‎<code>, ‎<div>, и ‎<span>. Они применяются везде, где вы их вставляете.

Описание Вы вводите Вы получаете
Вложено
(отображается как подчёркнутое в большинстве браузеров)
<ins>Вложено</ins>

или

<u>Подчёркнуто</u>

Вложено

или

Подчёркнуто

Удалено
(отображается зачёркнутым в большинстве браузеров)
<s>Зачёркнуто</s>

или

<del>Удалено</del>

Зачёркнуто

или

Удалено

Текст фиксированной ширины
<code>Исходный код</code>
Исходный код
Блок с цитатой
Текст до
<blockquote>Блок с цитатой</blockquote>
Текст после
Если цитата содержит несколько абзацев, то для правильного отображения теги должны располагаться в отдельных строках, т.е.:
<blockquote>
Первый абзац.

Второй абзац.
</blockquote>

Текст до

Цитата

Текст после

Цитаты
<q>Это цитата</q>
Элемент q не должен использоваться вместо кавычек, которые не являются кавычками; например, неуместно использовать элемент q для обозначения саркастических высказываний.[1]
Это цитата
Комментарий
<!-- Это комментарий -->
Комментарии видны только при редактировании.

Комментарии видны только в режиме редактирования.

Полностью преформатированный текст
<pre>
Текст '''преформатирован''' и
''разметка'' '''''не применяется'''''
</pre>

Для преформатированного текста с разметкой смотрите строку Преформатированный текст в конце предыдущей таблицы.
Текст '''преформатирован''' и ''разметка'' '''''не применяется'''''
Настраиваемое оформление текста
<pre style="color: red">
Текст '''преформатирован''' 
в некотором стиле и
''разметка'' '''''не применяется'''''
</pre>

Стиль CSS может быть назван в атрибуте style.
Текст '''преформатирован''' 
в некотором стиле и
''разметка'' '''''не применяется'''''

продолжение:

Описание Вы вводите Вы получаете
По умолчанию оформленный текст имеет CSS атрибут (white-space: pre-wrap;) для переноса текста в соответствии с доступной шириной
<pre>
Это длинное предложение используется для демонстрации переноса текста. Это дополнительное предложение делает текст еще длиннее. Это дополнительное предложение делает текст еще длиннее.
</pre>
Это длинное предложение используется для демонстрации переноса текста. Это дополнительное предложение делает текст еще длиннее. Это дополнительное предложение делает текст еще длиннее.
Настраиваемое оформление текста с отключенным переносом текста
<pre style="white-space: pre;">
Это длинное предложение используется для демонстрации переноса текста. Это дополнительное предложение делает текст еще длиннее. Это дополнительное предложение делает текст еще длиннее.
</pre>
Это длинное предложение используется для демонстрации переноса текста. Это дополнительное предложение делает текст еще длиннее. Это дополнительное предложение делает текст еще длиннее.

Полный список распознанных тегов — Справка:HTML в вики-разметке .

Вставка символов

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

В крайнем случае, вы можете использовать специальную последовательность символов. Эти последовательности называются сущностями или «мнемониками» HTML. Например, следующая последовательность (сущность) &rarr; при вставке будет отображаться как HTML-символ стрелка вправо →, а &mdash; при вставке будет отображаться как HTML-символ длинное тире —. Those sequences are called HTML character references. For example:

  • the rightwards arrow symbol () can be displayed using the &rarr; sequence
  • an em dash () can be displayed using &mdash;.

Наведите курсор на любой символ, чтобы увидеть объект, который его создаёт. Некоторые символы, недоступные в текущем шрифте, будут отображаться в виде пустых квадратиков.
Символьные сущности HTML
Á á Â â ´ Æ æ À à Α α & Å å Ã ã Ä ä Β β ¦ Ç ç ¸ ¢
Χ χ ˆ © ¤ ° Δ δ ÷ É é Ê ê È è Ε ε Η η
Ð ð Ë ë ƒ ½ ¼ ¾ Γ γ > Í í Î î ¡ Ì ì Ι ι
¿ Ï ï Κ κ Λ λ « < ¯ µ · Μ μ  
¬ Ñ ñ Ν ν Ó ó Ô ô Œ œ Ò ò Ω ω Ο ο ª º Ø ø Õ õ Ö
ö Φ φ Π π ϖ ± £ Ψ ψ " » ® Ρ ρ
Š š § ­ Σ σ ς ¹ ² ³ ß Τ τ Θ θ ϑ Þ þ ˜
× Ú ú Û û Ù ù ¨ ϒ Υ υ Ü ü Ξ ξ Ý ý ¥ ÿ Ÿ Ζ ζ
Описание Вы вводите Вы получаете
Символ авторского права &copy;
©
Символ греческой буквы дельта &delta;
δ
Символ евро &euro;

Список всех мнемонических элементов HTML можно найти в статье Википедии Мнемоники в HTML. Кроме того, MediaWiki поддерживает две нестандартных символьных последовательности: &רלמ; и &رلم;, которые расцениваются как эквивалент &rlm;, который является маркером направления письма справа налево. (Используется при объединении на одной странице текстов на разных языках, которые пишутся справа налево и слева направо.)

HTML-теги и объекты-символы отображаются сами по себе (с их интерпретацией и без нее)

&amp;euro;  → &euro;
<span style="color: red; text-decoration: line-through;">Опечатку надо исправить</span>  → Опечатку надо исправить
&lt;span style="color: red; text-decoration: line-through;">Опечатку надо исправить</span>  → <span style="color: red; text-decoration: line-through;">Опечатку надо исправить</span>

Nowiki для HTML

‎<nowiki /> может запрещать теги (HTML):

  • <<nowiki/>pre>  → <pre>

Но не символ экранирования &:

  • &<nowiki/>amp;  → &

Для вывода символа экранирования & как текста, используйте "&amp;" вместо символа "&" (например, введите "&amp;nbsp;", в результате получится "&nbsp;").

Другие вопросы форматирования

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

Вы можете найти больше о ссылках на Справка:Содержание .

Примечания