Ceci est la source de la documentation officielle de SUSE Linux et OpenSuse Leap.
Ce référentiel héberge les sources de documentation, y compris les traductions (si disponibles) pour les produits suivants:
SUSE Linux Enterprise Desktop (SLED)
SUSE Linux Enterprise Server (SLES)
SUSE LINUX ENTERPRISE MICRO (SLE-MICRO)
Opensuse Leap
Les versions publiées de la documentation SLE sont publiées sur https://documentation.suse.com/. Les versions publiées de la documentation OpenSuse LEAP peuvent être trouvées sur https://doc.opensuse.org/.
Les versions de documentation bêta sont disponibles sur https://susedoc.github.io/, où tous les branches main et de maintenance sont automatiquement construites.
| Nom | But |
|---|---|
| Doc Development (dernière version de développement) |
| Maintenance des versions publiées |
Utilisez la branche principale comme base de vos engins / de nouvelles branches de fonctionnalités.
Les bogues sont collectés sur https://bugzilla.suse.com. Si possible, veuillez vérifier les doublons avant de créer un nouveau rapport. Lors de la création d'un nouveau rapport, utilisez SUSE Linux Enterprise Desktop ou Server comme produit et à l'étape suivante de la version. Comme Documentation de sélection des composants.
Merci d'avoir contribué à ce dépôt. Lors de la création d'une demande de traction, veuillez suivre les directives ci-dessous:
Si vous souhaitez contribuer à la version la plus récente, créez votre demande de traction contre la branche main . La branche main est protégée.
Si vous souhaitez contribuer à une version précédente, veuillez créer votre demande de traction contre la branche maintenance/* respective. Ces branches sont également protégées.
Assurez-vous que toutes les vérifications de validation (actions GitHub) sont passées.
Pour que votre demande de traction soit examinée, veuillez marquer les experts en matière concernés de l'équipe de développement (le cas échéant) et des membres de l'équipe de documentation.
Implémenter les modifications requises. Si vous avez des questions, ping un membre de l'équipe de documentation dans # Team-Suse-Docs sur Slack.
Pour obtenir de l'aide sur le style et la structure, reportez-vous au guide de style de documentation.
Pour contribuer à la documentation, vous devez écrire DocBook.
Vous pouvez en apprendre davantage sur la syntaxe DocBook sur http://docbook.org/tdg5/en/html.
Les documents SUSE sont généralement construits avec DAPS (Package daps ) et le SUSE XSL Stylesheets (package suse-xsl-stylesheets ).
Installez l'environnement de documentation avec la commande suivante:
sudo OneClickInstallUI https://susedoc.github.io/ymp/Documentation.ympUtilisation des DAP de base:
$ daps -d DC-<YOUR_BOOK> validate : assurez-vous que ce que vous avez écrit est un XML bien formé et un docbook 5 valide 5
$ daps -d DC-<YOUR_BOOK> pdf : Créez un document PDF
$ daps -d DC-<YOUR_BOOK> html : construire un document HTML de plusieurs pages
$ daps -d DC-<YOUR_BOOK> optipng : toujours optimiser les nouvelles images PNG
En savoir plus sur https://opense.github.io/daps
