Справка: тег галереи

Эта страница справки представляет собой практическое руководство . В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не одна из политик или рекомендаций Википедии , и может отражать различные уровни консенсуса и проверки .

Ярлыки H: G H: GT

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

Галерея отображает несколько изображений в виде массива или аналогичного макета.

Галереи могут отображать изображения, сформированные в строки и столбцы, с помощью тега <gallery>...</gallery> парсера (преобразование Wikitext в HTML). Имейте в виду, что разные размеры экрана и браузеры могут повлиять на доступность для некоторых читателей.

Атрибуты и значения [ править ]

• mode=
  • traditional По умолчанию, эффект объяснен ниже
  • nolines Без границ, меньше отступов, подписи по центру изображений
  • packed Все изображения выровнены по высоте, выравниваются по ширине, подписи расположены по центру под изображениями.
  • packed-overlay Как упаковано, но подпись накладывается на изображение, в полупрозрачной рамке
  • packed-hover Подобно упакованному наложению, но заголовок виден только при наведении курсора (постепенно ухудшается в программах чтения с экрана и возвращается к упакованному наложению, если используется сенсорный экран)
  • slideshow Слайд-шоу
• caption= Добавляет общий заголовок над галереей
• widths= Ширина изображения в пикселях (не влияет, если установлен режим «Упаковано», «Упаковано с наложением», «Упаковано с наложением» или «Слайд-шоу»)
• heights= Высота изображения в пикселях (не влияет, если установлен режим слайд-шоу)
• perrow=Количество изображений в строке (не влияет, если режим установлен на упакованный, упакованный наложение, упакованный при наведении курсора или слайд-шоу; см. Примечания по использованию ниже )
• showfilename=yes Показывать каждое имя файла под соответствующим изображением
• class= Одно или несколько имен классов, разделенных пробелами и заключенных в двойные кавычки
• style= Одно или несколько объявлений CSS, разделенных точкой с запятой и заключенных в двойные кавычки.

Примечания по использованию [ править ]

• Неизбирательное использование perrowатрибута категорически не рекомендуется, поскольку он отменяет гибкое использование различных размеров дисплеев и соотношений сторон , от мобильных миниатюрных до широких «киноэкранов». Однако атрибут следует использовать, когда подходит фиксированная сетка , например «до / после», «низкий / средний / высокий» или другие систематические сравнения изображений.
• Если этот параметр perrowне указан, ширина является плавной: одна строка содержит столько изображений, сколько умещается по доступной ширине экрана пользователя, автоматически переносится на столько дополнительных строк, сколько необходимо.
• Опуская perrow теперь рекомендованное по умолчанию . До MediaWiki 1.17 по умолчанию было 4.
• Ширина и высота по умолчанию в настоящее время 120 пикселей. Изображения, отображаемые с помощью <Gallery>...</Gallery>тега, не подчиняются предпочтениям пользователя при просмотре.
• Этот packedрежим автоматически регулирует размеры изображения для оптимального использования доступного пространства дисплея.
• Каждая строка определяет файл изображения. File:Префикс не нужен.
• Параметр «thumb» недействителен и не может использоваться.
• Названия необязательны и отделяются от имени файла вертикальной чертой («|»).
• Скобки («[» или «]») не должны быть включены, за исключением Wikilinks, встроенных в подписи .
• Распространенная ошибка - забыть закрывающий </gallery>тег.
• При использовании обратите внимание, что многие параметры, особенно относящиеся к внешнему виду, могут не применяться или не работать должным образом для определенных скинов (особенно для скина Minerva, используемого мобильным сайтом).

Синтаксис [ править ]

Есть несколько «режимов» галерей.

традиционный :

«Традиционный» режим в настоящее время используется по умолчанию, и поэтому указывать его не нужно. Основной синтаксис:

<галерея>Детройт Паблишинг Ко. - Йомен из стражи (на самом деле Йомен-надзиратель), полное восстановление.jpg | 1Официальная_программа _-_ Woman_suffrage_procession_March_3, _1913 _-_ crop.jpg | 2Терстон, знаменитый фокусник - East Indian Rope Trick.jpg | 3Джозеф Фердинанд Кепплер - пиратский издатель - Puck Magazine - Реставрация Адама Куердена.jpg | 4</gallery>

Который дает:

• 

  1

• 

  2

• 

  3

• 

  4

