Admin: Created page with "TOC Эта страница объясняет синтаксис использования '''изображений''' при редактировании вики-сай…"

Admin — Fri, 30 Nov 2012 13:57:23 GMT

Created page with "__TOC__ Эта страница объясняет синтаксис использования '''изображений''' при редактировании вики-сай…"

New page

__TOC__
Эта страница объясняет синтаксис использования '''изображений''' при редактировании вики-сайта. Обычно требуется, чтобы вы или другой участник [[Help:Managing files/ru|загрузили изображение]] перед тем, как использовать его на вики-странице.

Изображения, которые хранятся на сервере MediaWiki, обычно предоставляются с помощью префикса пространства имён <code>Файл:</code> (также унаследован префикс пространства имён <code>Изображение:</code>, который до сих пор поддерживается как синоним) в качестве целевой ссылки MediaWiki. Альтернативный префикс пространства имён <code>Медиа:</code>, используется для ссылки на оригинальный медиафайл (для отдельного предоставления или скачивания с любой страницы MediaWiki).

== Поддерживаемые медиа-типы изображений ==
Mediawiki подерживает по умолчанию следующие форматы графических файлов:
* .jpg или.jpeg: сжатое растровое изображение в стандартном формате JPEG (формат с потерями, лучше всего подходит для фотографий).
* .png: растровое изображение в формате ''Portable Network Graphics'' (специфицирован ''консорциумом W3'').
* .gif: растровое изображение в унаследованном формате ''Graphics Interchange Format''.

