Ini adalah sumber untuk perusahaan resmi SUSE Linux dan dokumentasi lompatan OpenSUSE.
Repositori ini meng -host sumber dokumentasi termasuk terjemahan (jika tersedia) untuk produk berikut:
SUSE Linux Enterprise Desktop (SLED)
SUSE Linux Enterprise Server (SLES)
SUSE Linux Enterprise Micro (SLE-MICRO)
OpenSUSE LEAP
Versi yang dirilis dari dokumentasi SLE diterbitkan di https://documentation.suse.com/. Versi yang dirilis dari dokumentasi lompatan OpenSUSE dapat ditemukan di https://doc.opensuse.org/.
Versi dokumentasi beta tersedia di https://susedoc.github.io/, di mana semua berkomitmen untuk cabang main dan pemeliharaan secara otomatis dibangun.
| Nama | Tujuan |
|---|---|
| Pengembangan DOC (versi pengembangan terbaru) |
| pemeliharaan untuk versi yang dirilis |
Gunakan cabang utama sebagai dasar komit/cabang fitur baru Anda.
Bug dikumpulkan di https://bugzilla.suse.com. Jika memungkinkan, periksa duplikat sebelum membuat laporan baru. Saat membuat laporan baru, gunakan SUSE Linux Enterprise Desktop atau Server sebagai produk dan pada langkah berikutnya versi. Sebagai komponen pilih Documentation .
Terima kasih telah berkontribusi pada repo ini. Saat membuat permintaan tarik, silakan ikuti pedoman di bawah ini:
Jika Anda ingin berkontribusi pada rilis terbaru, buat permintaan tarik Anda terhadap cabang main . Cabang main dilindungi.
Jika Anda ingin berkontribusi pada rilis sebelumnya, silakan buat permintaan tarik Anda terhadap cabang maintenance/* masing -masing. Cabang -cabang ini juga dilindungi.
Pastikan semua pemeriksaan validasi (tindakan github) dilewati.
Untuk permintaan tarik Anda untuk ditinjau, harap beri tag ahli materi pelajaran yang relevan dari tim pengembangan (jika berlaku) dan anggota tim dokumentasi.
Menerapkan perubahan yang diperlukan. Jika Anda memiliki pertanyaan, ping anggota tim dokumentasi di #tim-gabungan-docs di Slack.
Untuk bantuan tentang gaya dan struktur, lihat panduan gaya dokumentasi.
Untuk berkontribusi pada dokumentasi, Anda perlu menulis Docbook.
Anda dapat belajar tentang sintaks docbook di http://docbook.org/tdg5/en/html.
Dokumen SUSE umumnya dibangun dengan DAP (paket daps ) dan stylesheet SUSE XSL (paket suse-xsl-stylesheets ).
Instal lingkungan dokumentasi dengan perintah berikut:
sudo OneClickInstallUI https://susedoc.github.io/ymp/Documentation.ympPenggunaan DAP Dasar:
$ daps -d DC-<YOUR_BOOK> validate : pastikan apa yang telah Anda tulis adalah XML yang dibentuk dengan baik dan docbook 5 yang valid
$ daps -d DC-<YOUR_BOOK> pdf : Bangun dokumen PDF
$ daps -d DC-<YOUR_BOOK> html : membangun dokumen html multi-halaman
$ daps -d DC-<YOUR_BOOK> optipng : Selalu optimalkan gambar png baru
Pelajari lebih lanjut di https://opensuse.github.io/daps
