Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Important
Bu makalenin platformunuza ve sürümünüze karşılık gelen sürümünü seçin. Sürüm seçici, içindekiler tablosunun üzerindedir. Azure DevOps platformunuzu ve sürümünüzü arayın.
Bu makalede, Wiki sayfaları da dahil olmak üzere Azure DevOps özellikleriyle Markdown (.md) biçimini kullanmaya yönelik temel söz dizimi açıklanmaktadır. Markdown söz dizimi, sayfa içeriğinize başlıklar, listeler, tablolar ve resimler gibi özel biçimlendirmeler eklemenize olanak tanır. README dosyalarınızı, panolarınızı, çekme isteği içeriklerinizi ve daha fazlasını biçimlendirmek için Markdown kullanın.
İki biçimlendirme seçeneği vardır: yaygın Markdown kuralları ve GitHub için Markdown uzantıları.
Azure DevOps özellikleri desteği
Markdown söz dizimi üst bilgiler, başvuru bağlantıları, kalın metin ve dosya ekleriyle içeriği biçimlendirmenizi sağlar. Markdown söz dizimlerinin tümü Azure DevOps'taki tüm özelliklerle çalışmaz. Markdown söz dizimlerini destekleyen temel özellikler şunlardır:
- Proje kilometre taşları için Tamamlanma Tanımı (yönetim panosu) ölçütleri.
- Markdown pencere öğesiyle ekip hedefleri ve ölçümleri.
- Git deposundaki proje dosyaları için çekme istekleri.
- Katkıda bulunanlara yardımcı olmak için Git deposundaki README dosyaları.
- Ekip projesi wiki'sindeki sayfa içeriği için wiki dosyaları.
Note
Azure DevOps'ta Markdown, JavaScript veya iframe'leri desteklemez. Örneğin, geri sayım zamanlayıcıları gibi etkileşimli öğeleri ekleyemezsiniz.
Aşağıdaki listede, her özelliğin desteklediği Markdown öğeleri ve bu makaledeki söz dizimi bölümlerine bağlantılar gösterilmektedir:
| Markdown türü | Done | Widget | PR | README | Wiki |
|---|---|---|---|---|---|
| Headers | ✓ | ✓ | ✓ | ✓ | ✓ |
| Paragraflar ve satır sonları | ✓ | ✓ | ✓ | ✓ | ✓ |
| Alıntıları engelle | ✓ | ✓ | ✓ | ✓ | ✓ |
| Yatay kurallar | ✓ | ✓ | ✓ | ✓ | ✓ |
| Emphasis | ✓ | ✓ | ✓ | ✓ | ✓ |
| Kod vurgulama | ✓ | ✓ | ✓ | ||
| Değişiklik önerin | ✓ | ||||
| Tables | ✓ | ✓ | ✓ | ✓ | |
| Lists | ✓ | ✓ | ✓ | ✓ | ✓ |
| Links | ✓ | ✓ | ✓ | ✓ | ✓ |
| Images | ✓ | ✓ | ✓ | ✓ | |
| Kontrol listesi veya görev listesi | ✓ | ✓ | |||
| Emojis | ✓ | ✓ | |||
| Markdown'ı yoksayma veya kaçış | ✓ | ✓ | ✓ | ✓ | ✓ |
| Attachments | ✓ | ✓ | |||
| Matematiksel gösterimi | ✓ | ✓ |
Headers
Markdown üst bilgilerini kullanarak içeriğinizi yapılandırabilirsiniz. Üst bilgiler, sayfa içeriğinin uzun bölümlerini daha kolay okunabilen bölümlere ayırır. Definition of Done (pano), Markdown pencere öğesi, pull request'lere, Benioku dosyalarına ve wiki dosyalarına üstbilgi ekleyebilirsiniz.
Üst düzey bir başlık tanımlamak için, bir satıra tek bir kare işareti # ardından da başlık metni # Get started on the project ile başlayın. Açıklamalarınızı, satırın başına ## Request permissions veya ### Send feedback gibi birden fazla diyez işareti koyarak alt başlıklarla düzenleyin. Başlık boyutlarını oluşturmak için en fazla altı karma işareti kullanabilirsiniz.
Örnek: Markdown'da başlıklar oluşturma
Aşağıdaki Markdown, bir üst düzey başlık (H1) ve dört alt başlık düzeyi (H2, H3, H4 ve H5) oluşturur.
# This is a top-level (H1) header
## This is a subheader (H2)
### This is a lower subheader (H3)
#### This is an H4 header
##### This is an H5 header
Aşağıdaki görüntüde Markdown'ın yayımlanmış görünümü gösterilmektedir:
Paragraflar ve satır sonları
Important
Azure DevOps Markdown, satır sonlarını diğer Markdown uygulamalarından farklı işler. Paragraf içinde satır sonu (geçici dönüş) oluşturmak için , Enter tuşuna basmadan önce satırın sonuna iki boşluk ekleyin. İki boşluk olmadan Enter tuşuna basarsanız, yayımlanan çıkış satır sonu içermez.
Metninizin daha kolay okunmasını sağlamak için uzun bölümleri daha küçük paragraflara bölün veya satır sonları ekleyin.
Definition of Done (pano), Markdown bileşeni, pull request'ler, Readme dosyaları ve wiki dosyalarına paragraflar ve satır sonları ekleyin.
Örnek: Markdown ve çekme isteklerinde kesmeler ekleme
Çekme isteğindeki açıklamalar, Metin için Kalın ve İtalik stil gibi Markdown'ı kabul eder. Bir sonraki satırda yeni metin başlatmak veya satırlar arasına boşluk eklemek üzere satır sonu eklemek için Enter tuşunu kullanın.
Azure DevOps'ta bir paragrafın içinde satır sonu oluşturmak için Enter tuşuna basmadan önce satırın sonuna iki boşluk ekleyin:
This is the first line with two spaces at the end.
This is the second line, which will appear directly below the first.
Bu şekilde görüntülenir:
Bu, sonunda iki boşluk bulunan ilk satırdır.
Bu, birinci satırın hemen altında görünecek ikinci satırdır.
sondaki iki boşluk olmadan Enter tuşuna basarsanız, satırlar yayımlanan çıktıda tek bir paragrafta birleştirilir.
Yeni bir paragraf oluşturmak için (aralarında boş satır olan) Enter tuşuna iki kez basın:
This is the first paragraph.
This is the second paragraph.
Aşağıdaki görüntüde, çekme isteği açıklamasındaki aralıklar için Markdown'ın yayımlanmış görünümü gösterilmektedir:
Örnek: Markdown dosyalarına veya pencere öğelerine kesme ekleme
Markdown dosyasında veya Markdown pencere öğesinde, yeni paragraflar oluşturmak için metin satırlarını ayırın. Satır sonundan önce iki boşluk (Boşluk tuşu) ekleyin ve yeni bir paragraf başlatmak için Enter tuşuna basın.
Add two **Space** characters before the end of the line and then press **Enter**.
The next paragraph starts on a new line. The two paragraphs are separated by a blank line.
Aşağıdaki görüntüde, pencere öğesindeki aralıklar için Markdown'ın yayımlanmış görünümü gösterilmektedir:
Alıntıları engelle
Bağlam oluşturmak için yorumları veya metni alıntılayın. Alıntılanan metin, sol kenar boşluğundan girintili olarak, alıntılanan bölüm boyunca dikey bir çizgiyle görüntülenir.
Bitti (pano) tanımına, Markdown pencere öğesine, pull request isteklerine, Benioku dosyalarına ve wiki dosyalarına alıntı blokları ekleyebilirsiniz.
Tek bir metin satırını veya paragraf bloğunu tırnak içine almak için, ilk metnin önüne dik açılı ayraç > ekleyin.
İç içe alıntı oluşturmak için, metnin önüne iki veya daha fazla köşeli parantez ekleyin. İç içe alıntı, çift dikey çizgilerle birlikte sol kenar boşluğundan daha fazla girintilidir.
Örnek: Köşeli ayraç kullanarak metin alıntı yapma
> Insert a bracket ">" before the text to quote the line of text.
This text references the quoted sentence.
> To quote a paragraph, insert a bracket ">" before the first text. The other lines in the paragraph are also included in the block quote. Notice the entire paragraph is indented from the left margin and highlighted with a vertical line.
This text references the quoted paragraph.
>> Insert two or more brackets ">>" before the text to create a nested quote.
>>> Nested quotes can also be multiple lines of text. Notice the nested quote text is indented further from the left margin and a vertical line is drawn for each level of bracket you insert.
This text references the nested block quotes.
Aşağıdaki görüntüde, tırnak içine alınmış metin için Markdown'ın yayımlanmış görünümü gösterilmektedir:
Yatay kurallar
yatay kurallarla içerik ve sayfa bölümlerinin altını çizin veya ayırın. Definition of Done (pano), Markdown pencere öğesi, pull requestler, README dosyaları ve wiki dosyalarına ayırıcılar ekleyebilirsiniz.
Yatay kural eklemek için boş bir çizgi, ardından üç kısa çizgi (tire) ---içeren başka bir satır girin.
Örnek: Yatay ayırıcı ekleme
Aşağıdaki Markdown iki yatay kural oluşturur:
Text **above** a horizontal rule
<!-- Blank -->
---
Text **between** horizontal rules
<!-- Blank -->
---
Text **under** a horizontal rule
Aşağıdaki görüntüde yatay kurallar için Markdown'ın yayımlanmış görünümü gösterilmektedir.
Vurgu (kalın, italik, üstü çizili)
Markdown, metni çeşitli yollarla vurgulamanıza olanak tanır:
| Style | Example | Markdown |
|---|---|---|
| Italics | Italik metin | Metni tek bir yıldız işareti * veya alt çizgi _ karakteri içine alın. |
| Kalın (Güçlü) | Kalın metin | Metni çift yıldız ** veya alt çizgi __içine alın. |
| Strikethrough |
|
Metni çift tilde içine ~~ alın. |
Vurgu eklemek için bu stilleri birleştirin. Vurgu stillerini Bitti Tanımında (pano),Markdown pencere öğesinde, çekme isteklerinde, Benioku dosyalarında ve wiki dosyalarında kullanabilirsiniz.
Note
Markdown'da metin altını çizmek için söz dizimi yoktur. Wiki sayfasında, HTML alt çizgi öğesini kullanarak metnin altını çizebilirsiniz <u> .
Örnek: Metni vurgula
Farklı ve birleştirilmiş stillere sahip metinlerin nasıl vurgulandığını gösteren bazı Markdown aşağıda belirtilmiştir:
**Italics** highlights text in a larger block like _new terminology_.
**Bold** (strong) adds presence to text, such as **Important!**
**Strikethrough** is useful for corrections like "Send feedback ~~to the team~~."
Combine styles for other effects, such as ~~__Content removed__~~ and **_Milestones_**.
Sonraki görüntüde Markdown metin vurgusu stillerinin yayımlandığında nasıl göründüğü gösterilir:
Kod vurgulama
Kod vurgularını kullanarak metin bloklarını veya satır içi metni kod olarak vurgulayın. Pull request'lere, README dosyalarına ve wiki dosyalarına kod vurgulama ekleyebilirsiniz.
Bir metin bloğunu kod olarak biçimlendirmek için, bloğu üç backtick (```) karakteri arasında yerleştirin. Bölümü başlatan ve bitiren ters tırnak işaretleri, vurgulanması için kod bloğundan ayrı bir satırda olmalıdır.
Ayrıca, daha büyük bir metin bloğundaki metnin bir bölümünü satır içi kod kesimi olarak biçimlendirebilirsiniz. Bu stil için, satır içi kodu tek ters tırnak işaretiyle çevreleyin. Ters tırnak işaretleri, metinle aynı hizada olup, ayrı satırlarda değildir.
Markdown pencere öğesinde kod vurgulama, kodu önceden biçimlendirilmiş düz metin olarak işler.
Örnek: Markdown pencere öğesinde kod bloğunu vurgulama
Bu örnekte, Markdown pencere öğesinde kod olarak bir metin bloğunun nasıl vurgulandığı gösterilmektedir:
<!-- ``` Three backticks to start block " -->
sudo npm install vsoagent-installer -g
<!-- ``` Three backticks to end block -->
Bu örnek, kod olarak vurgulanan bir metin bloğu için Markdown'ın yayımlanmış görünümünü gösterir:
sudo npm install vsoagent-installer -g
Örnek: Markdown pencere öğesinde satır içi kodu vurgulama
Bu örnekte, Markdown pencere öğesinde metnin bir bölümünü satır içi kod kesimi olarak vurgulama gösterilmektedir:
To install the Microsoft Cross Platform Build and Release Agent, run the following: <!-- ` - Single backtick --> $ sudo npm install vsoagent-installer -g <!-- ` - Single backtick -->
Bu görüntüde, satır içi kod kesimi olarak vurgulanan metnin bir bölümü için Markdown'ın yayımlanmış görünümü gösterilir:
Örnek: Metni koda dönüştürme, kod dilini tanımlama
Metin bloğunu koda dönüştürmenin başka bir yolu da vardır. Markdown'daki bir metin satırı sol kenar boşluğunda dört boşlukla başladığında, metin otomatik olarak bir kod bloğuna dönüştürülür. Bu örnekte şu davranış gösterilmektedir:
This article is a Markdown file (_.md_). This line of text automatically formats as code because the line starts with four spaces in the left margin.
Tercih edilen yaklaşım, dil tanımlayıcısını belirtebilmeniz için metni üç ters tırnak işareti içine almaktır. Tanımlayıcı, belirtilen dilin kurallarına göre koda söz dizimi vurgulama uygular. Tanımlayıcı etiketleri JavaScript (), C# (js) ve Markdown (csharpmd) gibi programlama dillerinin çoğunda kullanılabilir. Desteklenen dillerin listesi için bkz. highlightjs GitHub deposu.
Bu örnekler, bir metin bloğunun JavaScript veya C# olarak nasıl tanım yapılacağını gösterir. Dil tanımlayıcı etiketini ilk üç arka tik işaretinden sonra ekleyin, örneğin ```md.
JavaScript
<!-- ```js - Three backticks and identifier 'js' -->
const count = records.length;
<!-- ``` - Three backticks -->
Bu, JavaScript kodunun yayımlanmış görünümüdür:
const count = records.length;
C#
<!-- ```csharp - Three backticks and identifier 'csharp' -->
Console.WriteLine("Hello, World!");
<!-- ``` - Three backticks -->
Bu, C# kodunun yayımlanmış görünümüdür:
Console.WriteLine("Hello, World!");
Değişiklik önerin
GitHub pull request'leri, katkıda bulunanların geri bildirimde bulunmasına ve değişiklik önermesine olanak tanıyan Açıklama özelliğini destekler. Dosyaya belirli bir satır veya birden çok satır için açıklama ekleyin. Çekme isteği yazarı, Değişikliği Uygula'yı seçerek önerilen değişikliği bir açıklamaya uygular. Bu eylem, değişikliği çekme isteğine ekler ve bir derleme başlatır.
Markdown bileşeninde kod vurgulaması içeren bir yorum eklediğinizde, kod farklılık formatında gösterilir. Değiştirilen satırdaki değişikliklere, farklılıkları göstermek için ek açıklama eklenir. Eksi simgesi - kaldırılan içeriği gösterir ve artı simgesi + yeni içeriği vurgular.
Örnek: Pull request yorumunda değişiklik önerme
Bu örnek, Markdown widget'ında bir pull request üzerinde kod değişiklikleri önerme yöntemini göstermektedir. Bu senaryoda kod bloğu tanımlayıcısını suggestionkullanır:
<!-- ```suggestion - Three backticks and identifier 'suggestion' -->
for i in range(A, B+100, C):
<!-- ``` - Three backticks -->
Aşağıdaki görüntüde, açıklama önerisiyle birlikte farklılıklar görünümü gösterilmektedir.
Daha fazla bilgi için bkz. Açıklamalarda değişiklik önerme.
Tables
Markdown tabloları ile yapılandırılmış verileri düzenleyin. Markdown widget'ına, çekme taleplerine, Benioku dosyalarına ve wiki dosyalarına tablolar ekleyin. Tablolar özellikle işlev parametrelerini, nesne yöntemlerini ve diğer verileri net bir addan açıklamaya eşleme ile tanımlamak için kullanışlıdır.
Markdown'da tablolarla çalışmayla ilgili bazı noktalar şunlardır:
- Her satırı ayrı bir satırda yazın ve her satırın sonuna bir satır başı (CR) veya satır ilerlemesi (LF) ekleyin.
- Kısa çizgi
-ve boru simgesi|ile sütunlar oluşturun,|---|---|---|gibi. - İlk satırda sütun üst bilgilerini tanımlayın, örneğin
| First | Middle | Last |. - İkinci satırda
:gibi iki nokta üst üste kullanarak sütun hizalamasını (sol, orta, sağ) ayarlayın|:--|:--:|--:|. - Tablo metninde boru simgesini kullanırken
\|kaçış yapmak için ters eğik çizgi| Describe the pipe \| symbol. |kullanın. - HTML kesme etiketini
<br/>kullanarak hücre içinde satır sonları ekleyin. Bu yaklaşım wiki'de çalışır ancak başka bir yerde çalışmaz. - Tablo metninde bahsedilen bir iş öğesinin veya çekme isteğinin önüne ve arkasına boş alan ekleyin.
Örnek: Tablo oluşturma
Aşağıdaki örnekte, Markdown'da üç sütun ve beş satır içeren bir tablonun nasıl oluşturulacağı gösterilmektedir:
| Feature | Prerelease | Release target |
|:---|:---:|---:|
| Calculator | No | 10/27/2025 |
| Graphs | Yes | 8/18/2025 |
| Mail | No | 2/16/2025 |
| Tables | Yes | 10/27/2025 |
| Search | No | 1/5/2026 |
Markdown tablosu yayımlandığında şöyle görünür:
| Feature | Prerelease | Yayın hedefi |
|---|---|---|
| Calculator | No | 10/27/2025 |
| Graphs | Yes | 8/18/2025 |
| No | 2/16/2025 | |
| Tables | Yes | 10/27/2025 |
| Search | No | 1/5/2026 |
Lists
Farklı liste türlerini kullanarak ilgili öğeleri düzenleyin. Öğelerin sıralamasını veya düzenini göstermek için sıralı liste kullanın. Sıralı olması gerekmeyen ilgili öğeler için madde işaretlerini kullanın. Tamamlanma Tanımı (pano), Markdown pencere öğesine, çekme isteklerine, README dosyalarına ve wiki dosyalarına liste stilleri ekleyin.
Markdown'da listelerle çalışmayla ilgili bazı noktalar şunlardır:
- Her liste öğesini ayrı bir satırda belirtin.
- Sıralı listedeki her öğeyi bir sayı ve ardından noktayla başlatın; örneğin
1. First item 1. Next item.Yayımlama sistemi listeyi otomatik olarak numaralar. - Sıralı olmayan bir listedeki her öğeye,
-veya*, gibi bir kısa çizgi ya da yıldız işareti ile başlayın- First point - Next point. - Markdown dosyasında veya pencere öğesinde liste öncesi ve sonrası aralıklarını denetleyin:
- İlk liste için, listeden önce ve sonra boş bir satır ekleyin.
- İç içe listeler için doğru girintiyi kullanın. İç içe listelerin öncesinde veya sonrasında fazladan satır sonları gerekmez.
Örnek: Numaralandırılmış (sıralı) liste oluşturma
Bu örnekte Markdown kullanarak bir dizideki öğeler için numaralandırılmış liste oluşturma adımları gösterilmektedir:
<!-- Blank -->
1. First step in the procedure.
1. Second step.
1. Third step.
<!-- Blank -->
Markdown sıralı listesinin yayımlanmış görünümü şöyledir:
- Prosedürün ilk adımı.
- İkinci adım.
- Üçüncü adım.
Örnek: Madde işaretli sırasız liste oluşturma
Bu örnekte Markdown kullanarak ilgili öğelerin sıralanmamış bir listesinin nasıl oluşturulacağı gösterilmektedir:
<!-- Blank -->
- First item in the list.
- Next item.
- Last item.
<!-- Blank -->
Markdown sıralanmamış listesinin yayımlanmış görünümü aşağıdadır:
- Listedeki ilk öğe.
- Sonraki öğe.
- Son öğe.
Örnek: İç içe listeler
Listelerin içinde listeler oluşturun ve stilleri karıştırın.
Bu örnekte, Markdown'da iç içe madde işareti listeleriyle numaralandırılmış liste oluşturma gösterilmektedir:
<!-- Blank -->
1. First step in the procedure.
- First item in a nested list.
- Next item.
- Last item.
1. Second step.
- First item in a nested list.
- First item in a subnested list.
- Next item.
- Last item.
1. Third step.
1. First substep.
1. Next substep.
1. Last substep.
<!-- Blank -->
İç içe listelerin yer aldığı listenin yayımlanmış görünümü aşağıdadır:
- Prosedürün ilk adımı.
- İç içe listedeki birinci öğe.
- Sonraki öğe.
- Son öğe.
- İkinci adım.
- İç içe listedeki birinci öğe.
- İç içe geçmiş alt listedeki ilk öğe.
- Sonraki öğe.
- Son öğe.
- İç içe listedeki birinci öğe.
- Üçüncü adım.
- İlk alt adım.
- Sonraki alt adım.
- Son alt adım.
Links
Kare işaretini # ve ardından iş öğesi ID'sini girip, listeden iş öğesini seçerek iş öğelerine bağlantı oluşturun.
Yapılacak İşlerin Tanımı (pano), Markdown pencere öğesi, çekme istekleri, Readme dosyaları ve wiki dosyalarına farklı bağlantı türleri ekleyin.
Markdown'da bağlantılarla çalışma hakkında bazı noktalar şunlardır:
Bağlantı için standart Markdown söz dizimi şeklindedir
[Link display text](Link path).Çekme isteği açıklamalarında ve wiki'lerde, HTTP veya HTTPS ile başlayan URL'ler otomatik olarak bağlantı olarak biçimlendirilir.
Diyez işaretini
#renk hex kodları gibi farklı şekillerde kullanırsanız, diyez işaretinin önüne#ters eğik çizgi ekleyerek\iş öğeleri için otomatik önerilerden kaçınabilirsiniz.Markdown dosyaları ve pencere öğelerinde, standart Markdown bağlantı söz dizimini kullanarak URL için metin köprüleri oluşturun.
Link pathgöreli veya mutlak olabilir.Aşağıdaki örnek, Markdown'da göreli bağlantının nasıl belirtileceğini gösterir. Metin hiperlink olarak görüntülenir.
For more information, see the [C# language reference](/dotnet/csharp/language-reference/).Bağlantının yayımlanmış görünümü aşağıdadır:
Daha fazla bilgi için bkz. C# dil başvurusu.
Desteklenen bağlantılar
Aynı Git veya Team Foundation Sürüm Denetimi (TFVC) deposundaki başka bir Markdown sayfasına bağlandığınızda, bağlantı hedefini göreli veya mutlak bir yol olarak belirtin.
Note
Dosya paylaşımları (file://...) üzerindeki belgelerin bağlantıları güvenlik nedeniyle desteklenmez.
Aşağıdaki bölümlerde farklı Markdown senaryolarına yönelik örnekler gösterilmektedir.
Örnek olarak: Hoş Geldiniz Sayfası göreli bağlantıları
Wiki'nin Hoş Geldiniz sayfasında göreli bağlantı örnekleri aşağıda verilmiştir:
Göreli yol:
[Display text](target.md)Git'te mutlak yol:
[Display text](/folder/target.md)TFVC'de mutlak yol:
[Display text]($/project/folder/target.md)URL:
[Display text](http://address.com)
Örnek: Markdown pencere öğesi göreli bağlantıları
Aşağıdaki örnekte Markdown pencere öğesindeki göreli bağlantı gösterilmektedir:
- URL:
[Display text](http://address.com)
Örnek: Wiki sayfaları göreli bağlantıları
Wiki sayfasındaki göreli bağlantılara bazı örnekler aşağıda verilmiştir:
- Wiki sayfalarının mutlak yolu:
[Display text](/parent-page/child-page) - URL:
[Display text](http://address.com)
Kaynak denetimi göreli bağlantıları
Kaynak denetim dosyalarına göreli bağlantılar Hoş Geldiniz sayfasında ve Markdown pencere öğesinde farklı yorumlanır:
Örnek olarak: Hoş Geldiniz Sayfası göreli bağlantıları
Hoş Geldiniz sayfasındaki göreli bağlantılar, Hoş Geldiniz sayfasının bulunduğu kaynak denetim deposunun köküne göredir. Aşağıda bazı örnekler verilmiştir:
- /BuildTemplates/AzureContinuousDeploy.11.xaml
- ./page-2.md
Örnek: Markdown pencere öğesi göreli bağlantıları
Markdown pencere öğesindeki göreli bağlantılar, takım projesi koleksiyonu URL tabanına göredir. Aşağıda bazı örnekler verilmiştir:
- /DefaultCollection/Fabrikam/versionControl#path=$/TFVC-Welcome/BuildTemplates/AzureContinuousDeploy.11.xaml
- /DefaultCollection/Fabrikam/versionControl#path=$/TFVC-Welcome/page-2.md
Bağlantı bağlantıları
Markdown dosyası HTML olarak işlendiğinde, sistem sayfadaki her üst bilgi için bir bağlantı kimliği atar. ID, başlık metninin dönüştürülmüş bir biçimidir. Sistem, kimliği oluşturmak için aşağıdaki değişiklikleri uygular:
- Üst bilgi metnindeki boşlukları kısa çizgilerle değiştirme
- - Büyük harfleri küçük harfle değiştirme
- Özel karakterlerin ve noktalama işaretlerinin çoğunu , ,
:,",?,@, gibi$kısa çizgilere dönüştürün# - İşleme altyapısının kurallarına göre diğer özel karakterleri kaldırma veya dönüştürme
Belgede başlığa bağlantı vermek için # karma işaretini [Display text](#<header-anchor>) kullanın, tıpkı [Display text](#<header-anchor>) örneğindeki gibi.
Aşağıdaki örnekte bir başlık ve bağlantı kimliğine bağlantı gösterilmektedir.
#### Team #1 : Release Wiki!
Welcome to the Release wiki. For more information, [Visit the Project Wiki](#team-1--release-wiki).
Yayımlanan görünüm aşağıdadır:
Ekip #1 : Wiki'yi Serbest Bırak!
Yayın wiki'sine hoş geldiniz. Daha fazla bilgi için Project Wiki'yi ziyaret edin.
Tavsiye
Üst bilginin tam bağlantı kimliğini belirlemek için, işlenen HTML'yi inceleyin veya tarayıcının geliştirici araçlarını kullanarak üst bilgi öğesine atanan gerçek id özniteliği bulun.
Bağlantıda yer işareti kimliği olan dosya adını belirterek başka bir Markdown dosyasındaki bir başlığa bağlanın:
[Set up a project wiki](about-readme-wiki.md#set-up-a-project-wiki).
Wiki sayfası aynı zamanda bir Markdown dosyasıdır. Wiki'deki bir sayfadaki bir başlığa başka bir sayfadan başvurma:
Welcome to the Wiki!
- [Get Started](/get-started-page)
- [Contribute content](/get-started-page#contribute)
- [Send Feedback](/contact-page#send-feedback)
Images
Kavramları göstermek ve içeriğinize görsel ilgi eklemek için görüntüleri ve animasyonlu GIF'leri kullanın. Markdown widget'ına, pull request'lara, readme dosyalarına ve wiki dosyalarına resim ekleyin.
Resim veya animasyonlu GIF için standart Markdown söz dizimini kullanın: . Bu söz dizimi bir bağlantıya benzer, ancak satır ünlem işaretiyle ! başlar.
Image alt text resmi açıklar ve kullanıcı yayımlanan görünümde resmin üzerine geldiğinde görüntülenir.
Image path görüntü konumunu tanımlar.
Markdown dosyasına çizim ekleyen bir örnek aşağıda verilmişti:
Resim yolu
Görüntü dosyasının yolu, bir bağlantıdaki başka bir Markdown dosyasının yolu gibi Git veya TFVC'de göreli bir yol veya mutlak bir yol olabilir.
- Göreli yol:
 - Git'te mutlak yol:
 - TFVC'de mutlak yol:
Görüntü boyutu
Resim boyutunu söz dizimi ile Image-path =Image-widthxImage-height ayarlayın:
- Harf
x, width-by-height ifadesindeki "by" değerini temsil eder. - harfinden
xönce veya sonra boşluk eklemeyin. - Eşittir
=işaretinden önce bir boşluk ekleyin. - Yalnızca genişliği belirtmek için kullanın
Image-path =Image-widthx. Yine de harfinixeklemeniz gerekir.
Genişliği 500 ve yüksekliği 250 olan bir görüntü için Markdown söz dizimi örneği aşağıda verilmişti:
Denetim listesi veya görev listesi
Basit görev listeleriyle atamalarınızın ve eylem öğelerinizin ilerleme durumunu izleyin. Çekme isteklerine ve wiki dosyalarına denetim listeleri veya görev listeleri ekleyin. Bu özellik, inceleyicilerden gelen girdileri takip etmek için çekme talebi açıklamasında veya görev durumunu izlemek için wiki proje sayfasında kullanışlıdır.
Örnek: Markdown'da denetim listesi oluşturma
Doğrudan Markdown'da bir denetim listesi oluşturun:
- Yeni görev oluşturmak için boş köşeli ayraç kullanın
[<space>]. - Köşeli parantez içine
xharfini[x]ekleyerek bir görevi tamamlanmış olarak gösterin. - Her görevin önüne bir kısa çizgi ve boşluk
-<space>[<space>]ya da bir sayı ve boşluk1.<space>[<space>]ekleyin. Herhangi bir rakamı kullanın. - Markdown tablosunun içinde denetim listesi kullanmayın.
Aşağıdaki örnek, ilk öğenin tamamlandı olarak işaretlendiği dört öğe içeren bir denetim listesi oluşturur:
- [x] Project plan
- [ ] Draft 1 code
- [ ] Draft 2 code
- [ ] Test plan
Denetim listesinin yayımlanmış görünümü aşağıdadır:
Denetim listesi yayımlandıktan sonra, kullanıcılar listedeki öğe onay kutusunu seçerek bir öğeyi tamamlandı olarak işaretler.
Örnek: Seçili metne Markdown ile görev listesi uygulama
Web portalında var olan metni seçin ve denetim listesi biçimini uygulamak için Markdown araç çubuğundaki eylemleri kullanın. Bu şekilde bir denetim listesi veya görev ekledikten sonra, Markdown'daki listeyi veya görevi düzenleyin.
Aşağıdaki görüntüde, Markdown araç çubuğundaki Görev Listesi stilinin seçili metne nasıl uygulanacağı gösterilmektedir:
Listedeki görev kutusunu işaretleyerek görevi tamamlandı olarak işaretleyin:
Emoji tepkileri
Pull request'lere ve wiki dosyalarına emoji tepkileri ekleyin. karakter eklemek ve istekteki yorumlara tepki vermek için emoji tepkilerini kullanın.
gibi smile bir duygu veya ifadenin adını girin ve metni iki noktalı : karakterlerinin içine alın. Markdown'ın yayımlanan görünümünde girişiniz ilgili emoji grafiğine dönüştürülür. Azure DevOps'ta Markdown, GitHub emoji grafiklerinin çoğunu destekler. gibi :bowtie: desteklemez.
Örnek: Bir pull request'e emoji tepkileri ekleme
Bu örnek, çekme isteği yorumunda Markdown ile emoji tepkilerinin nasıl ekleneceğini göstermektedir.
The code review received :+1::+1: and the team is :smile:
Bu görüntüde emoji tepkilerinin yayımlanmış görünümü gösterilmektedir:
Örnek: Markdown'da emoji söz diziminin kaçış işlemi
Bu örnek, Markdown'da ters eğik çizgi \ karakteriyle emoji söz diziminden nasıl kaçtığını gösterir:
Markdown syntax for some emoji reactions:
- **Happy** \:smile:
- **Angry** \:angry:
- **Sad** \:cry:
Bu görüntüde, emoji söz dizimini gösteren Markdown'ın yayımlanmış görünümü gösterilmektedir:
Çekme isteği yorumunda, emoji sözdizimi dönüşümünü atlamak için iki ters eğik çizgi \\ kullanın.
Özel karakterler değişmez metin olarak
Özel karakterleri harfi harfine metin olarak yayımlamak için Markdown'da kaçış karakteri olarak ters eğik çizgi \ kullanın. Ters eğik çizgi, yayımlama sistemine özel karakteri olduğu gibi göstermesini ve yorumlamamasını veya dönüştürmemesini sağlar.
Bitti tanımı (pano), Markdown pencere öğesi, çekme istekleri, Benioku dosyaları ve wiki dosyalarında görmezden gelme ve kaçış dizimini kullanın.
Örnek: Özel karakterler yayımlama
Markdown söz dizimi 'Metni ters tırnak içine alın' yayımlanan görünümde Enclose text in backticks olarak gösterilir. Yayımlama sistemi, geri tik (`) içindeki metne inline code biçimini uygular ve geri tikleri yayımlamaz.
Ters eğik çizgiyi (\) önek olarak eklerseniz, ters tırnak işaretleri içindeki metin biçimi değişmez ve ters tırnak işaretleri yayımlanır. Bu davranış, parantezler (), köşeli ayraçlar [], alt çizgi _, kısa çizgi -, kare işareti #, yıldız işareti *, ters tırnak ' ve ters eğik çizgi \ dahil olmak üzere çoğu özel karakter için çalışır.
Aşağıdaki Markdown, özel karakterleri değişmez metin olarak göstermek için ters eğik çizgi \ karakterini kullanır:
\\\ Code comment
Show the **\_\_**underscores**\_\_**
\# Code comment and not a **Heading**
**\(** Include the **parentheses \)**
Show the __\*__asterisks__\*__ and don't change to *italics*
Markdown'ın yayımlanmış görünümü aşağıdadır:
\\ Kod açıklaması
__underscores__ göster
# Başlık değil kod açıklaması
(Parantezleri dahil et )
* Yıldız işaretlerini* göster ve italik olarak değişme
Note
Bazı Markdown için karakter simgesi \yerine ters eğik çizginin HTML kodunu \ girin.
Attachments
Çekme isteği yorumlarına ve wiki sayfalarına dosya ekleyin. Ekler, noktanızı göstermeye yardımcı olabilir veya önerilerinizle ilgili ayrıntıları sağlayabilir. Ekler aşağıdaki dosya biçimlerini destekler:
Ek türü
Dosya biçimleri
Code
C# (.cs), Genişletilebilir biçimlendirme dili (.xml), JavaScript Nesne Gösterimi (.json), Köprü Metni biçimlendirme dili (.html, .htm), Katman (.lyr), Windows PowerShell betiği (.ps1), Roshal Arşivi (.rar), Uzak Masaüstü Bağlantısı (.rdp), Yapılandırılmış Sorgu Dili (.sql)
Not: Çekme isteği açıklamalarında kod ekleri desteklenmez.
Sıkıştırılmış dosyalar
ZIP (.zip), GZIP (.gz)
Documents
Markdown (.md), Microsoft Office İletisi (.msg), Microsoft Project (.mpp), Word (.doc, .docx), Excel (.xls, .xlsx, .csv), PowerPoint (.ppt, .pptx), Düz metin (.txt), Taşınabilir Belge Biçimi (.pdf)
Images
PNG (.png), GIF (.gif), JPEG (.jpeg, .jpg), Simgeler (.ico)
Visio
VSD (.vsd, .vsdx)
Video
MOV (.mov), MP4 (.mp4)
Note
Tüm dosya biçimleri, Microsoft Office İletisi (.msg) dosyaları gibi çekme isteği açıklamalarında ek olarak desteklenmez.
Resim veya dosya ekleme
Bir çekme isteği Açıklama kutusuna veya Düzenleme bölmesindeki wiki sayfasına çeşitli yollarla resim veya dosya ekleyebilirsiniz:
Bir dosyayı açıklamaya veya wiki sayfasına sürükleyin.
Panonuzdan açıklamaya veya wiki sayfasına bir resim yapıştırın. Görüntü doğrudan açıklamada veya wiki sayfasında gösterilir.
Açıklamadaki veya wiki sayfanızdaki Biçim bölmesindeki Ekle (ataş) simgesini seçin ve eklenecek dosyayı seçin:
Görüntü olmayan bir dosya eklediğinizde, sistem açıklamadaki veya wiki sayfasındaki dosyaya bir bağlantı oluşturur. bağlantının görüntüleme metnini, köşeli ayraçlar içinde [Updated link display text](LINK URL) olduğu gibi değiştirin. Sayfayı veya açıklamayı yayımladığınızda, kullanıcı eke erişmek için bağlantıyı seçer.
Matematiksel notasyon ve karakterler
Çekme isteği yorumlarında ve wiki dosyalarında matematiksel gösterim ve karakterler kullanabilirsiniz. Aşağıdaki öğeleri içeren hem satır içi hem de blok KaTeX gösterimi desteklenir:
- Symbols
- Yunanca harfler
- Matematiksel işleçler
- Güçler ve endeksler
- Kesirler ve binomlar
- KaTeX tarafından desteklenen diğer öğeler
Markdown dosyasında matematiksel notasyon dolar $ işaretleri içine yerleştirilir. Diğer metinlerle satır içi bir ifade oluşturmak için gösterimi tek dolar işareti $ A + B = C $ içine alın. Blok ifadesi için bloğu iki dolar işaretiyle başlayıp sonlandırın: $$ A = 1 \ B = 2 \ C = A + B $$.
Örnek: Yunanca karakterleri listeleme
Aşağıdaki örnekte, Markdown dosyasına bir kod parçacığı ekleyerek matematiksel gösterimde kullanılan Yunanca karakterler listelenmektedir. Kod parçacığının dil tanımlayıcısının Markdown KaTeXdeğil olduğuna md dikkat edin:
$
\alpha, \beta, \gamma, \delta, \epsilon, \zeta, \eta, \theta, \kappa, \lambda, \mu, \nu, \omicron, \pi, \rho, \sigma, \tau, \upsilon, \phi, ...
$
$\Gamma, \Delta, \Theta, \Lambda, \Xi, \Pi, \Sigma, \Upsilon, \Phi, \Psi, \Omega$
Yunanca karakterlerin yayımlanmış görünümü aşağıdadır:
Örnek: Cebirsel gösterimi kullanma
Aşağıdaki örnekte satır içi gösterim ve cebirsel blok ifadesi kullanılmaktadır.
Area of a circle is $\pi r^2$
And, the area of a triangle is:
$$
A_{triangle}=\frac{1}{2}({b}\cdot{h})
$$
Markdown dosyasındaki gösterimin yayımlanmış görünümü aşağıdadır:
Örnek: Toplamları ve integralleri gösterme
Aşağıdaki örnek, toplamları ve integralleri hesaplamak için iki blok ifadesi kullanır:
$$
\sum_{i=1}^{10} t_i
$$
$$
\int_0^\infty \mathrm{e}^{-x}\,\mathrm{d}x
$$
Markdown dosyasındaki ifadelerin yayımlanmış görünümü aşağıdadır:
Azure DevOps wiki'sinde Markdown
Azure DevOps wiki'nizi geliştirmek için Markdown'ı kullanmanın birçok yolu vardır. Aşağıdaki bölümlerde çeşitli görevler için söz dizimi örnekleri verilmiştir:
- Diziler, akış çizelgeleri ve kullanıcı yolculukları gibi Denizkızı diyagramları ekleme
- Sayfalar ve alt sayfalar için içindekiler tablosu oluşturma
- Daraltılabilir sayfa bölümlerini yapılandırma
- Videoları ve Azure Boards sorgu sonuçlarını ekleme
- İş öğelerine # işareti ile bağlantı yapma
# - Kullanıcılar ve gruplar için
@<alias>etiketlerini kullanın - Zengin metinler için gibi
<font>HTML öğeleri ekleme - Sayfa ziyaret sayısını denetleyin
Bu özelliklerin kullanılabilirliği, Azure DevOps sürümünüze bağlıdır.
Denizkızı diyagramlarıyla çalışma
Mermaid, metin ve kod kullanarak diyagramlar ve görselleştirmeler oluşturmanıza olanak tanır. Azure DevOps wiki'sinde aşağıdaki Mermaid diyagram türleri desteklenir:
- Sıralı diyagramlar
- Gantt grafikleri
- Flowcharts
- Sınıf diyagramı
- Durum diyagramı
- Kullanıcı Yolculuğu
- Pasta grafik
- Gereksinimler diyagramı
- Gitgraph diyagramları
- Varlık İlişkisi diyagramları
- Zaman çizelgesi diyagramları
Daha fazla bilgi için bkz. Mermaid sürüm notları.
Limitations
Azure DevOps'ta Denizkızı diyagramıyla çalışırken aşağıdaki sınırlamaları göz önünde bulundurun:
Azure DevOps, Denizkızı diyagramı türleri için sınırlı söz dizimi desteği sağlar. Desteklenmeyen söz dizimi, çoğu HTML etiketi, Font Awesome,
flowchartsöz dizimi (bunun yerinegraphöğesini kullanın), LongArrow---->ve daha fazlasını içerir.Internet Explorer, Mermaid'i desteklemez. Wiki'nizde Denizkızı diyagramları kullanıyorsanız, diyagramlar Internet Explorer'da işlenmez.
Örnek: Wiki sayfasına Denizkızı diyagramı ekleme
Wiki sayfasına Mermaid diyagramı eklemek için notasyonu üç iki nokta ile başlatın ve sonlandırın :.
mermaid anahtar sözcüğünü, diyagram türünü örneğin sequenceDiagram, belirtin ve göstermek için bilgileri sağlayın. Diyagrama yönelik bilgiler söz diziminde girintili bir bölüm olarak belirtilir.
Aşağıdaki örnekte, wiki sayfasına Bir Deniz Kızı diyagramının nasıl ekleneceği gösterilmektedir:
::: mermaid
<diagram type>
<diagam information>
:::
Örnek: Sıralı diyagram
Sıralı diyagram (tür sequenceDiagram), işlemlerin birbiriyle nasıl ve hangi sırada çalıştığını gösteren bir etkileşim çizimidir.
Aşağıdaki örnekte, wiki sayfasına bir sıralı diyagramın nasıl ekleneceği gösterilmektedir:
::: mermaid
sequenceDiagram
Christie->>Josh: Hello Josh, how are you?
Josh-->>Christie: Great!
Christie->>Josh: See you later!
:::
Sıralı diyagramın yayımlanmış görünümü aşağıdadır:
Örnek: Gantt grafiği
Bir Gantt grafiği (tür gantt), zamanlanan her görevi soldan sağa uzanan bir sürekli çubuk olarak kaydeder. Eksen x zamanı temsil eder. Eksen, y görevleri ve tamamlanma sırasını kaydeder.
Göreve özgü bir tarih, gün veya tarih koleksiyonunu dışladığınızda, Gantt grafiği değişiklikleri barındırır. Görevin içinde boşluk oluşturmak yerine, grafik sağa doğru eşit sayıda gün genişler.
Aşağıdaki örnekte, wiki sayfasına Gantt grafiğinin nasıl ekleneceği gösterilmektedir:
::: mermaid
gantt
title A Gantt chart
dateFormat YYYY-MM-DD
excludes 2022-03-16,2022-03-18,2022-03-19
section Section
A task :a1, 2022-03-07, 7d
Another task :after a1 , 5d
:::
Gantt grafiğinin yayımlanmış görünümü aşağıdadır:
Örnek: Akış Çizelgesi
Akış çizelgesi (tür graph), düğümlerden, geometrik şekillerden ve kenarlardan, oklardan veya çizgilerden oluşur. Diyagram türünü tanımladıktan graph sonra, grafikteki bilgilerin akış yönünü (yukarıdan aşağıya gibi TB; ) belirtin.
Aşağıdaki örnek, graph türüyle bir akış çizelgesi oluşturur. Grafik bilgileri soldan sağa LR; yönde ilerler.
Note
Azure DevOps, flowchart diyagram türünü, ----> ok sözdizimini veya bir subgraph diyagram türüne ve türünden bağlantıları desteklemez.
:::mermaid
graph LR;
A[Hard edge] -->|Link text| B(Round edge) --> C{Decision}
C -->|One| D[Result one]
C -->|Two| E[Result two]
:::
Akış çizelgesi grafiğinin yayımlanmış görünümü aşağıdadır:
Örnek: Sınıf diyagramı
Sınıf diyagramı (tür classDiagram), nesne odaklı programlama modelinin temel parçasıdır. Diyagram, nesneleri öznitelikleri ve yöntemleriyle, ve nesneler arasındaki kalıtımla açıklar.
Aşağıdaki örnekte, bir wiki sayfasına sınıf diyagramının nasıl ekleneceği gösterilmektedir:
:::mermaid
classDiagram
Creature <|-- Superman
Creature <|-- Vampire
Creature <|-- Diavolo
Creature: +int size
Creature: +int weight
Creature: +isBenign()
Creature: +power()
class Superman{
+String currentName
+fly()
+heal()
}
class Vampire{
-int age
-canBite()
}
class Diavolo{
+bool is_serving
+heat()
}
:::
Sınıf diyagramının yayımlanmış görünümü aşağıdadır:
Örnek: Durum diyagramı
Durum diyagramı (tür stateDiagram), sistem durumlarının bir durumdan diğerine geçtiğinde nasıl değişebileceğini açıklar.
Aşağıdaki örnekte, bir wiki sayfasına durum diyagramının nasıl ekleneceği gösterilmektedir. Bu örnek, durum diyagramı türünün (tür stateDiagram-v2) 2. sürümünü kullanır.
:::mermaid
stateDiagram-v2
[*] --> Active
state Active {
[*] --> NumLockOff
NumLockOff --> NumLockOn : EvNumLockPressed
NumLockOn --> NumLockOff : EvNumLockPressed
--
[*] --> CapsLockOff
CapsLockOff --> CapsLockOn : EvCapsLockPressed
CapsLockOn --> CapsLockOff : EvCapsLockPressed
--
[*] --> ScrollLockOff
ScrollLockOff --> ScrollLockOn : EvScrollLockPressed
ScrollLockOn --> ScrollLockOff : EvScrollLockPressed
}
:::
Durum diyagramının yayımlanmış görünümü aşağıdadır:
Örnek: Kullanıcı yolculuğu diyagramı
Kullanıcı yolculuğu (tür journey) diyagramı, belirli bir üst düzey eylemi veya görevi tamamlamak için gereken adımları açıklar.
Aşağıdaki örnekte, wiki sayfasına kullanıcı yolculuğu diyagramının nasıl ekleneceği gösterilmektedir:
:::mermaid
journey
title Home office day
section Go to work
Wake up: 1: Me, Dog
Take shower: 2: Me
Go downstairs: 3: Me, Dog
Make coffee: 4: Me
Have a breakfast: 5: Me, Dog
Go upstairs: 3: Me, Dog
Do work: 1: Me, Dog
section Go home
Go downstairs: 3: Me, Dog
Sit down: 5: Me
:::
Kullanıcı yolculuğu diyagramının yayımlanmış görünümü aşağıdadır:
Örnek: Pasta grafik
Pasta grafiği (tür pie) diyagramı, daire grafiğindeki bilgilerin yüzdelerini görselleştirmeye yardımcı olur. Diyagram türünü pie tanımladıktan sonra, pasta grafik için anahtar sözcüğü bir başlıkla title belirtin.
Aşağıdaki örnek, Fishermen in countries başlıklı bir pasta grafik oluşturur:
:::mermaid
pie title Fishermen in countries
"Norway" : 684
"Sweeden" : 234
"Switzerland" : 10
:::
İşte pasta grafiğinin yayımlanmış görünümü:
Örnek: Gereksinimler diyagramı
Gereksinimler diyagramı (tür requirementDiagram) gereksinimlerin ve bağlantılarının bir görselleştirmesini oluşturur.
Aşağıdaki örnekte, wiki sayfasına gereksinimler diyagramının nasıl ekleneceği gösterilmektedir:
:::mermaid
requirementDiagram
requirement development_req {
id: 1
text: requirements spec.
risk: medium
verifymethod: test
}
element test_suite {
type: manual test
}
test_suite - verifies -> development_req
:::
Gereksinimler diyagramının yayımlanmış görünümü aşağıdadır:
Örnek: Gitgraph diyagramı
Git graf diyagramı (tür gitGraph), commit'ler, dallar ve birleştirmeler gibi Git işlemlerini görselleştirmek için kullanılır.
Aşağıdaki örnekte, wiki sayfasına git grafı diyagramının nasıl ekleneceği gösterilmektedir:
::: mermaid
gitGraph
commit id: "Initial commit"
branch develop
commit id: "Develop commit 1"
commit id: "Develop commit 2"
checkout main
commit id: "Main commit 1"
merge develop id: "Merge develop into main"
branch feature
checkout feature
commit id: "Feature commit 1"
checkout develop
commit id: "Develop commit 3"
checkout feature
merge develop id: "Merge develop into feature"
:::
Git grafı diyagramının yayımlanmış görünümü aşağıdadır:
Örnek: Varlık İlişkisi diyagramı
Varlık ilişkisi diyagramı (tür erDiagram), veritabanı veya uygulama gibi bir sistemdeki varlıklar arasındaki ilişkileri modellemek için kullanılır. Bu diyagramlar, verilerin yapısının ve aralarındaki ilişkilerin anlaşılmasına ve tasarlanmasında yardımcı olur.
Aşağıdaki örnekte, wiki sayfasına varlık ilişkisi diyagramının nasıl ekleneceği gösterilmektedir:
::: mermaid
erDiagram
CUSTOMER {
string name
string address
}
ORDER {
int orderNumber
string product
}
CUSTOMER ||--o{ ORDER : places
:::
Varlık ilişkisi diyagramının yayımlanmış görünümü aşağıdadır:
Örnek: Zaman çizelgesi diyagramı
Zaman çizelgesi diyagramı (tür timeline), olayları kronolojik sırada görselleştirmek için kullanılır ve bu da ilerleme durumunu veya geçmiş olayları izlemeyi kolaylaştırır.
Aşağıdaki örnekte wiki sayfasına Zaman Çizelgesi diyagramının nasıl ekleneceği gösterilmektedir:
::: mermaid
timeline
title Project Development Timeline
section Planning
Project kickoff : 2025-01-01
Requirements gathering : 2025-01-15
section Development
Initial development : 2025-02-01
First prototype : 2025-03-01
section Testing
Alpha testing : 2025-04-01
Beta testing : 2025-05-01
section Release
Public release : 2025-06-01
:::
Zaman çizelgesi diyagramının yayımlanmış görünümü aşağıdadır:
Wiki sayfasının içindekiler tablosu
Wiki sayfanız için [[_TOC_]] söz dizim etiketini kullanarak bir içindekiler tablosu oluşturun. Yayımlama sistemi etiketle karşılaştığında ve wiki sayfasında en az bir başlık onayladığında, sayfa için İçindekiler tablosu oluşturur. Sayfadaki içindekiler tablosu başlığı "İçindekiler" şeklindedir.
İçindekiler tablosu oluşturmak için Markdown'daki wiki sayfasına söz dizimi etiketini ekleyebilir [[_TOC_]] veya Diğer seçenekler (...) > seçeneğini belirleyebilirsinizSayfanın Düzenlemegörünümündeki İçindekiler tablosu.
İçindekiler tablosu eklemeyle ilgili bazı noktalar şunlardır:
- Etiketin
[[_TOC_]]söz dizimi büyük/küçük harfe duyarlıdır. Söz dizimini[[_toc_]]kullanarak küçük harfle belirtirseniz, İçindekiler Tablosu işlenmeyebilir. - Yayımlama sistemi, Markdown sayfasındaki etiketin ilk örneği
[[_TOC_]]için içindekiler tablosu oluşturur. Etiketin aynı sayfadaki diğer örneklerini yoksayar. - Etiketi Markdown'da herhangi bir yere yerleştirebilirsiniz
[[_TOC_]]. Sistem, Markdown'a etiketi yerleştirdiğiniz konumda sayfada içindekiler tablosunu görüntüler. - Sistem yalnızca diyez işareti
#sözdizimi ile tanımlanan Markdown tarzı başlıkları onaylar. HTML stili başlık etiketlerini yoksayar. - Sistem, İçindekiler tablosu girdisini oluşturmak için yalnızca başlık metnini kullanır. Tüm fazladan HTML ve Markdown söz dizimlerini yoksayar.
Aşağıdaki örnekte yayımlama sisteminin, içindekiler tablosundaki girişi oluştururken başlık için ek biçimlendirmeyi nasıl yoksaydığı gösterilmektedir. Başlık, "Flagship" sözcüğünü italik olarak biçimlendirir, ancak başlığın İçindekiler tablosu girişi ek stili kaldırır.
Wiki sayfasının alt sayfaları tablosu
Söz dizimi etiketini kullanarak [[_TOSP_]] wiki sayfası için alt sayfa tablosu ekleyin. Sayfadaki tablonun başlığı "Alt Sayfalar"dır. Tablo, wiki sayfasının her alt sayfası için bir girdi içerir.
Alt sayfa tablosunu oluşturmak için Markdown'daki wiki sayfasına söz dizimi etiketini ekleyebilir [[_TOSP_]] veya Diğer seçenekler (...) > seçeneğini belirleyebilirsinizSayfanın Düzenleme görünümünde alt sayfalar tablosu.
Alt sayfa tablosu eklemeyle ilgili bazı noktalar şunlardır:
- Etiketin
[[_TOSP_]]söz dizimi büyük/küçük harfe duyarlıdır. Söz dizimini küçük harf[[_tosp_]]kullanarak belirtirseniz, alt sayfa tablosu işlenmeyebilir. - Yayımlama sistemi, Markdown sayfasındaki etiketin ilk örneği
[[_TOSP_]]için alt sayfa tablosunu işler. Etiketin aynı sayfadaki diğer örneklerini yoksayar. - Etiketi Markdown'da herhangi bir yere yerleştirebilirsiniz
[[_TOSP_]]. Sistem, Markdown kodunda etiketi yerleştirdiğiniz konumda sayfadaki alt sayfaların tablosunu görüntüler.
Wiki sayfasındaki daraltılabilir bölümler
Wiki sayfasına HTML <details><summary> söz dizimi içeren daraltılabilir bir bölüm ekleyin. Eski veya arşivlenmiş veriler gibi sayfadaki belirli içeriğin görünürlüğünü sınırlamak ya da bir soru/yanıt senaryosu ayarlamak için daraltılabilir bir bölüm kullanabilirsiniz.
Wiki sayfası açıldığında daraltılabilir bölüm kapatılır (daraltılır), ancak bölüm özeti görünür. Kullanıcılar başlığı seçerek gerektiği gibi genişletebilir (açabilir) ve bölümü daraltabilir.
Daraltılabilir bölüm eklemeyle ilgili bazı noktalar şunlardır:
- Etiketlerin içindeki bölümün
<summary>Title</summary>başlığını belirtin. Özet her zaman sayfada görünür. - Kapanış
</summary>etiketinden sonra boş bir satır ekleyin. Boş satırı eklemezseniz, bölüm doğru şekilde işlenmez. - Boş satırdan sonra ana içeriği sağlayın. Ana içeriği biçimlendirmek için Markdown söz dizimi ve HTML kullanabilirsiniz.
- Sayfada birden çok daraltılabilir bölüm oluşturursanız, her kapanış
</details>etiketinden sonra boş bir satır ekleyin.
Aşağıdaki örnek, wiki sayfasında daraltılabilir bir bölüm oluşturur:
# A collapsible section with Markdown syntax
<details>
<summary>Click to expand!</summary>
## Heading
1. A numbered
2. list
* With some
* Sub bullets
</details>
Ekli videolar
Söz dizimini kullanarak ::: video ::: YouTube ve Microsoft Streams videolarını wiki sayfasına ekleyin. Bildirimin video içinde video için bir <iframe> blok tanımlayın. Videonun bağlantısını sağlayın ve tercih edilen genişlik ve yüksekliği belirtin. Kenarlıklar ve tam ekran modu gibi diğer öznitelikleri ayarlayabilirsiniz. Sayfada bir kesme olmaması için kapanış iki nokta ::: gereklidir.
Aşağıdaki örnek wiki sayfasına bir video ekler:
Watch the following video:
::: video
<iframe width="640" height="360" src="https://www.youtube.com/embed/OtqFyBA6Dbk" allowfullscreen style="border:none"></iframe>
:::
Video eklenmiş wiki sayfasının yayımlanmış görünümü aşağıdadır:
Eklenmiş Azure Boards sorgu sonuçları
Azure Boards sorgu sonuçlarını bir sorgu kimliği kullanarak query-table söz dizimiyle bir wiki sayfasına tablo olarak yerleştirin.
Results from the Azure Boards query:
:::
query-table 6ff7777e-8ca5-4f04-a7f6-9e63737dddf7
:::
Diğer seçenekler (...) > seçeneğini de belirleyebilirsinizAraç çubuğundaki Sorgu Sonuçları:
Sorgu Sonuçları iletişim kutusunda sorgu sonuçlarını seçin ve sonra sonuçları wiki sayfasına tablo olarak eklemek için Ekle'yi seçin.
Sorgu için BIR 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.
@ ile bahsedilenleri içeren bildirimler
uygulamasında olduğu gibi simgesiyle @@<user-alias>kullanıcılar veya gruplar için bahsetmeler oluşturun.
at simgesini girdiğinizde@, e-posta bildirimlerini almak için kullanıcıları veya grupları seçebileceğiniz Otomatik Öneri iletişim kutusu açılır:
Diğer seçenekler (...) > seçeneğini de belirleyebilirsinizAraç çubuğunda @ Bahsetme:
Sayfaları doğrudan kodda düzenlerken aşağıdaki deseni kullanın: @<{identity-guid}>.
Wiki sayfası için sayfa ziyaret sayısı
Wiki'deki her sayfada son 30 gün için otomatik olarak toplanmış sayfa ziyaretleri sayısı ekleyin. Sayfa ziyareti, 15 dakikalık bir aralıkta belirtilen bir kullanıcı tarafından sayfanın görünümüdür.
Sayfalandırılmış görünümde tüm sayfalara yapılan günlük ziyaret sayısını görmek için batch API'sini pagesBatch kullanın. Görünüm ziyaret sayısına göre sıralanmamıştır.
30 günden eski veriler için REST API'sini kullanarak tüm sayfa ziyaretlerinin listesini alın. Sayfaları ziyaret sayısına göre sıralayın ve ilk 100 sayfayı belirleyin. Ziyaretleri bir panoda veya veritabanında depolayabilirsiniz.
Aşağıdaki görüntüde yayımlanan wiki sayfasındaki sayfa sayısı gösterilmektedir:
Wiki sayfalarında HTML etiketleri
Wiki sayfalarında <font> ve <span> gibi HTML etiketlerini kullanarak zengin içerik oluşturun. Azure DevOps Server 2019.1 ve sonraki sürümlerde, görüntüler ve video gibi zengin içerikleri HTML olarak da yapıştırabilirsiniz.
Örnek: HTML içinde Markdown söz dizimi kullanma
Aşağıdaki örnekte, wiki sayfasındaki bir HTML öğesinin içinde Markdown söz diziminin nasıl kullanılacağı gösterilmektedir. HTML öğesini açtıktan sonra ve Markdown'ın önüne boş bir satır ekleyin:
<p>
This article describes how to **get started** with an Azure DevOps wiki.
For more information, see the [Wikis, search, & navigation documentation](https://learn.microsoft.com/azure/devops/project/) for Azure DevOps.
</p>
Örnek: HTML ile video ekleme
Aşağıdaki örnekte, videonun URL'si olan HTML öğesini kullanarak <video> wiki sayfasına video ekleme adımları gösterilmektedir:
<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 kullanma
Aşağıdaki örnekte, wiki sayfasında HTML zengin metin biçiminin nasıl kullanılacağı gösterilmektedir:
<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 might be shown as <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>
Aşağıdaki görüntüde, standart Açık tema görünümünde gösterildiği gibi wiki sayfasındaki HTML zengin metin içeriğinin yayımlanmış görünümü gösterilmektedir:
Koyu tema görünümünde aynı yayımlanan sayfa aşağıdadır:
