## 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 = Справочник по связыванию и включению содержимого в вики = <> В МойнМойн есть два основных типа ссылок. * Квадратные скобки (`[[ ]]`) используются для ''ссылки'' на страницу (связывания со страницей) того же вики, на внешний URL, на файл и т. п. * Фигурные скобки (`{{ }}`) используются для ''встраивания'' (embedding, непосредственного показа) некоторых объектов по ссылке (чаще всего — картинок, но также и текстов). Ссылки МойнМойн поддерживают практически всё, что положено стандартным HTML-ссылкам: относительные и полные пути, якоря и т. д. Далее ссылку на какой-либо объект того же вики мы будем называть ''внутренней'', а ссылку на другой сайт — ''внешней''. <> == Связывание == Автоматически считаются ссылками (даже в отсутствие скобок) встреченные в тексте: полные URL (например, {{{http://example.net}}}), ссылки ИнтерВики, почтовые адреса и слова в [[ВерблюжийРегистр|верблюжьем регистре]]. ||'''Описание''' || '''Синтаксис''' || '''Примечание''' || || Внутренняя ссылка || `ВикиИмя` || Имя страницы в формате [[ВикиИмя|ВикиИмени]] || || Внутренняя ссылка с произвольным именем || `[[что угодно]]` || Имя страницы может быть любым || || Ссылка на вложенную страницу || `/ВложеннаяСтраница` или `[[/вложенная страница]]` || Обратите внимание на `/` в начале, это — ''не'' полный путь || || Ссылка на соседнюю страницу || `../СоседняяСтраница` или `[[../соседняя страница]]` || || || Ссылка с пояснительным текстом || `[[КакаяТоСтраница|текст ссылки]]` || || || Ссылка на раздел страницы того же вики || `[[КакаяТоСтраница#Раздел|Раздел страницы КакаяТоСтраница]]` || Якорь с именем раздела создаётся автоматически, см. раздел «[[#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 || <> == Встраивание == Встраивание (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: * Добавить после ссылки пробел, * Добавить после ссылки [[Wiki:SixSingleQuotes|ШестьОдинарныхКавычек]], * Воспользоваться свободной формой задания ссылки (с двойными квадратными скобками). Допустимы следующие виды URL: `http`, `https`, `ftp`, `file` и некоторые другие. Параметр конфигурации {{{url_schemas}}} позволяет администратору вики изменять список допустимых видов URL, см. КакНастраивать. Вдобавок к стандартным для HTML видам ссылок, МойнМойн поддерживает схемы `attachment` и `drawing`. Эти схемы используются для приложения файлов и описаны на странице ПомощьПоДействиям/AttachFile. <> === Пробелы === Ссылки, содержащие пробелы, необходимо заключать в двойные квадратные (или фигурные) скобки. Если некоторый вики-сайт поддерживает стандартное кодирование URL (в котором пробел заменяется на {{{%20}}}), для него будет работать соответствующая !ИнтерВики-ссылка. Впрочем, лучше всего не использовать пробелов в ссылках, так как это всё равно неудобно. Копирование и вставка такого URL (например, для пересылки по почте) наверняка разобьёт его на части, перейти на нужную страницу по полученной ссылке будет непросто. <> === Якори === Чтобы ''поставить'' якорь в тексте, необходимо использовать макрокоманду ''Anchor'', (см. ПомощьПоМакроКомандам): `<>`, где `якорь` задаёт имя якоря. Чтобы ''сослаться'' на якорь на текущей странице, используется синтаксис `[[#якорь]]` или `[[#якорь|пояснительный текст]]`. Ссылка на на якорь на другой странице вики составляется из имени этой страницы и имени якоря на этой странице, например `[[ИмяСтраницы#якорь]]` или `[[ИмяСтраницы#якорь|пояснительный текст]]`. <> === Запрет и ограничение автоматического распознавания ссылок === Если необходимо, чтобы слово в верблюжьем регистре не преобразовывалось автоматически как ссылка на станицу вики, перед ним можно поставить восклицательный знак ({{{!}}}): `!ВикиИмя`. Этот метод хорош тем, что не влияет на результаты простого поиска по странице (при поиске точной фразы или регулярного выражения восклицательный знак различается). Другой вариант — вставлять два грависа перед большой буквой внутри слова: {{{Имя``Страницы}}}. К сожалению, вставленные символы помешают даже простому поиску слова «ИмяСтраницы» найти его на странице, Чтобы стандартный URL не превращался в ссылку, заключите его в грависы или в тройные фигурные скобки: {{{`http://...`}}} или `{{{http://...}}}`. <> === Параметры ссылок === Параметры ссылки влияют на внешний вид как её самой, так и связанного с нею объекта, а также на то, как обозреватель обрабатывает эту ссылку. Они указываются в поле '''параметры''' полной вики-ссылки `[[объект|пояснительный текст|параметры]]`. Например, если Вы хотите установить прямую ссылку на скачивание прикреплённого файла, то нужно указать это в виде параметра — `&do=get`, например: `[[attachment:ПомощьПоКартинкам/pineapple.jpg|ананас|&do=get]]` — [[attachment:ПомощьПоКартинкам/pineapple.jpg|ананас|&do=get]] <> ==== Атрибуты HTML-тега ==== Можно использовать следующие атрибуты: `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}}}). <> ==== Ссылка, содержащая 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`: всё это сделает МойнМойн. <> === Картинки === Чтобы приложенный к странице файл `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}}]] }}} Примеры картинок см. на странице ПомощьПоКартинкам.