Другие форматы, используемые Викимедиа, и обычно включаемые в других проектах (Они могут требовать установки дополнительных модулей сверх того, что включено по умолчанию):
* .svg: масштабируемое изображение в формате ''Standard Vector Graphics'' (специфицирован ''консорциумом W3''). См. {{mediawiki|Manual:Image_Administration/ru#SVG}}.
* .tiff: формат хранения растровых графических изображений (от англ. ''Tagged image format''). Часто используется для архивных фотографий с высоким разрешением. Часто используется с расширением {{mediawiki|Extension:PagedTiffHandler}} {{smaller|(англ.)}}
* .ogg, .oga, .ogv : Мультимедиаконтейнер Ogg (аудио или видео). Не формат изображений, но обрабатывается аналогично. Часто используется с расширением {{mediawiki|Extension:OggHandler}} {{smaller|(англ.)}}
* .pdf: многостраничный документ в формате ''Portable Document Format'' (первоначально специфицирован компанией ''Adobe''). Часто используется в сочетании с расширением {{mediawiki|Extension:PdfHandler}} {{smaller|(англ.)}}
* .djvu: многостраничный растровый документ в формате ''DejaVu''t (чаще всего, сканы книг). См. {{mediawiki|Manual:How to use DjVu with MediaWiki}} {{smaller|(англ.)}}
*: По умолчанию будут показаны лишь первые страницы .PDF и .DjVu файлов.

Другие медиа-типы могут не поддерживаться в зависимости от вашей версии MediaWiki. Обычно они могут быть загружены, но не могут быть показаны на странице, пока не будет установлено соответствующее расширение.

== Отображение одного изображения ==
=== Синтаксис ===
Полный синтаксис для отображения изображений:
<nowiki>[[</nowiki>Файл:''имя файла.расширение''|''параметр''|''заголовок'']]
раздел «параметры» может отсутствовать или содержать следующие значения, разделенные символом «|»:
* Параметр ''[[#Формат|формата]]'': один из '''border''' and/or '''frameless''', '''frame''', '''thumb''' (или '''thumbnail''');
*: Управляют форматированием и встраиванием изображения в остальную часть страницы.
* Параметр ''[[#Размер и рамка|размера]]'': один из
** ''{ширина}'''''px''' — Изменяет размер изображения в соответствии максимальной шириной в пикселях, не ограничивая его высоту;
** '''x'''''{высота}'''''px''' — Изменяет размер изображения в соответствии максимальной высотой в пикселях, не ограничивая его ширину;
** ''{ширина}'''''x'''''{высота}'''''px''' — Изменяет размер изображения в соответствии в заданной шириной и высотой в пикселях;
** '''upright''' — Изменяет размер изображения в соответствии с разумными размерами, в зависимости от предпочтений пользователя (подходит для изображений, высота которых больше ширины).
*: Обратите внимание, что изображение всегда будет сохранять свои пропорции, и может быть уменьшено (не увеличено) в размере, только если находится в масштабируемом медиа-типе (растровые изображения не могут быть масштабированы).
*: Стандартный максимальный размер зависит от ''формата'', и внутренних размеров изображения (в зависимости от его медиа-типа).
* Параметр ''[[#Горизонтальное выравнивание|горизонтального выравнивания]]'': один из '''left''', '''right''', '''center''', '''none''';
*: Управляют горизонтальным выравниванием (встроенными/блочными или плавающими стилями) изображения в тексте (по умолчанию пусто).
* Параметр ''[[#Вертикальное выравнивание|вертикального выравнивания]]'': один из '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom''';
*: Управляют вертикальным выравниванием без плавающих встроенных изображений в тексте, до или после изображения, и в том же блоке (по умолчанию '''middle''').
* Параметр ''[[#Изменение стандартной целевой ссылки|ссылки]]'': один из
** '''link='''''{цель}'' — Позволяет изменять цель (к произвольной странице или URL) генерируемых ссылок, доступных для отображаемых изображений;
** '''link=''' (без значения) — ({{mediawiki|rev:41727|MediaWiki 1.14+}}) Отображение изображения без каких-либо ссылок, например, <code><nowiki>[[</nowiki>File:Example.jpg|20px|link=]]</code> отобразится как [[File:Example.jpg|20px|link=]].
*: Обратите внимание, что параметр '''link''' не может быть использован в сочетании с '''thumb''' или '''thumbnail''', так как '''thumb''' всегда ссылается на большую версию изображения.
*: Вдобавок, параметр '''link''' не может быть использован в сочетании с '''frame'''.
* Другие конкретные параметры:
** '''alt='''''{альтернативный текст}'' — ({{mediawiki|rev:41837|MediaWiki 1.14+}}) Определяет альтернативный текст (отображается на HTML-атрибут <code>alt="..."</code> генерируемого кода <code><image /></code>) изображения, который будут выведен, если указанное изображение не может быть загружено и встроенные, или, если необходимо использовать альтернативный текст описания (например, при использовании шрифта Брайля).
** '''page='''''{число}'' — Отображает указанный номер страницы (в настоящее время применяется только при показе .DjVu или .PDF файлов).

Параметры могут быть указаны в любом порядке. Если параметры конфликтуют друг с другом, применяется последний, за исключением параметров формата, в которых параметры принимают приоритет по порядку ''frame'', ''thumb'', и ''frameless'' и/или''border''.

If a given option does not match any of the other possibilities, it is assumed to be the caption text. Caption text can contain wiki links or other formatting. If no caption text is supplied a caption is automatically created showing the file name; to completely remove the caption, set it to <code><nowiki></nowiki></code>. For example, <code><nowiki>[[File:Example.jpg|20px|]]</nowiki></code> → [[File:Example.jpg|20px|]].



=== Формат ===
Следующая таблица показывает эффект от применения всех доступных форматов.

{| class="wikitable plainlinks"
|-
!Описание
!Формат
!Результат
{{Help:Images/frame/ru|frame= |ex=формат не определён}}
{{Help:Images/frame/ru|frame=border |ex=рамка, даёт в результате тонкую серую рамку}}
{{Help:Images/frame/ru|frame=frame |ex=врезка, обеспечивает поля, рамку и отображение подписи под изображением}}
{{Help:Images/frame/ru|frame=thumb |ex=миниатюра, то же, что врезка, но с уменьшенным изображением}}
{{Help:Images/frame/ru|frame=frameless|ex=без врезки, то же, что миниатюра, но с шириной, установленной в персональных настройках, без полей и без выравнивания по правому краю
}}
{{Help:Images/frame/ru|frame=frameless|2=border |ex=без врезки, но с рамкой}}
{{Help:Images/frame/ru|2=link=Main Page |ex=внутренняя ссылка}}
{{Help:Images/frame/ru|2=link=http://wikipedia.org |ex=внешняя ссылка}}
{{Help:Images/frame/ru|2=link= |ex=без ссылки (внешней или на страницу описания)}}
|}

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

Обратите внимание, что в письменном виде <code>thumb={имя файла}</code>, вы можете использовать различные изображения для миниатюры.

=== Размер и рамка ===
Среди различных форматов, параметры размера могут быть разными, как показано ниже.
* О том, как отображается, если его размер не указан, см. раздел «[[#Формат|Формат]]» выше.
* Если формат не указан, или указан только <code>border</code>, размер может быть уменьшен и расширен с любым заданным размером.
* В примерах ниже, оригинальный размер изображения составляет 400 × 267 пикселей.
* Изображение с <code>frame</code> всегда игнорирует указанный размер, исходное изображение будет уменьшено, если оно превышает максимально допустимый размер определенный в пользовательских настройках.
* Размер изображения с <code>thumb</code> и <code>frameless</code> может быть уменьшен, но не может быть увеличен за пределы первоначального размера изображения.

{| class="wikitable"
!Формат!!Уменьшенный!! Увеличенный
{{Help:Images/size|frame=|notspec=''(не определено)''}}
{{Help:Images/size|frame=border}}
{{Help:Images/size|frame=frame}}
{{Help:Images/size|frame=thumb}}
{{Help:Images/size|frame=frameless}}
|}

=== Горизонтальное выравнивание ===
Заметьте, что при использовании <code>frame</code> или <code>thumb</code>, по умолчанию действует выравнивание по правому краю (<code>right</code>).

{| class="wikitable"
!Описание
!Формат
!Результат
{{Help:Images/frame/ru|frame=|ex='''выравнивание не определено''', действуют значения по умолчанию}}
{{Help:Images/frame/ru|frame=none|ex=выравнивание определено как '''отсутствующее'''}}
{{Help:Images/frame/ru|frame=center|ex=по центру}}
{{Help:Images/frame/ru|frame=left|ex=по левому краю}}
{{Help:Images/frame/ru|frame=right|ex=по правому краю}}
|}

=== Вертикальное выравнивание ===
Параметры вертикального выравнивания вступят в силу только тогда, когда изображение '''будет''' отображено как встроенный элемент и '''не''' плавающий. Они изменяют способ встраивания изображения по вертикали в текст, присутствующий в том же блоке до и/или после этого изображения в тот же ряде отображения.

Обратите внимание, что отображённые строки текста, где вставляется изображение (и строки текста отображённые после) могут быть перемещены вниз (это приведет к увеличению высоты строки), чтобы высота изображения была полностью отображена согласно этим ограничениям.

<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|40px|border|top]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|40px|border|text-top]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>super: [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|40px|border|super]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>text</del></nowiki>
<nowiki>'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|40px|border|baseline]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''sub:''' [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|40px|border|sub]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|40px|border]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|40px|border|middle]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|40px|border|text-bottom]]</nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki/>
<nowiki></nowiki>
<nowiki><del>текст</del></nowiki>
<nowiki>'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|40px|border|bottom]]</nowiki>
<nowiki><del>текст</del></nowiki>

в результате получится следующее:


<del>текст</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|40px|border|top]]
<del>текст</del>


<del>текст</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|40px|border|text-top]]
<del>текст</del>


<del>текст</del>
'''super:''' [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|40px|border|super]]
<del>текст</del>


<del>текст</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|40px|border|baseline]]
<del>текст</del>


<del>текст</del>
'''sub:''' [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|40px|border|sub]]
<del>текст</del>


<del>текст</del>
'''default:''' [[File:Example.jpg|20px]] [[File:Example.jpg|40px]] [[File:Example.jpg|40px|border]]
<del>текст</del>


<del>текст</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|40px|border|middle]]
<del>текст</del>


