Справочник по связыванию и включению содержимого в вики
Contents
В МойнМойн есть два основных типа ссылок.
Квадратные скобки ([[ ]]) используются для ссылки на страницу (связывания со страницей) того же вики, на внешний URL, на файл и т. п.
Фигурные скобки ({{ }}) используются для встраивания (embedding, непосредственного показа) некоторых объектов по ссылке (чаще всего — картинок, но также и текстов).
Ссылки МойнМойн поддерживают практически всё, что положено стандартным 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 позволяет сравнить две версии страницы МойнМойн (в примере сравниваются первая и вторая версия титульной страницы сайта МойнМойн)
Важно помнить, что
элементы запроса вида 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}}]]Примеры картинок см. на странице ПомощьПоКартинкам.