Wiki dosyaları ve dosya yapısı

  • Makale

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

Proje wiki'leri ve kod wiki'leri için dosyalar ve dosya yapısı hakkında bilgi edinin. Aşağıdaki kılavuzda kod wiki'leri belirtebilirsiniz, ancak her iki wiki türü için de geçerlidir.

Ekip projesi oluşturduğunuzda, varsayılan olarak wiki oluşturulmaz. Daha fazla bilgi için bkz. Wiki oluşturma, BENİOKU oluşturma veya Sağlanan wiki'ler ile yayımlanan kodu wiki olarak yazma.

Her kod wiki'si arka uçtaki bir Git deposu tarafından desteklenir. Bu depo Markdown sayfalarını, resimleri, ekleri ve sayfaların ve alt sayfaların sırasını depolar. Wiki'nizi Azure DevOps kullanıcı arabirimi aracılığıyla oluşturursunuz ve ardından Wiki'yi Git depoNUZUN URL yolu aracılığıyla düzenleyebilirsiniz. Kod wiki'lerini yayımlama hakkında daha fazla bilgi için bkz . Wiki'de Git deposu yayımlama.

Wiki dosyası ve klasör yapısı

Takım projesi wiki Git depolarına aşağıdaki etiketler atanır.

  • Ekip projesi için wiki deposu: ProjectName.wiki
  • Ana dal: wikiMain

wikiMain dalında dal ilkeleri tanımlayarak wiki deponuzu diğer Git depolarını yönettiğiniz gibi yönetin. Ancak, yerel wikiMain dalınızda değişiklik yapabilir ve herhangi bir ilke tanımlamadan bunları doğrudan uzak dala gönderebilirsiniz.

Wiki deposunda aşağıdaki dosya ve klasörler bulunur:

  • Kök düzeyde girilen her Markdown sayfasının dosyası
  • Kökte ve her klasörün altında etiketlenmiş .order dosya
  • Alt sayfaları olan her sayfanın klasörü
  • .attachments klasörü, wiki'nin tüm eklerini depolama

Dosya adlandırma kuralları

Her dosya için sayfa başlığındaki boşluklar yerine kısa çizgi kullanılması gerekir. Örneğin, Katkıda bulunma sayfası başlığı dosya adına karşılık gelir How-to-contribute.md . Sayfa adı URL’ye eklenir ve wiki zaman içinde değiştikçe paylaştığınız bağlantıların sabit kalmasını sağlar.

Her wiki sayfası, wiki Git deposundaki bir dosyaya karşılık gelir. Wiki sayfası başlığına atadığınız adlar aşağıdaki kısıtlamalara uymalıdır.

Kısıtlama türü Kısıtlama
Dosya adı Tam sayfa yolu 235 karakteri aşmamalıdır.
Benzersizlik Sayfa başlıkları büyük/küçük harfe duyarlıdır ve wiki hiyerarşisinde benzersiz olmalıdır.
Özel karakterler - Herhangi bir Unicode denetim karakteri veya vekil karakter içermemelidir.
- Şu yazdırılabilir karakterleri içermemelidir: / \ #.
- Nokta .ile başlamamalı veya bitmemelidir.
Dosya boyutu En fazşa 18 MB’ı aşmamalıdır.
Ek dosyası boyutu En fazla 19 MB’ı aşmamalıdır.

Wiki sayfası başlıklarında özel karakterler

Bu özel karakterlerden : < > * ? | -birini veya daha fazlasını içeren sayfa başlıklarını belirtebilirsiniz. Örneğin, Markdown dosyasını "SSS" veya "Kurulum kılavuzu" olarak adlandırabilirsiniz. Karakterler aşağıdaki URI ile kodlanmış dizelere sahiptir:

Karakter Kodlanmış dize
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2B
" %22

.order dosyası

.order dosyası, wiki'deki sayfaların sırasını tanımlar. Aşağıdaki görselde wiki İçindekiler tablosu örneği ve buna karşılık gelen .order dosyası gösterilmektedir.

Wiki İçindekiler tablosu .order dosyası
Wiki İçindekiler tablosu örneğinin ekran görüntüsü. Wiki örnek sipariş dosyasının ekran görüntüsü.

Varsayılan hiyerarşi alfabetik sıradadır, ancak bu hiyerarşiyi .order dosyasında değiştirebilirsiniz. Wiki sayfalarını yeniden sıralama hakkında daha fazla bilgi için bkz . Wiki sayfalarını ekleme ve düzenleme, Wiki sayfasını yeniden sıralama.

Alfabetik sıralamaya geri dönmek için .order dosyasını silin

.order dosyası olmadığında sayfalar alfabetik olarak sıralanır. Alfabetik sıralamaya geri dönmek için aşağıdaki adımları uygulayın:

  1. Wiki'nin kopya URL'sini kopyalayın ve tarayıcıda açın. Bunu yaptığınızda wiki'yi destekleyen Git deposu (dosya hub'ı) açılır.
  2. .order dosyasına gidin ve silin. Dosya, örneğin bir makaledeki sürükle ve bırak eyleminde silindikten sonra otomatik olarak (yeniden) oluşturulur.