Menambahkan dan mengedit halaman wiki
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Anda dapat menambahkan judul dan konten ke halaman, setelah repositori Wiki Git disediakan untuk proyek tim Anda. Ada pengalaman pengeditan dan pratinjau berdampingan di mana Anda dapat mengedit halaman dan mempratinjau konten saat Anda pergi.
Saat Anda menulis halaman menggunakan format Markdown, Anda juga bisa menggunakan panel format untuk pemformatan teks kaya dan menyisipkan gambar, lampiran, dan tautan.
Saat Anda mengedit halaman, simpan dengan memasukkan Ctrl+S. Untuk menyimpan dengan pesan revisi kustom, pilih di samping Simpan. Untuk pintasan lainnya, lihat Pintasan keyboard untuk mengelola halaman wiki.
Alat baris perintah Wiki
Perintah | Deskripsi |
---|---|
az devops wiki show | Membuka wiki |
az devops wiki page show | Mendapatkan konten halaman atau membuka halaman |
az devops wiki page create | Menambahkan halaman baru |
pembaruan halaman wiki az devops | Mengedit halaman |
az devops wiki page delete | Menghapus halaman |
Catatan
Untuk menambahkan atau mengedit halaman ke wiki yang telah Anda terbitkan dari repositori Git, lihat Menerbitkan repositori Git ke wiki. Artikel ini membahas cara menambahkan dan mengedit halaman wiki yang telah Anda provisikan untuk proyek tim.
Prasyarat
- Memiliki wiki yang disediakan.
- Jadilah anggota proyek tim sebagai Kontributor untuk menambahkan atau memperbarui halaman wiki.
- Memiliki tingkat akses Dasar untuk mengedit wiki proyek.
Buka Wiki
Anda dapat membuka dan melihat halaman wiki untuk proyek Anda.
Sambungkan ke proyek Anda menggunakan browser web yang didukung dan pilih Wiki.
Jika Anda perlu mengalihkan proyek tim, pilih Azure DevOps untuk menelusuri semua proyek dan tim tim.
Menambahkan halaman wiki
Untuk menambahkan halaman lain, pilih Halaman baru. Atau, untuk menambahkan sub halaman, buka menu konteks halaman yang sudah ada dan pilih Tambahkan sub halaman.
Tentukan judul unik 235 karakter atau kurang. Judul halaman peka huruf besar/kecil. Untuk pembatasan judul lainnya, lihat File repositori Wiki Git dan struktur file, Konvensi penamaan file.
Anda juga dapat menggunakan pintasan keyboard untuk menambahkan halaman baru dengan menekan n atau menambahkan sub halaman dengan menekan c. Untuk daftar lengkap pintasan keyboard, lihat Pintasan keyboard untuk mengelola halaman wiki.
Pembatasan penamaan judul halaman Wiki
Setiap halaman wiki sesuai dengan file dalam repositori wiki Git. Nama yang Anda tetapkan ke judul halaman wiki harus sesuai dengan batasan berikut.
Jenis pembatasan | Pembatasan |
---|---|
Nama file | Jalur halaman yang sepenuhnya memenuhi syarat tidak boleh melebihi 235 karakter. |
Keunikan | Judul halaman peka huruf besar/kecil dan harus unik dalam hierarki wiki. |
Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: / \ # .- Tidak boleh memulai atau mengakhiri dengan titik . . |
Ukuran file | Tidak boleh melebihi maksimum 18 MB. |
Ukuran file lampiran | Tidak boleh melebihi maksimum 19 MB. |
Karakter khusus dalam judul halaman Wiki
Anda dapat menentukan judul halaman yang berisi satu atau beberapa karakter : < > * ? | -
khusus ini . Misalnya, Anda dapat memberi nama file Markdown sebagai "FAQ?" atau "Panduan penyiapan". Karakter memiliki string yang dikodekan URI berikut:
karakter | String yang dikodekan |
---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |
Mengedit dan menghapus halaman wiki
Untuk mengedit halaman wiki yang sudah ada, buka halaman dan pilih Edit, atau buka menu konteks dan pilih Edit. Anda juga dapat menggunakan pintasan keyboard e untuk membuka pengeditan halaman saat ini dengan cepat. Untuk informasi selengkapnya tentang fungsi pengeditan tertentu, lihat Menggunakan panduan Markdown.
Untuk wiki kode, Anda dapat mengedit halaman di editor berdampingan, menggunakan toolbar markdown untuk membuat konten Anda. Pengalaman ini identik dengan proses di wiki proyek. Anda juga dapat mengedit halaman wiki di hub Repos juga dengan menggunakan opsi , Edit di Repos.
Pilih Edit di Repos untuk membuat cabang dan melanjutkan pengeditan. Tombol Edit di Repos hanya tersedia untuk wiki kode yang mengaktifkan kebijakan cabang. Jika Anda tidak melihat tombol, mungkin karena wiki Anda bukan wiki kode atau kebijakan cabang tidak diaktifkan. Untuk informasi selengkapnya tentang kebijakan cabang, lihat Kebijakan dan pengaturan cabang.
Untuk menghapus halaman, buka menu konteks dari pohon atau yang ada di dalam halaman dan pilih Hapus. Konfirmasi penghapusan dalam dialog yang terbuka.
Catatan
Saat menghapus halaman wiki, Anda juga menghapus semua metadata dan subhalaman apa pun dalam hierarkinya.
Menyusun ulang halaman wiki
Anda dapat menyusun ulang halaman dalam tampilan pohon wiki agar halaman muncul dalam urutan dan hierarki yang Anda inginkan. Anda bisa menyeret dan meletakkan judul halaman dalam tampilan pohon untuk melakukan operasi berikut:
- Ubah hubungan induk-turunan halaman.
- Ubah urutan halaman dalam hierarki.
Catatan
Memindahkan halaman dalam hierarki mungkin memutus tautan dari halaman lain. Anda dapat memperbaiki tautan ini secara manual setelah memindahkan halaman. Menyusun ulang halaman dalam hierarki tidak memengaruhi tautan halaman.
Memperbaiki tautan yang rusak secara manual setelah memindahkan halaman
Untuk memperbaiki tautan rusak secara manual setelah memindahkan halaman dalam hierarki, ikuti langkah-langkah berikut:
- Identifikasi tautan yang rusak:
- Buka halaman yang awalnya ditautkan ke halaman yang dipindahkan.
- Cari tautan rusak, yang mungkin muncul sebagai kesalahan atau konten yang hilang.
- Edit halaman penautan: Buka halaman dengan tautan rusak dalam mode edit.
- Perbarui tautan:
- Temukan tautan rusak dalam konten.
- Perbarui tautan untuk menunjuk ke lokasi baru halaman yang dipindahkan, yang biasanya melibatkan perubahan URL atau jalur di tautan.
- Simpan perubahan: Simpan perubahan ke halaman untuk menerapkan tautan yang diperbarui.
- Verifikasi perbaikan: Buka tautan yang diperbarui untuk memastikannya menunjuk ke halaman yang dipindahkan dengan benar.
Contoh
Jika Anda memindahkan halaman dari /docs/old-path/page.md
ke /docs/new-path/page.md
, Anda akan melakukan langkah-langkah berikut:
- Temukan tautan yang rusak dalam konten, seperti
Link to Page
. - Edit tautan ke jalur baru:
Link to Page
. - Simpan perubahan dan verifikasi bahwa tautan sekarang menunjuk dengan benar ke lokasi baru.
Menggunakan pintasan keyboard untuk menyusun ulang halaman
Anda juga dapat menggunakan pintasan keyboard untuk menyusun ulang halaman. Pilih halaman dan tekan CTRL + PANAH ATAS atau CTRL + PANAH BAWAH untuk mengubah urutan halaman. Untuk mengubah hubungan induk-turunan halaman, buka menu konteksnya dan pilih Pindahkan. Dialog Pindahkan halaman terbuka. Pilih halaman induk tempat Anda bisa memindahkan halaman saat ini.
Untuk daftar lengkap pintasan keyboard, lihat Pintasan keyboard untuk mengelola halaman wiki.
Membuat halaman di halaman beranda wiki
Secara default, halaman pertama yang Anda tambahkan saat membuat wiki diatur sebagai halaman beranda wiki. Anda dapat mengubah beranda wiki jika halaman lain menjadi lebih relevan dengan menyeret dan menjatuhkan halaman ke bagian atas pohon.