Wiki'de Git deposu yayımlama

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

Git deposunda zaten bulundurduğunuz içeriği wiki'de yayımlayabilirsiniz. Örneğin, bu içerik yazılım geliştirme seti (SDK) desteği, ürün belgeleri veya BENIOKU dosyası olabilir. Tek bir ekip projesinde birden çok wiki de yayımlayabilirsiniz.

Markdown dosyalarınızı bir wiki'de yayımladığınızda aşağıdaki avantajları elde edebilirsiniz:

• İçeriği hiyerarşik bir sayfa yapısında düzenleme
• İçindekiler tablosuna göz atma ve bunları filtreleme
• İçeriğin yeni sürümlerini yayımlama
• İçeriği kod tabanınızı yönettiğiniz şekilde yönetme
• Wiki arama özelliğini kullanarak wiki'de kolayca arama yapın

Daha fazla bilgi için bkz . Sağlanan ve yayımlanan kodu wiki olarak karşılaştırma.

Önkoşullar

• Bir takım projesine sahip olun. Projeniz yoksa şimdi bir proje oluşturun.
• Projeniz için Azure Repos hizmetini etkinleştirin.
• Ekip projenizde tanımlanmış bir Git deposuna sahip olun. İdeal olarak, bu depo wiki'nizde yayımlamak istediğiniz en az bir Markdown dosyası içerir. Daha fazla bilgi için bkz . Projenizde yeni bir Git deposu oluşturma.
• Kodu wiki olarak yayımlamak için katkıda bulunma iznine sahip olun. Varsayılan olarak, bu izin Katkıda Bulunanlar grubunun üyeleri için ayarlanır. Git deposuna katkıda bulunma izinleri olan herkes wiki sayfalarını ekleyebilir veya düzenleyebilir.

Wiki'leri açma

Wiki'de Git deposu yayımlama

az devops wiki create [--mapped-path]
                      [--name]
                      [--org]
                      [--project]
                      [--repository]
                      [--type {codewiki, projectwiki}]
                      [--version]

az devops wiki create --name "My New Wiki" --type codewiki --repository MyRepo --mapped-path /wikis --version main --output table

ID                                    Name         Type
------------------------------------  -----------  --------
77abd847-31ec-45e9-8622-a190df8e5917  My New Wiki  codewiki

Sayfaları düzenleme, yeniden adlandırma veya silme

Wiki sayfasını düzenlemek, yeniden adlandırmak veya silmek için aşağıdaki adımları uygulayın.

1. Projenizde Repos>Files veya Code > Files'ı açın.

2. İstediğiniz sayfayı seçin, Eylemler'i ve ardından işlemi seçin.

   

Bir sayfasını düzenleme

Değişikliklerinizi önizlemek veya önceki sürümden yapılan değişiklikleri vurgulamak için düzenleme modunda kullanılabilen bağlantıları kullanın. Değişikliklerinizi atmak için İptal'i seçin. Desteklenen Markdown özellikleri hakkında daha fazla bilgi için bkz . Markdown kullanımı için söz dizimi kılavuzu.

1. İşiniz bittiğinde güncelleştirmeleriniz hakkında bir açıklama ekleyin ve ardından İşle'yi seçin.

   

   Sistem, çekme isteği oluşturmak için size otomatik olarak bir bağlantı sunar. Wiki dalını doğrudan düzenlerken bu iletiyi yoksayabilirsiniz.

   

Sayfayı yeniden adlandırma

İçindekiler tablosu içinde görünmesini istediğiniz tüm sayfalar dosya türü .mdolmalıdır.

1. Dosyayı uygun şekilde yeniden adlandırmak için Yeniden Adlandır'ı seçin.

Örneğin, aşağıdaki görüntüde new-home-page.md New-Home-Page.md olarak yeniden adlandırıyoruz. Bu sayfa içindekiler tablosu içinde "Yeni Giriş Sayfası" etiketiyle görüntülenir.

Sayfa başlıkları büyük/küçük harfe duyarlıdır ve klasör içinde benzersiz ve 235 karakter veya daha kısa olmalıdır. Diğer başlık kısıtlamaları hakkında daha fazla bilgi için bkz . Sayfa başlığı adlandırma kısıtlamaları.

Bir sayfayı silme

Wiki'de görünmesini istemediğiniz Markdown dosyalarını yayımlanan klasörden silebilirsiniz. Dosyayı bir .order dosyaya eklediyseniz, dosyadan girdisini .order silin. Daha fazla bilgi için bkz . Sayfa sırasını değiştirme, .order dosyasını ekleme veya güncelleştirme.

Sayfa veya sayfa ekleme

Yayımlanan wiki'nize aşağıdaki sayfaları ekleyebilirsiniz:

• Web portalından kök klasöre veya alt klasöre dosya ekleme
• Dosyaları kök klasöre veya alt klasöre yükleme
• Wiki içindekiler tablosundaki sayfa sırasını belirtmek için dosya ekleme veya güncelleştirme .order

Her güncelleştirme, değişikliklerinizi depoya işlemenizi gerektirir. Ardından, değişiklikleri gözden geçirmek için yayımlanmış deponuzun wiki'sini yenileyebilirsiniz.

Web portalından sayfa ekleme

1. Yayımlanan depo için Depo>Dosyaları veya Kod>Dosyaları'ndan Eylemler'i ve ardından Dosya'yı seçin.

   

