在本機環境中使用文字編輯器建立目的地檔案頁面 local-authoring

本頁上的指示會示範如何使用文字編輯器在本機環境中運作,以撰寫檔案並提交提取請求(PR)。 在依照這裡指示的步驟進行之前,請務必閱讀在Adobe Experience Platform目的地中記錄您的目的地

連線至GitHub並設定您的本機編寫環境 set-up-environment

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

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

    分支Adobe檔案存放庫

  3. 將存放庫複製到本機電腦。 選取「程式碼> HTTPS >使用GitHub Desktop ​開啟」,如下所示。 確定您已安裝GitHub Desktop。 如需進一步參考,請參閱Adobe貢獻者指南中的建立存放庫的本機複製

    將Adobe檔案存放庫複製到本機環境

  4. 在您的本機檔案結構中,導覽至experience-platform.en/help/destinations/catalog/[...],其中[...]是您目的地所需的類別。 例如,如果您要將個人化目的地新增至Experience Platform,請選取personalization資料夾。

為您的目的地編寫檔案頁面 author-documentation

  1. 您的檔案頁面是以自助服務目的地範本為基礎。 下載目的地範本。 解壓縮檔案yourdestination-template.md,並將檔案解壓縮至上述步驟4提及的目錄。 重新命名檔案YOURDESTINATION.md,其中YOURDESTINATION是您在Adobe Experience Platform中的目的地名稱。 例如,如果您的公司名為Moviestar,您可將您的檔案命名為moviestar.md
  2. 使用您選擇的文字編輯器開啟新檔案。 Adobe建議您使用Visual Studio Code並安裝AdobeMarkdown Authoring擴充功能。 若要安裝擴充功能,請開啟Visual Studio Code,選取畫面左側的​ Extensions ​索引標籤,然後搜尋adobe markdown authoring。 選取擴充功能並按一下​ Install
    安裝AdobeMarkdown Authoring擴充功能
  3. 使用目的地的相關資訊編輯範本。 請依照範本中的指示操作。
  4. 對於您打算新增至檔案的任何熒幕擷取畫面或影像,請移至GitHub/experience-platform.en/help/destinations/assets/catalog/[...],其中[...]是您想要的目的地類別。 例如,如果您要將個人化目的地新增至Experience Platform,請選取personalization資料夾。 為您的目的地建立新資料夾,並將影像儲存於此處。 您必須從正在編寫的頁面連結至這些專案。 請參閱如何連結至影像的說明
  5. 準備就緒後,儲存您正在處理的檔案。

提交您的檔案以供檢閱 submit-review

TIP
請注意,您無法在此處中斷任何內容。 依照本節的指示,您只是建議更新說明檔案。 您建議的更新將由Adobe Experience Platform檔案團隊核准或編輯。
  1. 在GitHub Desktop中,為您的更新建立有效分支,並選取​ Publish分支 ​以將分支發佈至GitHub。

新增本機分支

  1. 在GitHub Desktop中,認可您的工作,如下所示。

    認可本機

  2. 在GitHub Desktop中,將您的工作推送到遠端分支,如下所示。

    推送您的認可

  3. 在GitHub網路介面中,開啟提取請求(PR),將您的工作分支合併至Adobe檔案存放庫的主分支。 確定已選取您處理的分支,並選取​ Contribute >開啟提取請求

    建立提取請求

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

    note tip
    TIP
    保留​ 允許維護者編輯 ​核取方塊為已選取狀態,讓Adobe檔案團隊可以編輯PR。

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

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

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

PR成功

  1. 感謝支持!Adobe檔案團隊會聯絡PR,以備需要編輯時使用,並告知您檔案將於何時發佈。
TIP
若要新增影像和連結至您的檔案,以及有關Markdown的任何其他問題,請閱讀Adobe合作撰寫指南中的使用Markdown
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6