Bagikan melalui


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.

Halaman beranda Wiki

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.

Simpan halaman dengan pesan kustom

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.

Cuplikan layar memperlihatkan pilihan menu Wiki yang disorot.

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.

Cuplikan layar halaman wiki pertama.

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.

Cuplikan layar halaman Edit wiki.

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.

Untuk memperbaiki tautan rusak secara manual setelah memindahkan halaman dalam hierarki, ikuti langkah-langkah berikut:

  1. 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.
  2. Edit halaman penautan: Buka halaman dengan tautan rusak dalam mode edit.
  3. 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.
  4. Simpan perubahan: Simpan perubahan ke halaman untuk menerapkan tautan yang diperbarui.
  5. 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:

  1. Temukan tautan yang rusak dalam konten, seperti Link to Page.
  2. Edit tautan ke jalur baru: Link to Page.
  3. 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.

Cuplikan layar memperlihatkan memindahkan halaman wiki dalam hierarki.

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.

Langkah berikutnya