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

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

• Квадратные скобки ([[  ]]) используются для ссылки на страницу (связывания со страницей) того же вики, на внешний URL, на файл и т. п.

• Фигурные скобки ({{  }}) используются для встраивания (embedding, непосредственного показа) некоторых объектов по ссылке (чаще всего — картинок, но также и текстов).

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

Связывание

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

Встраивание

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

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

Пояснения

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

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

• элементы запроса вида 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}}]]

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

MoinMoin Release 1.9.11 [Revision release], Copyright by Juergen Hermann et al.