source-git-commit	workflow-type	source-wordcount	ht-degree
a6086afc0a1f099b62014ad61098a5a1dc9d4675	tm+mt	719	3%

Adobe Commerce技術檔案

我們歡迎社群以及檔案團隊外部的Adobe員工出力貢獻。

Adobe Open Source行為準則

本專案已採用 Adobe 開放原始碼管理辦法或 .NET Foundation 管理辦法。如需詳細資訊，請參閱貢獻一文。

關於您對Adobe內容的貢獻

請參閱Adobe檔案貢獻者指南。

貢獻方式取決於您的身分和您要貢獻的變更型別：

微幅變更

如果您要提出微幅更新，請瀏覽文章，然後按一下文章底部的意見區域，按一下​詳細的意見選項，然後按一下​建議編輯，即可前往GitHub的Markdown來源檔案。 使用GitHub UI進行更新。 如需詳細資訊，請參閱一般Adobe檔案投稿人指南。

Adobe使用條款涵蓋您在本存放庫為檔案和程式碼範例提交的小幅更正或釐清。

來自社群成員的重大變更或新文章

如果您是Adobe社群的一員，且想建立新文章或提交重大變更，請使用Git存放庫中的「問題」標籤來提交問題，以開始與檔案團隊對話。 一旦您同意了計畫，就需要與員工合作，透過結合公共和私有存放庫的工作來幫助引入新內容。

來自Adobe員工的重大變更

若您是Adobe Experience Cloud解決方案產品團隊的技術撰寫人員、專案經理或開發人員，且您的工作正是貢獻或撰寫技術文章，請使用https://git.corp.adobe.com/AdobeDocs的私人存放庫。

工具與設定

社群投稿人可以使用GitHub UI進行基本編輯或建立存放庫復本，以做出重大貢獻。

如需詳細資訊，請參閱Adobe檔案貢獻者指南。

如何使用Markdown將主題格式化

此存放庫中的所有文章皆使用GitHub Flavored Markdown。 如果您不熟悉Markdown，請參閱：

• Markdown基本介紹
• 可列印的Markdown速查表

範本

對於某些主題，我們會使用資料檔案和範本來產生已發佈內容。 此方法的使用案例包括：

• 發佈大量以程式設計方式產生的內容
• 為需要機器可讀檔案格式（例如YAML）以進行整合（例如全網站分析工具）的多重系統的客戶提供單一信任來源

樣板化內容的範例包括但不限於：

• CLI工具參考
• 產品可用性表格
• 系統需求表

產生樣板化內容

一般而言，大部分的作者只需要將發行版本新增到產品可用性和系統需求表格。 所有其他樣板化內容的維護工作都是自動化的，或由專門的團隊成員管理。 這些指示適用於大部分的作者。

附註：

• 產生樣板化內容需要在終端機中的命令列上工作。
• 您必須安裝Ruby才能執行轉譯指令碼。 如需所需版本，請參閱_jekyll/.ruby-version。

如需範本化內容的檔案結構說明，請參閱下列內容：

• _jekyll — 包含範本化主題和必要資產
• _jekyll/_data — 包含用來轉譯範本的電腦可讀檔案格式
• _jekyll/templated — 包含使用Liquid範本語言的HTML式範本檔案
• help/_includes/templated — 包含範本化內容以.md檔案格式產生的輸出，以便在Experience League主題中發佈；轉譯指令碼會自動將產生的輸出寫入此目錄中

若要更新樣板化內容，請執行下列動作：

1. 在文字編輯器中，開啟/jekyll/_data目錄中的資料檔案。 例如：

   • 產品可用性表格： /jekyll/_data/product-availability.yml
   • 系統需求表格： /jekyll/_data/system-requirements.yml

2. 使用現有的YAML結構來建立專案。

   例如，若要將Adobe Commerce版本新增至產品可用性表格，請在/jekyll/_data/product-availability.yml檔案的extensions和services區段中的每個專案新增下列內容（視需要修改版本號碼）：

   support:
      - core: 1.2.3
        version: 4.5.6
   

3. 導覽至_jekyll目錄。

   cd _jekyll
   

4. 產生樣板化內容並將輸出寫入help/_includes/templated目錄。

   rake render
   

   注意：​您必須從_jekyll目錄執行指令碼。 如果這是您第一次執行指令碼，您必須先使用bundle install命令安裝Ruby相依性。

5. 導覽回root目錄。

   cd ..
   

6. 確認預期的help/_includes/templated檔案已修改。

   git status
   

   您應該會看到類似下列的輸出：

   modified:   _data/product-availability.yml
   modified:   help/_includes/templated/product-availability-extensions.md
   

7. 推送您的變更。

   git add .
   git commit -m "descriptive message of the intended commit"
   git push
   

請參閱Jekyll檔案以取得有關資料檔、Liquid濾鏡和其他功能的詳細資訊。