Правила создания ссылок

Целью ссылок может быть:
- Локальная страница:
  - Путь к ней может указываться абсолютно: имя страницы или основная страница/вложенная страница.
  - Путь также может задаваться относительно: /вложенная страница or ../соседняя страница
- Страницы Интервики: ДругаяВики:имя страницы
- URL: http://server/path
- Страницы и URL могут включать якорь (...#имя_якоря).
Можно использовать [[цель]] для создания ссылки на некий целевой объект.
Можно использовать {{target}} для включения объекта (обычно изображения) в тело страницы.
Можно использовать цель|описание вместо цель для указания текста, соответствующего ссылке (текста ссылок или заголовков/альтернативных текстов у изображений).
Можно использовать цель|текст|праметры вместо цель для задания дополнительных параметров.
Можно использовать цель|{{изображение}} если необходимо показать изображение вместо текста.

URL, страницы ИнтерВики, почтовые адреса и ВикиИмена преобразуются в ссылки автоматически, без указания квадратных скобок.

Справочник

Связывание

Автоматически считаются ссылками (даже в отсутствие скобок) встреченные в тексте: полные URL (например, http://example.net), ссылки ИнтерВики, почтовые адреса и слова в верблюжьем регистре.

Описание	Синтаксис	Примечание
Внутренняя ссылка	`ВикиИмя`	Имя страницы в формате ВикиИмени
Внутренняя ссылка с произвольным именем	`[[что угодно]]`	Имя страницы может быть любым
Ссылка на вложенную страницу	`/ВложеннаяСтраница` или `[[/вложенная страница]]`	Обратите внимание на `/` в начале, это — не полный путь
Ссылка на соседнюю страницу	`../СоседняяСтраница` или `[[../соседняя страница]]`
Ссылка с пояснительным текстом	`[[КакаяТоСтраница\|текст ссылки]]`
Ссылка на раздел страницы того же вики	`[[КакаяТоСтраница#Раздел\|Раздел страницы КакаяТоСтраница]]`	Якорь с именем раздела создаётся автоматически, см. раздел «Якори» ниже
Внутренняя ссылка с пояснительным текстом и параметром	`[[КакаяТоСтраница\|некоторая страница\|target="_blank"]]`	Описание параметров страницы см. ниже
Внутренняя ссылка в виде картинки	`[[КакаяТоСтраница\|{{attachment:картинка.png}}]]`
Внутренняя ссылка в виде картинки, открывающаяся в новом окне	`[[КакаяТоСтраница\|{{attachment:картинка.png}}\|target="_blank"]]`
Ссылка на прикреплённый файл	`[[attachment:изображение.png]]`	Ведёт на прикреплённую к странице картинку `изображение.png`
Ссылка на вложение к другой странице	`[[attachment:КакаяТоСтраница/изображение.png]]`	Ведёт на картинку, прикреплённую к другой странице (в данном случае, к странице `КакаяТоСтраница`)
Ссылка ИнтерВики	`ДругаяВики:страница`	Название вики должно начинаться с большой буквы
Ссылка ИнтерВики общего вида	`[[вики:страница]]`	Можно использовать любое название вики из списка, приведённого на странице ИнтерВики
Внешняя ссылка	`http://example.net/`
Внешняя ссылка с пояснительным текстом	`[[http://example.net/\|сайт для примера]]`
Внешняя ссылка с пояснительным текстом, открывающаяся в новом окне	`[[http://example.net/\|сайт для примера\|target="_blank"]]`	Описание параметров страницы см. ниже
Внешняя ссылка в виде картинки	`[[http://example.net/\|{{attachment:картинка.png}}]]`
Внешняя ссылка в виде картинки, открывающаяся в новом окне	`[[http://example.net/\|{{attachment:картинка.png}}\|target="_blank"]]`
Отделение внутренней ссылки	ВикиСтраница``ми	Если ссылка вида ВикиИмя заканчивается посреди слова, это место можно обозначить с помощью двух грависов (обратных одинарных кавычек)
Слово в верблюжьем регистре, не являющееся ссылкой	`!ВикиИмя`	Управляется параметром `bang_meta` конфигурации, см. КакНастраивать#various

Встраивание

Встраивание (embedding, непосредственный показ) используется для того, чтобы показать некоторый объект (чаще всего — картинку) непосредственно на странице вики. Объект также может быть текстовым или каким-либо иным файлом, главное, чтобы МойнМойн его распознавал. Можно, например, и предоставить ссылку для скачивания файла, и показать содержимое этого файла на той же странице. Подробнее см. ПомощьПоМакроКомандам/EmbedObject.

Примеры встроенных картинок есть на странице ПомощьПоКартинкам

Описание	Синтаксис	Примечание
Встроить прикреплённую картинку	`{{attachment:image.png}}`	Показывает файл-вложение `image.png`
Встроить прикреплённую картинку с текстовым комментарием	`{{attachment:image.png\|текстовый комментарий}}`	Показывает файл-вложение `image.png` с комментарием `alt text`; комментарий — т. н. «альтернативный текст», поле `alt` в HTML — удобен при текстовом просмотре страницы (например, для слабовидящих)
Встроить и выровнять прикреплённую картинку	`{{attachment:image.png\|комментарий\|align="положение"}}`	Показывает файл-вложение `image.png` с комментарием `комментарий` (обязательное поле), выравнивая картинку согласно параметру положение (допустимые значения параметра: top, middle, bottom, right и left)
Встроить прикреплённую картинку и задать её размер	`{{attachment:image.png\|комментарий\|width=100 height=150}}`	Показывает файл-вложение `image.png` с комментарием `комментарий` (обязательное поле), изменяя размер картинки до 100x150 пикселей (можно задать только ширину или высоту, и тогда другой размер будет подобран пропорционально)
Встроить произвольную картинку	`{{http://example.net/image.png}}`	Показывает на странице картинку с любого сайта
Встроить произвольную картинку с комментарием	`{{http://example.net/image.png\|alt text}}`	Показывает на странице картинку с любого сайта, снабдив её комментарием `alt text` (используется при текстовом просмотре страницы)
Встроить и выровнять произвольную картинку	`{{http://example.net/image.png\|комментарий\|align="положение"}}`	Показывает картинку с любого сайта с комментарием `комментарий` (обязательное поле), выравнивая её согласно параметру положение (допустимые значения параметра: top, middle, bottom, right и left)
Встроить произвольную картинку и изменить её размер	`{{http://example.net/image.png\|комментарий\|width=100}}`	Показывает картинку с любого сайта с комментарием `комментарий` (обязательное поле), изменяя ширину картинки до 100 пикселов

Пояснения

URL

Современные «живые» HTML-ссылки бывают довольно сложными, поэтому не всегда очевидно, какая часть текста принадлежит URL, а какая — нет. Вот три способа явно задать границу URL:

Добавить после ссылки пробел,
Добавить после ссылки ШестьОдинарныхКавычек,
Воспользоваться свободной формой задания ссылки (с двойными квадратными скобками).

Допустимы следующие виды URL: http, https, ftp, file и некоторые другие. Параметр конфигурации url_schemas позволяет администратору вики изменять список допустимых видов URL, см. КакНастраивать (HelpOnConfiguration).

Вдобавок к стандартным для HTML видам ссылок, МойнМойн поддерживает схемы attachment и drawing. Эти схемы используются для приложения файлов и описаны на странице ПомощьПоДействиям/AttachFile.

Пробелы

Ссылки, содержащие пробелы, необходимо заключать в двойные квадратные (или фигурные) скобки. Если некоторый вики-сайт поддерживает стандартное кодирование URL (в котором пробел заменяется на %20), для него будет работать соответствующая ИнтерВики-ссылка.

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

Якори

Чтобы поставить якорь в тексте, необходимо использовать макрокоманду Anchor, (см. ПомощьПоМакроКомандам): <<Anchor(якорь)>>, где якорь задаёт имя якоря.

Чтобы сослаться на якорь на текущей странице, используется синтаксис [[#якорь]] или [[#якорь|пояснительный текст]].

Ссылка на на якорь на другой странице вики составляется из имени этой страницы и имени якоря на этой странице, например [[ИмяСтраницы#якорь]] или [[ИмяСтраницы#якорь|пояснительный текст]].

Запрет и ограничение автоматического распознавания ссылок

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

Другой вариант — вставлять два грависа перед большой буквой внутри слова: Имя``Страницы. К сожалению, вставленные символы помешают даже простому поиску слова «ИмяСтраницы» найти его на странице,

Чтобы стандартный URL не превращался в ссылку, заключите его в грависы или в тройные фигурные скобки: `http://...` или {{{http://...}}}.

Параметры ссылок

Параметры ссылки влияют на внешний вид как её самой, так и связанного с нею объекта, а также на то, как обозреватель обрабатывает эту ссылку. Они указываются в поле параметры полной вики-ссылки [[объект|пояснительный текст|параметры]].

Например, если Вы хотите установить прямую ссылку на скачивание прикреплённого файла, то нужно указать это в виде параметра — &do=get, например: [[attachment:ПомощьПоКартинкам/pineapple.jpg|ананас|&do=get]] — ананас

Атрибуты HTML-тега <a>

Можно использовать следующие атрибуты: class, title, target, accesskey (подробнее про атрибуты и про то, что они означают, лучше всего посмотреть в каком-нибудь учебнике по HTML).

Пример:: [[http://moinmo.in/|Вики МойнМойн|class=green dotted,accesskey=1]]
Ссылка выглядит так:: Вики МойнМойн
Использование:: для быстрого перехода по ссылке достаточно нажать указанную атрибутом accesskey клавишу (в Firefox версии 2.0 и больше этот пример вызывается по Alt-Shift-1).

Ссылка, содержащая HTTP-запрос

Если поле параметров содержит строку, формирующую HTTP-запрос (query), она добавляется к ссылке. Как обрабатывать запрос решает сам сайт.

Пример:: [[MoinMoin:MoinMoinWiki|Вики МойнМойн|&action=diff,&rev1=1,&rev2=2]]
Ссылка выглядит как:: Вики МойнМойн
Использование:: запрос вида action=diff позволяет сравнить две версии страницы МойнМойн (в примере сравниваются первая и вторая версия титульной страницы сайта МойнМойн)

Важно помнить, что

элементы запроса вида key=value должны начинаться с амперсанда (&),
при использовании стандартного URL (вида http://...) запрос следует вписывать в этот URL; указание запроса в разделе «параметры» не сработает,
запрос не нужно ни перекодировать, ни экранировать в нём символы с помощью url_quota: всё это сделает МойнМойн.

Картинки

Чтобы приложенный к странице файл imagefile.png отобразился в виде картинки шириной 100 пикселов, можно написать

{{attachment:imagefile.png|картинка фиксированной ширины|width=100}}

Ширина картинки будет увеличена или уменьшена обозревателем до 100 пикселов, при этом высота картинки будет изменена в той же пропорции, что и ширина. Высота картинка размером, допустим, 200 на 400 пикселов в примере выше станет 200 пикселов. Точно так же ссылка вида

{{attachment:imagefile.png|картинка фиксированной высоты|height=100}}

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

{{attachment:imagefile.png|картинка фиксированного размера|width=100 height=150}}

размер картинки будет imagefile.png преобразован к виду 100 на 150 пикселов.

Важно помнить, что:

поле «комментарий» (alt text) во всех случаях обязательно,
сам файл и хранится в неизменном виде, преобразованием размера занимается обозреватель.

Миниатюры

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

[[attachment:imagefile.png|{{attachment:imagefile.png|text describing image|width=100}}]]

Примеры картинок см. на странице ПомощьПоКартинкам.

Прочее

Для дополнительной информации о возможностях синтаксиса см. КакРедактировать. Для дополнительной информации о ссылках на вложенные страницы см. КакРедактировать.ВложенныеСтраницы.

Примеры

Разметка

 * http://moinmoin.wikiwikiweb.de/
 * [http://moinmoin.wikiwikiweb.de/]
 * [http://moinmoin.wikiwikiweb.de/ MoinMoin Homepage]
 * http://moinmoin.wikiwikiweb.de/wiki/newlogo.png
 * [http://moinmoin.wikiwikiweb.de/wiki/newlogo.png]
 * [http://moinmoin.wikiwikiweb.de/wiki/newlogo.png newlogo.png]
 * [http:/wiki/newlogo.png http:/wiki/newlogo.png] неполный URL
 * InterWiki
  * Self:InterWiki
  * MeatBall:InterWiki
  * wiki:MeatBall/InterWiki
  * [wiki:MeatBall/InterWiki]
  * [wiki:MeatBall/InterWiki InterWiki page on MeatBall]
 * user@example.com
 * mailto:user@example.com?subject=test
 * [:InterWiki:InterWiki страница на этой вике]
 * [#anchorname переход к якорю на этой странице]
 * [wiki:Self:OtherPage#anchorname ссылка на якорь на другой странице]
 * [:OtherPage#anchorname:Подписанная ссылка на страницу в этой вики]

Отображение

Для тех, кто не использовал МойнМойн ранее

Синтаксис ссылок стал проще и очевиднее, чем ранее (до версии 1.6):

Всегда используются две квадратные скобки для ссылок и две фигурные для включения
В связи с этим, макрокоманды теперь имеют другой синтаксис вызова: «<<ИмяМакроКоманды(...)>>»
Скобки следует использовать, если цель имеет пробельные символы
Для разделения цели, описания и параметров используется символ вертикальной черты («|»)
Префикс «wiki:» более не используется, достаточно просто имени ИнтерВики
inline: заменён на {{attachment:...}}.
Ссылки ИнтерВики только вида ИмяВики:ИмяСтраницы (синтаксис ИмяВики/ИмяСтраницы более не используется)
Теперь в синтаксисе гораздо меньше магии (и он делает ровно то, что указано)
- Подчёркивание («_») — обычный символ и он отличается от пробела
- Для пробелов необходимо использовать пробелы и для подчёркиваний подчёркивания
- Ссылки на изображения будут ссылками на изображения (а не включать их в страницу)
Для пользователей ранних сборок МойнМойн 1.6: больше не требуется заключать ссылки в двойные кавычки, достаточно использовать квадрантые или фигурные скобки.

Данная разметка была придумана на основе разметки creole (и частично аналогично разметке, используемой в MediaWiki).