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

# 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

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

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