<del>текст</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|40px|border|text-bottom]]
<del>текст</del>


<del>текст</del>
'''bottom:''' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|40px|border|bottom]]
<del>текст</del>

=== Прекращение обтекания текстом ===
В некоторых случаях желательно останавливать обтекание текстом плавающего (или других встроенных не-плавающих изображений) изображения. В зависимости от разрешения экрана в браузере и обтекание текста справа от изображения может привести к тому, что заголовок раздела (например, <nowiki>== Мой заголовок ==</nowiki>) окажется справа от изображения, а не под ним, как пользователь может ожидать. Обтекание текстом может быть остановлено путем размещения '''<nowiki> </nowiki>''' перед текстом, который должен начаться ниже плавающего изображения.

Все изображения отображаются как блоки (включая не-плавающие '''отцентрированные''' изображения, '''лево'''- или '''право'''-плавающие изображения, а также плавающие изображения в '''рамках''' или '''миниатюрах''') неявно разрывая окружающие строки текста (прекращения текущего блока текста, изображений, а также создание нового параграфа в тексте после них). Затем они располагаются вертикально вдоль левого или правого края (или вдоль центра линии между этими полями для '''отцентрированных''' изображений).

=== Изменение стандартной целевой ссылки ===
В следующей таблице показано, как изменить цель ссылки (которая по умолчанию является страницой описания изображения), или как её удалить. Изменение ссылки не изменяет формат, описанный в предыдущих разделах.