Если вы хотите убедиться, что любые будущие изменения в режиме галереи по умолчанию сохранят этот стиль галереи, вы можете указать «режим = традиционный», как в примерах ниже.

nolines :

При указании параметра режима «nolines» поля удаляются. Используя тот же синтаксис, что и раньше, но заменив его <gallery>на, <gallery mode=nolines>мы получим:

• 

  1

• 

  2

• 

  3

• 

  4

упаковано :

Изменение <gallery>на <gallery mode=packed>создает центрированную галерею с небольшим или значительно меньшим пространством вокруг каждого изображения (в зависимости от его относительной ширины и высоты), как показано ниже. Это может относительно увеличить некоторые изображения, которые были меньше в приведенных выше видах.

• 

  1

• 

  2

• 

  3

• 4

Для длинных подписей под узкими изображениями, вероятно, лучше всего добавить heights=параметр, чтобы сделать изображения несколько больше, поскольку по умолчанию небольшой размер может привести к некрасивым изображениям. Смотри ниже.

Packed-overlay : используется<gallery mode=packed-overlay>для создания подписей, перекрывающих нижнюю часть изображения. Подписи, вероятно, лучше делать короткими.

• 1

• 2

• 3

• 4

Упаковано-парение :

Это использует <gallery mode=packed-hover>. Наведите указатель мыши на изображения ниже. ПРИМЕЧАНИЕ. По умолчанию это поведение упакованного оверлея на мобильном сайте.

• Подписи

• появляются, когда

• ты

• навести указатель мыши на

Расширенный синтаксис [ править ]

Помимо режима, расширенный синтаксис (см. Справку по тегу галереи и полный список параметров ниже):

<gallery  caption = "Образец галереи  " widths = "180px"  heights = "120px"  >Wiki.pngWiki.png | ПодписаноWiki.png | Подписано с помощью alt-текста | alt = Логотип ВикипедииWiki.png | [[Help: Contents / Links | Links]] можно помещать в подписи.Wiki.png | Теперь можно использовать полную [[MediaWiki]] <br/> [[синтаксис]] ... </gallery>

Что производит:

• Галерея образцов
• С субтитрами

• Подписано с замещающим текстом

• Ссылки можно помещать в подписи.

• Теперь можно использовать полный синтаксис MediaWiki ...
  

Параметры widths=и perrow=ничего не делают в режимах упаковки, наложения с упаковкой или наведения курсора.

Однако heights=в этих режимах этот параметр может быть чрезвычайно полезен. Этот параметр указывает начальную высоту для рендеринга каждой миниатюры изображения, прежде чем изображения, возможно, будутувеличены (с сохранением соотношения размеров) с помощью JavaScript для заполнения строк; при необходимости Javascript будет запрашивать сервер изображений, чтобы получить уменьшенные миниатюры для нескольких масштабов от 100% (указанная начальная высота) до примерно 125%. Это дает красивые галереи, которые могут заполнять страницы, даже если соотношение их размеров не совсем одинаковое, и позволяет использовать фактическую область, доступную для отображения на узких мобильных и больших ноутбуках / настольных компьютерах / телевизорах, а также для печати на различных форматах бумаги. (Этот режим также позволяет автоматически прокручивать по горизонтали галереи, встраивая их в большой контейнер в прокручиваемом контейнере, размер которого соответствует ширине страницы).

Например, возьмем следующее:

<  режим галереи = упаковано >Детройт Паблишинг Ко. - Йомен из стражи (NB на самом деле йомен-надзиратель), full recovery.jpg | Йомен-надзиратель из викторианской эпохи [[фотохром]]Официальная_программа _-_ Woman_suffrage_procession_March_3, _1913 _-_ crop.jpg | Официальная программа Шествия по избирательному праву женщин 1913 года, состоявшегося в Вашингтоне, округ КолумбияТерстон, знаменитый фокусник - Ост-индийский трюк с веревкой.jpg | [[Говард Терстон]] выполняет [[Индийский трюк с веревкой]]Джозеф Фердинанд Кепплер - Пиратский Издатель - Журнал Puck - Реставрация Адама Куердена.jpg | "Пиратский Издатель", сатира на нарушение авторских прав из журнала '' [[Puck (журнал) | Puck]] ''.</gallery>

дает:

• Йомен-надзиратель с фотохрома викторианской эпохи

• Официальная программа Шествия женщин 1913 года, проходившего в Вашингтоне, округ Колумбия.

