Studio CLI icon

Studio CLI

Studio CLI 是 WordPress Studio 的終端機介面,可用命令列管理本機網站、預覽網站、驗證登入與基於 Blueprint 的網站建立流程。

Studio CLI

從終端機使用 WordPress Studio

Studio CLI 是 WordPress Studio 的命令列介面。無論 Studio 應用程式是否開啟,它都可讓你從終端機控制 Studio 功能,而且它隨 Studio 一起提供,也可作為獨立的 npm 模組 `wp-studio`。

此 CLI 針對需要腳本化或終端機控制的本機 WordPress 開發工作流程而設計。文件中涵蓋的範圍包括驗證登入、託管於 WordPress.com 的預覽網站、本機網站管理,以及基於 Blueprint 的網站建立,並支援從網站根目錄執行命令,或透過明確傳入網站路徑來執行。

核心功能

本機網站管理

從終端機管理本機 Studio 網站,包括狀態檢查、建立、啟動、停止、刪除與設定更新。

預覽網站工作流程

建立、列出、更新與刪除暫時性的預覽網站,這些網站託管於 WordPress.com,方便在沒有本機環境時分享本機工作內容。

驗證登入命令

登入、登出並檢查需要已登入使用者的 WordPress.com 功能之驗證狀態,例如預覽網站。

適合終端機的命令結構

以一致的模式呼叫命令,例如 `studio <area> <command> [options]`,並使用 `--path` 來指定目前工作目錄以外的網站目錄。

基於 Blueprint 的網站建立

透過 Studio 使用 Blueprints 建立網站,包括精選 Blueprint 與自訂 JSON Blueprint 檔案。

常見工作流程

  • 本機開發維護

    使用 CLI 透過終端機建立與管理本機 Studio 網站,包括檢查狀態、啟動或停止網站,以及在不開啟應用程式的情況下調整設定。

  • 分享進行中的工作

    為本機專案建立預覽網站,分享產生的 URL 與協作者,之後再用同一組命令更新或刪除該預覽網站。

  • 自動化網站工作流程

    在腳本或建置步驟中執行由 Studio 管理的網站工作流程,當你需要可重複的終端機自動化而非手動操作應用程式時尤其適合。

  • 以帳號為基礎的功能

    在執行依賴登入工作階段的命令之前,先使用驗證命令連結 WordPress.com 帳號,例如預覽網站相關操作。

  • 以 Blueprint 為驅動的設定

    透過 Blueprints 流程建立新的本機網站,或在你想要可重現的起始環境時套用 Blueprint 檔案。

Pros and Cons

Pros

  • 可從終端機運作,很適合腳本與建置步驟工作流程。
  • 可在不開啟桌面應用程式的情況下管理本機 Studio 網站。
  • 支援可分享、託管於 WordPress.com 的預覽網站。
  • 包含驗證登入命令與清楚的 `--help` 入口,可查看命令細節。
  • 可搭配基於 Blueprint 的網站建立與自訂網站路徑使用。

Cons

  • 所提供的文件主要聚焦於命令參考,並未完整說明每個命令類別,包括頁面文字中提到的後續 WP-CLI 區段。
  • 部分功能仰賴 WordPress.com 驗證登入,因此在與預覽網站相關的工作流程中會增加額外的設定步驟。

FAQ

什麼是 Studio CLI?

Studio CLI 是 WordPress Studio 的終端機介面。它以 `studio` 指令呼叫,並支援驗證登入、預覽網站與本機網站管理相關命令。

我要如何取得 Studio CLI?

CLI 隨 Studio 內建提供,也可作為獨立的 npm 模組 `wp-studio` 使用。如果你已安裝 Studio,可以在 Studio 應用程式設定中啟用 CLI。

我可以用 Studio CLI 做什麼?

來源文件記載了預覽網站命令、本機網站管理命令,以及以 Blueprints 建立網站。也提到可透過 Studio 執行 WP-CLI 命令,並將 Studio 整合到腳本與建置步驟中,但所提供文字並未展開詳細的 WP-CLI 流程。

每個命令都需要 WordPress.com 帳號嗎?

某些命令,例如建立預覽網站,需要 WordPress.com 驗證登入。如果你在登出狀態下執行需要驗證的命令,CLI 會回傳錯誤並提示你登入。

我要在哪裡執行 Studio CLI 命令?

大多數命令設計為從 Studio 管理網站的根目錄執行,不過你也可以使用 `--path` 選項指定其他網站目錄。

Quick Facts

類別
開發者工具
產品
Studio CLI
平台
WordPress Studio 桌面應用程式與 npm (`wp-studio`)?
主要指令
`studio`
相關工作流程
驗證登入、預覽網站、本機網站管理、Blueprints