Wiki'de Markdown kullanımı için söz dizimi kılavuzu
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Önemli
Platform için kullanılabilir içeriği görüntülemek için, içindekiler tablosu üzerinde bulunan sürüm seçiciden bu makalenin doğru sürümünü seçmeye emin olun. Özellik desteği, Azure DevOps Services (TFS) ile yeniden adlandırılan Azure DevOps Server bir şirket içi sürümünden mi çalışmanıza bağlı Team Foundation Server farklılık gösterir.
Hangi şirket içi sürümü kullanmakta olduğunu öğrenmek için bkz. Hangi platformu/sürümü kullanıyorum?
Bu makalede, veri kaynaklarında kullanmak için Wiki'ye özgü Markdown söz dizimi Azure DevOps.
Wiki sayfaları için içindekiler tablosu (İçindekiler)
İçindekiler tablosu oluşturmak için [[_TOC_]] ekleyin. TC, etiket ekleniyorsa ve sayfada en az bir başlık olduğunda oluşturulur.
[[_TOC_]] içindekiler tablosu işlemek için sayfanın herhangi bir yerine yer alır. ToC için yalnızca Markdown başlıkları dikkate alınır (HTML başlık etiketleri dikkate alınmaz).
Tüm HTML ve Markdown etiketleri, içindekiler bloğuna ek olarak başlıklardan çıkarılmış olur. Bir başlığına kalın ve italik eklerken TSK'nin nasıl işleyesi hakkında aşağıdaki örnek için bkz.
Tutarlılık, toC'de biçimlendirmede korunur.
Not
[[_TOC_]] etiketi büyük/büyük/büyük harfe duyarlıdır. Örneğin, [[_toc_]] toC'leri işleyenem olabilir. Ayrıca, yalnızca [[_TOC_]] öğesinin ilk örneği işlenir ve geri kalanı yoksayılır.
Wiki sayfasına Diyagram ekleme
Wiki aşağıdaki Diyagram türlerini destekler:
Wiki sayfasına Diyagram diyagramları eklemek için aşağıdaki söz dizimlerini kullanın:
::: mermaid
<mermaid diagram syntax>
:::
Ayrıca, bir wiki sayfasına varsayılan Bir Diyagram diyagramı eklemek için bir araç çubuğu düğmesi de vardır.
Not
- Çoğu HTML etiketi ve fontawesome, Diyagram diyagramı söz dizimsinde desteklenmiyor.
- Bu, tarayıcıda Internet Explorer.
- Önceki diyagram türü bağlantılar, Daha yeni bir Windows sürümüne gider ve bu sürümde söz dizimi söz dizimi Azure DevOps. Örneğin akış çizelgeleri için LongArrow in Live Editor'ı destekliyoruz ancak bu
---->düzenleyicide Azure DevOps.
Wiki sayfasına video ekleme
YouTube ve Microsoft Akışlar wiki sayfasına video eklemek için aşağıdaki söz dizimlerini kullanın:
::: video
<iframe width="560" height="315" src="https://www.youtube.com/embed/OtqFyBA6Dbk" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
:::
iframe, YouTube veya Microsoft Akışlar videonun ekleme iframe'idir.
Sonuç:
(Sayfada bir kesmeyi önlemek için ":::" sonu gereklidir)
YAML etiketleri
Wiki'de YAML bloğu içeren herhangi bir dosya, tek başına ve bir satırı olan bir tablo tarafından işlenir. YAML bloğu dosyada ilk şey olmalıdır ve üç kesikli satırlar arasında ayarlanmış geçerli YAML biçimine sahip olmalıdır. Tüm temel veri türlerini, listeleri ve nesneleri değer olarak destekler. Söz dizimi, kod dosyası önizlemesi wiki'de de destekleni.
Temel örnek:
---
tag: post
title: Hello world
---
Listeli etiketler:
---
tags:
- post
- code
- web
title: Hello world
---
Wiki Azure Boards de sorgu sonuçlarını ekleme
Sorgu sonuçlarını Azure Boards wiki sayfasına tablo olarak eklemek için aşağıdaki söz dizimlerini kullanın:
::: query-table <queryid>
:::
Örnek:
::: query-table 6ff7777e-8ca5-4f04-a7f6-9e63737dddf7 :::
Sorgu sonuçlarını bir wiki sayfasına eklemek için araç çubuğunu ve sorgu seçiciyi de kullanabilirsiniz.
Sorgu için GUID sağlayan sorgu URL'sini kopyalama hakkında daha fazla bilgi için bkz. Sorgu öğelerini e-postayla gönderme veya sorgu URL'sini paylaşma.
@mention kullanıcıları ve grupları
Kullanıcı @mention grupları wiki'de düzenlemek için wiki düzenleyicisinde "@" tuşuna basın. Bu @mention, e-posta ile bildirilecek kullanıcılardan veya gruplardan bahsederek otomatik olarak açılır.
Ayrıca, düzenleme araç çubuğundan "@mention" öğesini de seçin.
Sayfaları doğrudan kodda düzenlerken aşağıdaki deseni @<{identity-guid}> kullanın: .
Wiki sayfaları için sayfa ziyaretleri
Otomatik olarak, her sayfada son 30 gün için toplu sayfa ziyaretleri sayısı görüntülenir.
Sayfalı bir pagesBatch şekilde tüm sayfalara yapılan ziyaretlerin günlük miktarını görmek için batch API'sini kullanın. Ancak bunlar ziyaret sayısına göre sıralanmış değildir. 30 günlük veriler için rest API'sini kullanarak tüm sayfa ziyaretlerini edinebilirsiniz. İlk 100 sayfayı almak için bu sayfaları ziyaret sayısına göre sırala. Bu ziyaretleri bir panoda veya veritabanında depoleyebilirsiniz.
Not
Sayfa ziyareti, belirli bir kullanıcı tarafından 15 dakikalık bir aralıkta sayfa görünümü olarak tanımlanır.
Wiki sayfasından iş öğelerine bağlantı
Diyez işareti ( # ) girin ve ardından bir iş öğesi kimliği girin.
Not
Bu özellik TFS 2018.2 ve sonraki sürümlerde kullanılabilir.
Wiki sayfalarında HTML etiketi desteği
Wiki sayfalarında HTML etiketlerini kullanarak zengin içerik de oluşturabilirsiniz.
İpucu
Markdown'ı HTML'nizin içine iç içe yerleştirmeniz gerekir, ancak HTML öğesi ile markdown arasına boş bir satır dahil etmek gerekir.
<p>
[A markdown link](https://microsoft.com)
</p>
Not
2019.1 ve sonraki sürümlerde zengin Azure DevOps Server HTML olarak yapıştırabilirsiniz.
Örnek - Eklenmiş video
<video src="path of the video file" width=400 controls>
</video>
<video src="https://sec.ch9.ms/ch9/7247/7c8ddc1a-348b-4ba9-ab61-51fded6e7247/vstswiki_high.mp4" width=400 controls>
</video>
Örnek - Zengin metin biçimi
<p>This text needs to <del>strikethrough</del> <ins>since it is redundant</ins>!</p>
<p><tt>This text is teletype text.</tt></p>
<font color="blue">Colored text</font>
<center>This text is center-aligned.</center>
<p>This text contains <sup>superscript</sup> text.</p>
<p>This text contains <sub>subscript</sub> text.</p>
<p>The project status is <span style="color:green;font-weight:bold">GREEN</span> even though the bug count / developer may be in <span style="color:red;font-weight:bold">red.</span> - Capability of span
<p><small>Disclaimer: Wiki also supports showing small text</small></p>
<p><big>Bigger text</big></p>
Sonuç:
