跳转到内容

Zoph/使用命令行工具/zoph CLI 客户端

Add links
来自维基教科书，为开放世界提供开放书籍

zoph是 Zoph 0.8.2 及更高版本的命令行界面 (CLI)。您可以使用 CLI 将照片导入 Zoph 并对已在 Zoph 中的照片进行（批量）更改。

多个 Zoph 安装

[编辑 | 编辑源代码]

--instance

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -i
描述 您可以在一个系统上安装多个 Zoph。例如，一个用于您自己的 Zoph 安装，一个用于家庭成员或朋友，或者如果您是 Zoph 开发人员，则一个用于生产，一个用于开发。Web 界面可以通过您使用的 URL 确定您正在使用哪个安装。命令行界面没有 URL，因此它需要不同的方法来确定使用的是哪个 Zoph 实例。
默认 zoph.ini 中的第一个实例
选项 zoph.ini 中定义的实例
示例 zoph --instance production photo.jpg


命令

[编辑 | 编辑源代码]

您只能为 Zoph 提供一个“命令”类型选项，如果提供多个，Zoph 将采用最后一个选项。

--import

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -I
描述 给定的照片列表将被导入 Zoph
默认
选项
示例 zoph --import photo.jpg


--update

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -u
描述 Zoph 将尝试在数据库中找到给定的照片列表并将选项应用于这些照片。您可以提供文件名列表或 ID 列表，请参阅--useIds。
默认
选项
示例 zoph --update photo.jpg


--new

[编辑源代码]
版本 v0.8.4 及更高版本
别名 -N
描述 从 CLI 创建相册、类别、地点和人物
默认
选项 使用 --album "new album"、--category "new category"、--person "new person"、--place "new location"。新对象将直接在根目录下创建，除非指定了--parent。有关 Zoph 如何确定什么是名字和姓氏的详细信息，请参阅--person。
示例 zoph --new --parent "Holidays" --album "Summer 2011"


--version

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -V
描述 显示当前 Zoph 版本。
默认
选项 如果指定了--version所有其他选项都将被忽略
示例 zoph --version


--help

[编辑源代码]
版本 v0.8.2 及更高版本（当前 CVS 版本中未实现）
别名 -h
描述 显示帮助。
默认
选项 如果指定了--help指定
示例 zoph --help


整理器

[编辑 | 编辑源代码]

整理器是 Zoph 的核心，您可以通过这些方式整理照片。

--album

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -a --albums
描述 指定 Zoph 应将给定照片列表添加到其中的一个或多个相册。您可以指定--album多次。
默认
选项 一个或多个相册的名称，用逗号分隔。相册必须预先存在于数据库中。
示例 zoph --album "Summer, Holiday"
zoph -a "Summer" -a "Holiday" photo.jpg


--category

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -c --categories
描述 指定 Zoph 应将给定照片列表添加到其中的一个或多个类别。您可以指定--category多次。
默认
选项 一个或多个类别的名称，用逗号分隔。类别必须预先存在于数据库中。
示例 zoph --category "sun, water" photo.jpg
zoph -c "sun" -c "water" photo.jpg


--person

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -p --persons --people
描述 指定出现在指定照片上的一位或多位人物。您可以指定--person多次。
默认
选项 一位人物或多位人物的名称，用逗号分隔。人物必须预先存在于数据库中。在使用--new 向数据库添加新人物时，Zoph 将尝试确定名称的哪些部分是名字、中间名和姓氏。如果名称是一个词（“John”），Zoph 假设这是名字。如果名称是两个词（“John Doe”），Zoph 将假设这是名字和姓氏。如果名称是 3 个或更多词，Zoph 将假设第一个词是名字，第二个词是中间名，其余所有词是姓氏。如果这没有给出正确的结果，您可以选择使用冒号 (":") 而不是空格来分隔。Zoph 然后将冒号之前的部分设置为名字，然后是中间名、姓氏，最后是“称为”。
示例 zoph --person "Linus Torvalds, Mark Shuttleworth" photo.jpg
zoph -p "Linus Torvalds" -p "Mark Shuttleworth" photo.jpg
zoph --new --person "Linus Torvalds"
zoph --new --person "John Fitzgerald Kennedy"
zoph --new --person "Johnny B.::Goode"
zoph --new --person "John::Doe:Average Joe


--location

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -l --place
描述 指定拍摄指定照片的位置。您可以指定--location只有一次。
默认
选项 一个地点的名称。地点必须预先存在于数据库中。
示例 zoph --location "Rotterdam" photo.jpg
zoph -l "Rotterdam" photo.jpg


--photographer

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -P
描述 指定指定照片的摄影师。您可以指定--photographer只有一次。
默认
选项 一个人的姓名。人物必须预先存在于数据库中。
示例 zoph --photographer "Alan Cox" photo.jpg
zoph -P "Alan Cox" photo.jpg


