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.
Ö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:
- Markdown biçimi
- HTML etiketleri
- Resim ekleme ve yeniden boyutlandırma
- Matematiksel gösterimi ve karakterler
- kullanarak iş öğelerine bağlanma #
- Dosya ekle
- Wiki içeriğini filtreleme
- Wiki sayfasını yazdırma
- İçeriği çevrimdışı güncelleştirme
- Wiki'den sayfa ekleme veya düzenleme
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 | Kod wiki'si olarak yayımlandı |
|---|---|---|
| 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.
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.
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.
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.1projedeki tüm wiki'leri döndürür, böylece hangisini sileceğinizi seçebilirsiniz.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.