Mengkloning dan memperbarui konten wiki secara offline
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Anda dapat memperbarui halaman wiki Anda secara offline dengan cara yang sama seperti Anda mengembangkan kode dalam repositori Git.
Anda dapat menggunakan klien apa pun yang Anda inginkan atau alat baris perintah git untuk memperbarui wiki Anda secara offline. Untuk detail tentang bekerja dengan repositori Git dan alat yang didukung, lihat Repositori Git.
Langkah-langkah dasar untuk memperbarui konten wiki secara offline adalah sebagai berikut:
- Kloning repositori Wiki Git Anda ke IDE atau ruang kerja lokal Anda.
- Tambahkan file atau folder ke cabang git lokal Anda.
- Perbarui file .order untuk mencerminkan halaman dan sub-halaman Anda.
- Terapkan dan dorong pembaruan yang Anda buat ke cabang git lokal Anda.
Prasyarat
Lakukan langkah-langkah berikut untuk memigrasikan halaman Markdown dari wiki lain ke wiki proyek tim Anda atau ke konten yang Anda terbitkan sebagai kode ke wiki.
Mengkloning wiki Anda
Repositori wiki Anda menyimpan halaman, gambar, lampiran, dan urutan halaman dan sub halaman. Kloning wiki Anda untuk memulai.
Masuk ke proyek Anda (
https://dev.azure.com/{Your_Organization/Your_Project}
) lalu pilih wiki Anda.Buka menu Konteks tindakan lainnya dan pilih Kloning wiki.
Dari dialog Kloning repositori, pilih
Salin URL kloning ke clipboard.
Masukkan di browser Anda untuk melihat file yang ditentukan di bawah cabang wikiMaster.
Gunakan URL yang Anda salin untuk mengkloning repositori di IDE yang Anda gunakan. Untuk mempelajari lebih lanjut, lihat salah satu artikel berikut:
Menambahkan halaman ke repositori Git lokal Anda
Kami menulis halaman menggunakan format Markdown. Tambahkan file Markdown ke cabang lokal Anda untuk setiap halaman dan sub halaman yang ingin Anda tambahkan ke wiki Anda.
Tambahkan halaman
Untuk menambahkan halaman di akar pohon wiki, tambahkan file Markdown di akar repositori Git.
Untuk setiap halaman yang ingin Anda tambahkan, buat file Markdown dengan konten halaman, lalu tambahkan di bawah folder akar untuk repositori Anda.
Untuk proyek tim CanaryBuilds, ada di folder berikut:
C:\Users\UserName\Source\Repos\CanaryBuilds.wiki
Untuk menambahkan halaman di akar pohon wiki, tambahkan file Markdown untuk setiap halaman di akar repositori Git.
Setelah Anda menambahkan semua halaman yang ingin Anda tambahkan di root, perbarui file .order di root. Ini harus memiliki satu entri untuk setiap file Markdown yang didefinisikan di akar. Setiap entri harus cocok dengan judul file dengan spasi diganti dengan tanda hubung.
Contohnya:
Welcome Roadmap How-to-contribute Home Reference
Tambahkan sub-halaman
Buat folder untuk halaman induk, lalu tambahkan file Markdown untuk setiap sub halaman di folder.
Misalnya, kami menambahkan file berikut ke folder Cara berkontribusi. Sub-halaman ini muncul di bawah halaman Cara berkontribusi di wiki.
Tambahkan file .order di folder dengan urutan sub-halaman karena akan muncul di wiki. Untuk memahami penggunaan file .order ke halaman urutan, lihat File repositori Wiki Git dan struktur file.
Misalnya, file memiliki sub-halaman berikut:
Request-extensions Licensing Smoke-test Coding-guidelines
Mendorong perubahan Anda
Setelah selesai dengan semua pembaruan, dorong file ke repositori Git.
Halaman dan sub-halaman yang ditambahkan segera muncul di wiki Anda.
Jika ada kesalahan dalam proses ini, halaman muncul di wiki Anda dengan tanda peringatan.
Artikel terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk