Merge branch 'main' into reference

HiDeoo · web-flow · commit 0cc8a575f807 · 2024-09-09T10:34:55.000+02:00
diff --git a/docs/src/content/docs/ru/guides/authoring-content.mdx b/docs/src/content/docs/ru/guides/authoring-content.mdx
@@ -203,17 +203,17 @@ Astro позволяет создавать быстрые сайты с пом
 ```js
 // Javascript код с подсветкой синтаксиса.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 
 ````md
 ```js
 // Javascript код с подсветкой синтаксиса.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 ````
@@ -241,16 +241,16 @@ Expressive Code предоставляет несколько вариантов
 
   ```js {2-3}
   function demo() {
-    // Эта строка (#2) и следующая выделены
-    return 'Это строка №3 этого фрагмента.';
+  	// Эта строка (#2) и следующая выделены
+  	return 'Это строка №3 этого фрагмента.';
   }
   ```
 
   ````md
   ```js {2-3}
   function demo() {
-    // Эта строка (#2) и следующая выделены
-    return 'Это строка №3 этого фрагмента.';
+  	// Эта строка (#2) и следующая выделены
+  	return 'Это строка №3 этого фрагмента.';
   }
   ```
   ````
@@ -260,15 +260,15 @@ Expressive Code предоставляет несколько вариантов
   ```js "Отдельные термины" /даже.*выражения/
   // Отдельные термины также могут быть выделены
   function demo() {
-    return 'Поддерживаются даже регулярные выражения';
+  	return 'Поддерживаются даже регулярные выражения';
   }
   ```
 
   ````md
   ```js "Отдельные термины" /даже.*выражения/
   // Отдельные термины также могут быть выделены
   function demo() {
-    return 'Поддерживаются даже регулярные выражения';
+  	return 'Поддерживаются даже регулярные выражения';
   }
   ```
   ````
@@ -277,18 +277,18 @@ Expressive Code предоставляет несколько вариантов
 
   ```js "return true;" ins="вставленные" del="удалённые"
   function demo() {
-    console.log('Это вставленные и удалённые типы маркеров');
-    // Оператор return использует тип маркера по умолчанию
-    return true;
+  	console.log('Это вставленные и удалённые типы маркеров');
+  	// Оператор return использует тип маркера по умолчанию
+  	return true;
   }
   ```
 
   ````md
   ```js "return true;" ins="вставленные" del="удалённые"
   function demo() {
-    console.log('Это вставленные и удалённые типы маркеров');
-    // Оператор return использует тип маркера по умолчанию
-    return true;
+  	console.log('Это вставленные и удалённые типы маркеров');
+  	// Оператор return использует тип маркера по умолчанию
+  	return true;
   }
   ```
   ````
@@ -393,3 +393,118 @@ Starlight поддерживает все синтаксические возм
 ## Расширенная конфигурация Markdown и MDX
 
 Starlight использует Markdown и рендерер MDX от Astro, основанный на `remark` и `rehype`. Вы можете добавить поддержку пользовательского синтаксиса и поведения, добавив `remarkPlugins` или `rehypePlugins` в свой файл конфигурации Astro. Дополнительную информацию см. в разделе [Настройка Markdown и MDX](https://docs.astro.build/ru/guides/markdown-content/#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-markdown-%D0%B8-mdx) в документации Astro.
+
+## Markdoc
+
+Starlight поддерживает создание контента в Markdoc с помощью экспериментальной [интеграции с Astro](https://docs.astro.build/ru/guides/integrations-guide/markdoc/) и пресета Starlight Markdoc.
+
+### Создание нового проекта с Markdoc
+
+Начните новый проект Starlight с предварительно настроенным Markdoc с помощью команды `create astro`:
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+<Tabs syncKey="pkg">
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight/markdoc
+```
+
+</TabItem>
+</Tabs>
+
+### Добавление Markdoc в существующий проект
+
+Если у вас уже есть сайт Starlight и вы хотите добавить Markdoc, выполните следующие действия.
+
+<Steps>
+
+1.  Добавьте интеграцию Markdoc:
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npx astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn astro add markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+2.  Установите пресет Markdoc для Starlight:
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npm install @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+3.  Создайте файл конфигурации Markdoc по адресу `markdoc.config.mjs` и используйте пресет Markdoc:
+
+    ```js
+    import { defineMarkdocConfig } from '@astrojs/markdoc/config';
+    import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+    export default defineMarkdocConfig({
+    	extends: [starlightMarkdoc()],
+    });
+    ```
+
+</Steps>
+
+Чтобы узнать больше о синтаксисе и возможностях Markdoc, смотрите [документацию](https://markdoc.dev/docs/syntax) или [Руководство по интеграции Markdoc в Astro](https://docs.astro.build/ru/guides/integrations-guide/markdoc/).
diff --git a/docs/src/content/docs/ru/guides/css-and-tailwind.mdx b/docs/src/content/docs/ru/guides/css-and-tailwind.mdx
@@ -249,7 +249,9 @@ module.exports = {
 ### Редактор цветовой темы
 
 Используйте ползунки ниже, чтобы изменить палитры акцентного и серого цветов Starlight.
-Темные и светлые области предпросмотра будут показывать результирующие цвета, и вся страница также обновится, чтобы показать ваши изменения.
+Тёмные и светлые области предпросмотра будут показывать результирующие цвета, и вся страница также обновится, чтобы показать ваши изменения.
+
+Используйте параметр «Уровень контрастности», чтобы указать, какому из [стандартов цветовой контрастности](https://developer.mozilla.org/ru/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast) должен соответствовать веб-контент.
 
 Когда вы будете довольны внесёнными изменениями, скопируйте приведённый ниже код CSS или Tailwind и используйте его в своем проекте.
 
@@ -266,6 +268,9 @@ import ThemeDesigner from '~/components/theme-designer.astro';
 			default: 'По умолчанию',
 			random: 'Случайно',
 		},
+		contrast: {
+			label: 'Уровень контрастности',
+		},
 		editor: {
 			accentColor: 'Акцентный цвет',
 			grayColor: 'Серый',
diff --git a/docs/src/content/docs/ru/guides/pages.mdx b/docs/src/content/docs/ru/guides/pages.mdx
@@ -14,7 +14,7 @@ Starlight генерирует HTML-страницы вашего сайта н
 ### Форматы файлов
 
 Starlight поддерживает создание контента в Markdown и MDX без необходимости настройки.
-Вы можете добавить поддержку Markdoc, установив экспериментальную [интеграцию Astro Markdoc](https://docs.astro.build/ru/guides/integrations-guide/markdoc/).
+Вы можете добавить поддержку Markdoc, следуя [руководству](/ru/guides/authoring-content/#markdoc).
 
 ### Добавление страниц
 