--fields

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -f --field
描述 指定应为指定照片填充的字段。您可以指定--field多次。
默认
选项 可以使用以下字段
  • date
  • time
  • camera_make
  • camera_model
  • flash_used
  • focal_length
  • exposure
  • compression
  • aperture
  • iso_equiv
  • metering_mode
  • ccd_width
  • focus_dist
  • comment
  • lat
  • lon
  • rating
  • description
  • level
  • view
  • title
示例 zoph --field "rating=10" photo.jpg
zoph -f "description=self portrait" photo.jpg


选项

[编辑 | 编辑源代码]

--thumbs / --no-thumbs

[编辑源代码]
版本 v0.8.2 及更高版本
别名 -t / --nothumbs -n
描述 指定是否应该创建缩略图。
默认 导入时 (--import): 创建缩略图。更新时 (--update): 不创建缩略图。
选项 使用这些命令来覆盖默认值。如果您要为已导入的照片重新创建缩略图，请使用--thumbs。如果您不想在导入时创建缩略图，请使用--no-thumbs.
示例 zoph --import --no-thumbs photo.jpg
zoph --update -t photo.jpg


--exif / --no-exif

[编辑源代码]
版本 v0.8.2 及更高版本
别名 --EXIF / --noexif --no-EXIF --noEXIF
描述 指定是否应该读取 EXIF 日期。
默认 导入 (--import) 时：读取 EXIF 数据。更新 (--update) 时：不读取 EXIF 数据。
选项 使用这些命令来覆盖默认设置。如果你想重新读取已导入照片的 EXIF 日期，请使用--exif。如果你在导入时不想读取 EXIF 数据，请使用--no-exif.
示例 zoph --import --no-exif photo.jpg
zoph --update --exif photo.jpg


--size / --no-size

[edit source]
版本 v0.8.2 及更高版本
别名 (none) / --nosize
描述 指定 Zoph 是否应该更新数据库中存储的照片尺寸。
默认 导入 (--import) 时：使用图像尺寸更新数据库。更新 (--update) 时：不更新尺寸信息。
选项 使用这些命令来覆盖默认设置。如果你想在更新时更新数据库中存储的信息，请使用--size。如果你在导入时不想存储尺寸信息（虽然我找不到这样做的实际用途），请使用--no-size.
示例 zoph --import --no-size photo.jpg
zoph --update --size photo.jpg


--useids

[edit source]
版本 v0.8.2 及更高版本
别名 --useIds --use-ids --useid --use-id
描述 在更新照片时，能够指定数据库 ID 而不是文件名可能很有用。
默认 使用文件名。使用--useids意味着--update
选项 你可以指定一个 ID 列表而不是文件名列表。你可以指定单个 ID 或者 ID 范围。请记住，文件名或 ID 列表是命令中的最后一个选项，并不一定遵循--useids选项。
示例 zoph --update --useids 2 5 11-20 56
zoph --update --useids --album "Summer" 15-60


--move / --copy

[edit source]
版本 v0.8.2 及更高版本
别名
描述 导入照片时，你可以导入照片的副本或将照片移动到 Zoph 图片目录中。
默认 文件被移动。
选项 如果导入的文件是符号链接，在--move的情况下，会导入符号链接指向的文件的副本，并删除符号链接。在--copy的情况下，符号链接不会被删除。
示例 zoph --move photo.jpg
zoph --copy photo.jpg


--dateddirs / --no-dateddirs

[edit source]
版本 v0.8.2 及更高版本
别名 --datedDirs --dated -d / --no-datedDirs --nodateddirs --nodatedDirs
描述 使用日期目录，Zoph 会根据照片的（EXIF-）日期自动创建目录。例如，2010 年 3 月 15 日拍摄的照片将自动放置在名为 2010.03.15 的目录中。
默认 不使用日期目录。
选项
示例 zoph --dateddirs photo.jpg


--hierarchical / --no-hierarchical

[edit source]
版本 v0.8.2 及更高版本
别名 -H --hier / --no-hierarchical --no-hier --nohierarchical --nohier
描述 分层日期目录类似于 日期目录，Zoph 会根据照片的（EXIF-）日期自动创建目录，不同之处在于，使用分层日期目录，会为年、月和日分别创建单独的目录。例如，2010 年 3 月 15 日拍摄的照片将自动放置在以下目录树中2010/03/15.
默认 不使用分层日期目录。
选项
示例 zoph --hierarchical photo.jpg


--hash / --no-hash

[edit source]
版本 v0.8.4 及更高版本
别名
描述 从 v0.8.4 版本开始，Zoph 在数据库中存储每张照片的哈希值。目前这仅用于“共享照片”功能。将来其他功能将使用它，因为它将允许 Zoph 检测照片是否已被更改。
默认 生成哈希值或在使用--update时更新哈希值。
选项
示例 zoph --no-hash photo.jpg


