使用GitHub網頁介面建立目的地檔案頁面

以下指示說明如何使用GitHub網頁介面來撰寫檔案及提交提取請求(PR)。 在執行此處指示的步驟之前,請務必閱讀Adobe Experience Platform目的地的檔案

設定您的GitHub製作環境

  1. 在您的瀏覽器中,導覽至https://github.com/AdobeDocs/experience-platform.en

  2. 若要取用存放庫取用,請按一下​取用,如下所示。 如此會在您自己的GitHub帳戶中建立Experience Platform存放庫復本。

    分支Adobe檔案存放庫

  3. 在存放庫的復本中,為專案建立新分支,如下所示。 使用這個新分支進行工作。

    建立新的GitHub分支

  4. 在取用存放庫的GitHub資料夾結構中,導覽至experience-platform.en/help/destinations/catalog/[...],其中[...]是您目的地的所需類別。 例如,如果您要新增個人化目的地以Experience Platform,請選取personalization類別。 選擇​添加檔案>建立新檔案

    新增檔案

  5. 將目的地命名為YOURDESTINATION.md,其中YOURDESTINATION是Adobe Experience Platform中目的地的名稱。 例如,如果貴公司稱為Moviestar,您可將檔案命名為moviestar.md

編寫您目的地的檔案頁面

  1. 您將根據檔案自助服務範本建立目的地頁面的內容。 🔗 下載範本並將其解壓縮以解壓縮 .md 檔案範本。

  2. 線上上Markdown編輯器中,貼上並編輯範本的內容,其中包含您目的地的相關資訊,例如dillinger.io。 請依照範本中的指示,詳細了解您應填入的內容,以及可以移除哪些段落。

    秘訣

    您可以隨時關閉瀏覽器視窗,稍後重新開啟。 您的工作會自動儲存,當您重新開啟瀏覽器時,將會等候您。

  3. 將Markdown編輯器中的內容複製到GitHub的新檔案中。

  4. 對於您打算使用的任何螢幕擷取畫面或影像,請使用GitHub介面將檔案上傳至experience-platform.en/help/destinations/assets/catalog/[...],其中[...]是您目的地的所需類別。 例如,如果您要新增個人化目的地以Experience Platform,請選取personalization類別。 您必須從編寫頁面連結至影像。 請參閱指示如何連結至影像

    上傳影像至GitHub

  5. 準備好後,將檔案儲存在分支中。

確認檔案建立

提交您的檔案以供審核

秘訣

請注意,這裡沒有什麼可以打破的。 依照本節中的指示,您只是建議進行檔案更新。 您建議的更新將由Adobe Experience Platform檔案團隊核准或編輯。

  1. 儲存檔案並上傳所需影像後,您可以開啟提取請求(PR),將工作分支合併至Adobe檔案存放庫的主分支。 請確定已選取您所處理的分支,並選取​Contribute > Open pull request

建立提取請求

  1. 請確定基分支和比較分支正確。 新增附註至PR,說明您的更新,並選取​建立提取請求。 這會開啟PR,將復本的工作分支合併至Adobe存放庫的主分支。

    秘訣

    保留「允許維護者編輯​**」核取方塊,讓Adobe檔案團隊可以編輯PR。**

    建立提取請求以Adobe檔案存放庫

  2. 此時會出現通知,提示您簽署Adobe貢獻者授權合約(CLA)。 這是必要步驟。 簽署CLA後,請重新整理PR頁面並提交提取請求。

  3. 您可以檢查https://github.com/AdobeDocs/experience-platform.en中的​提取請求​標籤,以確認提取請求已提交。

    PR成功

  4. 感謝支持!Adobe檔案團隊會在PR中聯絡,以備您需要任何編輯作業時使用,並通知您檔案將於何時發佈。

秘訣

若要新增影像和連結至您的檔案,以及有關Markdown的任何其他問題,請參閱Adobe協作撰寫指南中的使用Markdown

本頁內容