Microsoft Learn belgeleri için meta veriler

Meta veriler makalede (YAML ön maddesinde) veya deponun docfx.json dosyasında genel olarak uygulanabilir. Mevcut bir makalede düzenleme yapıyorsanız, büyük olasılıkla meta verileri değiştirmeniz gerekmez. Ancak, yeni bir makale ekliyorsanız, dosyanın YAML ön konusuna eklemeniz gereken bazı gerekli meta veri öznitelikleri vardır.

Markdown makalesinin YAML ön konusuna uygulanan meta verilerin bir örneği aşağıda verilmişti:

---
title:                     # the article title to show on the browser tab
description:               # 115 - 145 character description to show in search results
author: {github-id}        # the author's GitHub ID - will be auto-populated if set in settings.json
ms.author: {ms-alias}      # the author's Microsoft alias (if applicable) - will be auto-populated if set in settings.json
ms.date: {@date}           # the date - will be auto-populated when template is first applied
ms.topic: getting-started  # the type of article
---
# Heading 1 <!-- the article title to show on the web page -->

Gerekli meta veriler

Aşağıdaki tabloda gerekli meta veri öznitelikleri gösterilmektedir. Bunlardan herhangi birini atlarsanız, derleme sırasında büyük olasılıkla bir doğrulama hatası alırsınız.

Alan Değer Neden?
author Yazarın GitHub hesap kimliği. İçerikle ilgili sorular veya sorunlar olması durumunda yazarı GitHub Kimliğine göre tanımlar. Bazı durumlarda GitHub otomasyonu, dosyayı içeren etkinliği yazara bildirebilir.
description İçeriğin özeti. 75-300 karakter. Site aramasında kullanılır. Bazen iyileştirilmiş SEO için arama motoru sonuçları sayfasında kullanılır.
ms.author "@microsoft.com" olmadan yazarın Microsoft diğer adı. Microsoft çalışanı değilseniz, bu alanda kullanmak için uygun bir Microsoft çalışanı bulun. Makalenin sahibini tanımlar. Makalenin içeriği ve makalenin raporlaması ve iş zekası hakkındaki kararlardan sahibi sorumludur.
ms.date AA/GG/YYYY biçiminde bir tarih. Yayımlanan sayfada, makalenin en son ne zaman önemli ölçüde düzenlendiğini veya yenilendiğinden emin olundığını belirtmek için görüntülenir. Tarih saat olmadan girilir ve 0:00 ve UTC saat dilimi olarak yorumlanır. Kullanıcılara görüntülenen tarih kendi saat dilimine dönüştürülür.
title Sayfa başlığı. Bu, tarayıcı sekmesinde görüntülenen sayfa başlığıdır. SEO için en önemli meta verilerdir.

Öznitelikler büyük/küçük harfe duyarlıdır. Bunları tam olarak listelendiği gibi girin ve özniteliklerle değer arasında iki nokta üst üste ve boşluk kullanın. Öznitelik değeri iki nokta üst üste (:), karma (#) veya başka bir özel karakter içeriyorsa, bunu tek (') veya çift (") tırnak içine almanız gerekir. Örneğin:

---
title: 'Quickstart: How to use hashtags (#) to make a point on the internet'
---
# Heading 1 <!-- the article title to show on the web page -->