## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
## Пожалуйста редактируйте (или переводите) системные страницы и страницы помощи только в moinmaster вики!
##master-page:HelpOnLinking
##master-date:2011-01-27T19:35:21Z
#acl -All:write Default
#format wiki
#language ru

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

<<TableOfContents>>

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

 * Квадратные скобки (`[[  ]]`) используются для ''ссылки'' на страницу (связывания со страницей) того же вики, на внешний URL, на файл и т. п.
 * Фигурные скобки (`{{  }}`)  используются для ''встраивания'' (embedding, непосредственного показа) некоторых объектов по ссылке (чаще всего — картинок, но также и текстов).

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

<<Anchor(Linking)>>
== Связывание ==

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

||<tablewidth="100%"rowbgcolor="#ffffcc"25%>'''Описание'''            || '''Синтаксис'''                                                       || '''Примечание''' ||
|| Внутренняя ссылка                                                  || `ВикиИмя`                                                             || Имя страницы в формате [[ВикиИмя|ВикиИмени]] ||
|| Внутренняя ссылка с произвольным именем                            || `[[что угодно]]`                                                      || Имя страницы может быть любым ||
|| Ссылка на вложенную страницу                                       || `/ВложеннаяСтраница` или `[[/вложенная страница]]`                    || Обратите внимание на `/` в начале, это — ''не'' полный путь ||
|| Ссылка на соседнюю страницу                                        || `../СоседняяСтраница` или `[[../соседняя страница]]`                  || ||
|| Ссылка с пояснительным текстом                                     || `[[КакаяТоСтраница|текст ссылки]]`                                    || ||
|| Ссылка на раздел страницы того же вики                             || `[[КакаяТоСтраница#Раздел|Раздел страницы КакаяТоСтраница]]`          || Якорь с именем раздела создаётся автоматически, см. раздел «[[#Anchors|Якори]]» ниже ||
|| Внутренняя ссылка с пояснительным текстом и параметром             || `[[КакаяТоСтраница|некоторая страница|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 ||
|| Ссылки Lotus Notes                                                 ||`[[Notes://GunganCen/CA256992000B94BF/BC4B9A3C3F7C5458CA256A6C001A64F1/B0558F2B9DDB41C3CA25741900006827|Встреча отдела]]` || См. страницу [[/СсылкиNotes]] ||

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

||<tablewidth="100%"rowbgcolor="#ffffcc"25%>'''Описание'''   || '''Синтаксис'''                                                  || '''Примечание''' ||
|| Встроить прикреплённую картинку                           || `{{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 пикселов ||
|| Встраивание видео                                         || `{{attachment:video.mpg}}`                                       || Показывает прикреплённый файл `video.mpg` ||

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

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

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

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

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

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

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

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

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

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


<<Anchor(LimitAutoLinking)>>
=== Запрет и ограничение автоматического распознавания ссылок ===

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

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

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

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

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

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

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

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

  Пример::: `[[MoinMoin:MoinMoinWiki|Вики МойнМойн|&action=diff,&rev1=1,&rev2=2]]`
  Ссылка выглядит как::: [[MoinMoin:MoinMoinWiki|Вики МойнМойн|&action=diff,&rev1=1,&rev2=2]]
  Использование::: запрос вида `action=diff` позволяет сравнить две версии страницы МойнМойн (в примере сравниваются первая и вторая версия титульной страницы сайта МойнМойн)
<!> Важно помнить, что
  * элементы запроса вида `key=value` должны начинаться с амперсанда ({{{&}}}),
  * при использовании стандартного URL (вида `http://...`) запрос следует вписывать в этот URL; указание запроса в разделе «параметры» не сработает,
  * запрос не нужно ни перекодировать, ни экранировать в нём символы с помощью `url_quota`: всё это сделает МойнМойн.

<<Anchor(Images)>>
=== Картинки ===
Чтобы приложенный к странице файл `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) во всех случаях обязательно,
  * сам файл и хранится в неизменном виде, преобразованием размера занимается обозреватель.

<<Anchor(Thumbnails)>>
==== Миниатюры ====
Можно сконструировать ссылку, которая использует встроенную картинку вместо пояснительного текста. В частности, ссылка на картинку любого размера может быть представлена миниатюрой этой картинки:
{{{
[[attachment:imagefile.png|{{attachment:imagefile.png|text describing image|width=100}}]]
}}}

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