{|class="wikitable plainlinks"
|-
!Описание
!Формат
!Результат
{{Help:Images/frame/ru|2=link=Main Page|ex=внутренняя ссылка}}
{{Help:Images/frame/ru|2=link=http://wikipedia.org|ex=внешняя ссылка}}
{{Help:Images/frame/ru|2=link=|ex=без ссылки (внешней или страницы файла)}}
|}

'''Предупреждение:'''
: Требования по лицензированию вашего вики-сайта могут не позволять вам удалять все ссылки на страницу с описанием, на которой отображается необходимая атрибуция авторства, авторских прав, условий лицензирования, или более полное описание изображения (в том числе история изменений этого изображения и его описания).
: Если вы измените или удалите целевую ссылку из изображение, вы должны предоставить на странице явную ссылку на эту страницу описания, или явно указать автора, авторские права и ссылку на применимую лицензию, если она отличается от применимой к странице, где изображение используется.
: Правила вашего вики-сайта могут ограничить использование параметра альтернативной ссылки, или даже совсем запретить использование параметра альтернативной ссылки для встраиваемых медиафайлов (в этом случае параметр ссылки будет проигнорирован), или же такие ссылки могут приниматься только после их проверки уполномоченными участниками или администраторами.

== Отображение галереи изображений ==
===Галерея изображений===
Создать галерею '''уменьшенных изображений''' с помощью тега <code><nowiki><gallery></nowiki></code> довольно легко. Его синтаксис таков:
<nowiki><gallery></nowiki>
Image:имя_файл.расширение|подпись
Image:имя_файл.расширение|подпись
{...}
</gallery>

Заметьте, что код изображения не заключается в квадратные скобки, когда он находится внутри тега галереи.

Подписи к рисункам не обязательны, они могут содержать внутренние или внешние ссылки или иное форматирование.

Например:
<nowiki><gallery></nowiki>
File:Example.jpg|Пункт 1
File:Example.jpg|Ссылка на <nowiki>[[Help:Contents/ru|Справку]]</nowiki>
File:Example.jpg
File:Example.jpg
File:Example.jpg|<nowiki>''Курсив''</nowiki>
File:Example.jpg|на странице "<nowiki>{{</nowiki>PAGENAME}}"
</gallery>
будет выглядеть так:
<gallery>
File:Example.jpg|Пункт 1
File:Example.jpg|Ссылка на [[Help:Contents/ru|Справку]]
File:Example.jpg
File:Example.jpg
File:Example.jpg|''Курсив''
File:Example.jpg|на странице "{{PAGENAME}}"
</gallery>

===Параметры===
Тег галереи имеет несколько дополнительных параметров:
<pre><gallery {параметры}>
{изображения}
</gallery></pre>

* <code>caption={подпись}</code>: задаёт подпись к галерее.
* <code>widths={ширина}px</code>: задаёт ширину изображений.
* <code>heights={высота}px</code>: задаёт (максимальную) высоту изображений.
* <code>perrow={целое число}</code>: задаёт количество изображений в строке.

Пример:

Код:
<pre>
<gallery widths=60px heights=60px perrow=7 caption="потрясающие подсолнухи">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>
</pre>

Результат:
<gallery widths=60px heights=60px perrow=7 caption="потрясающие подсолнухи">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

== Ссылки ==
=== Ссылка на страницу описания ===
Если вы поместите внутри ссылки символ двоеточия (<code>:</code>) перед <code>{{ns:image}}:</code>, изображение не будет внедрено, и получившаяся ссылка будет вести на страницу описания этого файла.

<nowiki>[[</nowiki>:{{ns:image}}:{{mediawiki:image_sample}}]]
<nowiki>[[</nowiki>:{{ns:image}}:{{mediawiki:image_sample}}|Подсолнухи]]

даст результат

[[:{{ns:image}}:{{mediawiki:image_sample}}]]
[[:{{ns:image}}:{{mediawiki:image_sample}}|Подсолнухи]]

=== Ссылка на другую страницу ===
Показанный ниже код позволяет создать изображение шириной 50px ссылка с которого ведёт на страницу [[MediaWiki/ru]]:

<nowiki>[[</nowiki>File:Wiki.png|50px|link=MediaWiki/ru]]

[[File:Wiki.png|50px|link=MediaWiki/ru]]

=== Прямая ссылка на файл ===
Вы можете использовать псевдо-пространство имён «{{ns:media}}» для прямых ссылок на файлы, минуя их страницы описания.

<nowiki>[[</nowiki>{{ns:media}}:{{mediawiki:image_sample}}]]
<nowiki>[[</nowiki>{{ns:media}}:{{mediawiki:image_sample}}|Подсолнухи]]

даст результат

[[{{ns:media}}:{{mediawiki:image_sample}}]]
[[{{ns:media}}:{{mediawiki:image_sample}}|Подсолнухи]]

Вы также можете использовать: 

<nowiki>[[</nowiki>{{#special:Filepath}}/{{mediawiki:image_sample}}]]

для ссылок на потенциальные файлы, которые ещё не существуют. Вы также можете использовать следующий код:

<nowiki>{{</nowiki>FILEPATH:{{mediawiki:image_sample}}<nowiki>}}</nowiki>

для генерации корректных внешних URL на файлы, который будет обработан следующим образом: {{FILEPATH:{{mediawiki:image_sample}}}}

== Результаты ==
Перед использованием изображений на странице, системный администратор вашего вики-сайта должен разрешить закачку файлов. Системные администраторы могут также настройить вики-сайт на приём файлов из внешних хранилищ, таких как [http://commons.wikimedia.org/wiki/Заглавная_страница?uselang=ru Викисклад].

==Файлы на других веб-сайтах==
Вы можете ссылаться на внешние файлы, используя тот же самый синтаксис, что и для ссылок на внешние веб-страницы.
<pre>[http://url.for/some/image.png]</pre>
Или задать текст описания:
<pre>[http://url.for/some/image.png текст с описанием ссылки]</pre>
Вы также можете внедрять внешние изображения, если эта возможность включена в вашем вики-проекте (см. {{mediawiki|Manual:$wgAllowExternalImages}}). Для этого просто вставьте URL такого файла:
<pre>http://url.for/some/image.png</pre>

{{Languages|Help:Images}}

[[Category:Help/ru|Images]]

Help:Images/ru - Revision history

Admin: Created page with "__TOC__ Эта страница объясняет синтаксис использования '''изображений''' при редактировании вики-сай…"

Admin: Created page with "TOC Эта страница объясняет синтаксис использования '''изображений''' при редактировании вики-сай…"