在本機環境中使用文字編輯器來建立來原始檔頁面

本檔案提供相關步驟,說明如何使用本機環境編寫來原始檔,並提交提取請求(PR)。

秘訣

先決條件

下列教學課程要求您在本機電腦上安裝GitHub Desktop。 如果您沒有GitHub Desktop,可以下載應用程式 此處.

連線至GitHub並設定您的本機撰寫環境

設定本機編寫環境的第一個步驟是導覽至 Adobe Experience Platform GitHub存放庫.

platform-repo

在Platform GitHub存放庫的首頁上,選取「 」 分支.

分叉

若要將存放庫複製到本機電腦,請選取 程式碼. 從出現的下拉式功能表中,選取 HTTPS 然後,選取 使用GitHub Desktop開啟.

秘訣

如需詳細資訊,請參閱以下教學課程: 在本機設定適用於檔案的Git存放庫.

open-git-desktop

接下來,請稍候片刻,讓GitHub Desktop複製 experience-platform.en 存放庫。

複製

復製程式完成後,請前往GitHub Desktop建立新分支。 選取 主版 從頂端導覽列中,然後選取 新增分支

new-branch

在出現的彈出視窗面板中,輸入分支的描述性名稱,然後選取 建立分支.

create-branch-vs

接下來,選取 發佈分支.

publish-branch

為您的來源編寫檔案頁面

將存放庫複製到本機電腦,並建立新分支後,您現在可以開始透過為您的新來源編寫檔案頁面 您選擇的文字編輯器.

Adobe建議您使用 Visual Studio Code 並安裝AdobeMarkdown Authoring擴充功能。 若要安裝擴充功能,請啟動Visual Studio Code,然後選取 擴充功能 標籤。

擴充功能

接下來,輸入 Adobe Markdown Authoring 放入搜尋列,然後選取 安裝 從出現的頁面。

安裝

在本機電腦準備就緒後,下載 來原始檔範本 並將檔案解壓縮至 experience-platform.en/help/sources/tutorials/api/create/... 替換為 [...] 代表您選擇的類別。 例如,如果您要建立資料庫來源,請選取資料庫資料夾。

最後,請遵循範本上概述的指示,使用與您的來源相關的資訊來編輯範本。

edit-template

提交您的檔案以供檢閱

若要建立提取請求(PR)並提交檔案以供稽核,請先將您的工作儲存在 Visual Studio Code (或您選擇的文字編輯器)。 接下來,使用GitHub Desktop,輸入認可訊息並選取 提交至create-source-documentation.

commit-vs

接下來,選取 推播來源 將您的工作上傳至遠端分支。

推播來源

若要建立提取請求,請選取 建立提取請求.

create-pr-vs

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

秘訣

離開 允許維護者編輯 核取方塊已選取,以確保Adobe檔案團隊可以編輯PR。

create-pr

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

confirm-pr

本頁內容