lazygal - Интернет в облаке

ПРОГРАММА:

ИМЯ

lazygal - генератор статической веб-галереи

СИНТАКСИС

ленивый [-h | -v | [кредита] альбом]

ОПИСАНИЕ

Эта страница руководства объясняет ленивый программа. Эта программа представляет собой статическую веб-галерею
генератор написан на Python.

ленивый работает так: у вас должно быть оригинальное хранилище файлов - возможно, содержащих
подкаталоги (их имена служат заголовками, если не используется функция метаданных альбома).
Это иерархия исходных файлов. Он никогда не будет изменен ленивый. Потом, когда
запуск:

$ lazygal -o / var / www / MyAlbum / home / user / SourceDir

ленивый проанализирует содержимое исходной иерархии и (повторно) создаст целевой
иерархия, со всеми наворотами, определенными шаблонами. Только недостающие части или
части, которые не обновлены, будут созданы. У этого механизма есть ограничение
хотя: хотя обновления в исходном каталоге, в метаданных или в темах
обнаружены изменения в параметрах командной строки и файлах конфигурации с момента последнего поколения
не являются, и пользователь должен вручную удалить файлы, которые необходимо сгенерировать заново.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Эти программы следуют обычному синтаксису командной строки GNU с длинными параметрами, начинающимися с
два тире (`- '). Сводка опций приведена ниже. Полное описание см.
-h переключатель.

-v --версия
Показать номер версии программы и выйти.

-h --Помогите
Показать сводку опций.

--тихий
Не выводите ничего, кроме ошибок.

--отлаживать
Выведите все, что делает lazygal.

-o DEST_DIR --output-directory =DEST_DIR
Каталог, в который будут записаны веб-страницы, слайды и превью (по умолчанию текущий
каталог).

-t ТЕМЫ --theme =ТЕМЫ
Название темы (ищется в каталоге тем) или полный путь к теме.

--default-style =DEFAULT_STYLE
Стиль по умолчанию, применяемый к теме.

--template-vars =TPL_VARS
Общие переменные для загрузки всех шаблонов, например --template-vars = 'нижний колонтитул = нижний колонтитул
bar, color = baz '. Для более длинного содержимого переменных проще использовать файл конфигурации
(См. ленивый.conf(5 г.)).

-f --force-gen-страницы
Принудительно перестраивать веб-страницы независимо от времени их изменения.
зависимости. Это удобно при изменении параметра конфигурации, влияющего на эти
(тема, выравнивание каталогов и т. д.).

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

--check-все-каталоги
Исчерпывающе пройдитесь по всем каталогам независимо от времени модификации исходного кода.

-s РАЗМЕР ИЗОБРАЖЕНИЯ - размер изображения =РАЗМЕР ИЗОБРАЖЕНИЯ
Размер изображений, определите как имя=xxy, ..., например. маленький = 800x600, средний = 1024x768. В
специальные размеры 0x0 используют исходный размер. См. ОПИСАНИЕ ИЗМЕНЕНИЯ РАЗМЕРА ИЗОБРАЖЕНИЯ.
раздел для получения дополнительной информации о доступном синтаксисе.

-T THUMBNAIL_SIZE --thumbnail-size =THUMBNAIL_SIZE
Размер миниатюр, например. 150x113. См. Раздел ОПИСАНИЕ ИЗМЕНЕНИЯ РАЗМЕРА ИЗОБРАЖЕНИЯ для
больше информации о доступном синтаксисе.

-q КАЧЕСТВА - качество =КАЧЕСТВА
Качество сгенерированных изображений JPEG (по умолчанию 85).

-O --оригинальный
Включите исходные фотографии в вывод.

--orig-base =ОТНОСИТЕЛЬНЫЙ_ПУТЬ
Не копируйте исходные фотографии в выходной каталог, вместо этого свяжите их, используя ОТНОСИТЕЛЬНЫЙ_ПУТЬ
в качестве основы для этих ссылок (отбрасывается без -O).

--orig-символическая ссылка
Не копируйте исходные фотографии в выходной каталог, вместо этого создайте символические ссылки на их
оригинальные локации. Это полезно, когда вы планируете переносить весь каталог
, которые ленивый сгенерировано в какое-то другое место, возможно, с Rsync, и вы хотите
избегайте создания дополнительной копии каждой фотографии.

Предупреждение
Эта опция недоступна в Windows; если вы попытаетесь использовать его на этой операционной
системы, ленивый немедленно выйдет со статусом выхода 1.

--puburl =PUB_URL
URL публикации (полезно только для создания фида).

-m --генерировать метаданные
Вместо этого сгенерируйте файлы описания метаданных там, где их нет в исходном дереве.
создания веб-галереи. Это отключает все остальные параметры.

-n THUMBS_PER_PAGE --thumbs-per-page =THUMBS_PER_PAGE
Максимальное количество превью на страницу индекса. Это включает пагинацию индекса (0 - это
без ограничений).

--filter-by-tag =TAG
Если установлено, lazygal будет экспортировать только изображения с одним из их тегов (IPTC).
соответствующий TAG. Также можно использовать эквивалент логических тестов И и ИЛИ для
теги фильтров. Подробнее читайте ниже в разделе TAG ФИЛЬТРАЦИЯ.

--pic-sort-by =ЗАКАЗАТЬ
Порядок сортировки изображений в подгалерее: «mtime», «имя файла» или «exif». (дефолт
'exif', то есть по дате EXIF, если данные EXIF ​​доступны, в противном случае имя файла, сортировка
Ранее изображения без EXIF). Добавьте ': reverse', чтобы изменить порядок сортировки (например,
--pic-sort-by = mtime: обратный).

--subgal-sort-by =ЗАКАЗАТЬ
Порядок сортировки подгалерей среди 'exif' (дата EXIF ​​последнего изображения в
вложенная галерея), mtime или dirname (по умолчанию - dirname). Добавьте ': reverse', чтобы перевернуть
порядок сортировки (например, --subgal-sort-by = dirname: reverse).

--dir-flattening-depth =УРОВЕНЬ
Уровень, ниже которого дерево каталогов сплющено. По умолчанию выравнивание отсутствует («Нет»).

Эта опция заставляет программу включать индекс веб-галереи дочерних галерей в
индекс галереи их родителей, если их уровень выше, чем предоставленный УРОВЕНЬ,
уровень корня альбома равен 0.

Индексные страницы с несколькими галереями (что происходит при использовании этого раздела) показывают
ссылки на изображения в разделах галереи.

В следующих примерах показаны созданные индексы для образца альбома (2 под-галереи,
1 под-под-галерея, по 1 картинке в каждой).

Пример 1. --dir-flattening-depth = Нет (По умолчанию)

index.html <- ссылки на вложенные галереи
subgal1 / index.html <- индекс с img1
subgal1 / img1.html
subgal1 / subsubgal1 / index.html <- индекс с img2
subgal1 / subsubgal1 / img2.html
subgal2 / index.html <- индекс с img3
subgal2 / img3.html

Пример 2. --dir-flattening-depth = 0

index.html <- содержит индекс для всех фото
subgal1 / img1.html
subgal1 / subsubgal1 / img2.html
subgal2 / img3.html

Пример 3. --dir-flattening-depth = 1

index.html <- содержит индекс для всех фото
subgal1 / index.html <- индекс с img1 и img2
subgal1 / img1.html
subgal1 / subsubgal1 / img2.html
subgal2 / index.html <- индекс с img3
subgal2 / img3.html

-z --make-dir-zip
Сделайте zip-архив оригинальных изображений для каждого каталога.

--webalbum-pic-bg =ВЕБАЛБУМПИК_BG
Цвет фона изображения Webalbum. По умолчанию прозрачный и подразумевает формат PNG.
Любое другое значение, например красный, белый, синий, использует JPEG.

--webalbum-pic-type =ВЕБАЛБУМПИК_ТИП
Какие миниатюры веб-альбомов создавать. По умолчанию lazygal генерирует
любимые "грязные" миниатюры со случайно выбранными изображениями из альбома.
повернуты на случайную величину и склеены. Это значение по умолчанию также может быть принудительно установлено
указав "беспорядочный" как ВЕБАЛБУМПИК_ТИП.

С другой стороны, указание tidy в качестве значения этой опции заставляет lazygal
пропустить вращения, что приведет к более правильной форме эскизов, которые также можно
более плотно упакованный. Это может быть преимуществом, если не все пользователи ваших альбомов имеют
огромные экраны :-)

--keep-gps-данные
Не удаляйте данные GPS из тегов EXIF. По умолчанию теги местоположения удаляются для
причины конфиденциальности. Однако бывают ситуации, когда наличие данных о местоположении делает
смысл и желанен. Это в основном предназначено для использования с праздничными фотографиями.

ТЕМЫ

Тема отображается в каталог, содержащий следующие элементы:

тема/ОБЩИЙ_*
Файлы, которые нужно поместить в общий каталог веб-галереи, например CSS, Javascript, изображения или
другие ресурсы, общие для всех галерей.

тема/browse.thtml
Шаблон XHTML для страницы просмотра темы (с отображением одного изображения).

тема/dirindex.thtml или тема/dynindex.thtml
Шаблон XHTML для страницы индекса каталога (изображения и ссылки на вложенные галереи).

В зависимости от того, какой индексный файл присутствует, тема будет:

dirindex.thtml: полностью статический
одна страница HTML для каждого изображения, для каждого размера и один индекс для каждого размера, или

dynindex.thtml: динамический
должен быть сгенерирован только один индекс для каждого каталога.

тема/*.thtml должен быть допустимым XML. Видеть
http://genshi.edgewall.org/wiki/Documentation/xml-templates.html для синтаксиса. Зависимости
для статически включенных шаблонов (т.е. с именами файлов, не вычисляемыми из переменных) являются
автоматически вычисляется: при изменении включенного шаблона программное обеспечение
автоматически определять, какие страницы нужно повторно генерировать. Отсутствующие файлы шаблонов будут
искал в по умолчанию темы.

темаФайлы / SHARED_ * (общие ресурсы для общего каталога) переименовываются, чтобы удалить
ОБЩИЙ_ префикс и:

· Обработано с использованием механизма текстовых шаблонов Genshi (см.
http://genshi.edgewall.org/wiki/Documentation/text-templates.html для синтаксиса.) если
их расширение файла начинается с t,

· В противном случае скопировано в целевой веб-альбом.

Использование манифеста темы тема/manifest.json, можно включать файлы из
другие каталоги, которые будут скопированы в общие файлы веб-альбома.

Пример 4. manifest.json

{
"общий": [
# скопировать как общий / lib.js
{"путь": "../lib-2.1.js", "dest": "lib.js"},

# скопировать как общий / js / lib-2.1.js
{"путь": "../lib-2.1.js", "dest": "js /"}
]
}

Пожалуйста, обратитесь к примерам из / usr / share / lazygal / themes.

АЛЬБОМ METADATA

Если в каталоге исходного альбома содержится файл с именем album_description, он
обрабатывается как источник метаданных альбома. Формат заимствован из другого альбома
генераторный инструмент - Matew. Каждая строка рассматривается как один возможный тег, неизвестные строки -
просто проигнорировал. Ниже приводится пример содержимого этого файла:

Пример 5. альбом_описание

Название альбома "Мой альбом"
Описание альбома "Описание, которое может быть очень длинным".
Идентификатор изображения альбома относительный / путь / к / image.jpg

В противном случае пользователь может предоставить метаданные в следующих файлах.

ИСТОЧНИК_КАТАЛОГ/ название-альбома
Название, используемое для этого каталога альбомов.

ИСТОЧНИК_КАТАЛОГ/ описание-альбома
Описание каталога этого альбома. HTML-теги используются дословно из этого файла.

ИСТОЧНИК_КАТАЛОГ/ альбом-изображение
Изображение для использования в верхней части стопки изображений альбома.

ИСТОЧНИК_КАТАЛОГ/PICTURE_FILENAME.комментарий
Описание, которое нужно использовать для этого конкретного изображения. Обратите внимание, что используются HTML-теги
как предусмотрено в этом файле для вывода в шаблонах.

Lazygal также извлекает информацию из многих тегов метаданных в файлах изображений. Что касается изображения
description, Lazygal ищет комментарии в следующем порядке:

1. рис.jpeg.comment файл

2. Exif.Фото.Комментарий пользователя

3. Exif.Image.ImageDescription

4. Iptc.Приложение2.ИмяОбъекта

5. Комментарий в формате JPEG.

Используйте lazygal онлайн с помощью сервисов onworks.net