Wiki yang disediakan vs. kode yang diterbitkan sebagai wiki

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Di Azure DevOps, Anda dapat mempertahankan konten wiki Anda di wiki proyek tim atau yang diterbitkan sebagai wiki kode. Dengan wiki kode yang diterbitkan sebagai, Anda dapat mempertahankan beberapa wiki versi untuk mendukung kebutuhan konten Anda, meskipun hanya tersedia jika Azure Repos diaktifkan.

Meskipun kedua opsi mempertahankan konten wiki di repositori Git, cara Anda menambahkan, memperbarui, dan mengelola konten wiki berbeda.

Catatan

Fitur terbitkan kode sebagai wiki saat ini tersedia di Azure DevOps Server 2018 dan versi yang lebih baru. Untuk versi yang lebih lama, Anda hanya dapat menyediakan wiki untuk proyek tim Anda.

Opsi menu halaman Wiki

Dengan wiki yang disediakan, Anda dapat menambahkan dan mengedit halaman langsung di dalam wiki. Semua pembaruan konten untuk wiki yang disediakan terjadi di dalam wiki.

Dengan kode publikasi sebagai wiki, Anda dapat menambahkan, mengedit, dan memperbarui konten dari Repos atau Kode.

Gambar berikut ini memperlihatkan opsi untuk wiki yang disediakan. Beberapa opsi ini tidak didukung untuk terbitkan sebagai halaman wiki kode.

Cuplikan layar opsi menu halaman wiki yang disediakan.

Misalnya, opsi Edit di Repos untuk kode penerbitan sebagai wiki membawa Anda ke halaman Repositori untuk mengedit halaman tertentu. Pembaruan yang Anda buat ke halaman di cabang yang Anda pilih untuk wiki secara otomatis diterbitkan ke wiki.

Fitur yang didukung dan perbedaan operasional

Kedua jenis wiki mendukung fitur-fitur berikut:

Tabel berikut ini meringkas operasi atau fitur yang mungkin berbeda, tergantung pada jenis wiki.

Operasi Wiki yang disediakan Menerbitkan kode sebagai wiki
Mendukung beberapa wiki, nama wiki ✔️
Menambahkan atau mengedit halaman dari File Repos>atau File Kode> ✔️
Kembali ke revisi sebelumnya dari Wiki ✔️
Kembali ke revisi sebelumnya dari Repos atau Kode ✔️ ✔️
Pertahankan wiki versi ✔️
Pilih versi wiki ✔️
Membatalkan penerbitan wiki kode ✔️

Tambahkan halaman

Untuk kedua jenis wiki, pilih Halaman baru atau Tambahkan sub halaman. Untuk informasi selengkapnya, lihat Menambahkan dan mengedit halaman wiki.

Urutan halaman dan daftar halaman di panel navigasi

Wiki yang disediakan mengelola urutan halaman dan daftar halaman secara otomatis saat Anda menambahkan atau memindahkan halaman di dalam panel navigasi.

Untuk menyusun daftar halaman di panel navigasi untuk kode penerbitan sebagai wiki, tentukan file .order di root, dan untuk setiap subfolder atau halaman induk yang berisi subhalaman.

Kedua jenis wiki mengikuti struktur file yang sama, hanya saja kode penerbitan sebagai wiki mengharuskan Anda untuk mempertahankan urutan halaman secara manual.

Untuk informasi selengkapnya tentang bekerja dengan file .order , lihat File repositori Wiki Git dan struktur file.

Revisi halaman dan kembali ke versi sebelumnya

Dari wiki, Anda dapat melihat revisi halaman wiki apa pun. Pilih Revisi atau opsi menu Tampilkan revisi .

Tapi, proses kembali berbeda tergantung pada jenis halaman wiki.

  • Untuk halaman wiki yang disediakan, pilih Kembalikan, seperti yang dijelaskan di Mengembalikan penerapan ke halaman wiki yang disediakan
  • Untuk halaman wiki publikasi sebagai kode, bekerja dari cabang lokal dan kirim permintaan pull untuk memperbarui cabang tempat Anda bekerja.

Membuat versi dan membatalkan penerbitan wiki

Dengan penerapan versi, Anda dapat menerbitkan versi konten yang berbeda ke wiki yang berbeda, berdasarkan cabang versi repositori Git. Penerapan versi dan pembatalan penerbitan wiki, hanya didukung untuk wiki yang Anda buat dengan menerbitkan kode ke wiki. Untuk informasi selengkapnya, lihat Menerbitkan wiki kode/Membatalkan penerbitan wiki kode.

Menghapus wiki proyek

Catatan

REST API Wiki tidak mendukung penghapusan wiki proyek. Jadi, Anda harus menghapus repositori wiki sebagai gantinya.

  1. Kloning repositori wiki untuk mengambil cadangan semua kontennya. Opsi Lainnya memiliki URL wiki kloning, yang dapat digunakan untuk mengkloning wiki.

  2. Dapatkan ID repositori git yang mendukung wiki Anda. Anda dapat menggunakan REST API untuk mendapatkan semua wiki dalam proyek.

    Misalnya, GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 mengembalikan semua wiki dalam proyek, sehingga Anda dapat memilih mana yang akan dihapus.

  3. Gunakan REST API untuk menghapus repositori Git yang mendukung. Gunakan ID repositori wiki proyek yang Anda temukan di langkah sebelumnya dan periksa kembali ID repositori, sehingga Anda tidak menghapus yang salah.

    Misalnya: DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Memperbarui wiki offline

Anda dapat bekerja offline atau di cabang lokal untuk memperbarui konten untuk wiki yang disediakan dan menerbitkan sebagai wiki kode. Untuk informasi selengkapnya, lihat Mengkloning dan memperbarui halaman wiki secara offline.