withastro · HiDeoo · Apr 2, 2025 · Apr 2, 2025 · Apr 2, 2025 · Apr 2, 2025
diff --git a/docs/src/content/docs/ru/guides/authoring-content.mdx b/docs/src/content/docs/ru/guides/authoring-content.mdx
@@ -242,19 +242,40 @@ Expressive Code предоставляет несколько вариантов
   ```js {2-3}
   function demo() {
   	// Эта строка (#2) и следующая выделены
-  	return 'Это строка №3 этого фрагмента.';
+  	return 'Это строка №3 этого фрагмента';
   }
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```js {2-3}
   function demo() {
   	// Эта строка (#2) и следующая выделены
-  	return 'Это строка №3 этого фрагмента.';
+  	return 'Это строка №3 этого фрагмента';
   }
   ```
   ````
 
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````markdoc
+  ```js {% meta="{2-3}" %}
+  function demo() {
+    // Эта строка (#2) и следующая выделены
+    return 'Это строка №3 этого фрагмента';
+  }
+  ```
+  ````
+
+  </TabItem>
+
+  </Tabs>
+
 - [Пометка выделенного текста с помощью маркера `" "` или регулярных выражений](https://expressive-code.com/key-features/text-markers/#marking-individual-text-inside-lines):
 
   ```js "Отдельные термины" /даже.*выражения/
