Sağlanan wiki'ler ile yayımlanmış kodun wiki olarak karşılaştırması
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Bu Azure DevOps wiki içeriğini korumak için aşağıdaki seçeneklere sahipsiniz.
- Takım projeniz için bir wiki sağlama. Bu seçenek, takım projesi için yalnızca bir wiki'sini destekler.
- Git deposunda tanımlanan Markdown dosyalarını bir wiki'de yayımlayın. Bu seçenekle, içerik ihtiyaçlarınızı desteklemek için sürümü etkinleştirilmiş çeşitli wiki'ler bulundurabilirsiniz, ancak yalnızca Azure Repos kullanılabilir.
Her iki seçenek de Git depolarında wiki içeriğini bulundursa da, wiki içeriğini ekleme, güncelleştirme ve yönetme yolunuz farklılık gösterir.
Not
Kodu wiki olarak yayımlama özelliği şu anda 2018 Azure DevOps Server sonraki sürümlerde kullanılabilir. Eski sürümler için, takım projeniz için yalnızca wiki sabilirsiniz.
Wiki sayfası menü seçenekleri
Sağlanan bir wiki ile,sayfaları doğrudan Wiki'nin içine ekler ve düzenlersiniz. Sağlanan wiki'ye yapılan tüm içerik güncelleştirmeleri Wiki içinde gerçekleşir.
Bir kodu wiki olarak yayımla ile, kodundan veya Code'dan içerik Repos vegüncelleştirebilirsiniz.
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 desteklenmiyor.
Sağlanan wiki
Kodu wiki olarak yayımlama
Örneğin, wiki olarak Repos kodu yayımlama seçeneği sizi belirli bir sayfayı düzenlemek için Repo sayfasına alır. Wiki için seçtiğiniz dalda bir sayfada yapılan güncelleştirmeler otomatik olarak wiki'de yayımlanır.
Desteklenen özellikler ve operasyonel farklılıklar
Sağlanan wiki'lerve kod olarak yayımlama wiki'leri aşağıdaki özellikleri destekler:
- Markdown biçimi
- HTML etiketleri
- Görüntüleri ekleme ve yeniden boyutlandırma
- Matematiksel notalar ve karakterler
- kullanarak iş öğelerine bağlantı #
- Dosya ekleme
- Wiki içeriğini filtreleme
- Wiki sayfası 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österebilir işlemler veya özellikler özetlenmiştir.
| İşlem | Sağlanan wiki | Kodu wiki olarak yayımlama |
|---|---|---|
| Birden çok wiki desteği, ad wiki'leri | ✔️ | |
| Dosya veya Kod Repossayfaları eklemeveyadüzenleme | ✔️ | |
| Wiki'den önceki bir düzeltmeye geri dönme | ✔️ | |
| Repos veya Code'dan önceki bir düzeltmeye geri dönme | ✔️ | ✔️ |
| Sürüme sahip wiki'leri koruma | ✔️ | |
| Wiki sürümü seçme | ✔️ | |
| Wiki'nin yayımdan kaldır | ✔️ |
Sayfa ekleme
Sağlanan bir wiki veya kodu wiki olarak yayımlamak içinYeni sayfa 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ölmesinde sayfa ekleme veya taşıma sırasında sayfa sırasını ve sayfa listesini otomatik olarak yönetir.
Bir yayımlama kodunun gezinti bölmesindeki sayfaların listesini wikiolarak yapılandırarak kökte ve alt sayfa 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ı takip eder. Bunun tek yolu, wiki olarak yayımlama kodunun sayfa dizisini el ile korumanız gerektirmektedir.
.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'de,Düzeltmeler'i veya Düzeltmeleri görüntüle menü seçeneğini kullanarak 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 bir wiki sayfası için, Sağlanan wiki sayfasınaişlemeyi geri döndürme sayfasında açıklandığı gibi Geri Döndür'ü seçin.
- Kod olarak yayımla wiki sayfası için yerel bir daldan çalışabilirsiniz ve çalışmakta olduğu dalı güncelleştirmek için bir çekme isteği gönderin.
Wiki'de sürüm ve yayımdan kaldır
Sürüm ediş ile Git depos un sürümüne sahip bir dalı temel alarak farklı içerik sürümlerini ayrı wiki'lerde yayımlayın. Daha önce bir wiki'de yayımlamış olduğunuz içeriğin sürümü oluşturma ve yayımdan kaldırılan içerik, yalnızca bir wiki'de kod yayımladığı için oluşturduğunuz wiki'ler için de kullanılabilir.
Daha fazla bilgi edinmek için bkz. Yayımlanmış wiki'yi sürüm, seçin veya yayımdan kaldırabilirsiniz.
Proje wiki'sini silme
Bir proje wiki'sini silme işlemi wiki API'leri ile desteklenmiyor ancak aşağıdaki adımları tamamlayarak wiki deposunu silebilirsiniz.
Tüm içeriğini yedeklemek için wiki deposunu klonlama. Bağlam menüsünü seçin ve ardından Kopyalama URL'sini kopyalayıp Wiki'yikopyala'ya tıklayın.
Bu wiki'yi desteklemektedir git deposu kimliğini almak. Projede REST API wiki'leri almak için bu sayfayı kullanın.
Örneğin: GET https://dev.azure.com/fabrikam/_apis/wiki/wikis?api-version=4.1 Bu, "sampleProject" projesinde yer alan tüm wiki'leri döndürür. Burada silmek istediğiniz wiki'nin depo kimliğini bulabilirsiniz.
Git deposunu REST API aşağıdaki adımları kullanın.
Örneğin: DELETE https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}?api-version=4.1 Önceki adımı kullanarak bulunan proje wiki'sinde depo kimliğini kullanın. Depo kimliğinin kaldırmak istediğiniz proje wiki'si ile eş olduğundan emin olmak.
Çevrimdışı çalışarak wiki'leri güncelleştirme
Sağlanan bir 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 edinmek için bkz. Wiki sayfalarını çevrimdışı kopyalama ve güncelleştirme.