改善文件

• 如何提交貢獻？
• 如何撰寫內容？
• 我應該如何表現？
• 我可以貢獻什麼？

Handlebars 是開放原始碼專案。沒有「文件部門」負責維護文件。這個文件網站需要您的協助，才能成為一個良好且有用的網站。

版本說明 (開啟新視窗)
標籤為「docs-needed」的問題 (開啟新視窗)
舊的 Handlebars 網站 (開啟新視窗)

以下各節應有助於您協助我們改善文件。

如何提交貢獻？

這個網站由 Github (開啟新視窗)。

如果您的變更只影響單一頁面的內容，您可以直接按一下此頁面底部的連結建議變更此頁面！（請參閱編輯其他使用者儲存庫中的檔案 (開啟新視窗)）以取得詳細資料。

對於較複雜的變更（樣式、多個頁面、新頁面、修正建置問題），您應該分岔儲存庫 (開啟新視窗)，並在完成後提交拉取請求。儲存庫中的CONTRIBUTING.md 頁面 (開啟新視窗)包含更多資訊。這種方法讓您可以使用開發伺服器，並在提交變更前預覽變更。

我如何撰寫內容？

文件以 Markdown 編寫，並使用VuePress (開啟新視窗)進行渲染。VuePress 使用markdown-it套件來渲染 Markdown。markdown-it實作 CommonMark 方言。

這表示你可以使用這些來源中描述的語法

• CommonMark 說明 (開啟新視窗)
• markdown-it 新增的語法擴充 (開啟新視窗)
• VuePress 新增的語法擴充 (開啟新視窗)

除了所有這些擴充外，這個網站還新增了一些自訂 Vue 元件，可以內嵌在原始檔中。

• 互動範例
• 按鈕連結

我應該如何表現？

危險

• 尊重智慧財產權：請只提交您自己創作的文字和其他媒體，或者從 handlebarsjs.com (開啟新視窗) 複製的文字。網路上有很多關於 Handlebars 的部落格文章，但這些文章的文字是其作者的智慧財產。

• 授權：提交內容即表示您同意在這個網站的授權下，在此網站上發布該內容。

• 行為準則：請尊重他人，避免使用性暗示或粗俗的語言。

我可以貢獻什麼？

• 尋找標記為 docs-needed (在新視窗中開啟) 的議題，在 handlebars.js (在新視窗中開啟) 儲存庫中。這些議題描述了應該記錄下來的事項。
• 提出並提交新內容。如果您不確定您的提案，您可以在提交拉取請求之前建立一個議題。這可能會讓您免於浪費時間。
• 改善現有內容。您可以提出變更導覽、修正錯字、改善語言和更正錯誤內容的建議。
• 修復 CSS 造型問題。此頁面的造型遠遠稱不上完美。如果您有改善它的想法，請繼續進行。對於較大的變更，請透過開啟一個議題與我們聯繫。