Indonesian Maintaining the Wiki

Memelihara Wiki

Wiki GitHub adalah repositori Git yang terpisah. Antarmuka Baris Perintah GitHub (gh) dapat mengautentikasi Git, mengaktifkan atau membuka wiki, dan menyediakan konteks repositori, tetapi saat ini tidak menyertakan perintah bawaan untuk membuat atau mengedit halaman wiki.

Pengaturan sekali saja

Halaman pertama harus ada sebelum GitHub menampilkan repositori wiki untuk dikloning. Wiki ini sudah diinisialisasi, jadi pemelihara dapat menggunakan alur kerja lokal secara langsung.

Autentikasi dan konfigurasikan penanganan kredensial Git:

gh auth login
gh auth setup-git

Kloning repositori wiki:

git clone https://github.com/Appshines/Voice2Win.wiki.git
Set-Location Voice2Win.wiki

Edit dan publikasikan

Setiap file Markdown adalah satu halaman. Nama file menjadi alamat halaman; misalnya, Getting-Started.md diterbitkan sebagai Getting-Started. _Sidebar.md mengendalikan bilah navigasi.

Setelah mengedit:

git add --all
git commit -m "Update Voice2Win user guide"
git push

Hanya perubahan yang didorong ke cabang default repositori wiki yang akan terlihat oleh pembaca.

Perintah GitHub CLI yang Berguna

Buka wiki:

gh browse --wiki --repo Appshines/Voice2Win

Periksa apakah fiturnya aktif:

gh repo view Appshines/Voice2Win --json hasWikiEnabled

Aktifkan jika perlu:

gh repo edit Appshines/Voice2Win --enable-wiki

Konvensi Konten

• Kelompokkan halaman berdasarkan bahasa dan gunakan label yang konsisten dalam setiap bahasa.
• Buat Home singkat dan arahkan informasi rinci ke halaman yang fokus.
• Perbarui _Sidebar.md setiap kali halaman ditambahkan, dihapus, atau diganti nama.
• Lebih baik menggunakan deskripsi yang stabil daripada tangkapan layar versi tertentu atau nama file unduhan yang tepat.
• Dokumentasikan perbedaan platform secara eksplisit.
• Jelaskan singkatan saat pertama kali muncul di halaman.
• Jangan pernah mempublikasikan token pasangan, kata sandi, log pribadi, atau rekaman pribadi.
• Uji setiap tautan internal setelah mengganti nama halaman.

Panduan resmi GitHub: Menambahkan atau mengedit halaman wiki.