2. Sayfa için bir ad girin, dosya türünü belirttiğinizden .md emin olun. Dosya adı, içindekiler tablosu içinde gösterilmesini istediğiniz sayfa başlığına karşılık gelir ve boşluk yerine tireler olmalıdır. 235 karakter veya daha kısa benzersiz bir başlık belirtin. Sayfa başlıkları büyük/küçük harfe duyarlıdır. Diğer başlık kısıtlamaları hakkında daha fazla bilgi için bkz . Sayfa başlığı adlandırma kısıtlamaları.

   Örneğin, İçindekiler tablosu içinde Sayfa 4 olarak görünen bir sayfa eklemek için adlı Page-4.mdbir dosya ekleyin.

   

3. Sayfanın içeriğini girin. Daha fazla bilgi için bkz . Markdown dosyaları, pencere öğeleri, wiki'ler ve çekme isteği açıklamaları için söz dizimi kılavuzu.

4. İşiniz bittiğinde İşle'yi seçin.

Dosyaları bir klasöre yükleme

1. Zaten tanımlanmış içeriğiniz varsa, bunu bir klasöre yükleyebilirsiniz. Eylemler'i ve ardından Dosyaları karşıya yükle'yi seçin.

   

2. Karşıya yüklemek istediğiniz klasörü ve dosyaları seçerek İşleme iletişim formunu doldurun.

   

Üst sayfa ve alt sayfalar ekleme

Üst sayfa eklemek için, önce kök klasör düzeyinde bir Markdown dosyası ekleyin ve ardından aynı etikete sahip bir klasör ekleyin.

1. Klasör eklemek için Klasör'e tıklayın ve Yeni Klasör iletişim kutusunu doldurun. Klasördeki bir alt sayfaya karşılık gelen en az bir dosya belirtin.

   

2. İstediğiniz tüm dosyaları alt sayfa olarak klasöre ekleyin.

.order dosyası ekleme veya güncelleştirme

Wiki deposuna dosya veya klasör eklerken son adım, güncelleştirilmiş klasörlerin .order dosyasını eklemek veya güncelleştirmektir. Bu eylem, içindekiler tablosu içinde göstermek istediğiniz sayfaların sırasını yansıtır. Ayrıntılar için bkz . Sayfa sırasını değiştirme, .order dosyasını ekleme veya güncelleştirme. Dosyada .order listelenmeyen tüm dosyalar, sıraları olarak ayarlandığından int.MaxValuealfabetik listenin sonuna eklenir.

Sayfa sırasını değiştirme, .order dosyasını ekleme veya güncelleştirme

Her .order dosya, bir klasörün içinde yer alan sayfa sırasını tanımlar. Kök dosya, kök .order düzeyinde tanımlanan sayfa sırasını belirtir. Her klasör için bir .order dosya, bir üst sayfaya eklenen alt sayfaların sırasını tanımlar.

1. Bir dosyayı, Kod > Dosyaları sayfasından herhangi bir .order dosyayı eklediğiniz gibi ekleyebilirsiniz. Dosyayı .order olarak adlandırın.

2. Dosyanın içeriğini, klasörün içinde yer alan Markdown dosyalarının sırasını yansıtacak şekilde düzenleyin. Her girdi dosya adını yansıtmalıdır, ancak dosya türü olmadan .md . Başlıklar büyük/küçük harfe duyarlıdır, bu nedenle girdi dosya adında kullanılan büyük/küçük harfle eşleşmelidir.

Örneğin:

README
page-2
page-3
Page-4
Misc content

Giriş sayfası ayarlama

Varsayılan olarak, kökte alfabetik sırada görünen ilk dosya wiki giriş sayfası olarak ayarlanır. Web portalında Wiki'yi seçtiğinizde giriş sayfası açılır.

1. Kök .order dosya içinde sayfa sırasını ayarlayarak giriş sayfasını değiştirin.

Örneğin, sayfa adını ilk satıra girin.

New home page name here
page-2
page-3
Page-4
README
Misc content

Klasörü sayfaya yükselt

Bir klasörün de sayfa olması için klasörle aynı ada sahip, klasöre eşdüzey olarak ayarlanmış bir Markdown dosyası gerekir. Bu nedenle, hem klasör hem .md de aynı ada ait dosya yan yana yer almalıdır.

Aşağıdaki örnekte gösterildiği gibi Test'te hem bir klasör .md hem de wiki ağacı içinde hiyerarşi oluşturan bir dosya vardır.

Wiki sürümü seçme

Wiki sürümünü seçmek için wiki sayfasındaki dal seçeneklerinden sürümü seçin.

Kod wiki'lerini yayımdan kaldırma

Artık bir deponun wiki olarak yayımlanmasını istemiyorsanız, deponun yayımdan kaldırmayı seçebilirsiniz.

1. Yayımdan kaldırmak istediğiniz wiki'yi seçin, bağlam menüsünü açın ve Wiki'yi yayımdan kaldır'ı seçin.

   

2. Yayımdan kaldır'ı seçerek wiki'yi yayımdan kaldırmak istediğinizi onaylayın.

   

İlgili makaleler

• Wiki sayfasını takip edin ve bildirimler alın
• Sağlanan ve yayımlanan wiki karşılaştırması
• Wiki'leri çevrimdışı güncelleştirme
• Wiki Markdown kılavuzu