From 53418ca450ad3d6fb39d87f2d533ccb281f2b331 Mon Sep 17 00:00:00 2001
From: Bugo <cheetah@bk.ru>
Date: Sat, 23 Mar 2024 09:32:15 +0500
Subject: [PATCH] Translate guide/frontmatter.md

---
 docs/ru/guide/frontmatter.md | 48 ++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/ru/guide/frontmatter.md

diff --git a/docs/ru/guide/frontmatter.md b/docs/ru/guide/frontmatter.md
new file mode 100644
index 00000000..b1f7a646
--- /dev/null
+++ b/docs/ru/guide/frontmatter.md
@@ -0,0 +1,48 @@
+# Метаданные {#frontmatter}
+
+## Использование {#usage}
+
+VitePress поддерживает метаданные YAML во всех Markdown-файлах, разбирая их с помощью [gray-matter](https://github.com/jonschlinkert/gray-matter). Метаданные должны находиться в верхней части Markdown-файла (перед любыми элементами, включая теги `<script>`) и иметь вид корректного YAML, заданного между тройными пунктирными линиями. Пример:
+
+```md
+---
+title: Документация с VitePress
+editLink: true
+---
+```
+
+Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить определённое поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config).
+
+Вы также можете определить собственные метаданные, которые будут использоваться в динамических выражениях Vue на странице.
+
+## Доступ к метаданным {#accessing-frontmatter-data}
+
+Доступ к метаданным можно получить через специальную глобальную переменную `$frontmatter`:
+
+Вот пример того, как можно использовать его в файле Markdown:
+
+```md
+---
+title: Документация с VitePress
+editLink: true
+---
+
+# {{ $frontmatter.title }}
+
+Содержание руководства
+```
+
+Вы также можете получить доступ к метаданным текущей страницы в `<script setup>` с помощью [хэлпера `useData()`](../reference/runtime-api#usedata).
+
+## Альтернативные форматы метаданных {#alternative-frontmatter-formats}
+
+VitePress также поддерживает синтаксис метаданных JSON, начинающийся и заканчивающийся фигурными скобками:
+
+```json
+---
+{
+  "title": "Веду блог как хакер",
+  "editLink": true
+}
+---
+```