Merge branch 'main' into hd-file-tree-docs

* main:
  [ci] format
  [ci] release (withastro#1574)
  Add `<Steps>` component (withastro#1564)
  Add `<FileTree>` component (withastro#1308)
  Add icon support to the `<TabItem>` component (withastro#1568)
  [ci] format
  docs: add Flojoy to showcase (withastro#1571)
  i18n(es): update `components` (withastro#1547)
  i18n(pt-PT): add "manual-setup" page (withastro#1570)
  i18n(zh-cn): Update pages.mdx (withastro#1565)
  Updates internal github actions to the latest versions (withastro#1569)
  [ci] format
  i18n(it): Update pages.mdx & plugins.mdx (withastro#1567)
  [ci] format
  i18n(pt-PT): add "environmental-impact" page (withastro#1561)
  [ci] format
  i18n(zh-cn): Update plugins.mdx (withastro#1566)

.changeset/config.json

@@ -9,7 +9,7 @@
   "access": "public",
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
-  "ignore": ["starlight-docs", "@example/*"],
+  "ignore": ["starlight-docs", "@example/*", "starlight-file-icons-generator"],
   "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
     "onlyUpdatePeerDependentsWhenOutOfRange": true
   }

.github/workflows/ci.yml

@@ -20,9 +20,9 @@ jobs:
     name: Run unit tests
     runs-on: ubuntu-20.04
     steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -35,13 +35,13 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@v2
+        uses: pnpm/action-setup@v3
 
       - name: Setup Node
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -63,9 +63,9 @@ jobs:
     name: Docs site builds on Windows
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -79,13 +79,13 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@v2
+        uses: pnpm/action-setup@v3
 
       - name: Setup Node
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'

.github/workflows/format.yml

@@ -10,21 +10,21 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code using Git
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
           # Needs access to push to main
           token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}
-      - uses: pnpm/action-setup@v2
-      - uses: actions/setup-node@v3
+      - uses: pnpm/action-setup@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: 18
           cache: 'pnpm'
       - run: pnpm i
       - name: Format with Prettier
         run: pnpm format
       - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v4
+        uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: '[ci] format'
           branch: ${{ github.head_ref }}

.github/workflows/release.yml

@@ -12,16 +12,16 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           # This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
           fetch-depth: 0
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@v2
+        uses: pnpm/action-setup@v3
 
       - name: Setup Node
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: 18
           cache: 'pnpm'

.github/workflows/size-limit.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v3
       - run: pnpm i
       - run: 'pnpm build:examples'
       - run: pnpm size
@@ -31,7 +31,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v3
       - name: Run size-limit
         uses: andresz1/size-limit-action@dd31dce7dcc72a041fd3e49abf0502b13fc4ce05
         with:

.github/workflows/welcome-bot.yml

@@ -13,7 +13,7 @@ jobs:
     name: Welcome First-Time Contributors
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: zephyrproject-rtos/action-first-interaction@7e6446f8439d8b4399169880c36a3a12b5747699
         with:
           repo-token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}

docs/.pa11yci

@@ -2,6 +2,9 @@
   "defaults": {
     "runners": [
       "axe"
+    ],
+    "ignore": [
+      "color-contrast"
     ]
   }
 }

docs/astro.config.mjs

@@ -79,6 +79,7 @@ export default defineConfig({
 						id: 'Mulai dari sini',
 						'zh-CN': '从这里开始',
 						'pt-BR': 'Comece Aqui',
+						'pt-PT': 'Comece Aqui',
 						ko: '여기서부터',
 						tr: 'Buradan Başlayın',
 						ru: 'Начать отсюда',
@@ -98,6 +99,7 @@ export default defineConfig({
 								id: 'Memulai',
 								'zh-CN': '开始使用',
 								'pt-BR': 'Introdução',
+								'pt-PT': 'Introdução',
 								ko: '시작하기',
 								tr: 'Başlarken',
 								ru: 'Введение',
@@ -117,6 +119,7 @@ export default defineConfig({
 								id: 'Instalasi Manual',
 								'zh-CN': '手动配置',
 								'pt-BR': 'Instalação Manual',
+								'pt-PT': 'Instalação Manual',
 								ko: '수동으로 설정하기',
 								tr: 'Elle Kurulum',
 								ru: 'Установка вручную',
@@ -136,6 +139,7 @@ export default defineConfig({
 								id: 'Dampak terhadap lingkungan',
 								'zh-CN': '环境影响',
 								'pt-BR': 'Impacto Ambiental',
+								'pt-PT': 'Impacto Ambiental',
 								ko: '환경적 영향',
 								tr: 'Çevre Etkisi',
 								ru: 'Влияние на окружающую среду',

docs/src/components/icons-list.astro

@@ -54,6 +54,7 @@ const icons = Object.keys(Icons) as (keyof typeof Icons)[];
 		font-size: var(--sl-text-sm);
 		gap: 0.25rem;
 		margin: 0;
+		overflow-wrap: anywhere;
 		padding: 0.75rem;
 		background: none;
 	}

docs/src/components/showcase-sites.astro

@@ -106,4 +106,5 @@ import FluidGrid from './fluid-grid.astro';
 		thumbnail="astro-ghostcms.xyz.png"
 	/>
 	<Card title="oneRepo" href="https://onerepo.tools" thumbnail="onerepo.tools.png" />
+	<Card title="Flojoy" href="https://docs.flojoy.ai" thumbnail="docs.flojoy.ai.png" />
 </FluidGrid>

docs/src/content/docs/es/guides/components.mdx

@@ -173,6 +173,61 @@ import { LinkCard } from '@astrojs/starlight/components';
 	<LinkCard title="Componentes" href="/es/guides/components/" />
 </CardGrid>
 
+### Apartados
+
+Los apartados son útiles para mostrar información secundaria junto al contenido principal de una página.
+
+Un `<Aside>` puede tener un `type` opcional de `note` (el valor predeterminado), `tip`, `caution` o `danger`. Establecer un atributo `title` anula el título predeterminado del apartado.
+
+````mdx
+# src/content/docs/example.mdx
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>Un apartado predeterminado sin un título personalizado.</Aside>
+
+<Aside type="caution" title="Watch out!">
+	Un apartado de advertencia *con* un título personalizado.
+</Aside>
+
+<Aside type="tip">
+
+Otro contenido también es compatible en los apartados.
+
+```js
+// Una muestra de código, por ejemplo.
+```
+
+</Aside>
+
+<Aside type="danger">No le des tu contraseña a nadie.</Aside>
+````
+
+El código anterior genera lo siguiente en la página:
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>Un apartado predeterminado sin un título personalizado.</Aside>
+
+<Aside type="caution" title="Watch out!">
+	Un apartado de advertencia *con* un título personalizado.
+</Aside>
+
+<Aside type="tip">
+
+Otro contenido también es compatible en los apartados.
+
+```js
+// Una muestra de código, por ejemplo.
+```
+
+</Aside>
+
+<Aside type="danger">No le des tu contraseña a nadie.</Aside>
+
+Starlight también proporciona una sintaxis personalizada para renderizar apartados en Markdown y MDX como una alternativa al componente `<Aside>`.
+Consulta la guía [“Creación de contenido en Markdown”](/es/guides/authoring-content/#apartados) para obtener más detalles de la sintaxis personalizada.
+
 ### Iconos
 
 import { Icon } from '@astrojs/starlight/components';