.gitignore
模板的集合這是GitHub的.gitignore
文件模板的集合。我們使用此列表來填充Github.com界面中可用的.gitignore
模板選擇器,創建新的存儲庫和文件時。
有關.gitignore
文件工作以及如何使用它們的更多信息,以下資源是一個很好的起點:
我們支持以這種方式組織的模板集合:
Global
包含可在不同情況下使用的各種編輯,工具和操作系統的模板。建議將它們添加到全局模板中,或者如果要永久使用它們,則將這些規則合併到特定的項目模板中。community
包含其他流行語言,工具和項目的專業模板,這些模板目前不屬於主流模板。當您決定採用框架或工具時,應將這些添加到特定項目的模板中。 模板應包含一組規則,以幫助GIT存儲庫與特定的編程語言,框架,工具或環境一起使用。
如果無法為這種情況策劃一小部分有用的規則,那麼該模板不適合此集合。
如果模板主要是特定版本的某些軟件(例如PHP框架)安裝的文件列表,則可以在community
目錄下生活。有關更多詳細信息,請參見版本的模板。
如果您有一小部分規則,或者想支持不廣泛使用的技術,並且仍然認為這對他人有幫助,請閱讀有關專用模板的部分,以獲取更多詳細信息。
如果模板很重要且可見,請在打開拉請請求時包括詳細信息。我們可能不會立即接受它,但是我們可以根據興趣在以後將其推廣到根。
還請理解,我們不能列出所有存在的工具。我們的目的是策劃最常見和最有用的模板的集合,而不是確保我們涵蓋每個項目。如果我們選擇不包括您的語言,工具或項目,那不是因為它並不令人敬畏。
我們希望您能幫助我們改進該項目。為了幫助我們保持高質量的高質量,我們要求該貢獻符合以下準則。
提供指向應用程序或項目主頁的鏈接。除非非常受歡迎,否則維護者不知道或使用您的更改適用的語言,框架,編輯器,應用程序或項目。
提供支持您所做更改的文檔的鏈接。當前的規範文檔提到被忽略的文件是最好的。如果無法使用文檔來支持您的更改,請盡力解釋所忽略的文件的目的。
解釋為什麼您要進行更改。即使這似乎是不言而喻的,請服用一兩個句子告訴我們為什麼您的更改或加法會發生。闡明為什麼此更改適用於使用適用技術的每個人,而不僅僅是您或您的團隊,這一點尤其有用。
請考慮您的更改範圍。如果您的更改是特定於某種語言或框架的,請確保將更改用於該語言或框架的模板,而不是用於編輯器,工具或操作系統的模板。
請僅修改一個每拉請求的一個模板。這有助於將重點關注特定項目或技術的拉力請求和反饋保持。
通常,您可以做的越多地幫助我們了解您所做的變化,我們就越有可能快速接受您的貢獻。
一些模板可以在版本之間發生很大變化,如果您想為此存儲庫做出貢獻,我們需要遵循此特定流程:
community/
這有助於確保用戶獲得最新版本(因為他們將使用根源的所有內容),但可以幫助維護者支持舊版本仍在野外。
如果您有要貢獻的模板,但不是很主流,請考慮將其添加到最適合其所屬的文件夾下的community
目錄。
您的專用模板中的規則應針對框架或工具,並且在模板標題中的評論中應提及任何其他模板。
例如,此模板可能生活在community/DotNet/InforCRM.gitignore
:
# gitignore template for InforCRM (formerly SalesLogix)
# website: https://www.infor.com/product-summary/cx/infor-crm/
#
# Recommended: VisualStudio.gitignore
# Ignore model files that are auto-generated
ModelIndex.xml
ExportedFiles.xml
# Ignore deployment files
[Mm]odel/[Dd]eployment
# Force include portal SupportFiles
!Model/Portal/*/SupportFiles/[Bb]in/
!Model/Portal/PortalTemplates/*/SupportFiles/[Bb]in
這是我們建議您建議對該項目進行更改的方式:
main
分支。使用基於Web的接口進行更改也可以,並且可以通過自動構造項目並提示發送拉請請求來為您提供幫助。
CC0-1.0。