快速开始

在你的电脑里创建一个文件夹。
复制一些图片到此文件夹，调整它们的大小以适合网上浏览。注意: 文件名和文件夹必须以字母、数字、 "-"、 "_" 或者 "." 组成。没有空格，没有特别的符号。
使用FTP客户端，复制你的文件夹到 Piwigo 的 "galleries" 文件夹里。
登录你的相册，进入后台管理 » 图片 » 缩略图以创建你的缩略图。
进入后台管理然后点击“快速同步”的大按钮。

恭喜！你已成功地为你的图库创建了第一个相册。

文件夹与文件结构

相册文件夹均放在 Piwigo 的 "galleries" 文件夹里。以下的文件夹树里有一个很小的相册（但使用了很多功能）：

galleries
|-- wedding
|   |-- celebration
|   |   |-- arrival
|   |   |   |-- paul-alone.jpg
|   |   |   +-- sarah-alone.jpg
|   |   +-- departure
|   |       +-- paul-and-sarah.jpg
|   +-- party
|       |-- dancers001.jpg
|       |-- dancers002.jpg
|       +-- dancers003.jpg
+-- honeymoon
|   |-- hotel.png
|   |-- video-from-plane.avi
|   +-- pwg_representative
|       +-- video-from-plane.jpg
+-- photoshoot
    |-- img0001.jpg
    |-- img0002.jpg
    +-- pwg_format
        |-- img0001.cr2
        |-- img0001.cmyk.jpg
        |-- img0001.zip
        |-- img0002.cr2
        +-- img0002.cmyk.jpg

每个在 "galleries" 下面的文件夹都是一个相册。没有级别限制，即可以添加无限级的子相册。
基本上，一个文件代表一个元素。如果文件的扩展名存在于 file_ext 参数配置里，其将可作为 Piwigo 的一个元素(参见 include/config_default.inc.php 文件)。如果文件的扩展名存在于 picture_ext 参数配置里，其将作为一个图片。
图片元素必须要有一张对应的缩略图 (参见以下缩略图的相关说明)
图片元素可以有一个高品质的文件与其关联。如以上 wedding.jpg 的例子。高品质图片不需要前缀。
非图片元素 (如视频，声频，文本文件，一切你想到的...) 均以文件扩展名的默认图标显示。或者，你可以用一张缩略图来代表这个文件 (参见 video.avi 的例子)。
Multiple formats: a photo can be available in several formats. In this example, we have 3 additional formats for img0001.jpg. You can activate this feature with $conf['enable_formats'] = true; in your local configuration and define a list of formats, like $conf['format_ext'] = array('cmyk.jpg', 'cr2', 'zip');
注意: 文件名和文件夹必须以字母、数字、 "-"、 "_" 或者 "." 组成。没有空格，没有特别的符号。
一旦文件、缩略图都放到其正确的位置后，进入 : 后台管理 » 工具 » 同步