doc sle

Suse Linux Enterprise / opensuse Leap文档

这是官方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和维护分支。

分支

表1。重要分支的概述

姓名	目的
main	DOC开发（最新开发版）
maintenance/*	发布版本的维护

使用主分支作为您的提交/新功能分支的基础。

报告错误

虫子在https://bugzilla.suse.com上收集。如果可能的话，请在创建新报告之前检查重复项。创建新报告时，请使用SUSE Linux Enterprise Desktop或Server作为产品，并在下一步中使用版本。作为组件选择Documentation 。

贡献

感谢您为此仓库做出贡献。创建拉动请求时，请按照以下准则：

1. 如果您想为最新版本做出贡献，请针对main分支创建拉动请求。 main分支受到保护。

2. 如果您想为先前的版本做出贡献，请针对各自的maintenance/*分支创建拉动请求。这些分支也受到保护。

3. 确保通过所有验证（GITHUB操作）检查。

4. 为了审查您的拉动请求，请标记开发团队（如果适用）和文档团队成员的相关主题专家。

5. 实施所需的更改。如果您有任何疑问，请在Slack上使用＃Team-Suse-Docs中的文档团队成员。

6. 有关样式和结构的帮助，请参阅文档样式指南。

编辑文档

为了为文档做出贡献，您需要编写文档。

• 您可以在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上了解更多信息