Sağlanan wiki ile kod wikisi olarak yayımlanan wiki karşılaştırması

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

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

Kod olarak yayımlanan wiki ö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.

Kod olarak yayımlanan wiki ile Depolar veya Kod'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 wiki sayfaları olarak yayımlananlar için bu seçeneklerin birkaçı desteklenmez.

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

Örneğin, kod olarak yayımlanan wiki'nin 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.

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.

Kod wiki'sinde yayımlanan bir sayfanın gezinti bölmesindeki sayfaların listesini yapılandırmak için, dosyayı kökte ve alt sayfaları içeren her alt klasör veya üst sayfa için tanımlayın*.order*.

Her iki wiki türü de aynı dosya yapısını izler. Yalnızca kod wiki'sinde yayımlananlar sayfa dizisini el ile tutmanızı gerektirir.

Dosyalarla .order ç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ımlanan 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'yi yalnızca wiki'de kod yayımlayarak oluşturan sizseniz sürüm oluşturabilir ve yayımdan kaldırabilirsiniz. Daha fazla bilgi için bkz . 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.