diff options
author | Bugo | 2025-04-02 12:40:49 +0500 |
---|---|---|
committer | GitHub | 2025-04-02 09:40:49 +0200 |
commit | a03443e0cec4593c90290d11b544be55ddfdaef8 (patch) | |
tree | 376eabbfef894abf582800faaac7ea020119207d | |
parent | 7f63dd7f94d870e2992edfab7d235050f874ac9a (diff) | |
download | IT.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.mdx | 150 | ||||
-rw-r--r-- | docs/src/content/docs/ru/reference/plugins.md | 14 | ||||
-rw-r--r-- | docs/src/content/docs/ru/resources/plugins.mdx | 25 | ||||
-rw-r--r-- | docs/src/content/docs/ru/resources/themes.mdx | 6 |
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' }, + }, ]} /> |