這是官方Suse Linux Enterprise和OpenSuse Leap文檔的來源。
該存儲庫託管文檔資源,包括以下產品的翻譯(如果有):
Suse Linux企業桌面(雪橇)
Suse Linux企業服務器(SLE)
Suse Linux Enterprise Micro(SLE-Micro)
Opensuse飛躍
SLE文檔的發布版本發表在https://documentation.suse.com/上。可以在https://doc.opensuse.org/上找到OpenSuse Leap文檔的發布版本。
Beta文檔版本可在https://sudedoc.github.io/上獲得,其中所有承諾都是自動構建的main
和維護分支。
姓名 | 目的 |
---|---|
| DOC開發(最新開發版) |
| 發布版本的維護 |
使用主分支作為您的提交/新功能分支的基礎。
蟲子在https://bugzilla.suse.com上收集。如果可能的話,請在創建新報告之前檢查重複項。創建新報告時,請使用SUSE Linux Enterprise Desktop
或Server
作為產品,並在下一步中使用版本。作為組件選擇Documentation
。
感謝您為此倉庫做出貢獻。創建拉動請求時,請按照以下準則:
如果您想為最新版本做出貢獻,請針對main
分支創建拉動請求。 main
分支受到保護。
如果您想為先前的版本做出貢獻,請針對各自的maintenance/*
分支創建拉動請求。這些分支也受到保護。
確保通過所有驗證(GITHUB操作)檢查。
為了審查您的拉動請求,請標記開發團隊(如果適用)和文檔團隊成員的相關主題專家。
實施所需的更改。如果您有任何疑問,請在Slack上使用#Team-Suse-Docs中的文檔團隊成員。
有關樣式和結構的幫助,請參閱文檔樣式指南。
為了為文檔做出貢獻,您需要編寫文檔。
您可以在http://docbook.org/tdg5/en/html上了解DocBook語法。
Suse文檔通常是由DAPS(軟件包daps
)和SUSE XSL樣式表(軟件包suse-xsl-stylesheets
)構建的。
使用以下命令安裝文檔環境:
sudo OneClickInstallUI https://susedoc.github.io/ymp/Documentation.ymp
基本的使用量:
$ daps -d DC-<YOUR_BOOK> validate
:確保您寫的內容是XML良好的XML和有效的DocBook 5
$ daps -d DC-<YOUR_BOOK> pdf
:構建PDF文檔
$ daps -d DC-<YOUR_BOOK> html
:構建多頁HTML文檔
$ daps -d DC-<YOUR_BOOK> optipng
:始終優化新的png圖像
在https://opensuse.github.io/daps上了解更多信息