在本機環境中使用文字編輯器建立目的地檔案頁面 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 並安裝Adobe Markdown Authoring擴充功能。 若要安裝擴充功能,請開啟Visual Studio Code,然後選取 Extensions 標籤進行搜尋 adobe markdown authoring. 選取擴充功能並按一下 Install.
    安裝Adobe Markdown Authoring擴充功能
  3. 使用目的地的相關資訊編輯範本。 請依照範本中的指示操作。
  4. 如需您打算新增至檔案的任何熒幕擷取畫面或影像,請前往 GitHub/experience-platform.en/help/destinations/assets/catalog/[...],其中 [...] 是您目的地需要的類別。 例如,如果您要將個人化目的地新增至Experience Platform,請選取 personalization 資料夾。 為您的目的地建立新資料夾,並將影像儲存於此處。 您必須從正在編寫的頁面連結至這些專案。 另請參閱 如何連結至影像的說明.
  5. 準備就緒後,儲存您正在處理的檔案。

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

TIP
請注意,您無法在此處中斷任何內容。 依照本節的指示,您只是建議更新說明檔案。 您建議的更新將由Adobe Experience Platform檔案團隊核准或編輯。
  1. 在GitHub Desktop中,為您的更新建立工作分支並選取 發佈分支 將分支發佈至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的任何其他問題,請閱讀 使用Markdown 在Adobe的合作撰寫指南中。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6