Wiki 'ye git deposu yayımlama

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Bu hızlı başlangıçta aşağıdaki görevleri nasıl gerçekleştireceğinizi öğrenin:

  • Wiki 'yi aç
  • Wiki 'ye git deposu yayımlama
  • Yayımlanmış bir wiki 'nin sayfalarını düzenleme
  • Yayınlanan wiki 'ye sayfa ekleme
  • Yayımlanmış bir wiki 'nin sayfa sırasını değiştirme
  • Wiki giriş sayfasını bir sayfa haline getirme

Git deposunda korumakta olduğunuz içerik wiki 'ye yayımlanabilir. Örneğin, bu, yazılım geliştirme seti (SDK), ürün belgeleri veya BENIOKU dosyasını desteklemek için yazılmış içerik olabilir. Tek bir takım projesi içinde birden çok wikonu yayımlayabilirsiniz.

Markaşağı dosyalarınızı bir wiki 'ye yayımlayarak aşağıdaki avantajları elde edersiniz:

  • İçeriği hiyerarşik bir sayfa yapısına göre düzenleme
  • Okuyucuların gözatmasına ve filtreleyebiliyor içindekiler tablosu
  • İçeriğin yeni sürümlerini Yayımla
  • İçeriği, kod tabanınızı yönettiğiniz şekilde yönetme
  • Okuyucular wiki arama özelliğini kullanarak wiki 'yi kolayca arayabilir

Farklı wiki türlerini yönetme hakkında daha fazla bilgi için bkz. sağlanan wiki ve kodu wiki olarak yayımlama arasındaki farklar.

İpucu

Bu makalede özetlenen adımları kullanarak, bir wiki 'ye yayımladığınız içeriği ekleyebilir ve düzenleyebilirsiniz. Ayrıca, çevrimdışı çalışabilir ve wiki içeriğini bir git deposu aracılığıyla kodla 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 projeniz olmalıdır. Henüz bir takım projeniz yoksa, bir ekip projesi oluşturun.
  • projeniz için Azure Repos hizmeti etkinleştirmiş olmanız gerekir.
  • Takım projenizde tanımlanmış bir git deposu olması gerekir. İdeal olarak, bu depo, wiki 'nize yayımlamak istediğiniz en az bir markı dosyası içerir. Bir git deposu eklemeniz gerekiyorsa, bkz. projenizde yeni git deposu oluşturma.
  • Kodu wiki olarak yayımlamak için izin katkıda bulunma izninizin olması gerekir. Varsayılan olarak, bu izin katkıda bulunanlar grubununüyeleri için ayarlanır.
  • Git deposuna katkıda bulunma izinlerine sahip olan herkes, wiki sayfaları ekleyebilir veya düzenleyebilir.

Wiki 'yi aç

Desteklenen bir Web tarayıcısı kullanarak projenize bağlanarak başlayın ve wiki'yi seçin.

Genel Bakış wiki'yi seçin.

Wiki oluşturun, wiki 'niz için bir git deposu sağlayın veya var olan depo markı dosyalarını yayımlayın

takım projenizi değiştirmeniz gerekiyorsa, tüm takım projelerine ve takımlara gitmekiçin Azure DevOps ' yi seçin.

Wiki 'ye git deposu yayımlama

Mevcut bir git deposunda markın dosyalarını korudığınızda ve bunları bir wiki 'de yayımlamak istediğinizde bu seçeneği belirleyin.

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

    Wiki oluşturma, var olan depo markın dosyalarını yayımlama

    Not

    Projenizde bir git deposu tanımlı değilse, kodu wiki olarak Yayımla seçeneği görünmez. Yeni bir git deposu oluşturunve ardından bu sayfayı döndürün ve yenileyin.

    Zaten bir takım projesi wiki sağladıysanız, Wikin bağlam menüsünden kod wiki Yayımla' yı seçin.

    Kodu wiki olarak Yayımla menü seçeneği

  2. Markaşağı dosyalarını içeren depoyu, dalı ve klasörü seçin ve wiki deposunu adlandırın. Git deposunun takım projesi içinde olması gerekir.

    Wiki deposunu adlandırın.

    Depodaki tüm markın dosyalarını wiki 'nize yayınlamak istediğinizde deponun kökünü belirtin.

  3. Yayımla’yı seçin. Wiki deposu, seçtiğiniz depoya dahil edilen markın dosyaları ve klasörleri ile doldurulur.

    Örneğin, aşağıdaki görüntüde, adım 2 ' de seçtiğiniz Azure-docs-SDK-node deposunda bulunan dosyalar için yayımlanan depo gösterilmektedir.

    Mevcut Depo markın dosyalarından yayımlanmış wiki

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

    • Depo/dal/klasörde tanımlanan her bir markı dosyası (dosya türü =. MD) alfabetik sırada LISTELENIYORSA, TOC başlığı, markaşağı dosya adından türetilir

    • Herhangi bir markı dosyası içermediği halde yayımlanan klasör içinde tanımlanan her alt klasör için bir üst sayfa.

      Azure-docs-SDK-node deposunun içindekilerin bir görüntüsü aşağıda verilmiştir.

      Wiki 'de yayınlanan Marku dosyaları ile depo

