Sağlanan wiki'ler ile yayımlanan kodu wiki olarak karşılaştırma

  • Makale

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure DevOps'ta, wiki içeriğinizi bir ekip projesi wiki'sinde veya kod wiki'si olarak yayımlanan bir wiki'de tutabilirsiniz. Kod wiki'si olarak yayımlanan bir wiki ile içerik gereksinimlerinizi desteklemek için çeşitli sürüme sahip wiki'ler tutabilirsiniz, ancak yalnızca Azure Depoları etkinleştirildiğinde kullanılabilir.

Her iki seçenekte de wiki içeriği Git depolarında korunurken, wiki içeriğini ekleme, güncelleştirme ve yönetme şekliniz farklılık gösterir.

Not

Kodu wiki olarak yayımlama özelliği şu anda Azure DevOps Server 2018 ve sonraki sürümlerde kullanılabilir. Eski sürümler için yalnızca takım projeniz için bir wiki sağlayabilirsiniz.

Wiki sayfası menü seçenekleri

Sağlanan bir wiki ile sayfaları doğrudan wiki'nin içine ekleyebilir ve düzenleyebilirsiniz. Sağlanan wiki'de yapılan tüm içerik güncelleştirmeleri wiki içinde gerçekleşir.

Wiki olarak yayımlama koduyla Repos veya Code'dan içerik ekleyebilir, düzenleyebilir ve güncelleştirebilirsiniz.

Aşağıdaki görüntüde sağlanan wiki için seçenekler gösterilmektedir. Kod olarak yayımlama wiki sayfaları için bu seçeneklerden birkaçı desteklenmez.

Sağlanan wiki sayfası menü seçeneklerinin ekran görüntüsü.

Örneğin, wiki olarak yayımlama kodunun Depoda Düzenle seçeneği sizi depo sayfasına götürerek ilgili sayfayı düzenler. Wiki için seçtiğiniz daldaki bir sayfada yaptığınız Güncelleştirmeler otomatik olarak wiki'de yayımlanır.

Desteklenen özellikler ve operasyonel farklılıklar

Her iki wiki türü de aşağıdaki özellikleri destekler:

Aşağıdaki tabloda, wiki türüne bağlı olarak farklılık gösterebilecek işlemler veya özellikler özetlenmiştir.

İşlem Sağlanan wiki Kodu wiki olarak yayımlama
Birden çok wiki'yi destekleme, wiki'yi adlandırma ✔️
Depo>Dosyaları veya Kod>Dosyaları'ndan sayfa ekleme veya düzenleme ✔️
Wiki'den önceki bir düzeltmeye geri dönme ✔️
Depolardan veya Koddan önceki bir düzeltmeye geri dönme ✔️ ✔️
Sürümlenmiş wiki'leri koruma ✔️
Wiki sürümü seçme ✔️
Kod wiki'lerini yayımdan kaldırma ✔️

Sayfa ekleme

Her iki wiki türü için Yeni sayfa veya Alt sayfa ekle'yi seçin. Daha fazla bilgi için bkz . Wiki sayfaları ekleme ve düzenleme.

Gezinti bölmesinde sayfa dizisi ve sayfa listesi

Sağlanan wiki , gezinti bölmesine sayfa eklediğinizde veya taşıdığınızda sayfa sırasını ve sayfa listesini otomatik olarak yönetir.

Wiki olarak yayımlama kodunun gezinti bölmesindeki sayfaların listesini yapılandırmak için kökte ve alt sayfaları içeren her alt klasör veya üst sayfa için .order dosyasını tanımlayın.

Her iki wiki türü de aynı dosya yapısını izler; yalnızca wiki olarak yayımlama kodu sayfa dizisini el ile tutmanızı gerektirir.

.order dosyalarıyla çalışma hakkında daha fazla bilgi için bkz. Wiki Git depo dosyaları ve dosya yapısı.

Sayfa düzeltmeleri ve önceki sürüme geri dönme

Wiki'den herhangi bir wiki sayfasının düzeltmelerini görüntüleyebilirsiniz. Düzeltmeler'i veya Düzeltmeleri görüntüle menü seçeneğini belirleyin.

Ancak, geri döndürme işlemi wiki sayfası türüne bağlı olarak değişir.

  • Sağlanan wiki sayfası için, Sağlanan wiki'ye işlemeyi geri döndürme sayfasında açıklandığı gibi Geri Döndür'e tıklayın
  • Kod olarak yayımlama wiki sayfası için yerel bir daldan çalışın ve çalıştığınız dalı güncelleştirmek için bir çekme isteği gönderin.

Wiki'yi sürüm oluşturma ve yayımdan kaldırma

Sürüm oluşturma ile, Git deposunun sürümlenmiş dalı temelinde farklı wiki'lerde farklı içerik sürümleri yayımlayabilirsiniz. Wiki sürümü oluşturma ve yayımdan kaldırma, yalnızca wiki'de kod yayımlayarak oluşturduğunuz wiki'ler için desteklenir. Daha fazla bilgi için bkz . Kod yayımlama wiki'si/Kod wiki'sini yayımlama.

Proje wiki'lerini silme

Not

Wiki REST API'leri proje wiki'sini silmeyi desteklemez. Bu nedenle, bunun yerine wiki deposunu silmeniz gerekir.

  1. Tüm içeriğini yedeklemek için wiki deposunu kopyalayın. Diğer seçenekler, wiki'yi kopyalamak için kullanılabilecek kopyalama wiki URL'sine sahiptir.

  2. Wiki'nizi destekleyen git deposu kimliğini alın. Projedeki tüm wiki'leri almak için REST API'yi kullanabilirsiniz.

    Örneğin, GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 projedeki tüm wiki'leri döndürür, böylece hangisini sileceğinizi seçebilirsiniz.

  3. Yedekleme Git deposunu silmek için REST API'sini kullanın. Önceki adımda bulduğunuz proje wiki'sinin depo kimliğini kullanın ve depo kimliğini bir kez daha denetleyin; böylece yanlış olanı kaldırmazsınız.

    Örneğin DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Wiki'leri çevrimdışı güncelleştirme

Sağlanan wiki'nin içeriğini güncelleştirmek ve kod wiki'si olarak yayımlamak için çevrimdışı veya yerel bir dalda çalışabilirsiniz. Daha fazla bilgi için bkz . Wiki sayfalarını çevrimdışı kopyalama ve güncelleştirme.