Buat wiki untuk proyek Anda

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

Dalam artikel ini, pelajari cara membuka wiki dan membuat repositori Git untuk wiki Anda. Setiap proyek tim memiliki wiki. Gunakan wiki untuk berbagi informasi dengan tim Anda untuk memahami dan berkontribusi pada proyek Anda.

Setiap wiki proyek tim didukung oleh repositori Git di back-end. Saat Anda membuat proyek tim, repositori Wiki Git tidak dibuat secara default. Buat repositori Git untuk menyimpan file Markdown wiki Anda, atau terbitkan file Markdown yang ada dari repositori Git ke wiki.

Prasyarat

• Anda harus memiliki proyek tim. Jika Anda belum memiliki proyek tim, buat proyek di Azure DevOps.
• Anda harus memiliki setidaknya akses Dasar untuk membuat dan memodifikasi wiki.
• Anda harus memiliki izin Buat Repositori untuk menerbitkan kode sebagai wiki. Secara default, izin ini diatur untuk anggota grup Administrator Proyek.
• Siapa pun yang merupakan anggota kelompok keamanan Kontributor dapat menambahkan atau mengedit halaman wiki. Setiap pengguna dengan akses ke proyek tim, termasuk pemangku kepentingan, dapat melihat wiki.

Buka Wiki

Anda dapat membuka dan melihat halaman wiki untuk proyek Anda.

Browser

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.

Azure DevOps CLI

Anda dapat melihat dan membuka halaman wiki yang ditentukan untuk proyek menggunakan az devops wiki show perintah . Untuk memulai, lihat Mulai menggunakan Azure DevOps CLI.

az devops wiki show --wiki
                      [--open]
                      [--project]
                      [--subscription]

Parameter

• --wiki: Diperlukan. Nama atau ID wiki.
• --open: Opsional. Buka halaman wiki di browser web Anda.
• --project -p: Opsional. Nama atau ID proyek.
• --subscription: Opsional. Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Contoh

Buka wiki bernama 'myprojectwiki'.

az devops wiki show --wiki myprojectwiki --open

Menampilkan halaman wiki

Untuk mendapatkan konten halaman melalui Azure DevOps CLI, masukkan az devops wiki show perintah .

az devops wiki page show --path
                         --wiki
                         [--include-content]
                         [--open]
                         [--project]
                         [--subscription]
                         [--version]

Parameter

• --path: Diperlukan. Jalur halaman wiki.
• --wiki: Diperlukan. Nama atau ID wiki.
• --include-content: Opsional. Sertakan konten halaman.
• --open: Opsional. Buka halaman wiki di browser web Anda.
• --project -p: Opsional. Nama atau ID proyek.
• --version -v: Opsional. Versi (ETag) halaman wiki.

Contoh

Dapatkan konten halaman wiki dengan jalur 'wiki saya' di wiki bernama 'myprojectwiki'.

az devops wiki page show --path 'my wiki' --wiki 'myprojectwiki' --content "Hello World"

Membuat repositori Wiki Git

Browser

Buat repositori Git baru yang menyimpan semua halaman wiki dan artefak terkait. Dari halaman arahan wiki, pilih Buat wiki Proyek. Bahkan jika Anda menggunakan TFVC untuk kontrol sumber, Anda dapat membuat wiki dengan repositori Git.

Jika Anda tidak memiliki akses untuk membuat repositori Wiki Git atau jika Anda tidak memiliki akses ke salah satu wiki yang ada, pesan berikut muncul.

Administrator Anda dapat membuat repositori Wiki Git atau Anda dapat meminta mereka meningkatkan izin Anda. Pemangku kepentingan tidak dapat membuat wiki, karena mereka tidak memiliki izin untuk bekerja di Repos atau Kode.

Repositori Wiki Git disebut sebagai TeamProjectName.wiki. Misalnya, jika proyek tim Anda adalah foobar repositori wiki diberi label foobar.wiki.

Catatan

Jika Anda ingin membuat lebih banyak wiki, maka Anda harus menerbitkan kode sebagai wiki. Anda dapat menyiapkan beberapa repositori wiki dalam satu proyek.

Bagaimana cara membuka repositori Git?

TeamProjectName.wiki tidak muncul di menu drop-down repositori dari Repos atau Kode. Ini juga tidak ada dalam daftar yang disediakan dari halaman Repositori Pengaturan > Proyek atau Kontrol Versi Pengaturan > Proyek.
Namun, Anda bisa mendapatkannya dari URL berikut:

https://dev.azure.com/<Org_Name>/<Team_Project_Name>/_git/<Wiki_Name>

Pilih Klon Wiki dari elipsis di dekat pemilih wiki untuk mengakses URL wiki.

URL repositori Wiki Git diekspos. Salin dan tempelkan ke browser web Anda untuk mengakses repositori Git yang mendasar.

Azure DevOps CLI

Anda dapat membuat wiki dengan perintah az devops wiki create . Untuk memulai, lihat Mulai menggunakan Azure DevOps CLI.

Catatan

Untuk membuat lebih dari satu wiki, Anda harus menerbitkan kode sebagai wiki. Anda dapat menyiapkan beberapa repositori wiki dalam satu proyek.

az devops wiki create [--mapped-path]
                      [--name]
                      [--org]
                      [--project]
                      [--repository]
                      [--type {codewiki, projectwiki}]
                      [--version]

Parameter

• mapped-path: (Diperlukan untuk jenis codewiki ). Jalur wiki baru yang dipetakan. Misalnya, Anda dapat menentukan / untuk menerbitkan dari akar repositori.
• nama: (Diperlukan untuk jenis codewiki ). Nama wiki baru. Jika Anda tidak menentukan nama untuk jenis projectwiki, maka wiki baru akan diberi nama TeamProjectName.wiki.
• org: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config. Contoh: --org https://dev.azure.com/MyOrganizationName/.
• project: Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config.
• repositori: (Diperlukan untuk jenis codewiki ). Nama atau ID repositori untuk menerbitkan wiki.
• type: Jenis wiki yang akan dibuat. Nilai yang diterima adalah projectwiki (default) dan codewiki.
• version: (Diperlukan untuk jenis codewiki ). Nama cabang repositori untuk menerbitkan wiki kode.

Contoh

Perintah berikut membuat wiki bernama "Fabrikam Fiber" dan menunjukkan output dalam format tabel.

az devops wiki create --name "Fabrikam Fiber" --output table

ID                                    Name                 Type
------------------------------------  -------------------  -----------
7edcc35b-89be-465e-855e-377ba8660af7  Fabrikam Fiber.wiki  projectWiki

Langkah berikutnya

Menambahkan dan mengedit halaman wiki