Git deposunun başlığı artık wiki ile eşlendi. Dal ve seçili klasörler içinde yapılan tüm değişiklikler otomatik olarak wiki 'ye yansıtılır. Başka iş akışı dahil değildir.

Not

En fazla 10 adet wksıs yayımlayabilirsiniz.

Eklediğiniz markı dosyaları ile sağlanan wiki için artık git deponuzdaki kodu tuttuğunuz şekilde sayfaları ekleyebilir veya düzenleyebilirsiniz.

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

  1. Bir sayfayı düzenlemek, yeniden adlandırmak veya silmek için, Repos Dosyaları veya Kod Dosyalarısayfasını açın.

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

    Wiki içeriğini düzenleme, yeniden adlandırma veya silme

Not

Wiki deponuz, wiki'de yayımlamak üzere seçtiğiniz dalda dal ilkeleri tanımlayarak diğer Git depolarını yönetmekle aynı şekilde yönetilebilir. Ancak, hiçbir ilke tanımlanmamışsa değişiklik yapabilirsiniz ve bunları doğrudan web portaldan veya istemciden dalına itebilirsiniz.

Sayfayı düzenleme

Değişikliklerinizin önizlemesini görmek veya önceki sürümden yapılan değişiklikleri vurgulamak için düzenleme modundaki bağlantıları kullanabilirsiniz. Değişikliklerinizi atmak için İptal'i seçin. Desteklenen Markdown özellikleri hakkında ayrıntılı bilgi için bkz. Markdown kullanımı için söz dizimi kılavuzu.

  1. Güncelleştirmelerinizi bitirdikten sonra, Commit (Işle)öğesini seçin ve commit (Yürütme) iletişim formunu doldurun.

    Commit (Commit) iletişim kutusu

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

    Çekme isteği bağlantısı oluşturma

İpucu

Bir dosyanın adını veya büyük/küçük harflerini değiştirmiyorsanız, .order dosyasını değişikliği yansıtacak şekilde güncelleştirmek istemeniz gerekir. Daha fazla bilgi edinmek için Sayfa dizisini değiştirme, bir .order dosyası ekleme veya güncelleştirme'ye atlayın.

Sayfayı yeniden adlandırma

ToC'de görünmesini istediğiniz tüm sayfaların dosya türü olarak .md olması gerekir. Dosyayı uygun şekilde yeniden adlandırmak için Yeniden Adlandır'ı seçin.

Örneğin, burada dosya adını new-home-page.md olarak New-Home-Page.md. Bu sayfa, "Yeni Giriş Sayfası" etiketine sahip toc içinde görünür.

Commit'i Yeniden Adlandır iletişim kutusu

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

Sayfa silme

Wiki'de görünmesini istemeyebilirsiniz. Yayımlanan klasörden silebilirsiniz. Dosyayı bir .order dosyasına dahil ettiysiniz, girdisini .order dosyasından silin. Daha fazla bilgi edinmek için Sayfa dizisini değiştirme, bir .order dosyasını ekleme veya güncelleştirme'ye atlayın.

Sayfa veya sayfa ekleme

Yayımlanmış wiki'nize sayfa eklemek için şunları yapabilirsiniz:

  • Web portalında kök klasöre veya alt klasöre dosya ekleme
  • Upload klasöre veya alt klasöre dosya yükleme
  • Wiki TOC'de sayfa dizisini belirtmek için bir .order dosyası ekleyin veya güncelleştirin.

