summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBugo2025-04-02 12:40:49 +0500
committerGitHub2025-04-02 09:40:49 +0200
commita03443e0cec4593c90290d11b544be55ddfdaef8 (patch)
tree376eabbfef894abf582800faaac7ea020119207d
parent7f63dd7f94d870e2992edfab7d235050f874ac9a (diff)
downloadIT.starlight-a03443e0cec4593c90290d11b544be55ddfdaef8.tar.gz
IT.starlight-a03443e0cec4593c90290d11b544be55ddfdaef8.tar.bz2
IT.starlight-a03443e0cec4593c90290d11b544be55ddfdaef8.zip
i18n(ru): update some translations (#3029)
-rw-r--r--docs/src/content/docs/ru/guides/authoring-content.mdx150
-rw-r--r--docs/src/content/docs/ru/reference/plugins.md14
-rw-r--r--docs/src/content/docs/ru/resources/plugins.mdx25
-rw-r--r--docs/src/content/docs/ru/resources/themes.mdx6
4 files changed, 176 insertions, 19 deletions
diff --git a/docs/src/content/docs/ru/guides/authoring-content.mdx b/docs/src/content/docs/ru/guides/authoring-content.mdx
index e7e35e63..c1086198 100644
--- 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,6 +417,10 @@ Expressive Code предоставляет несколько вариантов
console.log('Привет, мир!');
```
+ <Tabs syncKey="content-type">
+
+ <TabItem label="Markdown/MDX">
+
````md
```js
// my-test-file.js
@@ -337,30 +428,81 @@ Expressive Code предоставляет несколько вариантов
```
````
+ </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
index 6dc0545e..0e97bb39 100644
--- 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
index 1a24a833..8f9dad1a 100644
--- a/docs/src/content/docs/ru/resources/plugins.mdx
+++ b/docs/src/content/docs/ru/resources/plugins.mdx
@@ -54,11 +54,6 @@ sidebar:
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"
description="Добавьте возможности масштабирования к изображениям вашей документации."
@@ -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
index c5b9d184..a39823e2 100644
--- 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' },
+ },
]}
/>