Esta é a fonte da documentação oficial do SUSE Linux Enterprise e OpenSuse Leap.
Este repositório hospeda as fontes de documentação, incluindo traduções (se disponível) para os seguintes produtos:
SUSE Linux Enterprise Desktop (trenó)
SUSE Linux Enterprise Server (SLES)
SUSE Linux Enterprise Micro (Sle-Micro)
OpenSuse Leap
As versões lançadas da documentação do LES são publicadas em https://documentation.suse.com/. As versões lançadas da documentação do OpenSuse Leap podem ser encontradas em https://doc.opensuse.org/.
As versões de documentação beta estão disponíveis em https://susedoc.github.io/, onde todos os compromissos com as main
e manutenção são construídos automaticamente.
Nome | Propósito |
---|---|
| Desenvolvimento do DOC (versão mais recente de desenvolvimento) |
| Manutenção para versões liberadas |
Use a filial principal como base de seus comissões/de novas filiais de recursos.
Os bugs são coletados em https://bugzilla.suse.com. Se possível, verifique se há duplicatas antes de criar um novo relatório. Ao criar um novo relatório, use SUSE Linux Enterprise Desktop
ou Server
como produto e na próxima etapa da versão. Como componente, selecione Documentation
.
Obrigado por contribuir com este repo. Ao criar uma solicitação de tração, siga as diretrizes abaixo:
Se você deseja contribuir para o lançamento mais recente, crie sua solicitação de tração contra a filial main
. O ramo main
está protegido.
Se você deseja contribuir para uma versão anterior, crie sua solicitação de tração na respectiva ramificação maintenance/*
. Esses ramos também são protegidos.
Verifique se todas as verificações de validação (ações do GitHub) são passadas.
Para que sua solicitação de tração seja revisada, marque os especialistas relevantes do assunto da equipe de desenvolvimento (se aplicável) e membros da equipe de documentação.
Implementar as alterações necessárias. Se você tiver alguma dúvida, ping em um membro da equipe de documentação no #Team-Suse-Docs no Slack.
Para obter ajuda em estilo e estrutura, consulte o Guia do estilo de documentação.
Para contribuir para a documentação, você precisa escrever DocBook.
Você pode aprender sobre a sintaxe do DocBook em http://docbook.org/tdg5/en/html.
Os documentos do SUSE são geralmente construídos com DAPS ( daps
de pacotes) e as folhas de estilo SUSE XSL (pacote suse-xsl-stylesheets
).
Instale o ambiente de documentação com o seguinte comando:
sudo OneClickInstallUI https://susedoc.github.io/ymp/Documentation.ymp
Uso básico do DAPS:
$ daps -d DC-<YOUR_BOOK> validate
: Verifique se o que você escreveu é XML bem formado e DocBook válido 5
$ daps -d DC-<YOUR_BOOK> pdf
: Construa um documento PDF
$ daps -d DC-<YOUR_BOOK> html
: Build Multi-Page HTML Document
$ daps -d DC-<YOUR_BOOK> optipng
: Sempre otimize novas imagens PNG
Saiba mais em https://opensuse.github.io/daps