@@ -264,6 +285,10 @@ Expressive Code предоставляет несколько вариантов
   }
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```js "Отдельные термины" /даже.*выражения/
   // Отдельные термины также могут быть выделены
@@ -273,6 +298,23 @@ Expressive Code предоставляет несколько вариантов
   ```
   ````
 
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````markdoc
+  ```js {% meta="'Отдельные термины' /даже.*выражения/" %}
+  // Отдельные термины также могут быть выделены
+  function demo() {
+    return 'Поддерживаются даже регулярные выражения';
+  }
+  ```
+  ````
+
+  </TabItem>
+
+  </Tabs>
+
 - [Пометка текста или строк как вставленных или удалённых с помощью `ins` или `del`](https://expressive-code.com/key-features/text-markers/#selecting-inline-marker-types-mark-ins-del):
 
   ```js "return true;" ins="вставленные" del="удалённые"
@@ -283,6 +325,10 @@ Expressive Code предоставляет несколько вариантов
   }
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```js "return true;" ins="вставленные" del="удалённые"
   function demo() {
@@ -293,6 +339,24 @@ Expressive Code предоставляет несколько вариантов
   ```
   ````
 
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````markdoc
+  ```js {% meta="'return true;' ins='вставленные' del='удалённые'" %}
+  function demo() {
+    console.log('Это вставленные и удалённые типы маркеров');
+    // Оператор return использует тип маркера по умолчанию
+    return true;
+  }
+  ```
+  ````
+
+  </TabItem>
+
+  </Tabs>
+
 - [Объединение подсветки синтаксиса с синтаксисом типа `diff`](https://expressive-code.com/key-features/text-markers/#combining-syntax-highlighting-with-diff-like-syntax):
 
   ```diff lang="js"
@@ -304,17 +368,40 @@ Expressive Code предоставляет несколько вариантов
     }
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```diff lang="js"
     function thisIsJavaScript() {
       // Весь этот блок выделяется как JavaScript,
       // и мы можем добавить к нему маркеры различий!
-  -   console.log('Старый код, который нужно удалить')
-  +   console.log('Новый и блестящий код!')
+  -   console.log('Устаревший код, который нужно удалить')
+  +   console.log('Обновлённый и крутой код!')
+    }
+  ```
+  ````
+
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````markdoc
+  ```diff {% meta="lang='js'" %}
+    function thisIsJavaScript() {
+      // Весь этот блок выделяется как JavaScript,
+      // и мы можем добавить к нему маркеры различий!
+  -   console.log('Устаревший код, который нужно удалить')
+  +   console.log('Обновлённый и крутой код!')
     }
   ```
   ````
 
+  </TabItem>
+
+  </Tabs>
+
 #### Рамки и заголовки
 
 Блоки кода могут отображаться внутри оконного фрейма.
@@ -330,37 +417,92 @@ Expressive Code предоставляет несколько вариантов
   console.log('Привет, мир!');
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```js
   // my-test-file.js
   console.log('Привет, мир!');
   ```
   ````
 
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````md
+  ```js
+  // my-test-file.js
+  console.log('Привет, мир!');
+  ```
+  ````
+
+  </TabItem>
+
+  </Tabs>
+
 - [Добавление заголовка в окне терминала](https://expressive-code.com/key-features/frames/#terminal-frames)
 
   ```bash title="Установка зависимостей…"
   npm install
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```bash title="Установка зависимостей…"
   npm install
   ```
   ````
 
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````markdoc
+  ```bash {% title="Установка зависимостей…" %}
+  npm install
+  ```
+  ````
+
+  </TabItem>
+
+  </Tabs>
+
 - [Отключение оконных рамок с помощью `frame="none"`](https://expressive-code.com/key-features/frames/#overriding-frame-types)
 
   ```bash frame="none"
   echo "Это не отображается как терминал, несмотря на использование языка bash"
   ```
 
+  <Tabs syncKey="content-type">
+
+  <TabItem label="Markdown/MDX">
+
   ````md
   ```bash frame="none"
   echo "Это не отображается как терминал, несмотря на использование языка bash"
   ```
   ````
 
+  </TabItem>
+
+  <TabItem label="Markdoc">
+
+  ````markdoc
+  ```bash {% frame="none" %}
+  echo "Это не отображается как терминал, несмотря на использование языка bash"
+  ```
+  ````
+
+  </TabItem>
+
+  </Tabs>
+
 ## Спойлеры
 
 Спойлеры (также известные как «раскрытия» или «аккордеоны») полезны для того, чтобы скрыть содержимое, которое не имеет непосредственного отношения к делу.

diff --git a/docs/src/content/docs/ru/reference/plugins.md b/docs/src/content/docs/ru/reference/plugins.md
@@ -16,7 +16,6 @@ tableOfContents:
 Подробнее о различных свойствах и параметрах хуков см. ниже.
 
 <!-- prettier-ignore-start -->
-
 ```ts
 interface StarlightPlugin {
   name: string;
@@ -30,10 +29,7 @@ interface StarlightPlugin {
       config: StarlightUserConfig;
       updateConfig: (newConfig: StarlightUserConfig) => void;
       addIntegration: (integration: AstroIntegration) => void;
-      addRouteMiddleware: (config: {
-        entrypoint: string;
-        order?: 'pre' | 'post' | 'default';
-      }) => void;
+      addRouteMiddleware: (config: { entrypoint: string; order?: 'pre' | 'post' | 'default' }) => void;
       astroConfig: AstroConfig;
       command: 'dev' | 'build' | 'preview';
       isRestart: boolean;
@@ -44,7 +40,6 @@ interface StarlightPlugin {
   };
 }
 ```
-
 <!-- prettier-ignore-start -->
 
 ## `name`
@@ -231,7 +226,7 @@ export default {
 export default {
   name: '@example/starlight-plugin',
   hooks: {
-    setup({ addRouteMiddleware }) {
+    'config:setup'({ addRouteMiddleware }) {
       addRouteMiddleware({
         entrypoint: '@example/starlight-plugin/route-middleware',
       });
@@ -245,9 +240,8 @@ export default {
 По умолчанию мидлвары плагинов выполняются в порядке их добавления.
 
 Если вам нужно больше контроля над порядком выполнения, используйте необязательное свойство `order`.
-
-- Установите `order: "pre"`, чтобы мидлвар выполнялся перед пользовательскими мидлварами.
-- Установите `order: "post"`, чтобы мидлвар выполнялся после всех остальных мидлваров.
+Установите `order: "pre"`, чтобы мидлвар выполнялся перед пользовательскими мидлварами.
+Установите `order: "post"`, чтобы мидлвар выполнялся после всех остальных мидлваров.
 
 Если два плагина добавляют мидлвары с одинаковым значением `order`, первым выполнится плагин, добавленный первым.
 

diff --git a/docs/src/content/docs/ru/resources/plugins.mdx b/docs/src/content/docs/ru/resources/plugins.mdx
@@ -53,11 +53,6 @@ sidebar:
 		title="starlight-obsidian"
 		description="Публикация хранилищ Obsidian на сайте Starlight."
 	/>
-	<LinkCard
-		href="https://astro-ghostcms.xyz/intro/starlight/install/"
-		title="starlight-ghostcms"
-		description="Добавьте записи в блог GhostCMS вместе с документами Starlight."
-	/>
 	<LinkCard
 		href="https://github.com/HiDeoo/starlight-image-zoom"
 		title="starlight-image-zoom"
@@ -133,6 +128,26 @@ sidebar:
 		title="starlight-view-transitions"
 		description="Добавьте нативные кросс-документные переходы в браузере."
 	/>
+	<LinkCard
+	  href="https://github.com/HiDeoo/starlight-auto-sidebar"
+	  title="starlight-auto-sidebar"
+	  description="Настройка автоматически создаваемых групп в боковой панели."
+	/>
+	<LinkCard
+	  href="https://github.com/delucis/starlight-llms-txt"
+	  title="starlight-llms-txt"
+	  description="Добавление файла llms.txt на сайт документации (основано на llmstxt.org)."
+	/>
+	<LinkCard
+	  href="https://github.com/trueberryless-org/starlight-toc-overview-customizer"
+	  title="starlight-toc-overview-customizer"
+	  description="Настройка оглавления в Starlight с изменяемым заголовком раздела «Обзор»."
+	/>
+	<LinkCard
+	  href="https://delucis.github.io/starlight-markdown-blocks/"
+	  title="starlight-markdown-blocks"
+	  description="Расширение синтаксиса Markdown-вставок в Starlight с помощью пользовательских типов блоков."
+	/>
 </CardGrid>
 
 ## Инструменты и интеграции от сообщества

diff --git a/docs/src/content/docs/ru/resources/themes.mdx b/docs/src/content/docs/ru/resources/themes.mdx
@@ -67,6 +67,12 @@ import ThemeGrid from '~/components/theme-grid.astro';
 			href: 'https://delucis.github.io/starlight-theme-flexoki/',
 			previews: { light: 'flexoki-light.png', dark: 'flexoki-dark.png' },
 		},
+		{
+			title: 'Starlight Nova',
+			description: 'Красивая и современная тема для Starlight.',
+			href: 'https://starlight-theme-nova.pages.dev/',
+			previews: { light: 'nova-light.png', dark: 'nova-dark.png' },
+		},
 	]}
 />