From 766e8754b798960056c2729f9d28b045dd4f6e3e Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 26 Sep 2024 02:34:22 -0600 Subject: [PATCH 1/9] i18n(es): translate `reference/icons` (#2409) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/es/reference/icons.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/src/content/docs/es/reference/icons.mdx diff --git a/docs/src/content/docs/es/reference/icons.mdx b/docs/src/content/docs/es/reference/icons.mdx new file mode 100644 index 00000000000..1b1b3406079 --- /dev/null +++ b/docs/src/content/docs/es/reference/icons.mdx @@ -0,0 +1,19 @@ +--- +title: Referencia de iconos +description: Una descripción general de todos los iconos disponibles en Starlight. +--- + +Starlight proporciona un conjunto de iconos integrados que puedes mostrar en tu contenido usando el componente ``. + +## Usar iconos + +Los iconos se pueden mostrar usando el componente [``](/es/components/icons/). +Estos también se utilizan a menudo en otros componentes, como [tarjetas](/es/components/cards/) o configuraciones como [acciones de hero](/es/reference/frontmatter/#hero). + +## Todos los iconos + +Una lista de todos los iconos disponibles se muestra a continuación con sus nombres asociados. Haz clic en un icono para copiar su nombre al portapapeles. + +import IconsList from '~/components/icons-list.astro'; + + From 2ba048f9abc931b2d789171fd94335fb900abdf3 Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 26 Sep 2024 02:45:25 -0600 Subject: [PATCH 2/9] i18n(es): translate `link-cards` (#2411) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- .../content/docs/es/components/link-cards.mdx | 128 ++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 docs/src/content/docs/es/components/link-cards.mdx diff --git a/docs/src/content/docs/es/components/link-cards.mdx b/docs/src/content/docs/es/components/link-cards.mdx new file mode 100644 index 00000000000..b92db5ab65b --- /dev/null +++ b/docs/src/content/docs/es/components/link-cards.mdx @@ -0,0 +1,128 @@ +--- +title: Tarjetas de enlace +description: Aprende a mostrar enlaces de forma destacada como tarjetas en Starlight. +sidebar: + order: 3 +--- + +import { LinkCard } from '@astrojs/starlight/components'; + +Para mostrar enlaces a diferentes páginas de forma destacada, utiliza el componente ``. + +import Preview from '~/components/component-preview.astro'; + + + + + + + +## Importación + +```tsx +import { LinkCard } from '@astrojs/starlight/components'; +``` + +## Uso + +Mostrar un enlace de forma destacada utilizando el componente ``. +Cada `` requiere un atributo [`title`](#title) y un atributo [`href`](#href). + + + +```mdx +import { LinkCard } from '@astrojs/starlight/components'; + + +``` + + + +```markdoc +{% linkcard title="Creación de contenido en Markdown" href="/es/guides/authoring-content/" /%} +``` + + + + + + + +### Agregar una descripción de enlace + +Agrega una descripción breve a una tarjeta de enlace utilizando el atributo [`description`](#description). + + + +```mdx {6} +import { LinkCard } from '@astrojs/starlight/components'; + + +``` + + + +```markdoc {4} +{% linkcard + title="Internacionalización" + href="/es/guides/i18n/" + description="Configura Starlight para admitir varios idiomas." /%} +``` + + + + + + + +### Agrupar tarjetas de enlace + +Muestra varias tarjetas de enlace una al lado de la otra cuando hay suficiente espacio agrupándolas con el componente [``](/es/components/card-grids/). +Ve la guía [“Agrupar tarjetas de enlace”](/es/components/card-grids/#agrupar-tarjetas) para un ejemplo. + +## Props de `` + +**Implementación:** [`LinkCard.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/LinkCard.astro) + +El componente `` acepta las siguientes propiedades, así como todos los demás atributos de los elementos [``](https://developer.mozilla.org/es/docs/Web/HTML/Element/a): + +### `title` + +**requerido** +**tipo:** `string` + +El título de la tarjeta de enlace a mostrar. + +### `href` + +**requerido** +**tipo:** `string` + +El URL al que enlazar cuando se interactúa con la tarjeta. + +### `description` + +**tipo:** `string` + +Una descripción opcional para mostrar debajo del título. From f7b15091af8254a74ecafbeb5c40713b96627dea Mon Sep 17 00:00:00 2001 From: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Date: Thu, 26 Sep 2024 03:13:22 -0600 Subject: [PATCH 3/9] i18n(es): translate `link-buttons` (#2410) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- .../docs/es/components/link-buttons.mdx | 145 ++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 docs/src/content/docs/es/components/link-buttons.mdx diff --git a/docs/src/content/docs/es/components/link-buttons.mdx b/docs/src/content/docs/es/components/link-buttons.mdx new file mode 100644 index 00000000000..62599b0d6ad --- /dev/null +++ b/docs/src/content/docs/es/components/link-buttons.mdx @@ -0,0 +1,145 @@ +--- +title: Botones de enlace +description: Aprende a crear botones de enlace en Starlight para enlaces de llamada a la acción visualmente distintos. +--- + +import { LinkButton } from '@astrojs/starlight/components'; + +Para mostrar enlaces de llamada a la acción visualmente distintos, usa el componente ``. + +import Preview from '~/components/component-preview.astro'; + + + + + Lee la documentación + + + + +## Importación + +```tsx +import { LinkButton } from '@astrojs/starlight/components'; +``` + +## Uso + +Usa el componente `` para mostrar un enlace de llamada a la acción visualmente distinto. +Un botón de enlace es útil para dirigir a los usuarios al contenido más relevante o accionable y se usa a menudo en páginas de destino. + +Un `` requiere un atributo [`href`](#href). +Opcionalmente, personaliza la apariencia del botón de enlace usando el atributo [`variant`](#variant), que se puede establecer en `primary` (el valor predeterminado), `secondary` o `minimal`. + + + +```mdx +import { LinkButton } from '@astrojs/starlight/components'; + +Comienza + + Referencia de configuración + +``` + + + +```markdoc +{% linkbutton href="/es/getting-started/" %}Comienza{% /linkbutton %} + +{% linkbutton href="/es/reference/configuration/" variant="secondary" %} +Referencia de configuración +{% /linkbutton %} +``` + + + + + Comienza + + Referencia de configuración + + + + + +### Agregar iconos a los botones de enlace + +Incluye un icono en un botón de enlace usando el atributo [`icon`](#icon) establecido en el nombre de [uno de los iconos integrados de Starlight](/es/reference/icons/#todos-los-iconos). + +El atributo [`iconPlacement`](#iconplacement) se puede usar para colocar el icono antes del texto estableciéndolo en `start` (el valor predeterminado es `end`). + + + +```mdx {6-7} +import { LinkButton } from '@astrojs/starlight/components'; + + + Relacionado: Astro + +``` + + + +```markdoc {4-5} +{% linkbutton + href="https://docs.astro.build" + variant="secondary" + icon="external" + iconPlacement="start" %} +Relacionado: Astro +{% /linkbutton %} +``` + + + + + Relacionado: Astro + + + + +## Props de `` + +**Implementación:** [`LinkButton.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/LinkButton.astro) + +El componente `` acepta las siguientes props y también cualquier [otro atributo ``](https://developer.mozilla.org/es/docs/Web/HTML/Element/a): + +### `href` + +**requerido** +**tipo:** `string` + +El URL al que apunta el botón de enlace. + +### `variant` + +**tipo:** `'primary' | 'secondary' | 'minimal'` +**por defecto:** `'primary'` + +La apariencia del botón de enlace. +Establece `primary` para un enlace de llamada a la acción prominente que usa el color de acento del tema, `secondary` para un enlace menos prominente o `minimal` para un enlace con un estilo mínimo. + +### `icon` + +**tipo:** `string` + +Un botón de enlace puede incluir un atributo `icon` establecido en el nombre de [uno de los iconos integrados de Starlight](/es/reference/icons/#todos-los-iconos). + +### `iconPlacement` + +**tipo:** `'start' | 'end'` +**por defecto:** `'end'` + +Determina la ubicación del icono en relación con el texto del botón de enlace. From 295100df03b4ea144350049422047458642fc22e Mon Sep 17 00:00:00 2001 From: Nin3 <30520689+Nin3lee@users.noreply.github.com> Date: Thu, 26 Sep 2024 17:21:26 +0800 Subject: [PATCH 4/9] i18n(zh-cn): Update `index.mdx` (#2413) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> From 3a20e7241c7757f3aaabc6950d6b3a145b35655f Mon Sep 17 00:00:00 2001 From: Nin3 <30520689+Nin3lee@users.noreply.github.com> Date: Thu, 26 Sep 2024 17:32:45 +0800 Subject: [PATCH 5/9] i18n(zh-cn): Update `plugins.md` & `i18n.mdx` (#2412) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/zh-cn/guides/i18n.mdx | 113 ++++++++++++++++++ .../content/docs/zh-cn/reference/plugins.md | 69 +++++++++++ 2 files changed, 182 insertions(+) diff --git a/docs/src/content/docs/zh-cn/guides/i18n.mdx b/docs/src/content/docs/zh-cn/guides/i18n.mdx index 53dff2c7eaa..76ae455c51e 100644 --- a/docs/src/content/docs/zh-cn/guides/i18n.mdx +++ b/docs/src/content/docs/zh-cn/guides/i18n.mdx @@ -275,6 +275,119 @@ export const collections = { 在 Astro 文档的[“定义集合模式”](https://docs.astro.build/zh-cn/guides/content-collections/#定义集合模式)中了解有关内容集合 schema 的更多信息。 +## 使用 UI 翻译 + +你可以使用由 [i18next](https://www.i18next.com/) 提供支持的统一 API 访问 Starlight 的 [内置 UI 字符串](/zh-cn/guides/i18n/#翻译-starlight-的-ui) 以及 [用户定义](/zh-cn/guides/i18n/#拓展翻译-schema) 和 [插件提供](/zh-cn/reference/plugins/#injecttranslations) 的 UI 字符串。 +其中包括了对 [插值](https://www.i18next.com/translation-function/interpolation) 和 [多元化](https://www.i18next.com/translation-function/plurals) 等功能的支持。 + +在 Astro 组件中，此 API 作为 [全局 `Astro` 对象](https://docs.astro.build/zh-cn/reference/api-reference/#astrolocals) 的一部分提供，即 `Astro.locals.t`： + +```astro title="example.astro" +

+ {Astro.locals.t('404.text')} +

+``` + +你还可以在 [端点](https://docs.astro.build/zh-cn/guides/endpoints/) 中使用 API，其中的 `locals` 对象可作为 [端点上下文](https://docs.astro.build/zh-cn/reference/api-reference/#contextlocals) 的一部分使用： + +```ts title="src/pages/404.ts" +export const GET = (context) => { + return new Response(context.locals.t('404.text')); +}; +``` + +### 渲染 UI 字符串 + +使用 `locals.t()` 函数以渲染 UI 字符串。 +这是 i18next 的 `t()` 函数的一个实例，该函数将 UI 字符串键作为其第一个参数，并返回当前语言的相应翻译。 + +例如，给定一个包含以下内容的自定义翻译文件： + +```json title="src/content/i18n/en.json" +{ + "link.astro": "Astro documentation", + "link.astro.custom": "Astro documentation for {{feature}}" +} +``` + +The first UI string can be rendered by passing `'link.astro'` to the `t()` function: +第一个 UI 字符串可以通过将 `'link.astro'` 传递给 `t()` 函数来渲染： + +```astro {3} + + + {Astro.locals.t('link.astro')} + + +``` + +第二个 UI 字符串对 `{{feature}}` 占位符使用了 i18next 的 [插值语法](https://www.i18next.com/translation-function/interpolation)。 +`feature` 的值在被作为第二个参数传递给 `t()` 时，必须被设置在一个选项对象中： + +```astro {3} + + + {Astro.locals.t('link.astro.custom', { feature: 'Astro DB' })} + + +``` + +有关如何使用 `t()` 函数进行插值、格式化等更多信息，请参阅 [i18next 文档](https://www.i18next.com/overview/api#t)。 + +### Advanced APIs + +#### `t.all()` + +`locals.t.all()` 函数可返回一个对象，返回的对象中包含当前区域设置下所有可用的 UI 字符串。 + +```astro +--- +// src/components/Example.astro +const allStrings = Astro.locals.t.all(); +// ^ +// { +// "skipLink.label": "Skip to content", +// "search.label": "Search", +// … +// } +--- +``` + +#### `t.exists()` + +要检查某个区域设置是否存在某个翻译键，请使用 `locals.t.exists()` 函数，并将该翻译键作为第一个参数。 +如需覆盖当前的区域设置，请传递第二个可选参数。 + +```astro +--- +// src/components/Example.astro +const keyExistsInCurrentLocale = Astro.locals.t.exists('a.key'); +// ^ true +const keyExistsInFrench = Astro.locals.t.exists('another.key', { lng: 'fr' }); +// ^ false +--- +``` + +有关详细信息，请参阅 [i18next 文档中的 `exists()` 参考](https://www.i18next.com/overview/api#exists)。 + +#### `t.dir()` + +`locals.t.dir()` 函数可返回当前或特定语言环境的文本方向。 + +```astro +--- +// src/components/Example.astro +const currentDirection = Astro.locals.t.dir(); +// ^ +// 'ltr' +const arabicDirection = Astro.locals.t.dir('ar'); +// ^ +// 'rtl' +--- +``` + +有关详细信息，请参阅 [i18next 文档中的 `dir()` 参考](https://www.i18next.com/overview/api#dir)。 + ## 访问当前语言环境 你可以使用 [`Astro.currentLocale`](https://docs.astro.build/zh-cn/reference/api-reference/#astrocurrentlocale) 在 `.astro` 组件中读取当前的语言环境。 diff --git a/docs/src/content/docs/zh-cn/reference/plugins.md b/docs/src/content/docs/zh-cn/reference/plugins.md index f213b2832e9..efd26eaa023 100644 --- a/docs/src/content/docs/zh-cn/reference/plugins.md +++ b/docs/src/content/docs/zh-cn/reference/plugins.md @@ -28,6 +28,7 @@ interface StarlightPlugin { command: 'dev' | 'build' | 'preview'; isRestart: boolean; logger: AstroIntegrationLogger; + injectTranslations: (Record>) => void; }) => void | Promise; }; } @@ -162,3 +163,71 @@ export default { ```shell [long-process-plugin] 启动一个长流程… ``` + +#### `injectTranslations` + +**类型：** `(translations: Record>) => void` + +一个回调函数，用于添加或更新 Starlight [本地化 API](/zh-cn/guides/i18n/#使用-ui-翻译) 中使用的翻译字符串。 + +在以下示例中，插件向 `en` 和 `fr` 语言环境注入了名为 `myPlugin.doThing` 的自定义 UI 字符串的翻译： + +```ts {6-13} /(injectTranslations)[^(]/ +// plugin.ts +export default { + name: 'plugin-with-translations', + hooks: { + setup({ injectTranslations }) { + injectTranslations({ + en: { + 'myPlugin.doThing': 'Do the thing', + }, + fr: { + 'myPlugin.doThing': 'Faire le truc', + }, + }); + }, + }, +}; +``` + +要在你的插件 UI 中使用注入的翻译，可以依照 [“使用 UI 翻译”指南](/zh-cn/guides/i18n/#使用-ui-翻译)。 + +插件注入的翻译字符串的类型，是在用户的项目中自动生成的，但在插件的代码库中工作时还不可用。 +要在插件上下文中对 `locals.t` 对象进行类型定义，可以在 TypeScript 声明文件中声明以下全局命名空间： + +```ts +// env.d.ts +declare namespace App { + type StarlightLocals = import('@astrojs/starlight').StarlightLocals; + // 在插件上下文中定义 `locals.t` 对象。 + interface Locals extends StarlightLocals {} +} + +declare namespace StarlightApp { + // 在 `I18n` 接口中定义附加的插件翻译。 + interface I18n { + 'myPlugin.doThing': string; + } +} +``` + +如果你有一个包含了翻译内容的对象，你还可以从源文件推断 `StarlightApp.I18n` 接口的类型。 + +举个例子，给定以下源文件： + +```ts title="ui-strings.ts" +export const UIStrings = { + en: { 'myPlugin.doThing': 'Do the thing' }, + fr: { 'myPlugin.doThing': 'Faire le truc' }, +}; +``` + +以下声明将从源文件中的英文键来推断出类型： + +```ts title="env.d.ts" +declare namespace StarlightApp { + type UIStrings = typeof import('./ui-strings').UIStrings.en; + interface I18n extends UIStrings {} +} +``` From 9b4dace60531478c52eb4f1e09b4f856680733dd Mon Sep 17 00:00:00 2001 From: Nin3 <30520689+Nin3lee@users.noreply.github.com> Date: Thu, 26 Sep 2024 17:52:49 +0800 Subject: [PATCH 6/9] i18n(zh-cn): Update `authoring-content.mdx` (#2414) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- ...oring-content.md => authoring-content.mdx} | 125 +++++++++++++++++- 1 file changed, 120 insertions(+), 5 deletions(-) rename docs/src/content/docs/zh-cn/guides/{authoring-content.md => authoring-content.mdx} (84%) diff --git a/docs/src/content/docs/zh-cn/guides/authoring-content.md b/docs/src/content/docs/zh-cn/guides/authoring-content.mdx similarity index 84% rename from docs/src/content/docs/zh-cn/guides/authoring-content.md rename to docs/src/content/docs/zh-cn/guides/authoring-content.mdx index ca6f9984988..1838dd391f9 100644 --- a/docs/src/content/docs/zh-cn/guides/authoring-content.md +++ b/docs/src/content/docs/zh-cn/guides/authoring-content.mdx @@ -202,8 +202,8 @@ Caution 和 danger 旁白有助于吸引用户注意可能绊倒他们的细节 ```js // 带有语法高亮的 JavaScript 代码。 var fun = function lang(l) { - dateformat.i18n = require('./lang/' + l); - return true; + dateformat.i18n = require('./lang/' + l); + return true; }; ``` @@ -211,8 +211,8 @@ var fun = function lang(l) { ```js // 带有语法高亮的 JavaScript 代码。 var fun = function lang(l) { - dateformat.i18n = require('./lang/' + l); - return true; + dateformat.i18n = require('./lang/' + l); + return true; }; ``` ```` @@ -394,4 +394,119 @@ Starlight 支持所有其他 Markdown 语法，例如列表和表格。 请参 ## 高级 Markdown 和 MDX 配置 -Starlight 使用 Astro 的 Markdown 和 MDX 渲染器，该渲染器构建在 remark 和 rehype 之上。 你可以通过在 Astro 配置文件中添加 `remarkPlugins` 或 `rehypePlugins` 来添加对自定义语法和行为的支持。 请参阅 Astro 文档中的 [“配置 Markdown 和 MDX”](https://docs.astro.build/zh-cn/guides/markdown-content/#配置-markdown) 以了解更多信息。 +Starlight 使用 Astro 的 Markdown 和 MDX 渲染器，该渲染器构建在 remark 和 rehype 之上。 你可以通过在 Astro 配置文件中添加 `remarkPlugins` 或 `rehypePlugins` 来添加对自定义语法和行为的支持。 请参阅 Astro 文档中的 [“Markdown 插件”](https://docs.astro.build/zh-cn/guides/markdown-content/#markdown-插件) 以了解更多信息。 + +## Markdoc + +Starlight 支持使用实验性 [Astro Markdoc 集成](https://docs.astro.build/zh-cn/guides/integrations-guide/markdoc/) 和 Starlight Markdoc 预设在 Markdoc 中创作内容。 + +### 使用 Markdoc 创建新项目 + +使用 Markdoc 的预配置 `create astro` 来启动一个新的 Starlight 项目： + +import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'; + + + + +```sh +npm create astro@latest -- --template starlight/markdoc +``` + + + + +```sh +pnpm create astro --template starlight/markdoc +``` + + + + +```sh +yarn create astro --template starlight/markdoc +``` + + + + +### 添加 Markdoc 到现有项目 + +如果你已有一个 Starlight 网站并想要添加 Markdoc，请按照以下步骤操作。 + + + +1. 添加 Astro 的 Markdoc 集成： + + + + + + ```sh + npx astro add markdoc + ``` + + + + + + ```sh + pnpm astro add markdoc + ``` + + + + + + ```sh + yarn astro add markdoc + ``` + + + + + +2. 安装 Starlight Markdoc 预设： + + + + + + ```sh + npm install @astrojs/starlight-markdoc + ``` + + + + + + ```sh + pnpm add @astrojs/starlight-markdoc + ``` + + + + + + ```sh + yarn add @astrojs/starlight-markdoc + ``` + + + + + +3. 在 `markdoc.config.mjs` 创建一个 Markdoc 配置文件并使用 Starlight Markdoc 预设： + + ```js + import { defineMarkdocConfig } from '@astrojs/markdoc/config'; + import starlightMarkdoc from '@astrojs/starlight-markdoc'; + + export default defineMarkdocConfig({ + extends: [starlightMarkdoc()], + }); + ``` + + + +要了解有关 Markdoc 语法和功能的更多信息，请参阅 [Markdoc 文档](https://markdoc.dev/docs/syntax) 或 [Astro Markdoc 集成指南](https://docs.astro.build/zh-cn/guides/integrations-guide/markdoc/)。 From 7e94f65a47398424d95f858c7afe58671fe602f2 Mon Sep 17 00:00:00 2001 From: HiDeoo Date: Thu, 26 Sep 2024 09:53:36 +0000 Subject: [PATCH 7/9] [ci] format --- .../docs/zh-cn/guides/authoring-content.mdx | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/src/content/docs/zh-cn/guides/authoring-content.mdx b/docs/src/content/docs/zh-cn/guides/authoring-content.mdx index 1838dd391f9..c6375a86d2f 100644 --- a/docs/src/content/docs/zh-cn/guides/authoring-content.mdx +++ b/docs/src/content/docs/zh-cn/guides/authoring-content.mdx @@ -202,8 +202,8 @@ Caution 和 danger 旁白有助于吸引用户注意可能绊倒他们的细节 ```js // 带有语法高亮的 JavaScript 代码。 var fun = function lang(l) { - dateformat.i18n = require('./lang/' + l); - return true; + dateformat.i18n = require('./lang/' + l); + return true; }; ``` @@ -211,8 +211,8 @@ var fun = function lang(l) { ```js // 带有语法高亮的 JavaScript 代码。 var fun = function lang(l) { - dateformat.i18n = require('./lang/' + l); - return true; + dateformat.i18n = require('./lang/' + l); + return true; }; ``` ```` @@ -244,16 +244,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 行'; } ``` ```` @@ -263,7 +263,7 @@ Expressive Code 提供了几种自定义你的代码示例视觉外观的选项 ```js "单个词组" /甚.*表达式/ // 单个词组也能被高亮显示 function demo() { - return '甚至支持使用正则表达式'; + return '甚至支持使用正则表达式'; } ``` @@ -271,7 +271,7 @@ Expressive Code 提供了几种自定义你的代码示例视觉外观的选项 ```js "单个词组" /甚.*表达式/ // 单个词组也能被高亮显示 function demo() { - return '甚至支持使用正则表达式'; + return '甚至支持使用正则表达式'; } ``` ```` @@ -280,18 +280,18 @@ Expressive Code 提供了几种自定义你的代码示例视觉外观的选项 ```js "return true;" ins="插入" del="删除" function demo() { - console.log('这是插入以及删除类型的标记'); - // 返回语句使用默认标记类型 - return true; + console.log('这是插入以及删除类型的标记'); + // 返回语句使用默认标记类型 + return true; } ``` ````md ```js "return true;" ins="插入" del="删除" function demo() { - console.log('这是插入以及删除类型的标记'); - // 返回语句使用默认标记类型 - return true; + console.log('这是插入以及删除类型的标记'); + // 返回语句使用默认标记类型 + return true; } ``` ```` From 009fab3a3ed57b7b47a075f4a656ada5ed983b57 Mon Sep 17 00:00:00 2001 From: Nin3 <30520689+Nin3lee@users.noreply.github.com> Date: Thu, 26 Sep 2024 18:01:18 +0800 Subject: [PATCH 8/9] i18n(zh-cn): Update `pages.mdx` (#2415) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/zh-cn/guides/pages.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/src/content/docs/zh-cn/guides/pages.mdx b/docs/src/content/docs/zh-cn/guides/pages.mdx index c3b9ddcd584..5a8b7368b64 100644 --- a/docs/src/content/docs/zh-cn/guides/pages.mdx +++ b/docs/src/content/docs/zh-cn/guides/pages.mdx @@ -13,8 +13,8 @@ Starlight 根据你的内容生成站点的 HTML 页面，并通过 Markdown fro ### 文件格式 -Starlight 支持使用 Markdown 和 MDX 编写内容，无需任何配置。 -你可以通过安装实验性的 [Astro Markdoc 集成](https://docs.astro.build/zh-cn/guides/integrations-guide/markdoc/) 来添加对 Markdoc 的支持。 +Starlight 支持在 Markdown 和 MDX 中创作内容，无需任何配置。 +你可以按照 [“Markdoc” 指南](/zh-cn/guides/authoring-content/#markdoc) 添加对 Markdoc 的支持。 ### 添加页面 From 5aa6d9a85f0bb57471213d21bc25cbd0d833d748 Mon Sep 17 00:00:00 2001 From: HiDeoo <494699+HiDeoo@users.noreply.github.com> Date: Thu, 26 Sep 2024 12:09:44 +0200 Subject: [PATCH 9/9] i18n(fr): update `reference/plugins` (#2416) --- docs/src/content/docs/fr/reference/plugins.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/src/content/docs/fr/reference/plugins.md b/docs/src/content/docs/fr/reference/plugins.md index 5b2b3994947..91c136bafee 100644 --- a/docs/src/content/docs/fr/reference/plugins.md +++ b/docs/src/content/docs/fr/reference/plugins.md @@ -27,6 +27,7 @@ interface StarlightPlugin { command: 'dev' | 'build' | 'preview'; isRestart: boolean; logger: AstroIntegrationLogger; + injectTranslations: (Record>) => void; }) => void | Promise; }; }