01Що це таке та як це працює
YAML (YAML Ain't Markup Language) використовує відступи та пари «ключ-значення» для представлення вкладених даних. В SEO він з'являється як front matter у верхній частині Markdown або HTML-файлів у генераторах статичних сайтів, таких як Jekyll, Hugo або Eleventy. Front matter обробляється під час збірки для створення HTML-метатегів, таких як ` та `. Пошукові системи ніколи не бачать сам YAML; вони бачать відрендерений HTML. Формат суворий до пробілів та структури, тому невелика помилка може зламати всю збірку або непомітно видалити метадані.
YAML — це спосіб запису даних за допомогою відступів та пар «ключ-значення», який використовується для встановлення заголовків, описів та інших SEO-полів на сторінках.
02Що з цим робити
Додайте YAML front matter до кожної сторінки вашого статичного сайту. Включіть принаймні поля title, description та canonical. Використовуйте однакові назви ключів на всіх сторінках для цілісності. Перевірте ваш YAML за допомогою лінтера перед збіркою сайту. Якщо ви використовуєте CMS, яка видає YAML, переконайтеся, що згенерований HTML містить очікувані метатеги. Для динамічних сайтів YAML зазвичай не потрібен; замість нього використовуйте базу даних або JSON.
03Як це вимірюється або помічається
Ви помічаєте проблеми з YAML, перевіряючи відрендерений HTML ваших сторінок. Шукайте теги ` та `; якщо вони відсутні або некоректні, то front matter, швидше за все, неправильний. Використовуйте Google Search Console, щоб побачити, чи відображає Google заголовки та описи, які ви запланували. Пошуковий краулер, як-от Screaming Frog, також може повідомити про відсутні або дубльовані метатеги, які часто пов'язані з проблемами у front matter. Ви також можете перевірити лог збірки на наявність помилок парсингу YAML.
Як це формулює довідник
YAML — зручний для читання людиною формат серіалізації даних, концептуально близький до мов розмітки, але орієнтований на зручність введення-виведення типових структур даних багатьох мов програмування.
04Поширені помилки
- Використання табуляції для відступів замість пробілів — YAML вимагає пробілів.
- Відсутність лапок у рядках, що містять двокрапки, наприклад, "Title: A Guide".
- Написання структурованих даних у YAML замість JSON-LD — пошукові системи не розпізнають YAML.
- Пропуск валідації; одна друкарська помилка може зламати всю збірку.
- Повторення одного й того самого ключа в одному блоці, що є невалідним для YAML.
05Обмеження
YAML — це інструмент для етапу збірки, а не формат для виконання. Пошукові системи не читають YAML безпосередньо, тому він не може замінити структуровані дані, такі як JSON-LD. Він застосовується лише до генераторів статичних сайтів або конвеєрів збірки; динамічні сайти, які рендеринг сторінок з бази даних, не потребують YAML. YAML часто плутають із JSON, оскільки обидва є форматами даних, але YAML легше читати людині, і він підтримує коментарі, тоді як JSON є суворим підмножиною та стандартом для структурованих даних. YAML також має особливості із застосуванням спеціальних символів, що може призвести до прихованих помилок.
06Практичний приклад
---
title: "How to Use YAML for SEO"
description: "A practical guide to YAML front matter."
canonical: "https://example.com/yaml-seo"
robots: "index, follow"
---
Запис вище написаний GetLoopLoop. Нижче — те, що про цей самий термін тримають незалежні каталоги. Жодне з цього не є джерелом цієї сторінки.
- Також називається
- YAML Ain't Markup Language, Yet Another Markup Language, .yaml, .yml
- Запроваджено
- 2001
- Розробник
- Clark Evans
- Спирається на
- XML, Perl, JSON
- Різновид
- формат файлу, мова розмітки даних, формат серіалізації даних
Той самий термін у Вікіпедії
Каталогізовано 26 мовами07Поширені запитання
Чим YAML відрізняється від JSON?
YAML легше читати людині, він використовує відступи замість дужок і ком, тоді як JSON є суворим підмножиною YAML. Для front matter YAML є стандартом у більшості генераторів статичних сайтів, оскільки його легше писати та читати.
Чи обов'язково використовувати YAML front matter для мого статичного сайту?
Ні, це необов'язково, але рекомендовано. Більшість генераторів статичних сайтів використовують YAML front matter для встановлення метаданих, таких як заголовок, опис та макет. Без цього ви втратите можливості SEO та структурованих даних.
Як правильно писати YAML front matter?
Розмістіть це між потрійними тире на початку вашого файлу, а потім використовуйте пари ключ-значення з однаковими відступами. Використовуйте пробіли, а не табуляцію, і беріть у лапки рядки, що містять спеціальні символи, такі як двокрапки або решітки.
Чи працює YAML у сучасних генераторах статичних сайтів?
Так, YAML залишається стандартом для front matter у Jekyll, Hugo та Eleventy. Він має гарну підтримку, і навіть новіші інструменти, як-от Astro, приймають його. Ви можете покладатися на нього для метаданих вашого сайту.
Що зламається, якщо у моєму YAML буде синтаксична помилка?
Збірка вашого сайту може завершитися помилкою, або сторінки відображатимуть стандартні заголовки та описи замість ваших власних. Ви помітите це, перевіривши відрендерений HTML і побачивши відсутні метатеги. Система збірки зазвичай вказує на конкретний рядок.
08Як про це питають уголос
Той самий термін словами, якими про нього питають асистента, а не набирають у рядку пошуку — написано із ситуації, тому кожне питання несе ту ситуацію, з якої виникло.
Ймовірно, це ваш YAML front matter. Відкрийте markdown-файл сторінки та подивіться на поле title між тире. Виправте його та перезібрати сайт.
Це YAML front matter. Він містить метадані сторінки, такі як title, description та layout. Ви можете редагувати його безпосередньо, і сайт оновиться, коли ви зробите перезбірку.
Ви, ймовірно, забули додати опис у YAML front matter. Перевірте початок кожного файлу сторінки та додайте поле description. Перезіберіть та розгорніть проєкт знову.