在本機環境中使用文字編輯器建立目的地檔案頁面 local-authoring
本頁上的指示會示範如何使用文字編輯器在本機環境中運作,以撰寫檔案並提交提取請求(PR)。 在依照這裡指示的步驟進行之前,請務必閱讀在Adobe Experience Platform目的地中記錄您的目的地。
連線至GitHub並設定您的本機編寫環境 set-up-environment
-
在您的瀏覽器中,瀏覽至
https://github.com/AdobeDocs/experience-platform.en
-
若要分支存放庫,請按一下 分支,如下所示。 這會在您自己的GitHub帳戶中建立Experience Platform存放庫的復本。
-
將存放庫複製到本機電腦。 選取「程式碼> HTTPS >使用GitHub Desktop 開啟」,如下所示。 確定您已安裝GitHub Desktop。 如需進一步參考,請參閱Adobe貢獻者指南中的建立存放庫的本機複製。
-
在您的本機檔案結構中,導覽至
experience-platform.en/help/destinations/catalog/[...]
,其中[...]
是您目的地所需的類別。 例如,如果您要將個人化目的地新增至Experience Platform,請選取personalization
資料夾。
為您的目的地編寫檔案頁面 author-documentation
- 您的檔案頁面是以自助服務目的地範本為基礎。 下載目的地範本。 解壓縮檔案
yourdestination-template.md
,並將檔案解壓縮至上述步驟4提及的目錄。 重新命名檔案YOURDESTINATION.md
,其中YOURDESTINATION是您在Adobe Experience Platform中的目的地名稱。 例如,如果您的公司名為Moviestar,您可將您的檔案命名為moviestar.md
。 - 使用您選擇的文字編輯器開啟新檔案。 Adobe建議您使用Visual Studio Code並安裝AdobeMarkdown Authoring擴充功能。 若要安裝擴充功能,請開啟Visual Studio Code,選取畫面左側的 Extensions 索引標籤,然後搜尋
adobe markdown authoring
。 選取擴充功能並按一下 Install。
- 使用目的地的相關資訊編輯範本。 請依照範本中的指示操作。
- 對於您打算新增至檔案的任何熒幕擷取畫面或影像,請移至
GitHub/experience-platform.en/help/destinations/assets/catalog/[...]
,其中[...]
是您想要的目的地類別。 例如,如果您要將個人化目的地新增至Experience Platform,請選取personalization
資料夾。 為您的目的地建立新資料夾,並將影像儲存於此處。 您必須從正在編寫的頁面連結至這些專案。 請參閱如何連結至影像的說明。 - 準備就緒後,儲存您正在處理的檔案。
提交您的檔案以供檢閱 submit-review
- 在GitHub Desktop中,為您的更新建立有效分支,並選取 Publish分支 以將分支發佈至GitHub。
-
在GitHub Desktop中,認可您的工作,如下所示。
-
在GitHub Desktop中,將您的工作推送到遠端分支,如下所示。
-
在GitHub網路介面中,開啟提取請求(PR),將您的工作分支合併至Adobe檔案存放庫的主分支。 確定已選取您處理的分支,並選取 Contribute >開啟提取請求。
-
請確定基礎分支和比較分支正確無誤。 將說明您更新的附註新增至PR,並選取 建立提取請求。 這會開啟PR,以將復本的工作分支合併至Adobe存放庫的主分支。
note tip TIP 保留 允許維護者編輯 核取方塊為已選取狀態,讓Adobe檔案團隊可以編輯PR。 -
此時,系統會顯示通知,提示您簽署Adobe貢獻者授權合約(CLA)。 此為必要步驟。 簽署CLA後,請重新整理PR頁面並提交提取請求。
-
您可以檢查
https://github.com/AdobeDocs/experience-platform.en
中的 提取請求 索引標籤,以確認提取請求已提交。
- 感謝支持!Adobe檔案團隊會聯絡PR,以備需要編輯時使用,並告知您檔案將於何時發佈。