Sağlanan wiki'ler ile yayımlanan kodun wiki olarak yayımlanması karşılaştırması
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
Azure DevOps'ta wiki içeriğini korumak için aşağıdaki seçeneklere sahipsiniz.
- Ekip projeniz için bir wiki sağlayın. Bu seçenek, takım projesi için yalnızca bir wiki'yi destekler.
- Git deposunda tanımlanan Markdown dosyalarını wiki'de yayımlayın. Bu seçenekle, içerik gereksinimlerinizi desteklemek için çeşitli sürümlere sahip wiki'leri koruyabilirsiniz, ancak yalnızca Azure Repos etkinleştirildiğinde kullanılabilir.
Her iki seçenek de Git depolarındaki wiki içeriğini korurken, wiki içeriğini ekleme, güncelleştirme ve yönetme yöntemleri 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 wiki sağlayabilirsiniz.
Wiki sayfası menü seçenekleri
Sağlanan wiki ile sayfaları doğrudan Wiki'nin içine ekler ve düzenlersiniz. Sağlanan wiki'de yapılan tüm içerik güncelleştirmeleri Wiki'nin içinde gerçekleşir.
Wiki olarak yayımlama koduylaRepos veya Code'dan içerik ekler, düzenler ve güncelleştirirsiniz.
Wiki sayfaları için kullanılamayan menü seçenekleri aşağıdaki çizimde gösterilmiştir. Gördüğünüz gibi kod olarak yayımlama wiki sayfaları için çeşitli seçenekler desteklenmez.
Sağlanan wiki
Kodu wiki olarak yayımlama
Örneğin, wiki olarak kodu yayımlamak için Depolarda Düzenle seçeneği sizi ilgili sayfayı düzenlemek için Depo sayfasına götürür. Wiki için seçtiğiniz daldaki bir sayfada yaptığınız Güncelleştirmeler wiki'de otomatik olarak yayımlanır.
Desteklenen özellikler ve operasyonel farklılıklar
Sağlanan wiki'ler ve kod olarak yayımlama wiki'leri aşağıdaki özellikleri destekler:
- Markdown biçimi
- HTML etiketleri
- Resim ekleme ve yeniden boyutlandırma
- Matematiksel notasyon ve karakterler
- kullanarak iş öğelerine bağlanma #
- Dosya ekleme
- 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 | Kodu wiki olarak yayımlama |
---|---|---|
Birden çok wiki'yi, ad wiki'sini destekleme | ✔️ | |
Depo> Dosyaları veya Kod>Dosyaları'ndan sayfa ekleme veya düzenleme | ✔️ | |
Wiki'den önceki bir düzeltmeye geri dönme | ✔️ | |
Repos veya Code'dan önceki bir düzeltmeye geri dönme | ✔️ | ✔️ |
Sürümlenmiş wiki'leri koruma | ✔️ | |
Wiki sürümü seçin | ✔️ | |
Wiki'nin yayımdan kaldırılma | ✔️ |
Sayfa ekleme
Sağlanan wiki veya wiki olarak kod yayımlama içinYeni sayfa'yı veya Alt sayfa ekle'yi seçin. Daha fazla bilgi edinmek için bkz. Wiki sayfaları ekleme ve düzenleme.
Gezinti bölmesinde sayfa sırası 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 sayfa 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 edinmek için bkz. Wiki Git depo dosyaları ve dosya yapısı.
Sayfa düzeltmeleri ve önceki bir sürüme geri dönme
Wiki'den, Düzeltmeler'i seçerek veya Düzeltmeleri görüntüle menü seçeneğini belirleyerek herhangi bir wiki sayfasının düzeltmelerini görüntüleyebilirsiniz.
Ancak, geri döndürme işlemi wiki sayfası türüne bağlı olarak farklılık gösterir.
- Sağlanan wiki sayfası için, Sağlanan wiki sayfasına işlemeyi geri döndürme bölümünde açıklandığı gibi Geri Döndür'e tıklayın.
- Kod olarak yayımla 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ını temel alarak farklı wiki'lerde farklı içerik sürümleri yayımlayabilirsiniz. Daha önce bir wiki'de yayımladığınız içeriği sürüm oluşturma ve yayımdan kaldırma, yalnızca bir wiki'de kod yayımlayarak oluşturduğunuz wiki'ler için desteklenir.
Daha fazla bilgi edinmek için bkz . Yayımlanan wiki'yi sürüm oluşturma, seçme veya yayımdan kaldırma.
Proje wiki'lerini silme
- Sağlanan wiki kimliğine veya wiki adına karşılık gelen wiki'yi alın. Daha fazla bilgi için bkz. Wikis - REST API alma.
Al https://dev.azure.com/{organization}/{projec``t}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0
Ayrıca bir proje veya koleksiyondaki tüm wiki'leri de alabilirsiniz. Daha fazla bilgi için bkz. Wikis - Liste REST API'si
- Sağlanan wiki kimliğine veya wiki adına karşılık gelen wiki'yi silin. Daha fazla bilgi için bkz. Wikis - REST API'yi silme.
DELETE https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0
Wiki'leri çevrimdışı çalışarak güncelleştirme
Sağlanan wiki'nin içeriğini güncelleştirmek ve kod wiki'siolarak yayımlamak için çevrimdışı veya yerel bir dalda çalışabilirsiniz. Daha fazla bilgi edinmek için bkz. Wiki sayfalarını çevrimdışı kopyalama ve güncelleştirme.