Галерея

Плагин галереи изображений является довольно удобным и мощным инструментом. Базовая галерея может быть добавлена путем выбора пространства имен следующим образом:

{{gallery>:namespace}}

Все файлы изображений в выбранном пространстве имен будут добавлены в галерею изображений. Не забывайте «:» перед пространством имен. Вместо использования целого пространства имен изображений вы также можете указать одно изображение - это имеет смысл в сочетании с режимом лайтбокса (см. ниже).

{{gallery>:namespace:someimage.jpg}}

Созданная галерея может быть выровнена с использованием пробелов (по умолчанию - по центру):

{{gallery> namespace}} (выравнивание вправо)
{{gallery>namespace }} (выравнивание слева)
{{gallery> namespace }} (по центру)

Вместо пространства имен вы также можете указывать URL-адрес HTTP (-ов) для любого канала Media RSS или ATOM с приложениями (как это делается на большинстве сайтов для обмена фотографиями, таких как Flickr). Затем изображения будут извлекаться из этого канала:

{{gallery>http://www.23hq.com/rss/schabloni}}

Примечание: поскольку знак вопроса используется для разделения параметров (см. Следующий раздел), URL-адрес не может содержать знак вопроса. Чтобы использовать такой URL-адрес фида с плагином галереи, просто используйте одну из многих коротких URL-сервисов, таких как http://bit.ly.

Например. Вместо « http: //api.flickr.com/services/feeds/photos_public.gne? Id = 22019303 @ N00 & lang = en-us & format = rss_200 использовать сокращенный URL-адрес, например ' http: //bit.ly/HurZM.

Кроме того, чтобы правильно создавать эскизы, вам необходимо установить fetchsize достаточно большим, чтобы загрузить удаленные изображения.

Параметры

Ряд параметров можно установить, добавив их с символом '??' В пространство имен или изображение. Каждый параметр должен быть разделен символом '&'. Параметры по умолчанию для всех параметров могут быть установлены в диспетчере конфигураций. Если параметр включен по умолчанию, его можно отключить в синтаксисе, префикс его слогом «нет». Например. Параметр cache обычно включен и может быть отключен с помощью ключевого слова nocache. Ниже приведен список всех признанных параметров

Параметр Значение по-умолчанию Description
<number>x<number> 120x120 Устанавливает размер для эскизов. Если параметр обрезки не установлен, это граничный ящик, в который будет установлен миниатюра, поддерживая правильное соотношение сторон.
<number>X<number> 800X600 Устанавливает размер связанных изображений в режиме «прямой». Это пограничный ящик, в который будет установлено изображение, поддерживающее правильное соотношение сторон. Обратите внимание на верхний регистр «X»
<number> 5 Число изображений в строке в таблице галереи. Если вы укажете таблицу 0 no, вместо этого все миниатюры добавляются в последовательность
=<number> =0 Ограничивает вывод на заданное количество изображений. 0 означает все
+<number> +0 Пропустить первое число изображений. Полезно с опцией выше
~<number> ~0 Добавьте разбивку на страницы для миниатюр, отображающих количество заданных эскизов на страницу. 0 отключает разбиение на страницы. Pagination добавляется через JavaScript - при отсутствии JavaScript все эскизы отображаются
cache enabled Обычно вывод созданной галереи кэшируется. Когда изображения в выбранном пространстве имен меняются, вам необходимо вручную принудительно обновить страницу галереи кеш. Чтобы отключить кеш для страницы, показывающей галерею, установите параметр «nocache» в качестве опции
crop disabled Сделайте миниатюры точного размера эскиза большого размера, обрезая при необходимости
direct disabled Связать миниатюры с изображениями большего размера не со своей страницей подробностей
lightbox disabled Показывать изображения в окне просмотра модального браузера JavaScript, см. Ниже. Установка этой опции автоматически означает «прямой» режим
reverse disabled Изменить порядок отображаемых изображений
recursive enabled Поиск изображений в данном пространстве имен и во всех подпространствах имен
random disabled Сортировка изображений произвольно. Возможно, вы захотите использовать nocache
modsort disabled Сортировка изображений по дате изменения файла
datesort disabled Сортировка изображений по дате EXIF
titlesort disabled Сортировка изображений по заголовку EXIF
showname disabled Показывать имя файла под эскизами
showtitle disabled Показать тег EXIF Headline в качестве названия под эскизами
Все, что содержит * jpg,gif,png images Это можно использовать для фильтрации списка файлов, найденных в данном пространстве имен. * Работает как простой символ подстановки.

Пример

{{gallery>images:vacation?image_*.jpg&80x80&crop&lightbox}}

Это отображает все изображения, начинающиеся с image_ и заканчивающиеся на .jpg из пространства имен images: vacation. Миниатюры обрезаются до 80x80 пикселей, и изображения будут открываться в режиме лайтбокса.

Пример

{{gallery>?crop&lightbox}}

Это отображает все изображения в текущем пространстве имен, используя 2 параметра. Список параметров начинается с ? , Дополнительные из них объединены с &.

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

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

Для навигации можно использовать следующие клавиши:

Клавиша Действие
Следующее изображение
Предыдущее изображение
ESC Закрыть изображение

Если вы хотите показать заголовок под изображением, используя параметр showtitle, может показаться, что указанное название не так, как вы ожидали (например, einstein.jpg вместо Albert Einstein).

Если вы хотите адаптировать субтитры изображения, показанные в галерее, вам нужно манипулировать тегом EXIF под названием «Заголовок». Это можно сделать с помощью встроенного менеджера файлов. Альтернативы включают ExifTool, для которых даже Windows GUI, Чтобы адаптировать данные EXIF к вашим потребностям. В Windows , маленький просмотрщик изображений IrfanView также может использоваться для изменения только значений IPTC.

Обратите внимание, что EXIF-теги, используемые для отображения, могут быть изменены. По умолчанию используются следующие теги:

  • IPTC:Headline для названия
  • IPTC:Caption-Abstract для описания под изображением в режиме lightboxe
  • IPTC:By-line для имени фотографа
  • IPTC:CopyrightNotice для авторских прав
  • IPTC:Keywords для списка ключевых слов

Загрузка изображений

Загрузка изображений выходит за рамки этого плагина. Не запрашивайте никаких дополнительных функций.

  • Для загрузки нескольких изображений одновременно совместимыми браузерами используйте встроенный файловый менеджер.
  • Загружайте файлы вручную через FTP в каталог data / media. Имейте в виду, что имена изображений должны быть действительными, все строчные буквы, пробелы или специальные символы!
  • Изображения, ранее повернутые на 90 ° и сохраненные в этой ориентации, больше не отображаются таким образом, когда используются в документах.

Кэширование

Вывод галереи кэшируется по умолчанию. Когда вы добавляете фотографии позже, они могут не отображаться в галерее: добавьте & purge = true в конец URL-адреса, чтобы очистить кеш. Подробнее см. документации про кеширование страниц.

Необязательно используйте параметр nocache плагина (не рекомендуется).

Проблемы с EXIF-данными

Проблемы с доступом к данным EXIF или IPTC на изображениях должны сообщаться как ошибки DokuWiki, а не для этого плагина. Вся обработка EXIF находится в ядре DokuWiki. В настоящее время данные EXIF ожидаются в кодировке UTF-8.

Проблемы с лайтбокс

Когда режим лайтбокса не работает, и вместо этого изображения просто открываются в том же окне, JavaScript был неправильно загружен. Это, скорее всего, проблема с браузером-кэшем. Просто выполните шаги, описанные для устранения аналогичной проблемы с очисткой кеша. Также убедитесь, что у вас не установлен какой-либо конфликтный плагин. Вы не должны ** устанавливать какой-либо дополнительный плагин Lightbox.

Изображения не изменяются.

Существуют разные причины, по которым эскизы не создаются:

  • LibGD extension отсутствует ⇒ Установить расширение или настроить DokuWiki для использования imagemagick
  • Расширение libGD установлено, но размер исходного изображения + служебные данные больше, чем memory_limit, установленный в php.ini ⇒ Уменьшите размер исходного изображения или увеличьте memory_limit

Канал MediaRSS отображает «ничего не найдено»

Когда не отображаются изображения из вашего фида, убедитесь, что у вас нет знака вопроса в вашем URL-адресе. Используйте сокращенный URL, как было предложено выше. Также убедитесь, что ваш URL-адрес фида (до сокращения) начинается с http: // или https: // , а не с feed: // . Последний - это просто переименованная HTTP-ссылка - просто переименуйте ее обратно.