--parent

[edit source]
版本 v0.8.4 及更高版本
别名
描述 使用 --new 选项向数据库添加新对象时，你可以通过指定--parent.
默认 来确定专辑、类别或位置在树中的哪个位置。如果你没有指定父级，新对象将直接放置在根目录下。
选项 --parent 必须位于实际专辑、类别或位置之前。父级仅设置用于下一个 --album、--category 或 --place。
示例 在根专辑下创建一个名为“summer 2011”的新专辑
zoph --new --album "Summer 2011"

在“Holidays”专辑下创建名为“Summer 2011”和“Winter 2011”的新专辑

zoph --new --parent "Holidays" --album "Summer 2011, Winter 2011"

在“Holidays”专辑下创建名为“Summer 2011”和“Winter 2011”的新专辑，并在根专辑下创建名为“Trees”的专辑

zoph --new --parent "Holidays" --album "Summer 2011, Winter 2011" --album "Trees"

在“Holidays”专辑下创建名为“Summer 2011”和“Winter 2011”的新专辑，并在“Nature”专辑下创建名为“Trees”的专辑

zoph --new --parent "Holidays" --album "Summer 2011, Winter 2011" --parent "Nature" --album "Trees"

在“Holidays”专辑下创建名为“Summer 2011”的新专辑，并在“Nature”类别下创建名为“Trees”的类别
zoph --new --parent "Holidays" --album "Summer 2011" --parent "Nature" --category "Trees"


--autoadd

[edit source]
版本 v0.8.4 及更高版本
别名 -A --auto-add
描述 你可以使用 --new 从 CLI 添加专辑、类别、位置和人物，使用 autoadd，你可以在导入照片的同时添加它们。Zoph 会添加你已指定但不存在的任何专辑、类别等。但是，为了保护你免受任何打字错误被自动添加到数据库中，只有以 --parent 开头的项目才会被添加，除非你指定 --addalways。当然，这仅适用于专辑、类别和位置，不适用于人物和摄影师。
默认
选项
示例 zoph --autoadd --album "Summer 2011" IMG_1234.JPG
“Summer 2011”没有父级专辑
zoph --autoadd --parent "Holidays" --album "Summer 2011" IMG_1234.JPG

--addalways

[edit source]
版本 v0.8.4 及更高版本
别名 -w --add-always
描述 使用 --autoadd 时，zoph 通过仅添加以 --parent 开头的专辑、类别和位置，来保护你免受任何打字错误被自动添加到数据库中。要覆盖此行为，请使用--addalways，它会导致它们被添加到根专辑、类别或位置下。
默认 除非指定了父级，否则不要添加专辑、类别或位置。
选项
示例 zoph --autoadd --addalways --album "Summer 2011" IMG_1234.JPG


--recursive

[edit source]
版本 v0.8.4 及更高版本
别名 -r
描述 使用--recursive，Zoph 将递归遍历添加到文件列表中的目录，并导入在这些目录中找到的照片。
默认 如果你尝试导入目录，Zoph 会出错。
选项
示例 zoph -r IMG_1234.JPG Photos/
导入图像 IMG_1234.JPG 和“Photos”目录中的任何照片，或该目录下的任何目录。


--dirpattern

[edit source]
版本 v0.8.4 及更高版本
别名
描述 使用--dirpattern，你可以根据照片所在的目录自动分配专辑、类别、人物、摄影师、位置或路径。你可以通过指定一个模式来实现，Zoph 将根据该模式使用目录名称来分配到正确的组织者。此模式由字母列表组成，其中每个字母代表一个目录。如果你没有指定 --recursive，则此选项没有意义。

默认值=无默认值。

默认 {{{Default}}}
选项 a (专辑)、c (类别)、l (位置)、p (人物)、P (摄影师) 和 D (路径)
示例 zoph -r --dirpattern "Paccc" *
导入当前目录和该目录下的所有目录中的所有文件。对于每个路径，将第一个目录的名称分配为摄影师，第二个目录的名称分配为专辑，第三、第四和第五个目录的名称分配为类别。有关更详细的示例，请参阅 [dirpatterns]


--path

[edit source]
版本 v0.8.2 及更高版本
别名
描述 {{{Description}}}
默认 照片直接导入到图片目录下。
选项 有效路径，相对于图片目录。
示例 zoph --path "holiday" photo.jpg
zoph --path "travel/business" --dateddirs photo.jpg
Retrieved from "https://wikibooks.cn/w/index.php?title=Zoph/Using_the_commandline_tools/zoph_CLI_client&oldid=4342555"
华夏公益教科书