Приложение «Изображения» (Pictures) было переписано и улучшено, теперь оно называется «Галерея» (Gallery). Оно поддерживает больше форматов изображений, а также функции сортировки, масштабирования и прокручивания. Кроме того, оно позволяет выполнять дополнительную настройку с помощью простого текстового файла.
На главной странице «Файлы» (Files) в программе Nextcloud нужно нажать на небольшой значок в верхнем правом углу под именем пользователя, чтобы запустить ваше приложение «Галерея» (Gallery). Оно автоматически обнаружит все изображения в папках Nextcloud и наложит названия папок на соответствующие эскизы. Для открытия папки нужно нажать на ее эскиз. В верхнем левом углу будут отображаться два варианта сортировки: по алфавиту и по дате.
После открытия папки щелкните левой кнопкой мыши по любому изображению для перехода в режим показа слайдов. В этом режиме есть следующие функции: кнопка загрузки (сверху в центре), кнопки перехода вперед и назад (слева и справа), кнопка автоматического показа слайдов (в нижнем правом углу) и кнопка закрытия (в верхнем правом углу).

Пользовательские настройки
Вы можете настроить альбом «Галерея» (Gallery) с помощью текстового файла gallery.cnf, который содержит параметры со структурой языка разметки Yaml. Вы можете использовать несколько файлов gallery.cnf; один файл должен находиться в корневой папке Nextcloud (исходной папке), в нем указаны глобальные функции. Также вы можете создать отдельные файлы gallery.cnf для каждого альбома для использования разных свойств для разных альбомов.
Функции
Ниже перечислены общие функции, реализованные на данный момент:
- встроенная поддержка масштабируемой векторной графики (SVG);
- доступ к внешним общим файлам.
Ниже перечислены функции для альбомов, реализованные на данный момент:
- добавление ссылки на файл с описанием;
- ввод заявления об авторском праве непосредственно в файл конфигурации;
- добавление ссылки на файл с заявлением об авторском праве;
- определение типа и порядка сортировки;
- определение цвета фона;
- определение дополнительных альбомов, наследующих конфигурацию главного альбома.
Ниже перечислены функции для показа слайдов, реализованные на данный момент:

