Справочник по связыванию и включению содержимого в вики

В МойнМойн есть два основных типа ссылок.

Ссылки МойнМойн поддерживают практически всё, что положено стандартным HTML-ссылкам: относительные и полные пути, якоря и т. д. Далее ссылку на какой-либо объект того же вики мы будем называть внутренней, а ссылку на другой сайт — внешней.

Связывание

Автоматически считаются ссылками (даже в отсутствие скобок) встреченные в тексте: полные 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, см. КакНастраивать.

Вдобавок к стандартным для 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 позволяет сравнить две версии страницы МойнМойн (в примере сравниваются первая и вторая версия титульной страницы сайта МойнМойн)

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

Картинки

Чтобы приложенный к странице файл 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 пикселов.

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

Миниатюры

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

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

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