diff --git a/.changeset/short-mirrors-happen.md b/.changeset/short-mirrors-happen.md new file mode 100644 index 0000000000..bb6ac216b0 --- /dev/null +++ b/.changeset/short-mirrors-happen.md @@ -0,0 +1,5 @@ +--- +'@astrojs/starlight': patch +--- + +Remove extra margin from markdown lists that uses inline code diff --git a/docs/src/assets/showcase/ai-prompt-snippets.png b/docs/src/assets/showcase/ai-prompt-snippets.png new file mode 100644 index 0000000000..9e779636f0 Binary files /dev/null and b/docs/src/assets/showcase/ai-prompt-snippets.png differ diff --git a/docs/src/components/showcase-sites.astro b/docs/src/components/showcase-sites.astro index 5f87cdaae6..7bbda34b70 100644 --- a/docs/src/components/showcase-sites.astro +++ b/docs/src/components/showcase-sites.astro @@ -59,4 +59,9 @@ import FluidGrid from './fluid-grid.astro'; thumbnail="drops-of-php.hi-folks.dev.png" /> + diff --git a/docs/src/content/docs/es/guides/customization.mdx b/docs/src/content/docs/es/guides/customization.mdx index 7ec5d0dc7c..2b49aff605 100644 --- a/docs/src/content/docs/es/guides/customization.mdx +++ b/docs/src/content/docs/es/guides/customization.mdx @@ -188,7 +188,7 @@ defineConfig({ Starlight cuenta con soporte incorporado para agregar enlaces a tus cuentas de redes sociales en el encabezado del sitio mediante la opción [`social`](/es/reference/configuration/#social) en la integración de Starlight. -Actualmente, se admiten enlaces a Bitbucket, Codeberg, CodePen, Discord, Correo Electrónico, Facebook, GitHub, GitLab, Gitter, Instagram, LinkedIn, Mastodon, Microsoft Teams, Patreon, Reddit, un flujo RSS, Stack Overflow, Telegram, Threads, Twitch, Twitter, X, y Youtube ¡Háznoslo saber en GitHub o Discord si necesitas soporte para otro servicio! +Puedes encontrar una lista completa de todos los iconos de enlaces compatibles en la [Referencia de Configuración](/es/reference/configuration/#social). ```js // astro.config.mjs diff --git a/docs/src/content/docs/es/reference/configuration.md b/docs/src/content/docs/es/reference/configuration.mdx similarity index 75% rename from docs/src/content/docs/es/reference/configuration.md rename to docs/src/content/docs/es/reference/configuration.mdx index 7487ccf1bc..a9be57d718 100644 --- a/docs/src/content/docs/es/reference/configuration.md +++ b/docs/src/content/docs/es/reference/configuration.mdx @@ -12,11 +12,11 @@ Starlight es una integración construida sobre el framework [Astro](https://astr import { defineConfig } from 'astro/config'; import starlight from '@astrojs/starlight'; export default defineConfig({ - integrations: [ - starlight({ - title: 'Mi encantador sitio de documentación', - }), - ], + integrations: [ + starlight({ + title: 'Mi encantador sitio de documentación', + }), + ], }); ``` @@ -42,9 +42,9 @@ Establece un logotipo para mostrarlo en la barra de navegación junto al título ```js starlight({ - logo: { - src: './src/assets/mi-logo.svg', - }, + logo: { + src: './src/assets/mi-logo.svg', + }, }); ``` @@ -52,8 +52,8 @@ starlight({ ```ts type LogoConfig = { alt?: string; replacesTitle?: boolean } & ( - | { src: string } - | { light: string; dark: string } + | { src: string } + | { light: string; dark: string } ); ``` @@ -72,9 +72,9 @@ Hablita "Editar los enlaces" de está página estableciendo la URL base que se d ```js starlight({ - editLink: { - baseUrl: 'https://github.com/withastro/starlight/edit/main/', - }, + editLink: { + baseUrl: 'https://github.com/withastro/starlight/edit/main/', + }, }); ``` @@ -97,25 +97,25 @@ Cada elemento debe tener una propiedad `label` y una de las siguientes propiedad ```js starlight({ - sidebar: [ - // Un solo elemento de enlace etiquetado como “Home”. - { label: 'Home', link: '/' }, - // Un grupo etiquetado como "Start Here" que contiene dos enlaces. - { - label: 'Start Here', - items: [ - { label: 'Introduction', link: '/intro' }, - { label: 'Next Steps', link: '/next-steps' }, - ], - }, - // Un grupo que enlaza a todas las páginas del directorio de referencia. - { - label: 'Reference', - autogenerate: { - directory: 'reference', - }, - }, - ], + sidebar: [ + // Un solo elemento de enlace etiquetado como “Home”. + { label: 'Home', link: '/' }, + // Un grupo etiquetado como "Start Here" que contiene dos enlaces. + { + label: 'Start Here', + items: [ + { label: 'Introduction', link: '/intro' }, + { label: 'Next Steps', link: '/next-steps' }, + ], + }, + // Un grupo que enlaza a todas las páginas del directorio de referencia. + { + label: 'Reference', + autogenerate: { + directory: 'reference', + }, + }, + ], }); ``` @@ -182,19 +182,19 @@ sidebar: [ ```ts type SidebarItem = { - label: string; - translations?: Record; + label: string; + translations?: Record; } & ( - | { - link: string; - badge?: string | BadgeConfig; - attrs?: Record; - } - | { items: SidebarItem[]; collapsed?: boolean } - | { - autogenerate: { directory: string; collapsed?: boolean }; - collapsed?: boolean; - } + | { + link: string; + badge?: string | BadgeConfig; + attrs?: Record; + } + | { items: SidebarItem[]; collapsed?: boolean } + | { + autogenerate: { directory: string; collapsed?: boolean }; + collapsed?: boolean; + } ); ``` @@ -202,14 +202,14 @@ type SidebarItem = { ```ts interface BadgeConfig { - text: string; - variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default'; + text: string; + variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default'; } ``` ### `locales` -**tipo:** { \[dir: string\]: [LocaleConfig](#localeconfig) } +**tipo:** \{ \[dir: string\]: [LocaleConfig](#localeconfig) \} [Configura la internacionalización (i18n)](/es/guides/i18n/) para tu sitio estableciendo qué `locales` se admiten. @@ -221,29 +221,29 @@ import { defineConfig } from 'astro/config'; import starlight from '@astrojs/starlight'; export default defineConfig({ - integrations: [ - starlight({ - title: 'My Docs', - // Establece el inglés como el idioma predeterminado para este sitio. - defaultLocale: 'en', - locales: { - // Los documentos en inglés en `src/content/docs/en/` - en: { - label: 'English', - }, - // Los documentos en chino simplificado en `src/content/docs/zh-cn/` - 'zh-cn': { - label: '简体中文', - lang: 'zh-CN', - }, - // Los documentos en árabe en `src/content/docs/ar/` - ar: { - label: 'العربية', - dir: 'rtl', - }, - }, - }), - ], + integrations: [ + starlight({ + title: 'My Docs', + // Establece el inglés como el idioma predeterminado para este sitio. + defaultLocale: 'en', + locales: { + // Los documentos en inglés en `src/content/docs/en/` + en: { + label: 'English', + }, + // Los documentos en chino simplificado en `src/content/docs/zh-cn/` + 'zh-cn': { + label: '简体中文', + lang: 'zh-CN', + }, + // Los documentos en árabe en `src/content/docs/ar/` + ar: { + label: 'العربية', + dir: 'rtl', + }, + }, + }), + ], }); ``` @@ -251,9 +251,9 @@ export default defineConfig({ ```ts interface LocaleConfig { - label: string; - lang?: string; - dir?: 'ltr' | 'rtl'; + label: string; + lang?: string; + dir?: 'ltr' | 'rtl'; } ``` @@ -283,15 +283,15 @@ Puedes servir el idioma predeterminado sin un directorio `/lang/` estableciendo ```js starlight({ - locales: { - root: { - label: 'English', - lang: 'en', - }, - fr: { - label: 'Français', - }, - }, + locales: { + root: { + label: 'English', + lang: 'en', + }, + fr: { + label: 'Français', + }, + }, }); ``` @@ -309,24 +309,26 @@ El idioma predeterminado se utilizará para proporcionar contenido de respaldo d ### `social` -**tipo:** `Partial>` +import SocialLinksType from '../../../../components/social-links-type.astro'; + +**tipo:** Detalles opcionales sobre las cuentas de redes sociales para este sitio. Agregar cualquiera de estos los mostrará como enlaces de iconos en el encabezado del sitio. ```js starlight({ - social: { - codeberg: 'https://codeberg.org/knut/examples', - discord: 'https://astro.build/chat', - github: 'https://github.com/withastro/starlight', - linkedin: 'https://www.linkedin.com/company/astroinc', - mastodon: 'https://m.webtoo.ls/@astro', - threads: 'https://www.threads.net/@nmoodev', - twitch: 'https://www.twitch.tv/bholmesdev', - twitter: 'https://twitter.com/astrodotbuild', - 'x.com': 'https://x.com/astrodotbuild', - youtube: 'https://youtube.com/@astrodotbuild', - }, + social: { + codeberg: 'https://codeberg.org/knut/examples', + discord: 'https://astro.build/chat', + github: 'https://github.com/withastro/starlight', + linkedin: 'https://www.linkedin.com/company/astroinc', + mastodon: 'https://m.webtoo.ls/@astro', + threads: 'https://www.threads.net/@nmoodev', + twitch: 'https://www.twitch.tv/bholmesdev', + twitter: 'https://twitter.com/astrodotbuild', + 'x.com': 'https://x.com/astrodotbuild', + youtube: 'https://youtube.com/@astrodotbuild', + }, }); ``` @@ -340,7 +342,7 @@ Admite archivos CSS locales relativos a la raíz de tu proyecto, por ejemplo, `' ```js starlight({ - customCss: ['./src/custom-styles.css', '@fontsource/roboto'], + customCss: ['./src/custom-styles.css', '@fontsource/roboto'], }); ``` @@ -353,17 +355,17 @@ Puede ser útil para agregar análisis y otros scripts y recursos de terceros. ```js starlight({ - head: [ - // Ejemplo: agregar etiqueta de script de análisis de Fathom. - { - tag: 'script', - attrs: { - src: 'https://cdn.usefathom.com/script.js', - 'data-site': 'MY-FATHOM-ID', - defer: true, - }, - }, - ], + head: [ + // Ejemplo: agregar etiqueta de script de análisis de Fathom. + { + tag: 'script', + attrs: { + src: 'https://cdn.usefathom.com/script.js', + 'data-site': 'MY-FATHOM-ID', + defer: true, + }, + }, + ], }); ``` @@ -371,9 +373,9 @@ starlight({ ```ts interface HeadConfig { - tag: string; - attrs?: Record; - content?: string; + tag: string; + attrs?: Record; + content?: string; } ``` @@ -445,9 +447,9 @@ Proporciona las rutas a los componentes para sobreescribir las implementaciones ```js starlight({ - components: { - SocialLinks: './src/components/MySocialLinks.astro', - }, + components: { + SocialLinks: './src/components/MySocialLinks.astro', + }, }); ``` diff --git a/docs/src/content/docs/fr/guides/customization.mdx b/docs/src/content/docs/fr/guides/customization.mdx index b1642055d3..40e1de9c29 100644 --- a/docs/src/content/docs/fr/guides/customization.mdx +++ b/docs/src/content/docs/fr/guides/customization.mdx @@ -191,7 +191,7 @@ defineConfig({ Starlight supporte par défaut l’ajout de liens vers vos comptes de médias sociaux dans l’en-tête du site via l’option [`social`](/reference/configuration/#social) dans l’intégration Starlight. -Actuellement, les liens vers Bitbucket, Codeberg, Codepen, Discord, un courriel, Facebook, GitHub, GitLab, Gitter, Instagram, LinkedIn, Mastodon, Microsoft Teams, un flux RSS, Stack Overflow, Telegram, Threads, Twitch, Twitter, X et Youtube sont pris en charge. +Vous pouvez retrouver une liste complète des icônes de liens prises en charge dans la [référence de configuration](/fr/reference/configuration/#social). Faites-nous savoir sur GitHub ou Discord si vous avez besoin de la prise en charge d’un autre service ! ```js diff --git a/docs/src/content/docs/fr/guides/i18n.mdx b/docs/src/content/docs/fr/guides/i18n.mdx index ba27a2d32c..0d2d8fd7c5 100644 --- a/docs/src/content/docs/fr/guides/i18n.mdx +++ b/docs/src/content/docs/fr/guides/i18n.mdx @@ -143,7 +143,7 @@ Si une traduction n'est pas encore disponible pour une langue, Starlight affiche En plus d'héberger des fichiers de contenu traduits, Starlight vous permet de traduire les chaînes de l'interface utilisateur par défaut (par exemple, l'en-tête "Sur cette page" dans la table des matières) afin que vos lecteurs puissent découvrir votre site entièrement dans la langue sélectionnée. -Les textes de l'interface utilisateur traduits en anglais, arabe, allemand, chinois simplifié, danois, espagnol, français, italien, japonais, néerlandais, norvégien, farsi, hébreu, portugais, tchèque, turc, coréen, indonésien, russe, suédois et vietnamien sont disponibles prêts à l'emploi, et nous acceptons les [contributions pour ajouter d'autres langues par défaut](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md). +Les textes de l'interface utilisateur traduits en anglais, arabe, allemand, chinois simplifié, danois, espagnol, français, italien, japonais, néerlandais, norvégien, farsi, hébreu, portugais, tchèque, turc, coréen, indonésien, russe, suédois, ukrainien et vietnamien sont disponibles prêts à l'emploi, et nous acceptons les [contributions pour ajouter d'autres langues par défaut](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md). Vous pouvez fournir des traductions pour les langues supplémentaires que vous supportez - ou remplacer nos étiquettes par défaut - via la collection de données `i18n`. diff --git a/docs/src/content/docs/fr/guides/sidebar.mdx b/docs/src/content/docs/fr/guides/sidebar.mdx index b19efa1616..617b3709fc 100644 --- a/docs/src/content/docs/fr/guides/sidebar.mdx +++ b/docs/src/content/docs/fr/guides/sidebar.mdx @@ -367,7 +367,7 @@ La configuration ci-dessus génère la barre latérale suivante : ## Internationalisation -Utilisez la propriété `translations` sur les liens et les groupes pour traduire l'étiquette du lien ou du groupe pour chaque langue prise en charge. +Utilisez la propriété `translations` sur les liens et les groupes pour traduire l'étiquette du lien ou du groupe pour chaque langue prise en charge en spécifiant une étiquette d'identification de langue [BCP-47](https://www.w3.org/International/questions/qa-choosing-language-tags), par exemple `"en"`, `"ar"` ou `"zh-CN"`, comme clé et l'étiquette traduite comme valeur. La propriété `label` sera utilisée pour la langue par défaut et pour les langues sans traduction. ```js @@ -376,20 +376,20 @@ starlight({ { label: 'Guides', translations: { - es: 'Guías', + 'pt-BR': 'Guias', }, items: [ { label: 'Composants', translations: { - es: 'Componentes', + 'pt-BR': 'Componentes', }, link: '/guides/components/', }, { label: 'Internationalisation (i18n)', translations: { - es: 'Internacionalización (i18n)', + 'pt-BR': 'Internacionalização (i18n)', }, link: '/guides/i18n/', }, @@ -399,15 +399,15 @@ starlight({ }); ``` -Parcourir la documentation en espagnol générera la barre latérale suivante : +Parcourir la documentation en portugais brésilien générera la barre latérale suivante : .content :global( - :not(a, strong, em, del, span, input) - + :not(a, strong, em, del, span, input, :where(.not-content *)) + :not(a, strong, em, del, span, input, code) + + :not(a, strong, em, del, span, input, code, :where(.not-content *)) ) { margin-top: 1.5rem; }