lazygal - 云端在线

程序：

您的姓名

lazygal - 静态网络画廊生成器

概要

懒人 [-h | -v | [选项] 专辑目录]

商品描述

本手册页解释了 懒人 程序。 这个程序是一个静态的网络画廊
用 Python 编写的生成器。

懒人 这样工作：你应该有一个原始的文件存储 - 可能包含
子目录（如果不使用专辑元数据功能，它们的名称将用作标题）。
这是源文件层次结构。 它永远不会被修改 懒人. 那么，当
发射：

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

懒人 将分析源层次结构的内容并（重新）创建目标
层次结构，具有模板定义的所有花里胡哨。 仅缺少零件或
将生成不是最新的部分。 这种机制有局限性
虽然：虽然在源目录、元数据或主题中更新
检测到，自上一代以来命令行选项和配置文件的更改
不是，用户应该手动删除需要再次生成的文件。

配置

这些程序遵循通常的 GNU 命令行语法，长选项以
两个破折号 (`-')。 下面是选项的摘要。 有关完整说明，请参阅
此 -h 开关。

-v - 版
显示程序的版本号并退出。

-h - 帮帮我
显示选项摘要。

- 安静的
除了错误之外，不要输出任何内容。

-调试
输出lazygal正在做的一切。

-o 目标目录 --输出目录=目标目录
将写入网页、幻灯片和拇指的目录（默认为当前
目录）。

-t 主题 --主题=主题
主题名称（在主题目录中查找）或主题完整路径。

--默认样式=默认样式
应用于主题的默认样式。

--模板变量=TPL_VARS
加载所有模板的通用变量，例如 --template-vars='footer=foo
酒吧，颜色=巴兹'. 对于较长的变量内容，使用配置文件更容易
（见 懒人配置文件（5））。

-f --force-gen-页面
强制重建网页，无论其修改时间如何
依赖关系。 这在更改影响这些的配置选项时很方便
（主题、目录扁平化等）。

--干净的目的地
清理不应该存在的文件的目标目录（默认是打印一个
警告但不要删除）。

--检查所有目录
无论源代码修改时间如何，都要彻底浏览所有目录。

-s 图片尺寸 --图像大小=图片尺寸
图像的大小，定义为 姓名=xxy, ..., 例如。 小=800x600，中=1024x768。 这
特殊尺寸 0x0 使用原始尺寸。 请参阅图像调整大小说明
部分以获取有关可用语法的更多信息。

-T THUMBNAIL_SIZE --缩略图大小=THUMBNAIL_SIZE
缩略图的大小，例如。 150x113。 请参阅图像调整大小说明部分以了解
有关可用语法的更多信息。

-q 质量 --质量=质量
生成的 JPEG 图像的质量（默认为 85）。

-O - 原来的
在输出中包含原始照片。

--原始基础=相对路径
不要复制输出目录中的原始照片，而是使用链接它们 相对路径
作为这些链接的基础（丢弃而不 -O).

--orig-符号链接
不要复制输出目录中的原始照片，而是创建指向它们的符号链接
原始位置。 当您计划传输整个目录时，这很有用
这 懒人 生成到其他某个位置，也许与 rsync的，并且您希望
避免为每张照片创建一个额外的副本。

注意：
此选项在 Windows 上不可用； 如果您尝试在该操作上使用它
系统， 懒人 将立即退出，退出状态为 1。

--puburl=PUB_URL
发布 URL（仅对提要生成有用）。

-m --生成元数据
在源树中不存在的元数据描述文件中生成
生成网络画廊。 这将禁用所有其他选项。

-n THUMBS_PER_PAGE --每页拇指数=THUMBS_PER_PAGE
每个索引页的最大拇指数。 这将启用索引分页（0 是
无限）。

--按标签过滤=行李牌
如果设置，lazygal 将仅导出具有其 (IPTC) 标签之一的图片
匹配标签。 也可以使用等效的 AND 和 OR 布尔测试来
过滤标签。 有关更多详细信息，请阅读以下部分 行李牌 筛选.

--图片排序=订单
子库中图像的排序顺序，在“mtime”、“filename”或“exif”之间。 （默认
是“exif”，如果 EXIF 数据可用，则按 EXIF 日期，否则为文件名，排序
之前没有 EXIF 的图像）。 添加 ':reverse' 以反转排序顺序（例如
--pic-sort-by=mtime:反向).

--subgal-排序依据=订单
子画廊的排序顺序，在“exif”（最新图片的 EXIF 日期
子画廊）、'mtime' 或 'dirname'（默认为 'dirname'）。 添加 ':reverse' 来反​​转
排序顺序（例如 --subgal-sort-by=目录名：反向).

--dir-展平深度=LEVEL
目录树在该级别以下展平。 默认为不展平（“否”）。

此选项使程序包含子画廊的网络画廊索引
他们父母的画廊索引，如果他们的级别大于提供的 LEVEL。 该
专辑根级别为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-展平深度=0

index.html <- 包含所有图片的索引
subgal1/img1.html
subgal1/subsubgal1/img2.html
subgal2/img3.html

例如： 3. --dir-展平深度=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=WEBALBUMPIC_BG
网络相册图片背景颜色。 默认是透明的，表示 PNG 格式。
任何其他值，例如红色、白色、蓝色，都使用 JPEG。

--webalbum-图片类型=WEBALBUMPIC_TYPE
要生成什么类型​​的网络相册缩略图。 默认情况下，lazygal 生成
深受喜爱的“凌乱”缩略图，每张都是从相册中随机选择的图片
随机旋转并粘贴在一起。 此默认值也可以通过
将“凌乱”指定为 WEBALBUMPIC_TYPE.

另一方面，将 'tidy' 指定为该选项的值会强制 lazygal
跳过旋转，产生更规则形状的缩略图，也可以
更密集。 如果不是您相册的所有用户都拥有
大屏幕:-)

--keep-gps-数据
不要从 EXIF 标签中删除 GPS 数据。 默认情况下，位置标签被删除
隐私原因。 但是，在某些情况下，位置数据会使
感觉和被需要。 这主要用于假日照片。

THEMES

主题映射到包含以下项目的目录：

主题/共享_*
放置在网络画廊共享目录中的文件，例如 CSS、Javascript、图像或
所有画廊共有的其他资源。

主题/浏览.thtml
主题浏览页面的 XHTML 模板（显示一张图片）。

主题/dirindex.thtml 或 主题/动态索引.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

{
“共享”：[
# 复制为 shared/lib.js
{ "path": "../lib-2.1.js", "dest": "lib.js" },

# 复制为 shared/js/lib-2.1.js
{ "path": "../lib-2.1.js", "dest": "js/" }
]
}

请参考 /usr/share/lazygal/themes 中提供的示例。

专辑 元数据

如果源专辑中的目录包含名为专辑描述的文件，则为
作为专辑元数据的来源进行处理。 格式是从另一张专辑借来的
生成工具 - Matew。 每一行都被视为一个可能的标签，未知的行被视为
干脆忽略了。 该文件的示例内容如下：

例如： 5. 专辑描述

专辑名称“我的专辑”
专辑描述 “描述，可能很长。”
相册图像标识符relative/path/to/image.jpg

否则，用户可以在以下文件中提供元数据。

源目录/专辑名称
用于此专辑目录的标题。

源目录/专辑描述
此专辑目录的描述。 此文件中逐字使用 HTML 标记。

源目录/专辑图片
要在相册图片堆栈顶部使用的图像。

源目录/图片_文件名。评论
用于此特定图像的描述。 请注意HTML标签
如此文件中提供的用于模板中的输出。

Lazygal 还从图像文件中的许多元数据标签中提取信息。 关于图像
描述，Lazygal 按以下顺序搜索评论：

1. 图片.jpeg.comment 文件

2.Exif.Photo.UserComment

3.Exif.Image.ImageDescription

4.Iptc.Application2.对象名称

5.JPEG 注释

使用 onworks.net 服务在线使用 lazygal