• Ховард Терстон выполняет трюк с индийской веревкой

• «Пиратский издатель», сатира на нарушение авторских прав из журнала Puck .

Как видите, узость изображения искажает подпись. Это легко исправить, добавив heights=параметр как таковой.

<  режим галереи = высота в упаковке  = 200 пикселей >Детройт Паблишинг Ко. - Йомен из стражи (NB на самом деле йомен-надзиратель), full recovery.jpg | Йомен-надзиратель из викторианской эпохи [[фотохром]]Официальная_программа _-_ Woman_suffrage_procession_March_3, _1913 _-_ crop.jpg | Официальная программа Шествия по избирательному праву женщин 1913 года, состоявшегося в Вашингтоне, округ КолумбияТерстон, знаменитый фокусник - Ост-индийский трюк с веревкой.jpg | [[Говард Терстон]] выполняет [[Индийский трюк с веревкой]]Джозеф Фердинанд Кепплер - Пиратский Издатель - Журнал Puck - Реставрация Адама Куердена.jpg | "Пиратский Издатель", сатира на нарушение авторских прав из журнала '' [[Puck (журнал) | Puck]] ''.</gallery>

дает:

• Йомен-надзиратель с фотохрома викторианской эпохи

• Официальная программа Шествия женщин 1913 года, проходившего в Вашингтоне, округ Колумбия.

• Ховард Терстон выполняет трюк с индийской веревкой

• «Пиратский издатель», сатира на нарушение авторских прав из журнала Puck .

Другой совет по использованию упакованного режима - делайте подписи для особенно узких изображений как можно более короткими.

Подписи [ править ]

Для всех режимов, кроме традиционного, подписи располагаются по центру. Чтобы выровнять заголовки по левому краю, укажите объявление CSS text-align:leftв style=атрибуте:

<  режим галереи = высота упаковки  = 150 пикселей  style = "text-align: left" >Детройт Паблишинг Ко. - Йомен из стражи (NB на самом деле йомен-надзиратель), full recovery.jpg | Йомен-надзиратель из викторианской эпохи [[фотохром]]Официальная_программа _-_ Woman_suffrage_procession_March_3, _1913 _-_ crop.jpg | Официальная программа Шествия по избирательному праву женщин 1913 года, состоявшегося в Вашингтоне, округ КолумбияДжозеф Фердинанд Кепплер - Пиратский Издатель - Журнал Puck - Реставрация Адама Куердена.jpg | "Пиратский Издатель", сатира на нарушение авторских прав из журнала '' [[Puck (журнал) | Puck]] ''.</gallery>

дает:

• Йомен-надзиратель с фотохрома викторианской эпохи

• Официальная программа Шествия женщин 1913 года, проходившего в Вашингтоне, округ Колумбия.

• «Пиратский издатель», сатира на нарушение авторских прав из журнала Puck .

Чтобы центрировать заголовок, когда другие варианты неэффективны, возможно, наиболее надежной альтернативой является использование:

yourimage.jpg | <div style="text-align: center;">yourcaption</div>

Центр [ править ]

Для центрирования галереи используйте class="center":

<gallery class = "center">Детройт Паблишинг Ко. - Йомен из стражи (на самом деле Йомен-надзиратель), полное восстановление.jpg | 1Официальная_программа _-_ Woman_suffrage_procession_March_3, _1913 _-_ crop.jpg | 2Терстон, знаменитый фокусник - East Indian Rope Trick.jpg | 3Джозеф Фердинанд Кепплер - пиратский издатель - Puck Magazine - Реставрация Адама Куердена.jpg | 4</gallery>

Который дает:

• 1

• 2

• 3

• 4

Использование perrowатрибута приведет к тому, что это не сработает. Если требуется определенное количество изображений в строке, используйте отдельные <gallery>элементы. Центрированные галереи используются по умолчанию для большинства различных режимов галереи.

См. Также [ править ]

В MediaWiki есть документация по следующим темам : Справка: изображения # Рендеринг галереи изображений

• Википедия: Политика использования изображений
• Википедия: Руководство по стилю / изображениям
• Википедия: Руководство по стилю / доступности # изображения
• Википедия: расширенный синтаксис изображений
• m: Шаблон: галерея  ( обратные ссылки править )
• Дополнительные параметры галереи : см. Раскрывающийся список для получения дополнительных сведений о коде галереи CSS.
• mw: Help: Images # Визуализация галереи изображений