雨果photosweep相册的创建和管理工具
hugophotoswipe的Python项目详细描述
hugophotosweep是一个易于创建和管理的命令行应用程序 ^使用Hugo静态网站生成器时的{a1}相册。
为什么？
我用雨果创建了我的个人网站，所以所有的源文档都是创建的 作为标记文件。我也想在网站上有相册，使用 photosweep查看器。我还想轻松地设置照片描述，快速 当照片更改时更新相册，并具有响应的图像大小和 自动生成缩略图。雨果擦拭使这一切变得容易 可能的。
查看我的博客文章here 更多关于我制作这个工具的动机。
怎么做？
photosweep需要一些javascript和特定的html格式才能工作，并且 雨果通常使用降价文件。所以，这个程序创建一个降价 基于hugoshortcodes为hugo工作的文件。这些缺点是 然后用来创建photosweep需要的html代码。请参阅docs 快捷方式的目录。
安装
pypi上提供了hugophotosweep，您可以使用pip轻松安装它：
pip install hugophotoswipe
安装之后，您应该只剩下一个hps程序。
使用量
这是一个简短的概述。有关详细说明，请参阅Wiki。
为hugophotosweep创建一个新目录并切换到它。例如：
mkdir hugophotos cd hugophotos
接下来，使用以下命令初始化hugophotosweep配置：
hps init
这将创建一个新的hugophotosweep配置文件，名为 hugophotoswipe.yml。这是一个YAML file。在这个配置文件中，您需要 至少设置markdown_dir和output_dir变量。这些是 分别是需要放置标记的目录和 需要放置已处理照片的目录。你可能还想 设置url_prefix变量，该变量添加在照片路径之前 文件夹。
使用：
hps new
Hugophotosweep会问你新专辑的名字，然后创建一个 有那个名字的目录。尽量保持名字简短，它们不是 这张专辑的最后一个标题。名称中的空格将自动替换 带下划线。在新目录中，您将找到一个album.yml文件，并 空的photos目录。
此时，您应该在photos目录中放置一些照片，然后 在album.yml文件中设置相册的标题字段。你也可以设置 相册日期、版权行和封面图像的文件名。 放在properties行下的键/值对将放在 标记文件的前导，因此您可以在雨果布局中使用它们。为了 例如，您可能需要添加国家字段、相机详细信息等。
在主目录（文件hugophotoswipe.yml所在的目录）中，现在可以 运行：
hps update
若要创建标记文件、调整大小的照片，并将更新 album.yml文件。Hugophotosweep创建大小照片，如 以及使用SmartCrop.py的缩略图。
如果现在打开album.yml文件，您会注意到 照片和散列已经扩展。在photos:下面 将列出目录，每个照片的目录为afile，name， alt，和caption字段。最后三个字段可以由您编辑。 这样做可以帮助你的照片搜索引擎优化，但不是必需的。这个 ^ album.yml文件中的{tt20}$字段用于检测 照片，不需要你编辑。
最后，如果要重新生成所有标记和调整大小的照片，则 始终可以使用：
hps clean
把一切都打扫干净。这当然不会触及原始照片文件。
注释
我注意到，使用SmartCrop.js的缩略图比使用SmartCrop.py的略胜一筹。所以，在hugophotoswipe.yml 文件中，可以将选项use_smartcrop_js设置为True，然后 smartcrop_js_path到smartcrop-cli.js实用程序的路径。这样可以确保缩略图 是克雷亚特德和smartcrop.js。
HugophotosWipe是免费软件，由GNU公众授权 许可证，版本3或更高版本（GPLV3）。版权所有G.J.J.van den burg，所有权利 保留。
如果您遇到任何问题，请在GitHub上打开一个问题。你可以在这里联系我： @GJJvandenBurg。
欢迎加入QQ群-->： 979659372
