Phabricator 管理員手冊/專案

Phabricator 中專案的通用圖示。

在 Phabricator 中，幾乎所有內容都可以組織或與專案相關聯。

在這裡，您將瞭解有關它們的更多資訊。

用例

一些具有不同顏色和用途的 Phabricator 專案。

安裝 Phabricator 後，您可能要做的第一件事就是建立一些專案。例如，使用專案，您可以

• 描述興趣領域以組織您的工作
• 對公司和組織的成員進行分組
• 建立許可權和策略（例如：需要成為專案的成員才能推送到儲存庫）

此外，但不限於

• 一個專案可以有子專案來組織層次結構
• 一個專案可以有許多里程碑來組織釋出、衝刺等。

建立新專案

開啟收藏夾選單，其中包含建立專案條目。

您可以開啟收藏夾選單，從主頁頂部建立專案，然後單擊建立專案。

您可以在以下 URL 找到所有專案

example.com/project/

表單欄位

名稱

將在所有地方顯示的專案名稱，可以在任何搜尋表單中使用。理想情況下，應該使用一個詞。為了方便從評論中連結，多個詞應使用連字元連線。

描述

將在專案主頁中顯示的描述。您可以使用Remarkup語法編寫。第一句話很重要，它將顯示在“瀏覽專案”結果中，因此您可以避免不必要的序言，例如這是一個專案，作為專案，它跟蹤...等。

圖示

一個可能更能說明該專案用途的圖示。

顏色

見上文。還有一個適合截止日期的棋盤格顏色。

附加標籤

用逗號分隔的“備用”名稱，這些名稱可能在從評論或搜尋欄位等處引用該專案時有用。

初始成員

要成為該專案成員的已註冊使用者列表。

可見範圍

誰有權僅檢視該專案。

可編輯範圍

誰有權編輯該專案（更改描述、新增成員等）。

可加入範圍

誰有權僅加入該專案。

請注意，這些策略不會影響與該專案相關的任何內容。在 Phabricator 中，每個元素都設計有自己的策略。

關於專案策略

關於專案的一個重要規則是，按照設計，向物件新增或刪除專案永遠不會影響誰可以看到該物件。

如果您需要在專案中工作時保留某些策略，您可能會對#空間策略感興趣。

空間策略

空間（上游文件）允許使用相同的檢視策略配置物件（如任務）組。一些組可能在其專案中具有特定型別的任務，這些任務只能對組成員可見。在這種情況下，可以為該組設定一個空間。

空間將其“可見範圍”策略應用於空間內的所有物件（如任務）。空間的策略是絕對的，比任何其他策略規則都強。如果使用者無法看到空間，使用者也永遠無法看到空間內的物件，即使它們是該空間中任務的作者、分配者或訂閱者。（要允許不是空間成員的使用者檢視或編輯空間中的物件，需要在物件上應用自定義策略，而不是空間。）除了空間的策略之外，特定物件/任務上的檢視策略仍然適用。

預設情況下，物件位於公共空間（S1）中。任何其他空間都對其物件應用了更嚴格的“可見範圍”策略。

關於附加到私有空間中任務的檔案附件，只有當您使用拖放上傳到任務時，該檔案才受與附加到它的任務相同的策略保護。如果您改為透過 file/upload 直接將檔案上傳到“檔案”應用程式，然後將其附加到任務，則您不會獲得相同的保護。

空間和有限專案的示例

空間不是專案。因此，空間本身不提供看板。為了擁有具有看板和其他功能的 Phabricator 專案，以及限制對專案內任務和其他物件的訪問許可權，可以在 Phabricator 中建立三個獨立的實體

• 一個 Phabricator 專案。該專案本身是公開的。
• 一個 Phabricator 空間。可以在空間內建立公共專案中的任務，在這種情況下，它們對不在空間內的任何人都不可見且不可訪問。
• 一個“ACL 專案”。由於直接管理空間的訪問列表需要管理員訪問許可權，因此可以將空間配置為使用“ACL 專案”的訪問列表。這是一個普通的 Phabricator 專案，可能遵循特殊命名約定以供跟蹤，其成員資格可能由非管理員控制。它不應該用於任務。

重新命名專案

當您重新命名專案時，您可能需要確保在更改名稱後不會留下斷開的連結。

檢查以前的標籤是否保留為“附加標籤”（目前會自動執行）。否則，人們在評論和描述中新增的對您專案的引用將斷開。

提示：如果您的專案有一個易變的名稱，請使用帶有專案編號而不是其名稱的 URL。這會在專案重新命名時為您節省麻煩，因為專案編號保持不變。

這是一個唯一的專案 URL 示例

https://example.com/project/board/5/

這是一個帶有專案名稱的專案 URL 示例

https://example.com/tag/awesome-project-name/

另請參閱

• 專案使用者指南 - 官方文件