Bagikan melalui

Mengkloning dan memperbarui konten wiki secara offline

  • Artikel

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

Anda dapat memperbarui halaman wiki Anda secara offline dengan cara yang sama seperti Anda mengembangkan kode dalam repositori Git.

Anda dapat menggunakan klien apa pun yang Anda inginkan atau alat baris perintah git untuk memperbarui wiki Anda secara offline. Untuk detail tentang bekerja dengan repositori Git dan alat yang didukung, lihat Repositori Git.

Langkah-langkah dasar untuk memperbarui konten wiki secara offline adalah sebagai berikut:

  1. Kloning repositori Wiki Git Anda ke IDE atau ruang kerja lokal Anda.
  2. Tambahkan file atau folder ke cabang git lokal Anda.
  3. Perbarui file .order untuk mencerminkan halaman dan sub-halaman Anda.
  4. Terapkan dan dorong pembaruan yang Anda buat ke cabang git lokal Anda.

Prasyarat

Lakukan langkah-langkah berikut untuk memigrasikan halaman Markdown dari wiki lain ke wiki proyek tim Anda atau ke konten yang Anda terbitkan sebagai kode ke wiki.

Mengkloning wiki Anda

Repositori wiki Anda menyimpan halaman, gambar, lampiran, dan urutan halaman dan sub halaman. Kloning wiki Anda untuk memulai.

  1. Masuk ke proyek Anda (https://dev.azure.com/{Your_Organization/Your_Project}) lalu pilih wiki Anda.

  2. Buka menu Konteks tindakan lainnya dan pilih Kloning wiki.

    Mengkloning repositori Git wiki

  3. Dari dialog Kloning repositori, pilih Salin URL kloning ke clipboard.

    Salin url wiki

    Masukkan di browser Anda untuk melihat file yang ditentukan di bawah cabang wikiMaster.

    File utama Wiki

  4. Gunakan URL yang Anda salin untuk mengkloning repositori di IDE yang Anda gunakan. Untuk mempelajari lebih lanjut, lihat salah satu artikel berikut:

Menambahkan halaman ke repositori Git lokal Anda

Kami menulis halaman menggunakan format Markdown. Tambahkan file Markdown ke cabang lokal Anda untuk setiap halaman dan sub halaman yang ingin Anda tambahkan ke wiki Anda.

Tambahkan halaman

Untuk menambahkan halaman di akar pohon wiki, tambahkan file Markdown di akar repositori Git.

  1. Untuk setiap halaman yang ingin Anda tambahkan, buat file Markdown dengan konten halaman, lalu tambahkan di bawah folder akar untuk repositori Anda.

    Untuk proyek tim CanaryBuilds, ada di folder berikut:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Untuk menambahkan halaman di akar pohon wiki, tambahkan file Markdown untuk setiap halaman di akar repositori Git.

    Repositori Git wiki cabang lokal

  3. Setelah Anda menambahkan semua halaman yang ingin Anda tambahkan di root, perbarui file .order di root. Ini harus memiliki satu entri untuk setiap file Markdown yang didefinisikan di akar. Setiap entri harus cocok dengan judul file dengan spasi diganti dengan tanda hubung.

    Contohnya:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Tambahkan sub-halaman

  1. Buat folder untuk halaman induk, lalu tambahkan file Markdown untuk setiap sub halaman di folder.

    Misalnya, kami menambahkan file berikut ke folder Cara berkontribusi. Sub-halaman ini muncul di bawah halaman Cara berkontribusi di wiki.

    Cuplikan layar sub-halaman.

  2. Tambahkan file .order di folder dengan urutan sub-halaman karena akan muncul di wiki. Untuk memahami penggunaan file .order ke halaman urutan, lihat File repositori Wiki Git dan struktur file.

    Misalnya, file memiliki sub-halaman berikut:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Mendorong perubahan Anda

Setelah selesai dengan semua pembaruan, dorong file ke repositori Git.

Halaman dan sub-halaman yang ditambahkan segera muncul di wiki Anda.

Pohon Wiki diperbarui

Jika ada kesalahan dalam proses ini, halaman muncul di wiki Anda dengan tanda peringatan.

Peringatan ketika file .order tidak diperbarui dengan benar.