Это источник официального SUSE Linux Enterprise и OpenSuse Leap Documentation.
В этом репозитории размещаются источники документации, включая переводы (если доступны) для следующих продуктов:
SUSE Linux Enterprise Desktop (SLED)
SUSE Linux Enterprise Server (SLE)
SUSE Linux Enterprise Micro (SLE-MICRO)
OpenSuse Leap
Выпущенные версии документации SLE опубликованы по адресу https://documentation.suse.com/. Выпущенные версии документации OpenSuse Leap можно найти по адресу https://doc.opensuse.org/.
Версии бета -документации доступны по адресу https://susedoc.github.io/, где автоматически строятся все main и обслуживание.
| Имя | Цель |
|---|---|
| Разработка DOC (последняя версия разработки) |
| Техническое обслуживание выпущенных версий |
Используйте основную ветвь в качестве основы ваших коммитов/новых филиалов.
Ошибки собираются на https://bugzilla.suse.com. Если возможно, пожалуйста, проверьте дубликаты перед созданием нового отчета. При создании нового отчета используйте Desktop или Server SUSE Linux Enterprise Desktop в качестве продукта, а на следующем шаге версия. В качестве компонента выберите Documentation .
Спасибо, что внесли свой вклад в это репо. При создании запроса на привлечение, пожалуйста, следуйте указаниям ниже:
Если вы хотите внести свой вклад в самый последний релиз, создайте запрос на привлечение против main филиала. main ветвь защищена.
Если вы хотите внести свой вклад в предыдущий выпуск, пожалуйста, создайте свой запрос на притяжение в соответствии с соответствующим филиалом maintenance/* . Эти ветви также защищены.
Убедитесь, что все проверки проверки (действия GitHub) проходят.
Для рассмотрения вашего запроса о привлечении, пожалуйста, отметьте соответствующих экспертов по предметам из команды разработчиков (если применимо) и членов команды документации.
Реализовать необходимые изменения. Если у вас есть какие-либо вопросы, пинг члена команды документации в # #команда-SUSE-DOCS на Slack.
Для получения помощи в стиле и структуре см. Руководство по стилю документации.
Чтобы внести свой вклад в документацию, вам нужно написать документ.
Вы можете узнать о синтаксисе Docbook по адресу http://docbook.org/tdg5/en/html.
Документы SUSE, как правило, строятся с помощью DAPS (пакет daps ) и таблицы стилей SUSE XSL (пакет suse-xsl-stylesheets ).
Установите среду документации со следующей командой:
sudo OneClickInstallUI https://susedoc.github.io/ymp/Documentation.ympБазовое использование DAPS:
$ daps -d DC-<YOUR_BOOK> validate : Убедитесь, что вы написали, хорошо сформировано XML и действительный документ 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
