跳轉到內容

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://wikibook.tw/w/index.php?title=Zoph/Using_the_commandline_tools/zoph_CLI_client&oldid=4342555"
華夏公益教科書