Wiki'de Git deposu yayımlama

  • Makale

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.

İpucu

Bu makaledeki adımları kullanarak wiki'de yayımladığınız içeriği ekleyebilir ve düzenleyebilirsiniz. Ayrıca çevrimdışı çalışabilir ve wiki içeriğini git deposu aracılığıyla kod üzerinde işbirliği yaptığınız şekilde güncelleştirebilirsiniz. Daha fazla bilgi için bkz . Wiki sayfalarını çevrimdışı güncelleştirme.

Ö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

  1. Kuruluşunuzda (https://dev.azure.com/{yourorganization} ) oturum açın, projenizi açın ve ardından Genel Bakış>Wiki'yi seçin.

    Wiki sekmesinin seçimini gösteren ekran görüntüsü.

Projeler arasında geçiş yapmanız gerekiyorsa, tüm projelere göz atmak için Azure DevOps'ıseçin.

Wiki'de Git deposu yayımlama

Markdown dosyalarını mevcut bir Git deposunda tutarken ve bunları bir wiki'de yayımlamak istediğinizde aşağıdaki adımları uygulayın.

  1. Kodu wiki olarak yayımla'yı seçin.

    Vurgulanan kodu wiki olarak yayımla düğmesini gösteren ekran görüntüsü.

    Not

    Projenizde tanımlanmış bir Git deposu yoksa Kodu wiki olarak yayımla seçeneği görünmez. Yeni bir Git deposu oluşturun ve bu sayfayı döndürerek yenileyin.

  2. Zaten bir takım projesi wiki'sini sağladıysanız Kod wiki'sini yayımla'yı seçin.

    Kodu wiki olarak yayımla menü seçeneğini gösteren ekran görüntüsü.

  3. Markdown dosyalarını içeren depoyu, dalı ve klasörü seçin ve wiki deposu için bir ad girin. Git deposunun takım projesi içinde olması gerekir.

    Wiki deposu için girilen adı gösteren ekran görüntüsü.

    Depodaki tüm Markdown dosyalarını wiki'nizde yayımlamak istediğinizde deponun kökünü belirtin.

  4. Yayımla'yı seçin. Wiki deposu, seçtiğiniz depoya dahil edilen Markdown dosyaları ve klasörleriyle doldurulur.

    Örneğin, aşağıdaki görüntüde, 2. Adımda seçtiğiniz azure-docs-sdk-node deposunda bulunan dosyalar için yayımlanan depo gösterilmektedir.

    Mevcut depo Markdown dosyalarından yayımlanan wiki'nin ekran görüntüsü.

    Wiki içindekiler tablosu (İçindekiler tablosu) aşağıdaki dosyaları içerir:

    • Depo/dal/klasörde tanımlanan her Markdown dosyası (dosya türü= .md) alfabetik sırada listelenir, içindekiler tablosu başlığı Markdown dosya adından türetilir.

    • Herhangi bir Markdown dosyası içermese bile yayımlanan klasör içinde tanımlanan her alt klasör için bir üst sayfa.

      Aşağıdaki görüntüde azure-docs-sdk-node deposunun içeriği gösterilmektedir.

      Wiki'de yayımlanan Markdown dosyalarının yer aldığı deponun ekran görüntüsü.

Git deposu dalının başı wiki ile eşlenir. Dal ve seçili klasörlerde yapılan tüm değişiklikler otomatik olarak wiki'ye yansıtılır. Başka iş akışı söz konusu değildir.

Not

Yayımlanan kod wiki'leri başına en fazla 10 dal yayımlayabilirsiniz.

Ek Markdown dosyalarıyla sağlanan wiki için, Git deponuzda kod bulundurduğunuz gibi sayfaları ekleyebilir veya düzenleyebilirsiniz.

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.

    Wiki eylemi seçeneklerinin, Düzenle, yeniden adlandır veya sil ekran görüntüsü.

Not

Wiki deponuzu, wiki'de yayımlamak üzere seçtiğiniz dalda dal ilkeleri tanımlayarak diğer Git depolarını yönettiğiniz gibi yönetin. Ancak, tanımlı ilkeler olmadan değişiklik yapabilir ve bunları doğrudan web portalınızdan veya bir istemciden dala gönderebilirsiniz.

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.

    İşleme iletişim kutusunun ekran görüntüsü.

    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.

    Çekme isteği oluştur bağlantısının ekran görüntüsü.

İpucu

Dosyanın adını veya büyük/küçük harflerini değiştirdiğinizde, dosyayı değişikliği yansıtacak şekilde güncelleştirin .order . Daha fazla bilgi için bkz . Sayfa sırasını değiştirme, .order dosyası ekleme veya güncelleştirme.

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.

İşlemeyi Yeniden Adlandır iletişim kutusunun ekran görüntüsü.

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.

    Web portalından wiki'ye sayfa ekleme işleminin ekran görüntüsü.

  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.

    Oluştur düğmesiyle yeni dosya iletişim kutusunu gösteren ekran görüntüsü.

  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.

    Vurgulanan dosyaları karşıya yükle seçimini gösteren ekran görüntüsü.

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

    Dosyaları karşıya yüklemek için İşleme iletişim kutusunu gösteren ekran görüntüsü.

Ü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.

    Klasör oluştur iletişim kutusunun ekran görüntüsü.

  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.

Klasörü sayfaya yükseltme işlemini gösteren ekran görüntüsü.

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.

Wiki açılan menüsünden seçilen wiki sürümünü gösteren ekran görüntüsü.

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.

Uyarı

Wiki'nin yayımdan kaldırılması, daha önce yayımladığınız deponun tüm sürümlerini içeren kod wiki'sinin tamamını yayımdan kaldırıyor.

  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.

    Wiki onay iletişim kutusunu yayımdan kaldır'ın ekran görüntüsü.

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

    Wiki'nin yayımdan kaldırılma ekran görüntüsü.