## 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:2010-05-14T18:31:32Z
#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 ||

<<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 пикселов ||

== Пояснения ==
=== 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}}]]
}}}

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