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 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 wiki kode yang diterbitkan 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 wiki kode yang diterbitkan, 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 halaman wiki yang diterbitkan sebagai kode.
Misalnya, opsi Edit di Repos untuk wiki yang diterbitkan sebagai kode 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:
- Format markdown
- Tag HTML
- Menyisipkan dan mengubah ukuran gambar
- Notasi dan karakter matematika
- Menautkan ke item kerja menggunakan #
- Lampirkan file
- Memfilter konten Wiki
- Mencetak halaman Wiki
- Memperbarui konten secara offline
- Menambahkan atau mengedit halaman dari Wiki
Tabel berikut ini meringkas operasi atau fitur yang mungkin berbeda, tergantung pada jenis wiki.
| Operasi | Wiki yang disediakan | Diterbitkan sebagai wiki kode |
|---|---|---|
| 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 wiki kode yang diterbitkan, tentukan *.order* file di akar, dan untuk setiap subfolder atau halaman induk yang berisi subhalaman.
Kedua jenis wiki mengikuti struktur file yang sama, hanya saja yang diterbitkan sebagai wiki kode mengharuskan Anda untuk mempertahankan urutan halaman secara manual.
Untuk informasi selengkapnya tentang bekerja dengan .order file, 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 kode yang diterbitkan, 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. Anda dapat membuat versi dan membatalkan penerbitan wiki hanya jika Anda adalah orang yang membuatnya dengan menerbitkan kode ke wiki. Untuk informasi selengkapnya, lihat Membatalkan penerbitan wiki kode.
Menghapus wiki proyek
Catatan
REST API Wiki tidak mendukung penghapusan wiki proyek. Jadi, Anda harus menghapus repositori wiki sebagai gantinya.
Kloning repositori wiki untuk mengambil cadangan semua kontennya. Opsi Lainnya memiliki URL wiki kloning, yang dapat digunakan untuk mengkloning wiki.
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.1mengembalikan semua wiki dalam proyek, sehingga Anda dapat memilih mana yang akan dihapus.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.