Bagikan melalui

File Wiki dan struktur file

  • Artikel

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

Pelajari tentang file dan struktur file untuk wiki proyek dan wiki kode. Panduan berikut mungkin menentukan wiki kode, tetapi berlaku untuk kedua jenis wiki.

Saat Anda membuat proyek tim, wiki tidak dibuat secara default. Untuk informasi selengkapnya, lihat Membuat wiki, Membuat README, atau Wiki yang disediakan vs. kode yang diterbitkan sebagai wiki.

Setiap wiki kode didukung oleh repositori Git di back-end. Repositori ini menyimpan halaman Markdown, gambar, lampiran, dan urutan halaman dan sub-halaman. Anda membuat wiki melalui antarmuka pengguna Azure DevOps, lalu Anda dapat mengedit wiki melalui jalur URL repositori Git Anda. Untuk informasi selengkapnya tentang menerbitkan wiki kode, lihat Menerbitkan repositori Git ke wiki.

Struktur file dan folder Wiki

Repositori Git wiki proyek tim diberi label berikut.

  • Repositori Wiki untuk proyek tim: ProjectName.wiki
  • Cabang utama: wikiMain

Kelola repositori wiki Anda dengan cara yang sama seperti Anda mengelola repositori Git lainnya, dengan menentukan kebijakan cabang di cabang wikiMain. Namun, Anda dapat membuat perubahan pada cabang wikiMain lokal Anda dan mendorongnya langsung ke cabang jarak jauh tanpa menentukan kebijakan apa pun.

Repositori wiki memiliki file dan folder berikut:

  • File untuk setiap halaman Markdown yang dimasukkan di tingkat akar
  • File berlabel .order di akar dan di bawah setiap folder
  • Folder untuk setiap halaman yang memiliki sub-halaman
  • .attachments folder , menyimpan semua lampiran wiki

Konvensi penamaan file

Setiap file memerlukan penggunaan tanda hubung alih-alih spasi di judul halaman. Misalnya, judul halaman Cara berkontribusi sesuai dengan How-to-contribute.md nama file. Nama halaman ditambahkan ke URL, memastikan bahwa link yang Anda bagikan tetap utuh saat wiki berubah dari waktu ke waktu.

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%

File .order

File .order mendefinisikan urutan halaman dalam wiki. Visual berikut menunjukkan contoh WIKI TOC dan file .order yang sesuai.

Wiki TOC File .order
Cuplikan layar contoh WIKI TOC. Cuplikan layar file pesanan contoh Wiki.

Hierarki default dalam urutan alfabet, namun Anda dapat mengubah hierarki ini dalam file .order . Untuk informasi selengkapnya tentang cara menyusun ulang halaman wiki, lihat Menambahkan dan mengedit halaman wiki, Menyusun ulang halaman wiki.

Menghapus file .order untuk kembali ke pengurutan alfabet

Ketika tidak ada file .order , halaman akan diurutkan menurut abjad. Untuk kembali ke pengurutan alfabet, lakukan langkah-langkah berikut:

  1. Salin URL kloning untuk wiki dan buka di browser. Melakukannya membuka repositori Git (hub file), yang mendukung wiki.
  2. Buka file .order dan hapus. File akan dibuat secara otomatis (kembali)setelah penghapusan, misalnya, dalam tindakan seret dan letakkan pada artikel.