- отображение кнопки, позволяющей выбрать фон (черный или белый) для просматриваемого изображения (подходит только для изображений с прозрачным фоном).
Настройка
Файл конфигурации должен иметь имя gallery.cnf. Вы можете использовать несколько файлов gallery.cnf для дополнительных альбомов. Для включения глобальных настроек поместите файл в папку верхнего уровня, который обозначен в графическом веб-интерфейсе пользователя в виде значка домика (после этого будет выполнен переход по адресу: data/<имя_пользователя>/files/). Пример приведен ниже в разделе «Глобальные свойства».
Примечание: для отображения изменений в конфигурации нужно перезапустить веб-обозреватель.
Формат
UTF-8 без маркера последовательности байтов (BOM). Можно использовать файл, созданный в графическом веб-интерфейсе пользователя Nextcloud.
Структура
Вы должны добавить комментарии в файл, чтобы при его открытии становилось ясно, для чего он нужен. В начале комментария нужно поставить значок «#».
В качестве разделителя используются 2 пробела. Запрещено использовать знаки табуляции.
При появлении сообщений об ошибках следует изучить документацию по форматированию для языка YAML.
Ниже приведен пример файла gallery.cnf:
# Gallery configuration file
# Created on 31 Jan 2016 by Nextcloud User
features:
external_shares: yes
native_svg: yes
background_colour_toggle: yes
design:
background: "#ff9f00"
inherit: yes
information:
description: This is an **album description** which is only shown if there
is no `description_link`
description_link: readme.md
copyright: Copyright 2003-2016 [interfaSys sàrl](https://www.interfasys.ch),
Switzerland
copyright_link: copyright.md
inherit: yes
sorting:
type: date
order: des
inherit: yes
Поддерживаемые переменные
Глобальные свойства
Данный файл должен быть сохранен в корневую папку Nextcloud (исходная папка).
- Общие_данные_во_внешнем_хранилище (external_shares): установите значение «да» (yes) в корневом файле конфигурации, если нужно загрузить изображения, хранящиеся во внешнем хранилище, при помощи приложения files_external.
- Встроенная_поддержка_масштабируемой_векторной_графики (native_svg): установите значение «да» (yes) в корневом файле конфигурации, чтобы включить рендеринг изображений SVG в вашем веб-обозревателе. Если вы не доверяете источнику файлов SVG, данная настройка может привести к возникновению риска для безопасности.
- Переключение_цвета_фона (background_colour_toggle): установите значение «да» (yes) в корневом файле конфигурации, чтобы включить отображение кнопки, переключающей черный и белый фон на прозрачных изображениях.
Примечание: общие данные во внешнем хранилище обрабатываются в 20-50 раз медленнее, чем локальные данные. В связи с этим может пройти много времени до отображения всех изображений в общем альбоме.
Конфигурация альбома
Каждый альбом может иметь индивидуальные настройки, задаваемые при помощи различных параметров конфигурации. Параметр «наследовать» (inherit) позволит использовать одну конфигурацию для дополнительных альбомов.
Внешний вид
- фон (background): выбор цвета фона при помощи шестнадцатеричного представления данного цвета в системе RGB. Например: «#ffa033». Для того чтобы данное значение не было проигнорировано, его нужно поставить в кавычки. При использовании данной функции настоятельно рекомендуется использовать пользовательскую тему с индикатором загрузки CSS. Данное цветное колесо можно использовать для подбора нужного цвета;
- наследование (inherit): установите значение «да» (yes), если вложенные папки должны наследовать данные настройки.
Отображение альбома
- описание (description): отформатированная строка, которая будет отображаться в поле информации. При использовании меток Yaml описание может занимать несколько строк;
- ссылка на описание (description_link): файл разметки, хранящийся в альбоме, который будет анализироваться и отображаться в поле информации вместо описания;
- авторское право (copyright): отформатированная строка. В ней могут содержаться ссылки на внешние ресурсы;
- ссылка на авторское право (copyright_link): любой файл (например, copyright.html) в альбоме, загружаемый при щелчке по ссылке;
- наследовать (inherit): установите значение «да» (yes), если вложенные папки должны наследовать данные настройки.
Информация о синтаксисе разметки приведена по ссылке: http://www.markitdown.net/markdown.
Примечание: запрещено добавлять ссылки на строку с заявлением об авторском праве (copyright), если вы используете переменную «ссылка на авторское право» (copyright_link).
Сортировка
- сортировка (sorting): по дате (date) или названию (name). Сортировка по дате доступна только для файлов;
- порядок сортировки (sort_order): по возрастанию (asc) или «по убыванию» (des);
- наследовать (inherit): установите значение «да» (yes), если вложенные папки должны наследовать данные настройки.
Примечания
- Если выбран только тип сортировки, будет использоваться порядок сортировки по умолчанию;
- при использовании переменной «порядок сортировки» (sort_order) настройки сортировки будут проигнорированы, при этом по сценарию будет проверено наличие подходящей конфигурации на более высоком уровне;
- для включения какой-либо функции (например, встроенной поддержки масштабируемой векторной графики (SVG)) для опубликованных общих данных нужно создать в данной папке файл конфигурации с соответствующей настройкой;
- при предоставлении доступа к общей папке все файлы, на которые вы ссылаетесь (например, description.md или copyright.md), должны быть добавлены в общую папку, поскольку пользователь не будет иметь доступ к файлам, хранящимся в родительской папке;
- поскольку люди могут загружать всю папку в виде архива, вместо текста в файле конфигурации рекомендуется добавлять все файлы в общую папку.
Примеры
Только сортировка
Применяется только для текущей папки:
# Gallery configuration file
sorting:
type: date
order: asc
Краткое описание и ссылка на документ с заявлением об авторском праве применяется только для текущей папки и всех вложенных в нее папок. Ниже также указан синтаксис, который вы можете использовать для того, чтобы описание занимало несколько строк:
# Gallery configuration file
information:
description: | # La Maison Bleue, Winter '16
This is our Winter 2016 collection shot in **Kyoto**
Visit our [website](http://www.secretdesigner.ninja) for more information
copyright: Copyright 2015 La Maison Bleue, France
copyright_link: copyright_2015_lmb.html
inherit: yes
Загрузка изображений из внешних облачных хранилищ
Примечание: данные функции могут быть указаны только в корневой папке.
Вы можете добавить стандартные настройки конфигурации в один файл конфигурации:
# Gallery configuration file
features:
external_shares: yes
Включение встроенной поддержки масштабируемой векторной графики (SVG)
Примечание: специальные функции могут быть указаны только в корневой папке.
Вы можете добавить стандартные настройки конфигурации в один файл конфигурации:
# Gallery configuration file
features:
native_svg: yes
Возможные будущие расширения
Различные параметры сортировки для альбомов.