Приложение «Галерея» (Gallery)

Приложение «Изображения» (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:

Поддерживаемые переменные

Глобальные свойства

Данный файл должен быть сохранен в корневую папку Nextcloud (исходная папка).

• Общие_данные_во_внешнем_хранилище (external_shares): установите значение «да» (yes) в корневом файле конфигурации, если нужно загрузить изображения, хранящиеся во внешнем хранилище, при помощи приложения files_external.
• Встроенная_поддержка_масштабируемой_векторной_графики (native_svg): установите значение «да» (yes) в корневом файле конфигурации, чтобы включить рендеринг изображений SVG в вашем веб-обозревателе. Если вы не доверяете источнику файлов SVG, данная настройка может привести к возникновению риска для безопасности.
• Переключение_цвета_фона (background_colour_toggle): установите значение «да» (yes) в корневом файле конфигурации, чтобы включить отображение кнопки, переключающей черный и белый фон на прозрачных изображениях.

Конфигурация альбома

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

Внешний вид

• фон (background): выбор цвета фона при помощи шестнадцатеричного представления данного цвета в системе RGB. Например: «#ffa033». Для того чтобы данное значение не было проигнорировано, его нужно поставить в кавычки. При использовании данной функции настоятельно рекомендуется использовать пользовательскую тему с индикатором загрузки CSS. Данное цветное колесо можно использовать для подбора нужного цвета;
• наследование (inherit): установите значение «да» (yes), если вложенные папки должны наследовать данные настройки.

Отображение альбома

• описание (description): отформатированная строка, которая будет отображаться в поле информации. При использовании меток Yaml описание может занимать несколько строк;
• ссылка на описание (description_link): файл разметки, хранящийся в альбоме, который будет анализироваться и отображаться в поле информации вместо описания;
• авторское право (copyright): отформатированная строка. В ней могут содержаться ссылки на внешние ресурсы;
• ссылка на авторское право (copyright_link): любой файл (например, copyright.html) в альбоме, загружаемый при щелчке по ссылке;
• наследовать (inherit): установите значение «да» (yes), если вложенные папки должны наследовать данные настройки.

Информация о синтаксисе разметки приведена по ссылке: http://www.markitdown.net/markdown.

Сортировка

• сортировка (sorting): по дате (date) или названию (name). Сортировка по дате доступна только для файлов;
• порядок сортировки (sort_order): по возрастанию (asc) или «по убыванию» (des);
• наследовать (inherit): установите значение «да» (yes), если вложенные папки должны наследовать данные настройки.

Примечания

• Если выбран только тип сортировки, будет использоваться порядок сортировки по умолчанию;
• при использовании переменной «порядок сортировки» (sort_order) настройки сортировки будут проигнорированы, при этом по сценарию будет проверено наличие подходящей конфигурации на более высоком уровне;
• для включения какой-либо функции (например, встроенной поддержки масштабируемой векторной графики (SVG)) для опубликованных общих данных нужно создать в данной папке файл конфигурации с соответствующей настройкой;
• при предоставлении доступа к общей папке все файлы, на которые вы ссылаетесь (например, description.md или copyright.md), должны быть добавлены в общую папку, поскольку пользователь не будет иметь доступ к файлам, хранящимся в родительской папке;
• поскольку люди могут загружать всю папку в виде архива, вместо текста в файле конфигурации рекомендуется добавлять все файлы в общую папку.

Примеры

Только сортировка

Применяется только для текущей папки:

Краткое описание и ссылка на документ с заявлением об авторском праве применяется только для текущей папки и всех вложенных в нее папок. Ниже также указан синтаксис, который вы можете использовать для того, чтобы описание занимало несколько строк:

Загрузка изображений из внешних облачных хранилищ

Вы можете добавить стандартные настройки конфигурации в один файл конфигурации:

Включение встроенной поддержки масштабируемой векторной графики (SVG)

Вы можете добавить стандартные настройки конфигурации в один файл конфигурации:

Возможные будущие расширения

Различные параметры сортировки для альбомов.