Yaptığınız her güncelleştirme için değişikliklerinizi depoya işlemeniz gerekir. Ardından, değişiklikleri gözden geçirmek için yayımlanan reponuz için Wiki'nizi yenileyin.

Web portaldan sayfa ekleme

  1. Yayımlanan Repos dosyalar veya Kod Dosyaları'nın ardından Eylemler'i veardından Dosya'ya seçin.

    Web portalında wiki'ye sayfa ekleme

  2. Sayfa için bir ad girin ve .md dosya türünü belirttiğinizden emin olun. Dosya adı, toc içinde görünmesini istediğiniz sayfa başlığına karşılık gelen ve boşluklar yerine tirelerle birlikte gelen addır. 235 karakter veya daha az benzersiz bir başlık belirtin. Sayfa başlıkları büyük/büyük/büyük harfe duyarlıdır. Diğer başlık kısıtlamaları için bkz. Sayfa başlığı adlandırma kısıtlamaları.

    Örneğin, ToC'de Sayfa 4olarak görünen bir sayfa eklemek için, Page-4.md.

    Wiki toC'sini filtreleme

  3. Sayfanın içeriğini girin. Desteklenen Markdown özellikleri hakkında ayrıntılı bilgi için bkz. Markdown dosyaları, pencere öğeleri, wiki'ler ve çekme isteği yorumları için söz dizimi kılavuzu.

  4. Bitirin, Commit 'i (Commit) seçin ve ardından Commit (Yürütme) iletişim kutusunu doldurun.

Upload klasöre yükleme

  1. Önceden tanımlanmış bir içeriğiniz varsa, bunu bir klasöre yükleyebilirsiniz. Eylemler'ive ardından Upload'yi seçin.

    Upload klasöre yükleme seçeneği

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

    Dosyaları karşıya yüklemek için commit iletişim kutusu

Üst sayfa ve alt sayfa ekleme

Üst sayfa eklemek için önce kök klasör düzeyinde bir Markdown dosyası eksersiniz ve sonra aynı etikete sahip bir klasör eklersiniz.

  1. Klasör eklemek için Klasör'e tıklayınve yeni klasör iletişim formunu doldurun. Klasördeki bir altsayfaya karşılık gelen en az bir dosya belirtin.

    Klasör oluştur iletişim kutusu

  2. Klasöre alt sayfa olarak istediğiniz tüm dosyaları ekleyin.

.order dosyası ekleme veya güncelleştirme

Wiki repona dosya veya klasör eklerken son adım, güncelleştirilmiş klasörlerin .order dosyasını eklemek veya güncelleştirmektir. Bu eylem, toC'de göstermek istediğiniz sayfaların sırasını gösterir. Ayrıntılar için bkz. Sayfa dizisini değiştirme, bir .order dosyasını ekleme veya güncelleştirme. .order dosyasında listelenmiyor olan tüm dosyalar alfabetik listenin sonuna eklenir çünkü sıraları int olarak ayarlanır. Maxvalue.

Sayfa dizisini değiştirme, bir .order dosyası ekleme veya güncelleştirme

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

Bir .order dosyasını, Kod Dosyaları sayfasındaki herhangi bir dosyayı eklerken olduğu gibi ekleyebilirsiniz. Dosyaya .order adını girin.

Ardından, klasörün içinde yer alan Markdown dosyalarının sırasını yansıtacak şekilde dosyanın içeriğini düzenleyin. Her giriş, .md dosya türü olmadan dosya adını yansıtmalı. Başlıklar büyük/büyük/büyük harfe duyarlıdır, bu nedenle girişin dosya adı içinde kullanılan büyük/büyük/büyük harfle eşleşmesi gerekir.

Örnek:

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 her seçerek giriş sayfası açılır.

Kök .order dosyasındaki sayfa dizisini ayarerek giriş sayfasını değiştirebilirsiniz.

Örneğin, ilk satıra sayfa adını 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ı adı içeren bir markdown dosyası olması gerekir. Başka bir ifadeyle hem klasör hem de aynı adı içeren md dosyası yanyana yer alamayacaktır.

Aşağıdaki örnekte gösterilen Test, Wiki ağacı içinde bir hiyerarşi oluşturan bir klasöre ve md dosyasına sahip.

Klasörü sayfaya yükseltin

Sonraki adımlar