Bagikan melalui

Wiki yang disediakan vs. diterbitkan sebagai wiki kode

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

Anda dapat mempertahankan konten wiki Anda di wiki proyek tim atau wiki yang diterbitkan sebagai kode. Dengan wiki kode yang diterbitkan, Anda dapat mempertahankan beberapa wiki versi untuk mendukung kebutuhan konten Anda. Opsi ini tersedia saat Anda mengaktifkan Azure Repos.

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

Pertahankan konten wiki

Untuk kedua jenis wiki, Anda dapat bekerja langsung di GitHub atau bekerja offline lalu mendorong perubahan Anda ke repositori.

Untuk wiki yang disediakan, Anda menambahkan dan memelihara halaman wiki langsung di dalam bagianHalaman> pada repositori. Semua pembaruan konten untuk wiki yang disediakan terjadi di dalam wiki itu sendiri.

Untuk wiki kode yang diterbitkan, Anda menambahkan dan memelihara konten wiki sebagai file kode di repositori. Anda mengakses file dalam bagian Repos atau Kode repositori di GitHub.

Gambar berikut ini memperlihatkan opsi menu untuk wiki yang disediakan:

Cuplikan layar opsi menu tersedia untuk wiki yang disediakan dari bagian Halaman wiki.

Beberapa opsi menu tidak didukung untuk diterbitkan sebagai halaman wiki kode . Untuk wiki kode yang diterbitkan sebagai kode, opsi Edit di Repos membuka halaman saat ini, sehingga Anda dapat mengedit konten di tempatnya. Pembaruan yang Anda buat pada halaman di cabang yang dipilih untuk wiki secara otomatis diterbitkan ke wiki.

Menambahkan halaman wiki

Halaman Baru dan opsi menu Tambahkan sub halaman tersedia untuk kedua jenis wiki di GitHub. Untuk informasi selengkapnya, lihat Menambahkan dan mengedit halaman wiki.

Menyesuaikan urutan halaman dan daftar halaman

Kedua jenis wiki menerapkan folder dan struktur file yang sama dalam repositori Git. Perbedaannya adalah bagaimana Anda mempertahankan urutan halaman.

Untuk wiki yang disediakan, GitHub mengelola urutan halaman dan daftar halaman secara otomatis saat Anda menambahkan atau memindahkan halaman di dalam panel navigasi.

Untuk wiki kode terbitan, Anda perlu mengelola urutan halaman secara manual. Untuk menyusun daftar halaman di panel navigasi, Anda menentukan file .order di akar dan untuk setiap subfolder atau halaman induk yang berisi sub-halaman. Untuk informasi selengkapnya, lihat File repositori Wiki Git dan struktur file.

Menampilkan revisi halaman dan kembali ke versi yang lebih lama

Dari halaman Wiki untuk repositori Git, Anda dapat melihat revisi halaman mana pun dalam wiki. Gunakan opsi menu Revisi atau Lihat revisi . Untuk mengembalikan konten halaman saat ini ke versi yang lebih lama, prosesnya berbeda tergantung pada jenis halaman wiki.

Untuk halaman wiki yang disediakan , pilih opsi menu Kembalikan . Untuk informasi selengkapnya, lihat Mengembalikan penerapan ke halaman wiki yang disediakan.

Untuk halaman wiki kode yang diterbitkan, Anda bekerja dari cabang lokal dan mengirimkan permintaan pull untuk memperbarui cabang tempat Anda bekerja.

Menggunakan penerapan versi dan membatalkan penerbitan wiki

Dukungan penerapan versi memungkinkan Anda menerbitkan versi konten yang berbeda ke wiki yang berbeda, berdasarkan cabang versi repositori Git.

Anda dapat membuat versi dan membatalkan penerbitan wiki hanya jika Anda adalah pengguna yang menerbitkan kode untuk membuat wiki. Untuk informasi selengkapnya, lihat Membatalkan penerbitan wiki kode.

Menghapus wiki proyek

Langkah-langkah berikut menjelaskan cara menghapus wiki proyek.

Catatan

Anda tidak dapat menggunakan REST API untuk menghapus wiki proyek. Sebagai gantinya, hapus repositori wiki secara langsung.

  1. Kloning repositori wiki untuk mencadangkan semua konten. Anda dapat menemukan URL wiki pada menu Opsi lainnya (...).

  2. Dapatkan ID repositori Git yang terkait dengan 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 perintah mengembalikan semua wiki dalam proyek. Jalankan perintah dan pilih wiki yang akan dihapus.

  3. Hapus repositori Git yang terkait dengan wiki Anda dengan menggunakan REST API. Gunakan ID repositori wiki proyek yang Anda temukan sebelumnya. Periksa kembali ID repositori untuk memastikan Anda tidak menghapus wiki yang salah.

    Misalnya, DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 perintah menghapus wiki. Ganti <repositoryId> dengan ID repositori wiki untuk dihapus.

Memperbarui wiki saat offline

Anda dapat bekerja offline atau di cabang lokal untuk memperbarui konten untuk kedua jenis wiki. Untuk informasi selengkapnya, lihat Mengkloning dan memperbarui halaman wiki secara offline.

Menjelajahi fitur dan operasi lainnya

Kedua jenis wiki mendukung beberapa fitur dan operasi lainnya:

Beberapa operasi dan fitur hanya tersedia untuk satu jenis wiki atau pendekatan penggunaan yang berbeda:

Operasi Disiapkan Diterbitkan sebagai kode
Mendukung beberapa wiki, memberi nama wiki ✔️
Menambahkan atau mengedit halaman dari Repos>File
atau dari Kode>File		 ✔️
Kembali ke revisi sebelumnya dari halaman Wiki ✔️
Kembali ke revisi sebelumnya dari opsi Repos
atau dari pilihan Kode		 ✔️ ✔️
Pertahankan wiki versi ✔️
Pilih versi wiki ✔️
Membatalkan penerbitan wiki kode ✔️

Konten terkait