文件Experience Platform來源連接器指南

使用GitHub網頁介面建立來原始檔頁面

最後更新: 2025年5月5日
  • 主題:

建立對象:

  • 開發人員

本檔案提供如何使用GitHub網頁介面來撰寫檔案及提交提取請求(PR)的步驟。

秘訣
Adobe的投稿指南中的下列檔案可用來進一步支援您的說明檔案程式:
  • 安裝Git與Markdown編寫工具
  • 在本機設定檔案的Git存放庫
  • 重大變更的GitHub貢獻工作流程

設定您的GitHub環境

設定GitHub環境的第一個步驟是導覽至Adobe Experience Platform GitHub存放庫。

平台存放庫

接著,選取​ 分支。

分支

復本完成後,請選取​ master,然後在出現的下拉式功能表中輸入新分支的名稱。 請確定您為分支提供描述性名稱,因為這將用來包含您的工作,然後選取​ 建立分支。

create-branch

在您取用的存放庫的GitHub資料夾結構中,導覽至experience-platform.en/help/sources/tutorials/api/create/,然後從清單中為您的來源選取適當的類別。 例如,如果您正在建立新CRM來源的檔案,請選取​ crm。

秘訣
如果您正在建立UI的檔案,請導覽至experience-platform.en/help/sources/tutorials/ui/create/並為您的來源選取適當的類別。 若要新增影像,請導覽至experience-platform.en/help/sources/images/tutorials/create/sdk,然後將熒幕擷取畫面新增至sdk資料夾。

crm

現有CRM來源的資料夾隨即顯示。 若要新增新來源的檔案,請選取[新增檔案] ​,然後從出現的下拉式功能表中選取[建立新檔案] 。

create-new-file

將您的來源檔案命名為YOURSOURCE.md,其中YOURSOURCE是您在Experience Platform中的來源名稱。 例如,如果您的公司是ACME CRM,則您的檔案名稱應該是acme-crm.md。

git-interface

為您的來源編寫檔案頁面

若要開始記錄您的新來源,請將來原始檔範本的內容貼到GitHub網頁編輯器中。 您也可以在這裡下載範本。

將範本複製到GitHub網頁編輯器介面後,請依照範本上概述的指示操作,並編輯包含來源相關資訊的值。

貼上範本

完成後,在您的分支中提交檔案。

認可

提交您的檔案以供檢閱

在提交檔案後,您可以開啟提取請求(PR),將您的工作分支合併至Adobe檔案存放庫的主分支。 確定已選取您正在處理的分支,然後選取​ 比較與提取請求。

比較 — pr

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

秘訣
保留​ 允許維護者進行編輯 ​核取方塊為已選取狀態,以確保Adobe檔案團隊可對PR進行編輯。

create-pr

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

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

confirm-pr

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089