RU:Справка:Редактирование Wiki

From OpenStreetMap Wiki
(Redirected from RU:Wiki syntax)
Jump to navigation Jump to search

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

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


Способы редактирования

Длинные строки
  • Вы можете писать текст как есть. Он будет сам переноситься на другую строку.
  • Новая строка в редакторе не разрывает текст.
  • Для разрыва абзацев нужно вставить пустую строку.
  • Для разрыва строки нужно вставить специальный символ.

Пример:

Текст отображается подряд, автоматически создавая переносы.
Для разрыва текста вставьте <br>

Вики код:

Текст отображается <ввод>
подряд, автоматически <ввод>
создавая <ввод>
переносы. <br>Для разрыва <ввод>
текста вставьте <nowiki> <br> </nowiki>

Форматирование текста
  • Включение текста в двойной апостроф (') будет отображаться наклонно.
  • Включение текста в тройной апостроф (') будет отображаться жирно.
  • Включение текста в четверной апостроф (') будет отображаться жирно наклонно.
  • Одиночный апостроф (') выглядит как обычный апостроф.

Пример:

Выделяйте 'свой' текст наклонно, жирно или жирно наклонно

Вики код:

Выделяйте 'свой' текст ''наклонно'', '''жирно''' или '''''жирно наклонно'''''

Специальное форматирование
  • Для избежания автоматического переноса используйте неразрывной пробел &nbsp; как для Школа № 1.
  • Символы '<nowiki>' и '</nowiki>' отключают wiki-синтаксис в словах между ними.
  • Символы '<!-- ', ' -->' позволяют заключать в себя не отображаемый текст (комментарии).

Пример:

Школа № 1


Пишите как хотите.

Вики код:

'''Школа&nbsp№&nbsp1'''

Пишите <!---комментарии---> как хотите.

Первый или несколько первых символов в строке определяют какого вида она будет.
  • Пробел ( ) в начале строки создаёт неформатируюмую строку, которая не переносится.
    Это удобно для списков небольших элементов и полезно для отображения заготовок кода.
  • Звёздочка (*), решётка (#), точка с запятой (;) или двоеточие (:) первым символом показывают пункт списка.
    Использование двух и более символов подряд создают вложенные списки.
  • Строка, начинающаяся с '{|' или '|-' или '|+' или '|' или '!' или '|}' нужна для таблиц.
  • Между знаками '=' в начале и конце строки располагают заголовки секций.
  • Строка, начинающаяся с буквы или цифры, является обычной строкой и может переносится автоматически.
  • Квадратные скобки — одна или две — ([), для ссылки, две фигурные скобки ({{), для шаблона, отображаемых как простой текст, который может переноситься автоматически. Ссылки и шаблоны относятся к обычному тексту и не имеют специальных значений при попадании в начал строки.
  • Строки с не упомянутыми символами чаще всего будут отображаться как эти символы. (A line starting with so far unmentioned characters most likely will be treated as default text.)

Пример:

Пробел в начале строки
  1. Нумерованный элемент
  • Элемент списка
    • Вложенный элемент списка
Отступ
Термин определения
Текст определения


Главная страница

key=value


@ В подписи
§ параграф

Вики код:


   Пробел в начале строки

# Нумерованный элемент
* Элемент списка
** Вложенный элемент списка
 : Отступ

 ; Термин определения
 : Текст определения

[[Main Page | Главная страница]]
{{tag|key|value|pair}}


@ В подписи
§ параграф

Заголовки

Секция начинающаяся заголовком содержит в начале и конце по два или более (но одинаковому) количеству знаков 'равно' (=). Количество знаков является признаком уровня вложенности. Одинарные знаки зарезервированы для названия страницы

При наличии нескольких секций таблица "Содержание" располагается только перед первой секцией. Эта статья содержит более пяти секций и соответственно содержание в начале страницы.

При необходимости расположить "Содержание" в другом месте вставьте __TOC__ для отображения содержания. Можете указать __NOTOC__ в любом месте документа, если не хотите вообще показывать содержание.

Пример:

Заголовок 2

Заголовок 3

Заголовок 4

Вики код:

<nowiki>=== Заголовок 2 === </nowiki>
...
==== Заголовок 3 ====
...
===== Заголовок 4 =====

Списки

Создать список очень просто, поставьте звёздочку (*) первым символом одной или нескольких строк. Будут видны точки списка.

Решётка (#) вместо звёздочки (*) делает нумерованный список. Вместо точек будут идти номера.

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

Пример:

  • Список из
    1. двух уровней
    2. с цифрами
  • снова первый уровень

Вики код:

* Список из
*# двух уровней
*# с цифрами
* снова первый уровень

Вы можете создать список для определения. При помощи начального знака точка с запятой (;) задаётся термин, выделенный жирно, а при помощи двоеточия одно или несколько вариантов текста, поясняющие термин.

Для создания нескольких абзацев пояснения необходимо перед каждым из них ставить двоеточие в начале строки.

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

Примеры:

Определение
пояснение
следующий абзац пояснений

&nbsp;

Название списка
просто сдвиг
на два уровня

Вики код:

 ; Определение
 : пояснение
 : следующий абзац пояснений


 : Название списка
 :: просто сдвиг
 :: на два уровня

Правило: Каждая новая строка списка начинающаяся со специального символа (*, #, ; или : ) это пункт списка. Простая новая строка заканчивает список и отображается как простой текст. Если нужно продолжить пояснительный текст с новой строки вставьте символ <br /> в те части, которые должны быть перенесены оставаясь частью списка (важно для нумерованных списков).

Пример:

  1. Часть текста
    с новой строки
  2. Продолжение

Вики код:

# Часть текста <br /> с новой строки
# Продолжение

Ссылки

Ссылки на части самой wiki очень просты. Просто заключите заголовок статьи в двойные квадратные скобки [[wiki-ссылка]]. Можно добавить пояснение для ссылки вставив символ вертикальной линии (|) и сам текст пояснения [[wiki-ссылка | пояснение]] Для ссылке на статью на другом языке перед названием заголовка статьи допишите двух буквенный префикс языка и двоеточие (:). Результатом станет ссылка вида [[de:wiki-ссылка]] на немецкий вариант статьи.

Пример:

Wiki_Help
Wiki Help (на английском)
Wiki Hilfe (на немецком)

Вики код:

[[Wiki_Help]]
[[Wiki_Help | Wiki Help (на английском)]]
[[de:Wiki_Help | Wiki Hilfe (на немецком)]]

Если нужна ссылка на статью wikipedia, тогда добавьте префиксом к названию статьи Википедии "wikipedia:". Это сделает [[wikipedia:имя статьи]] ссылкой на английскую часть Википедии по-умолчанию. Для других языков между "wikipedia:" и "имя статьи" допишите двух буквенный префикс языка и двоеточие (:). Ссылка на немецкую Википедию — [[wikipedia:de:имя статьи]].

Пример:

wikipedia:Main_Page
wikipedia:de:Main_Page

Вики код:

[[wikipedia:Main_Page]]
[[wikipedia:de:Main_Page]]

Внешние ссылки тоже легко указать. Просто напишите адрес ''http://wiki.openstreetmap.org'' и он станет кликабельной ссылкой с текстом в виде адреса.Для сокращения длины ссылки заключите её в квадратные скобки [внешняя_ссылка] которая будет выглядеть числом-ссылкой — к примеру — [7] . Это коротко но не информативно. Лучше добавить подсказку куда она ведёт. Для этого заключите в одинарные квадратные скобки адрес, a пробел ( ) и пояснение — [внешняя_ссылка пояснение] и она станет ссылкой, выглядящей как пояснение .

Помните, что тут в отличие от ссылок на wiki 'пробел' ( ) разделяет ссылку от пояснения. Все внешние ссылки помечаются специальным значком.

Пример:

http://wiki.openstreetmap.org

Короткая ссылка [1]

OSM-Wiki


Вики код:

http://wiki.openstreetmap.org
Короткая ссылка
[http://wiki.openstreetmap.org]
[http://wiki.openstreetmap.org OSM-Wiki]

Таблицы

Таблица это двумерная сетка состоящая из строк и колонок и задаётся двумя значениями — число строк и число колонок.

Простая таблица состоит из следующих частей:

  • Строка из символов '{|' обозначающих начало таблицы.
  • Допускается строка, начинающаяся с '|+' для заголовка таблицы.
  • Одна или более строк для строки таблицы, каждая начинается с '|-' и обычно ничего не содержит.
  • После каждой строки таблицы указываются её ячейки и их содержимое. Ячейки начинаются с символов (|) и второго любого, кроме плюса (+) или минуса (-) зарезервированных для заголовков и выравнивания.
  • Строка из символов '|}' обозначающих конец таблицы.

Для удобства чтения и избежания неопределённости полезно в ячейках всегда ставить второй символ — пробел.

Пример:

заголовок таблицы
Это таблица
размером 2 х 2

Вики код:

{| align="center"
|+ заголовок таблицы
|- align="center"
| Это
| таблица
|- align="center"
| размером
| 2 х 2


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

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

Пример:

Это
тут другая
таблица

Вики код:

{| border="1"
|- align="center"
| Это
{| align="center"
|- align="center"
| тут другая
|} таблица
|}

Шаблоны

Шаблоны это текстовые макросы. Есть статьи о шаблонах, имеющие собственный ключ (Template:) Шаблоны нужны для использования однотипного текста или структуры статей. Шаблоны подгружаются "на лету" при загрузке статьи. (Можно отключить по-желанию.) Шаблоном является заключённое в двойные фигурные скобки имя шаблона — {{имя_шаблона}}.

У шаблона могут быть параметры. Параметры начинаются за знаком (|) — {{имя_шаблона | параметр}}. Параметры могут иметь своё место — {{имя_шаблона | параметр-1 | | параметр-3 }} — тогда нужно вставлять пробел для пропуска ненужного параметра. Параметры могут иметь имя и тогда его нужно указать как пару ключ-значение {{имя_шаблона | параметр-X=значение-X | параметр-F = значение-F}}. Можете добавлять пробелы для читабельности. Параметры могут иметь значение по-умолчанию, описанное внутри шаблона. Оно будет использовано если вы не зададите своё значение.

Существует много мест где используют шаблоны. Шаблоны используют для создания нескольких одинаковых по структуре страниц. Templates can create infoboxes and alike with parameters and sophisticated formating. Посетите список часто используемых шаблонов в OSM-wiki для просмотра самых популярных шаблонов.

Шаблоны с которыми вы работаете приведены в конце редактируемой страницы. Вы можете перейти по ссылкам и посмотреть что это такое.

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

Пример:

Шаблоны-иконки для:

точка точек
линия линий
замкнутая линия замкнутых линий
полигон полигонов
отношение отношений


Шаблон-тег

key=value

часто используется в wiki


Создаём ссылку
.Keep Right
(Cologne Center)


Вики код:

Шаблоны-иконки для:
  {{Icon|node}} точек
  {{Icon|way}} линий
  {{Icon|closedway}} ...
  {{Icon|area}} полигонов
  {{Icon|relation}} ...


Шаблон-тег
  {{Tag |key|value}}
часто используется в wiki


Создаём ссылку
{{Keepright | lat=50.94 |
long=6.95 | zoom=16 }}
(Cologne Center)

Ссылки на дополнительную информацию

  • Для короткого обзора часто используемого синтаксиса для редактирования wiki смотрите Help:Editing на meta.wikimedia.org на русском
  • Другой обзор используемого синтаксиса для редактировани wiki с примерами на meta.wikimedia.org English
  • Для полного ознакомления с редактированием смотрите тут — Help:Wiki_markup на Википедии English, German (Deutsch) на русском
  • Список статей по помощи вулючая редактирование на wiki — Help:Contents на MediaWiki и прикреплённых страницах. на русском
  • Для общей информации о пользовании этой wiki посетите OSM-страничку Wiki Help (ничего конкретного о редактировании). English German (Deutsch) Русский
  • Для обзора работы редактора смотрите страницу помощи Википедии (ничего конкретного о редактировании). English German (Deutsch) на русском