From 1b08fcf97fc983e0da8e2f2e09cd1377696c3d78 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar <kzunigac@uvm.edu>
Date: Thu, 13 Jun 2024 11:18:09 -0400
Subject: [PATCH 1/4] remove aliases page

---
 src/content/docs/en/guides/aliases.mdx | 47 --------------------------
 src/content/docs/en/guides/imports.mdx | 45 ++++++++++++++++++++++++
 2 files changed, 45 insertions(+), 47 deletions(-)
 delete mode 100644 src/content/docs/en/guides/aliases.mdx

diff --git a/src/content/docs/en/guides/aliases.mdx b/src/content/docs/en/guides/aliases.mdx
deleted file mode 100644
index e8510a8372974..0000000000000
--- a/src/content/docs/en/guides/aliases.mdx
+++ /dev/null
@@ -1,47 +0,0 @@
----
-title: Aliases
-description: An intro to aliases with Astro.
-i18nReady: true
----
-
-An **alias** is a way to create shortcuts for your imports.
-
-Aliases can help improve the development experience in codebases with many directories or relative imports.
-
-```astro title="src/pages/about/company.astro" del="../../components" del="../../assets"
----
-import Button from '../../components/controls/Button.astro';
-import logoUrl from '../../assets/logo.png?url';
----
-```
-
-In this example, a developer would need to understand the tree relationship between `src/pages/about/company.astro`, `src/components/controls/Button.astro`, and `src/assets/logo.png`. And then, if the `company.astro` file were to be moved, these imports would also need to be updated.
-
-You can add import aliases from either `tsconfig.json` or `jsconfig.json`.
-
-```json title="tsconfig.json" ins={5-6}
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "paths": {
-      "@components/*": ["src/components/*"],
-      "@assets/*": ["src/assets/*"]
-    }
-  }
-}
-```
-
-:::note
-Make sure `compilerOptions.baseUrl` is set so the aliased paths can be resolved.
-:::
-
-The development server will automatically restart after this configuration change. You can now import using the aliases anywhere in your project:
-
-```astro title="src/pages/about/company.astro" ins="@components" ins="@assets"
----
-import Button from '@components/controls/Button.astro';
-import logoUrl from '@assets/logo.png?url';
----
-```
-
-These aliases are also integrated automatically into [VS Code](https://code.visualstudio.com/docs/languages/jsconfig) and other editors.
diff --git a/src/content/docs/en/guides/imports.mdx b/src/content/docs/en/guides/imports.mdx
index 0ff749888cd5d..2e6154efa1419 100644
--- a/src/content/docs/en/guides/imports.mdx
+++ b/src/content/docs/en/guides/imports.mdx
@@ -146,6 +146,51 @@ It can also be useful to place images in the `public/` folder as explained on th
 Adding **alt text** to `<img>` tags is encouraged for accessibility! Don't forget to add an `alt="a helpful description"` attribute to your image elements. You can just leave the attribute empty if the image is purely decorative.
 :::
 
+## Aliases
+
+An **alias** is a way to create shortcuts for your imports.
+
+Aliases can help improve the development experience in codebases with many directories or relative imports.
+
+```astro title="src/pages/about/company.astro" del="../../components" del="../../assets"
+---
+import Button from '../../components/controls/Button.astro';
+import logoUrl from '../../assets/logo.png?url';
+---
+```
+
+In this example, a developer would need to understand the tree relationship between `src/pages/about/company.astro`, `src/components/controls/Button.astro`, and `src/assets/logo.png`. And then, if the `company.astro` file were to be moved, these imports would also need to be updated.
+
+You can add import aliases from either `tsconfig.json` or `jsconfig.json`.
+
+```json title="tsconfig.json" ins={5-6}
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@components/*": ["src/components/*"],
+      "@assets/*": ["src/assets/*"]
+    }
+  }
+}
+```
+
+:::note
+Make sure `compilerOptions.baseUrl` is set so the aliased paths can be resolved.
+:::
+
+The development server will automatically restart after this configuration change. You can now import using the aliases anywhere in your project:
+
+```astro title="src/pages/about/company.astro" ins="@components" ins="@assets"
+---
+import Button from '@components/controls/Button.astro';
+import logoUrl from '@assets/logo.png?url';
+---
+```
+
+These aliases are also integrated automatically into [VS Code](https://code.visualstudio.com/docs/languages/jsconfig) and other editors.
+
+
 ## `Astro.glob()`
 
 [`Astro.glob()`](/en/reference/api-reference/#astroglob) is a way to import many files at once.

From 5609607595beffa72663f14f6aa8014091063020 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar <kzunigac@uvm.edu>
Date: Thu, 13 Jun 2024 11:53:17 -0400
Subject: [PATCH 2/4] find a replace yolo

---
 old-translations/de/guides/images.mdx              | 2 +-
 old-translations/fr/images.mdx                     | 2 +-
 old-translations/ja/images.mdx                     | 2 +-
 old-translations/zh-CN/guides/images.mdx           | 2 +-
 src/content/docs/de/guides/typescript.mdx          | 2 +-
 src/content/docs/en/guides/images.mdx              | 6 +++---
 src/content/docs/en/guides/markdown-content.mdx    | 2 +-
 src/content/docs/en/guides/typescript.mdx          | 2 +-
 src/content/docs/en/install-and-setup.mdx          | 4 ++--
 src/content/docs/es/guides/images.mdx              | 6 +++---
 src/content/docs/es/guides/markdown-content.mdx    | 2 +-
 src/content/docs/es/guides/typescript.mdx          | 2 +-
 src/content/docs/es/install-and-setup.mdx          | 2 +-
 src/content/docs/fr/guides/images.mdx              | 6 +++---
 src/content/docs/fr/guides/markdown-content.mdx    | 2 +-
 src/content/docs/fr/guides/typescript.mdx          | 2 +-
 src/content/docs/ja/guides/images.mdx              | 6 +++---
 src/content/docs/ja/guides/markdown-content.mdx    | 2 +-
 src/content/docs/ja/guides/typescript.mdx          | 2 +-
 src/content/docs/ko/guides/images.mdx              | 6 +++---
 src/content/docs/ko/guides/markdown-content.mdx    | 2 +-
 src/content/docs/ko/guides/typescript.mdx          | 2 +-
 src/content/docs/ko/install-and-setup.mdx          | 4 ++--
 src/content/docs/pt-br/guides/images.mdx           | 6 +++---
 src/content/docs/pt-br/guides/markdown-content.mdx | 2 +-
 src/content/docs/pt-br/guides/typescript.mdx       | 2 +-
 src/content/docs/ru/guides/markdown-content.mdx    | 4 ++--
 src/content/docs/ru/guides/typescript.mdx          | 2 +-
 src/content/docs/zh-cn/guides/images.mdx           | 6 +++---
 src/content/docs/zh-cn/guides/markdown-content.mdx | 2 +-
 src/content/docs/zh-cn/guides/typescript.mdx       | 2 +-
 src/content/docs/zh-cn/install-and-setup.mdx       | 4 ++--
 32 files changed, 50 insertions(+), 50 deletions(-)

diff --git a/old-translations/de/guides/images.mdx b/old-translations/de/guides/images.mdx
index 693194dc9210e..ce183d85d1dc8 100644
--- a/old-translations/de/guides/images.mdx
+++ b/old-translations/de/guides/images.mdx
@@ -90,7 +90,7 @@ Deine in `src/` gespeicherten Bilder können von Komponenten (`.astro`, `.mdx` u
 
 Wir empfehlen, dass du deine Bilder in [`public/`](#public) aufbewahrst oder sie [remote](#bilder-von-einem-cms-oder-cdn-verwenden) speicherst, wenn du Markdown-Dateien verwenden musst.
 
-Importiere sie aus einem **relativen Dateipfad** oder [import alias](/de/guides/aliases/) in eine beliebige Komponentendatei und verwende dann den Import als `src`-Attribut des Bildes.
+Importiere sie aus einem **relativen Dateipfad** oder [import alias](/de/guides/imports/#aliases) in eine beliebige Komponentendatei und verwende dann den Import als `src`-Attribut des Bildes.
 
 
 ```astro
diff --git a/old-translations/fr/images.mdx b/old-translations/fr/images.mdx
index 7f2f18f82718a..00d8c556376fc 100644
--- a/old-translations/fr/images.mdx
+++ b/old-translations/fr/images.mdx
@@ -80,7 +80,7 @@ Vos images stockées dans `src/` peuvent être utilisées par les composants (`.
 
 Nous recommandons de garder vos images dans [`public/`](#public) ou de les stocker [à distance](#utilisation-des-images-depuis-un-cms-ou-un-cdn) si vous devez utiliser des fichiers Markdown.
 
-Importez-les depuis un **chemin de fichier relatif** ou un [alias d'import](/fr/guides/aliases/) dans n'importe quel fichier composant et utilisez ensuite l'import comme attribut `src` de l'image.
+Importez-les depuis un **chemin de fichier relatif** ou un [alias d'import](/fr/guides/imports/#aliases) dans n'importe quel fichier composant et utilisez ensuite l'import comme attribut `src` de l'image.
 
 ```astro
 ---
diff --git a/old-translations/ja/images.mdx b/old-translations/ja/images.mdx
index 54c53602c96e2..c9c36e6653665 100644
--- a/old-translations/ja/images.mdx
+++ b/old-translations/ja/images.mdx
@@ -90,7 +90,7 @@ import rocket from '../images/rocket.svg';
 
 Markdownファイルを利用する必要がある場合、[`public/`へ配置する](#public)か[CMSやCDN上の画像を利用](#cmsやcdn上の画像利用)することをお勧めします。
 
-画像を**相対ファイルパス**または[importエイリアス](/ja/guides/aliases/)を利用してコンポーネントファイル内でインポートし、画像の`src`属性として利用できます。
+画像を**相対ファイルパス**または[importエイリアス](/ja/guides/imports/#aliases)を利用してコンポーネントファイル内でインポートし、画像の`src`属性として利用できます。
 
 
 ```astro
diff --git a/old-translations/zh-CN/guides/images.mdx b/old-translations/zh-CN/guides/images.mdx
index d1a9b2f50910c..95c0b2e2a1bbd 100644
--- a/old-translations/zh-CN/guides/images.mdx
+++ b/old-translations/zh-CN/guides/images.mdx
@@ -95,7 +95,7 @@ import rocket from '../images/rocket.svg';
 
 如果你必须使用 Markdown 文档，我们建议你将图像保存在 ['public/']（#public） 中或 [远程](#使用-cms-或-cdn-上的图片) 存储他们。
 
-从任何组件文档中的 **相对文档路径** 或 [导入别名](/zh-cn/guides/aliases/) 导入它们，然后像使用 `src`属性一样使用。
+从任何组件文档中的 **相对文档路径** 或 [导入别名](/zh-cn/guides/imports/#aliases) 导入它们，然后像使用 `src`属性一样使用。
 
 ```astro
 ---
diff --git a/src/content/docs/de/guides/typescript.mdx b/src/content/docs/de/guides/typescript.mdx
index 32c8c4616a960..521d1f60b601d 100644
--- a/src/content/docs/de/guides/typescript.mdx
+++ b/src/content/docs/de/guides/typescript.mdx
@@ -114,7 +114,7 @@ Du kannst TypeScript so konfigurieren, dass Typ-Importe in deiner `.tsconfig`-Da
 
 ## Import-Aliase
 
-Astro unterstützt [Import-Aliase](/de/guides/aliases/), die du in deiner `tsconfig.json` & `jsconfig.json` `paths` Konfiguration definierst. [Lies unsere Anleitung](/de/guides/aliases/), um mehr zu erfahren.
+Astro unterstützt [Import-Aliase](/de/guides/imports/#aliases), die du in deiner `tsconfig.json` & `jsconfig.json` `paths` Konfiguration definierst. [Lies unsere Anleitung](/de/guides/imports/#aliases), um mehr zu erfahren.
 
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx
index 45aa7e4f39a76..80e77042f4779 100644
--- a/src/content/docs/en/guides/images.mdx
+++ b/src/content/docs/en/guides/images.mdx
@@ -95,7 +95,7 @@ import myImage from '../assets/my_image.png'; // Image is 1600x900
 
 The format of the `src` value of your image file depends on where your image file is located:
 
-- **Local images in `src/`** - you must **also import the image** using a relative file path or configure and use an [import alias](/en/guides/aliases/). Then use the import name as the `src` value:
+- **Local images in `src/`** - you must **also import the image** using a relative file path or configure and use an [import alias](/en/guides/imports/#aliases). Then use the import name as the `src` value:
 
   ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
   ---
@@ -405,7 +405,7 @@ It accepts all HTML `<img>` tag properties, and the only required property is `s
 
 #### Local images in `src/`
 
-Local images must be **imported from the relative path** from the existing `.astro` file, or configure and use an [import alias](/en/guides/aliases/). Then, you can access the image's `src` and other properties to use in the `<img>` tag.
+Local images must be **imported from the relative path** from the existing `.astro` file, or configure and use an [import alias](/en/guides/imports/#aliases). Then, you can access the image's `src` and other properties to use in the `<img>` tag.
 
 For example, use the image's own `height` and `width` properties to avoid CLS and improve Core Web Vitals.
 
@@ -781,7 +781,7 @@ If necessary, also update your `src/env.d.ts` file to replace the `astro/client-
 
 #### Remove the `~/assets` import alias
 
-This import alias is no longer included by default with `astro:assets`. If you were using this alias with experimental assets, you must convert them to relative file paths, or [create your own import aliases](/en/guides/aliases/).
+This import alias is no longer included by default with `astro:assets`. If you were using this alias with experimental assets, you must convert them to relative file paths, or [create your own import aliases](/en/guides/imports/#aliases).
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/en/guides/markdown-content.mdx b/src/content/docs/en/guides/markdown-content.mdx
index 838b45126a60e..a1e84fa3d0d81 100644
--- a/src/content/docs/en/guides/markdown-content.mdx
+++ b/src/content/docs/en/guides/markdown-content.mdx
@@ -68,7 +68,7 @@ Astro provides some extra, built-in Markdown features available when using Markd
 
 ### Frontmatter `layout`
 
-Astro provides [Markdown and MDX pages](/en/basics/astro-pages/#markdownmdx-pages) (located within `src/pages/`) with a special frontmatter `layout` property that can specify a relative path (or [alias](/en/guides/aliases/)) to an Astro [layout component](/en/basics/layouts/#markdownmdx-layouts).
+Astro provides [Markdown and MDX pages](/en/basics/astro-pages/#markdownmdx-pages) (located within `src/pages/`) with a special frontmatter `layout` property that can specify a relative path (or [alias](/en/guides/imports/#aliases)) to an Astro [layout component](/en/basics/layouts/#markdownmdx-layouts).
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/en/guides/typescript.mdx b/src/content/docs/en/guides/typescript.mdx
index 8d877377b4456..53f573511dec9 100644
--- a/src/content/docs/en/guides/typescript.mdx
+++ b/src/content/docs/en/guides/typescript.mdx
@@ -95,7 +95,7 @@ You can configure TypeScript to enforce type imports in your `tsconfig.json` fil
 
 ## Import Aliases
 
-Astro supports [import aliases](/en/guides/aliases/) that you define in your `tsconfig.json` & `jsconfig.json` `paths` configuration. [Read our guide](/en/guides/aliases/) to learn more.
+Astro supports [import aliases](/en/guides/imports/#aliases) that you define in your `tsconfig.json` & `jsconfig.json` `paths` configuration. [Read our guide](/en/guides/imports/#aliases) to learn more.
 
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/en/install-and-setup.mdx b/src/content/docs/en/install-and-setup.mdx
index 1a73b2eb043d0..9875e32205268 100644
--- a/src/content/docs/en/install-and-setup.mdx
+++ b/src/content/docs/en/install-and-setup.mdx
@@ -165,7 +165,7 @@ Explore the guides below to customize your development experience.
   <LinkCard
     title="Import Aliases"
     description="Create convenient shortcuts for your file imports."
-    href="/en/guides/aliases/"
+    href="/en/guides/imports/#aliases"
   />
   <LinkCard
     title="Environment Variables"
@@ -429,4 +429,4 @@ If you prefer not to use our automatic `create astro` CLI tool, you can set up y
 
 8. You can now [start the Astro dev server](#start-the-astro-dev-server) and see a live preview of your project while you build!
 
-</Steps>
\ No newline at end of file
+</Steps>
diff --git a/src/content/docs/es/guides/images.mdx b/src/content/docs/es/guides/images.mdx
index 512be988579d3..8bbc669c34eee 100644
--- a/src/content/docs/es/guides/images.mdx
+++ b/src/content/docs/es/guides/images.mdx
@@ -95,7 +95,7 @@ import myImage from '../assets/my_image.png'; // La imagen es 1600x900
 
 El formato del valor `src` de tu archivo de imagen depende de dónde esté ubicado tu archivo de imagen:
 
-- **Imágenes locales en `src/`** - también debes **importar la imagen** utilizando una ruta de archivo relativa o configurar y usar un [alias de importación](/es/guides/aliases/). Luego usa el nombre de importación como valor de `src`:
+- **Imágenes locales en `src/`** - también debes **importar la imagen** utilizando una ruta de archivo relativa o configurar y usar un [alias de importación](/es/guides/imports/#aliases). Luego usa el nombre de importación como valor de `src`:
 
   ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
   ---
@@ -404,7 +404,7 @@ Esta acepta todas las propiedades de la etiqueta HTML `<img>`, y la única propi
 
 #### Imágenes locales en `src/`
 
-Las imágenes locales deben ser **importadas desde la ruta relativa** al archivo `.astro` existente, o configurar y usar un [alias de importación](/es/guides/aliases/). Luego, puedes acceder a la propiedad `src` de la imagen y otras propiedades para usar en la etiqueta `<img>`.
+Las imágenes locales deben ser **importadas desde la ruta relativa** al archivo `.astro` existente, o configurar y usar un [alias de importación](/es/guides/imports/#aliases). Luego, puedes acceder a la propiedad `src` de la imagen y otras propiedades para usar en la etiqueta `<img>`.
 
 Por ejemplo, utiliza las propiedades `height` y `width` propias de la imagen para evitar CLS y mejorar los Core Web Vitals.
 
@@ -780,7 +780,7 @@ Si es necesario, también actualiza tu archivo `src/env.d.ts` para reemplazar la
 
 #### Eliminar el alias de importación `~/assets`
 
-Este alias de importación ya no se incluye por defecto con `astro:assets`. Si estabas usando este alias con assets experimentales, debes convertirlos a rutas de archivo relativas o [crear tus propios alias de importación](/es/guides/aliases/).
+Este alias de importación ya no se incluye por defecto con `astro:assets`. Si estabas usando este alias con assets experimentales, debes convertirlos a rutas de archivo relativas o [crear tus propios alias de importación](/es/guides/imports/#aliases).
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/es/guides/markdown-content.mdx b/src/content/docs/es/guides/markdown-content.mdx
index 0886e540e049d..0e8f354be0abd 100644
--- a/src/content/docs/es/guides/markdown-content.mdx
+++ b/src/content/docs/es/guides/markdown-content.mdx
@@ -65,7 +65,7 @@ Astro provee algunas características adicionales incorporadas disponibles a la
 
 ### `layout` en el Frontmatter
 
-Astro provee a [las páginas de Markdown y MDX](/es/basics/astro-pages/#páginas-markdownmdx) (localizadas en `src/pages/`) una propiedad especial en el frontmatter para `layout` que define la ruta relativa (o un [alias](/es/guides/aliases/)) a un [componente plantilla](/es/basics/layouts/) de Astro.
+Astro provee a [las páginas de Markdown y MDX](/es/basics/astro-pages/#páginas-markdownmdx) (localizadas en `src/pages/`) una propiedad especial en el frontmatter para `layout` que define la ruta relativa (o un [alias](/es/guides/imports/#aliases)) a un [componente plantilla](/es/basics/layouts/) de Astro.
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/es/guides/typescript.mdx b/src/content/docs/es/guides/typescript.mdx
index 2462bc2118880..0f0dd9f9aa78e 100644
--- a/src/content/docs/es/guides/typescript.mdx
+++ b/src/content/docs/es/guides/typescript.mdx
@@ -95,7 +95,7 @@ Puedes configurar TypeScript para que obligue a realizar importaciones de tipos
 
 ## Alias de importación
 
-Astro es compatible con [alias de importación](/es/guides/aliases/) definidos en la configuración `tsconfig.json` o `jsconfig.json` usando `paths`. [Lee nuestra guía](/es/guides/aliases/) para saber más.
+Astro es compatible con [alias de importación](/es/guides/imports/#aliases) definidos en la configuración `tsconfig.json` o `jsconfig.json` usando `paths`. [Lee nuestra guía](/es/guides/imports/#aliases) para saber más.
 
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/es/install-and-setup.mdx b/src/content/docs/es/install-and-setup.mdx
index d17421940259f..5bcf0d77b9c45 100644
--- a/src/content/docs/es/install-and-setup.mdx
+++ b/src/content/docs/es/install-and-setup.mdx
@@ -406,7 +406,7 @@ Aquí te dejamos algunas sugerencias para explorar a continuación. Puedes leerl
   <LinkCard
     title="Alias de importación"
     description="Crea accesos directos convenientes para tus importaciones de archivos."
-    href="/es/guides/aliases/"
+    href="/es/guides/imports/#aliases"
   />
   <LinkCard
     title="Variables de entorno"
diff --git a/src/content/docs/fr/guides/images.mdx b/src/content/docs/fr/guides/images.mdx
index 6c29f07f81148..597f7d7c5d8e7 100644
--- a/src/content/docs/fr/guides/images.mdx
+++ b/src/content/docs/fr/guides/images.mdx
@@ -96,7 +96,7 @@ import myImage from '../assets/my_image.png'; // Image est en 1600x900
 
 Le format de la valeur `src` de votre fichier image dépend de l'endroit où se trouve votre fichier image :
 
-- **Images locales dans `src/`** - vous devez **aussi importer l'image** en utilisant un chemin de fichier relatif ou configurer et utiliser un [alias d'importation](/fr/guides/aliases/). Utilisez ensuite le nom de l'importation comme valeur `src` :
+- **Images locales dans `src/`** - vous devez **aussi importer l'image** en utilisant un chemin de fichier relatif ou configurer et utiliser un [alias d'importation](/fr/guides/imports/#aliases). Utilisez ensuite le nom de l'importation comme valeur `src` :
 
   ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
   ---
@@ -406,7 +406,7 @@ Elle accepte toutes les propriétés de la balise HTML `<img>` , et la seule pro
 
 #### Images locales dans `src/`
 
-Les images locales doivent être **importées à partir du chemin relatif** du fichier `.astro` existant, ou configurer et utiliser un [alias d'importation]](/fr/guides/aliases/). Ensuite, vous pouvez accéder au `src` de l'image et à d'autres propriétés à utiliser dans la balise `<img>`.
+Les images locales doivent être **importées à partir du chemin relatif** du fichier `.astro` existant, ou configurer et utiliser un [alias d'importation]](/fr/guides/imports/#aliases). Ensuite, vous pouvez accéder au `src` de l'image et à d'autres propriétés à utiliser dans la balise `<img>`.
 
 Par exemple, utilisez les propriétés `height` et `width` de l'image pour éviter le CLS et améliorer Core Web Vitals.
 
@@ -782,7 +782,7 @@ Si nécessaire, mettez également à jour votre fichier `src/env.d.ts` pour remp
 
 #### Supprimer l'alias d'importation `~/assets`
 
-Cet alias d'importation n'est plus inclus par défaut avec `astro:assets`. Si vous utilisiez cet alias avec des actifs expérimentaux, vous devez les convertir en chemins de fichiers relatifs, ou [créer vos propres alias d'importation](/fr/guides/aliases/).
+Cet alias d'importation n'est plus inclus par défaut avec `astro:assets`. Si vous utilisiez cet alias avec des actifs expérimentaux, vous devez les convertir en chemins de fichiers relatifs, ou [créer vos propres alias d'importation](/fr/guides/imports/#aliases).
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/fr/guides/markdown-content.mdx b/src/content/docs/fr/guides/markdown-content.mdx
index b4d7c32d0461b..92a8c990b0a0c 100644
--- a/src/content/docs/fr/guides/markdown-content.mdx
+++ b/src/content/docs/fr/guides/markdown-content.mdx
@@ -68,7 +68,7 @@ Astro offre quelques fonctions Markdown supplémentaires intégrées, disponible
 
 ### Frontmatter `layout`
 
-Astro fournit des [pages Markdown et MDX](/fr/basics/astro-pages/#pages-markdownmdx) (situées dans `src/pages/`) avec une propriété spéciale `layout` qui peut spécifier un chemin relatif (ou [alias](/fr/guides/aliases/)) vers un [composant de mise en page](/fr/basics/layouts/#mises-en-page-markdownmdx) Astro.
+Astro fournit des [pages Markdown et MDX](/fr/basics/astro-pages/#pages-markdownmdx) (situées dans `src/pages/`) avec une propriété spéciale `layout` qui peut spécifier un chemin relatif (ou [alias](/fr/guides/imports/#aliases)) vers un [composant de mise en page](/fr/basics/layouts/#mises-en-page-markdownmdx) Astro.
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/fr/guides/typescript.mdx b/src/content/docs/fr/guides/typescript.mdx
index 3e8ee9ce2a18c..d6edf36478166 100644
--- a/src/content/docs/fr/guides/typescript.mdx
+++ b/src/content/docs/fr/guides/typescript.mdx
@@ -95,7 +95,7 @@ Vous pouvez configurer TypeScript pour qu'il applique les importations de types
 
 ## Alias d'importation
 
-Astro supporte les [alias d'importation](/fr/guides/aliases/) que vous définissez dans votre configuration `tsconfig.json` & `jsconfig.json` `paths`. [Lisez notre guide](/fr/guides/aliases/) pour en savoir plus.
+Astro supporte les [alias d'importation](/fr/guides/imports/#aliases) que vous définissez dans votre configuration `tsconfig.json` & `jsconfig.json` `paths`. [Lisez notre guide](/fr/guides/imports/#aliases) pour en savoir plus.
 
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/ja/guides/images.mdx b/src/content/docs/ja/guides/images.mdx
index d7dcc5c42f524..473ae28031f45 100644
--- a/src/content/docs/ja/guides/images.mdx
+++ b/src/content/docs/ja/guides/images.mdx
@@ -95,7 +95,7 @@ import myImage from "../assets/my_image.png"; // 画像は1600x900
 
 画像ファイルの`src`値の形式は、画像ファイルの場所によって異なります。
 
-- **`src/`内のローカル画像** - 相対ファイルパスを使用するか、または[インポートエイリアス](/ja/guides/aliases/)を設定して**、画像もインポート**する必要があります。インポート名を`src`値として使用します。
+- **`src/`内のローカル画像** - 相対ファイルパスを使用するか、または[インポートエイリアス](/ja/guides/imports/#aliases)を設定して**、画像もインポート**する必要があります。インポート名を`src`値として使用します。
 
   ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
   ---
@@ -372,7 +372,7 @@ import myImage from "../my_image.png"; // 画像は1600x900
 
 #### `src/`内のローカル画像
 
-ローカル画像は、`.astro`ファイルからの相対パスにより**インポート**するか、[インポートエイリアス](/ja/guides/aliases/)を設定して使用する必要があります。これにより、`<img>`タグで使用する画像の`src`やその他のプロパティにアクセスできます。
+ローカル画像は、`.astro`ファイルからの相対パスにより**インポート**するか、[インポートエイリアス](/ja/guides/imports/#aliases)を設定して使用する必要があります。これにより、`<img>`タグで使用する画像の`src`やその他のプロパティにアクセスできます。
 
 たとえば、CLSを回避しCore Web Vitalsを改善するために、画像の`height`と`width`プロパティを使用します。
 
@@ -743,7 +743,7 @@ export default defineConfig({
 
 #### `~/assets`インポートエイリアスの削除
 
-このImportエイリアスは、`astro:assets`にデフォルトで含まれなくなりました。実験的なアセット機能でこのエイリアスを使用していた場合は、相対ファイルパスに変換するか、[自分でImportエイリアスを作成](/ja/guides/aliases/)する必要があります。
+このImportエイリアスは、`astro:assets`にデフォルトで含まれなくなりました。実験的なアセット機能でこのエイリアスを使用していた場合は、相対ファイルパスに変換するか、[自分でImportエイリアスを作成](/ja/guides/imports/#aliases)する必要があります。
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/ja/guides/markdown-content.mdx b/src/content/docs/ja/guides/markdown-content.mdx
index a697a6aabf665..634519fce4396 100644
--- a/src/content/docs/ja/guides/markdown-content.mdx
+++ b/src/content/docs/ja/guides/markdown-content.mdx
@@ -63,7 +63,7 @@ Astroは、MarkdownとMDXファイルを使用する際に利用できる、追
 
 ### フロントマター `layout`
 
-Astroは、MarkdownおよびMDXページに、Astro[レイアウトコンポーネント](/ja/basics/layouts/#markdownとmdxのレイアウト)への相対パス（または[エイリアス](/ja/guides/aliases/)）を指定できる特別なフロントマター用の`layout`プロパティを提供します。
+Astroは、MarkdownおよびMDXページに、Astro[レイアウトコンポーネント](/ja/basics/layouts/#markdownとmdxのレイアウト)への相対パス（または[エイリアス](/ja/guides/imports/#aliases)）を指定できる特別なフロントマター用の`layout`プロパティを提供します。
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/ja/guides/typescript.mdx b/src/content/docs/ja/guides/typescript.mdx
index 1642369a5f1f5..9716669088e8f 100644
--- a/src/content/docs/ja/guides/typescript.mdx
+++ b/src/content/docs/ja/guides/typescript.mdx
@@ -96,7 +96,7 @@ import type { SomeType } from './script';
 
 ## Importエイリアス
 
-Astroは、`tsconfig.json`と`jsconfig.json`の`paths`設定で定義する[importエイリアス](/ja/guides/aliases/)をサポートしています。詳しくは[ガイド](/ja/guides/aliases/)をご覧ください。
+Astroは、`tsconfig.json`と`jsconfig.json`の`paths`設定で定義する[importエイリアス](/ja/guides/imports/#aliases)をサポートしています。詳しくは[ガイド](/ja/guides/imports/#aliases)をご覧ください。
 
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/ko/guides/images.mdx b/src/content/docs/ko/guides/images.mdx
index f64d66833f31f..b1389f156401e 100644
--- a/src/content/docs/ko/guides/images.mdx
+++ b/src/content/docs/ko/guides/images.mdx
@@ -95,7 +95,7 @@ import myImage from '../assets/my_image.png'; // 1600x900의 이미지
 
 이미지 파일의 `src` 값 형식은 이미지 파일의 위치에 따라 다릅니다.
 
-- **`src/`의 로컬 이미지** - 상대 파일 경로를 사용하여 **이미지도 가져오거나** [가져오기 별칭](/ko/guides/aliases/)을 구성하고 사용해야 합니다. 그런 다음 가져오기 이름을 `src` 값으로 사용합니다.
+- **`src/`의 로컬 이미지** - 상대 파일 경로를 사용하여 **이미지도 가져오거나** [가져오기 별칭](/ko/guides/imports/#aliases)을 구성하고 사용해야 합니다. 그런 다음 가져오기 이름을 `src` 값으로 사용합니다.
 
   ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
   ---
@@ -404,7 +404,7 @@ import myImage from "../my_image.png"; // 1600x900의 이미지
 
 #### `src/`의 로컬 이미지
 
-로컬 이미지는 기존 `.astro` 파일의 **상대 경로에서 가져오거나** [가져오기 별칭](/ko/guides/aliases/)을 구성하고 사용해야 합니다. 그런 다음 이미지의 `src` 및 `<img>` 태그에 사용할 기타 속성에 액세스할 수 있습니다.
+로컬 이미지는 기존 `.astro` 파일의 **상대 경로에서 가져오거나** [가져오기 별칭](/ko/guides/imports/#aliases)을 구성하고 사용해야 합니다. 그런 다음 이미지의 `src` 및 `<img>` 태그에 사용할 기타 속성에 액세스할 수 있습니다.
 
 예를 들어, CLS를 방지하고 Core Web Vitals를 개선하려면 이미지 자체의 `height` 및 `width` 속성을 사용하세요.
 
@@ -778,7 +778,7 @@ export default defineConfig({
 
 #### `~/assets` 가져오기 별칭 제거
 
-이 가져오기 별칭은 더 이상 `astro:assets`에 기본적으로 포함되지 않습니다. 실험적 자산과 함께 이 별칭을 사용하는 경우 이를 상대 파일 경로로 변환하거나 [자신만의 가져오기 별칭을 생성](/ko/guides/aliases/)해야 합니다.
+이 가져오기 별칭은 더 이상 `astro:assets`에 기본적으로 포함되지 않습니다. 실험적 자산과 함께 이 별칭을 사용하는 경우 이를 상대 파일 경로로 변환하거나 [자신만의 가져오기 별칭을 생성](/ko/guides/imports/#aliases)해야 합니다.
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/ko/guides/markdown-content.mdx b/src/content/docs/ko/guides/markdown-content.mdx
index bc6eb62dbbefe..1c200bc7fa9ec 100644
--- a/src/content/docs/ko/guides/markdown-content.mdx
+++ b/src/content/docs/ko/guides/markdown-content.mdx
@@ -64,7 +64,7 @@ Astro는 Markdown 및 MDX 파일을 사용할 때 사용할 수 있는 몇 가
 
 ### 프런트매터 `layout`
 
-Astro는 Astro [레이아웃 컴포넌트](/ko/basics/layouts/#markdownmdx-레이아웃)에 대한 상대 경로 (또는 [별칭](/ko/guides/aliases/))를 지정할 수 있는 특별한 프런트매터 `layout` 속성이 있는 [Markdown 및 MDX 페이지](/ko/basics/astro-pages/#markdownmdx-페이지) (`src/pages/`에 위치하는)를 제공합니다.
+Astro는 Astro [레이아웃 컴포넌트](/ko/basics/layouts/#markdownmdx-레이아웃)에 대한 상대 경로 (또는 [별칭](/ko/guides/imports/#aliases))를 지정할 수 있는 특별한 프런트매터 `layout` 속성이 있는 [Markdown 및 MDX 페이지](/ko/basics/astro-pages/#markdownmdx-페이지) (`src/pages/`에 위치하는)를 제공합니다.
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/ko/guides/typescript.mdx b/src/content/docs/ko/guides/typescript.mdx
index 10156283d91fd..484dcb74d8d3e 100644
--- a/src/content/docs/ko/guides/typescript.mdx
+++ b/src/content/docs/ko/guides/typescript.mdx
@@ -98,7 +98,7 @@ TypeScript는 가져오기를 확인하고 `import type`을 사용해야 하는
 
 ## 가져오기 별칭
 
-Astro는 `tsconfig.json` 및 `jsconfig.json` 파일의 `paths` 구성에서 설정할 수 있는 [가져오기 별칭](/ko/guides/aliases/)을 지원합니다. 자세한 내용은 [안내서](/ko/guides/aliases/)를 확인하세요.
+Astro는 `tsconfig.json` 및 `jsconfig.json` 파일의 `paths` 구성에서 설정할 수 있는 [가져오기 별칭](/ko/guides/imports/#aliases)을 지원합니다. 자세한 내용은 [안내서](/ko/guides/imports/#aliases)를 확인하세요.
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
 ---
diff --git a/src/content/docs/ko/install-and-setup.mdx b/src/content/docs/ko/install-and-setup.mdx
index 17508981e1fac..f948f9011fb84 100644
--- a/src/content/docs/ko/install-and-setup.mdx
+++ b/src/content/docs/ko/install-and-setup.mdx
@@ -408,7 +408,7 @@ Astro는 배포 가능한 버전의 사이트를 별도의 폴더 (기본적으
   <LinkCard
     title="가져오기 별칭"
     description="파일 가져오기를 위한 편리한 바로가기를 만드세요."
-    href="/ko/guides/aliases/"
+    href="/ko/guides/imports/#aliases"
   />
   <LinkCard
     title="환경 변수"
@@ -420,4 +420,4 @@ Astro는 배포 가능한 버전의 사이트를 별도의 폴더 (기본적으
     description="개발 툴바의 유용한 기능을 살펴보세요."
     href="/ko/guides/dev-toolbar/"
   />
-</CardGrid>
\ No newline at end of file
+</CardGrid>
diff --git a/src/content/docs/pt-br/guides/images.mdx b/src/content/docs/pt-br/guides/images.mdx
index 44574b4981ada..d881542626996 100644
--- a/src/content/docs/pt-br/guides/images.mdx
+++ b/src/content/docs/pt-br/guides/images.mdx
@@ -95,7 +95,7 @@ import minhaImagem from "../assets/minha_imagem.png"; // Imagem é 1600x900
 
 O formato do valor `src` de sua imagem depende de onde o seu arquivo de imagem está localizado:
 
-- **Imagens locais em `src/`** - você deve **também importar a imagem** utilizando um caminho de arquivo relativo ou configurar e utilizar um [atalho de importação](/pt-br/guides/aliases/). Então, utilize o nome de importação como o valor de `src`:
+- **Imagens locais em `src/`** - você deve **também importar a imagem** utilizando um caminho de arquivo relativo ou configurar e utilizar um [atalho de importação](/pt-br/guides/imports/#aliases). Então, utilize o nome de importação como o valor de `src`:
 
   ```astro title="src/pages/index.astro" "minhaImagemImportada" "{minhaImagemImportada}"
   ---
@@ -405,7 +405,7 @@ Ela aceita todas as propriedades da tag HTML `<img>`, e a única propriedade obr
 
 #### Imagens locais em `src/`
 
-Imagens locais devem ser **importadas de seu caminho relativo** a partir do arquivo `.astro` existente, ou configure e utilize um [atalho de importação](/pt-br/guides/aliases/). Então, você pode acessar o `src` da imagem e outras propriedades para utilizar na tag `<img>`.
+Imagens locais devem ser **importadas de seu caminho relativo** a partir do arquivo `.astro` existente, ou configure e utilize um [atalho de importação](/pt-br/guides/imports/#aliases). Então, você pode acessar o `src` da imagem e outras propriedades para utilizar na tag `<img>`.
 
 Por exemplo, utilize as propriedades `height` e `width` da imagem para evitar CLS e melhorar os Core Web Vitals.
 
@@ -780,7 +780,7 @@ Se necessário, também atualize seu arquivo `src/env.d.ts` para substituir a re
 
 #### Remova o atalho de importação `~/assets`
 
-Esse atalho de importação não é mais incluído por padrão com `astro:assets`. Se você estava utilizando esse atalho com assets experimentais, você deve convertê-los em caminhos de arquivo relativos ou [criar seu próprio atalho de importação](/pt-br/guides/aliases/).
+Esse atalho de importação não é mais incluído por padrão com `astro:assets`. Se você estava utilizando esse atalho com assets experimentais, você deve convertê-los em caminhos de arquivo relativos ou [criar seu próprio atalho de importação](/pt-br/guides/imports/#aliases).
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/pt-br/guides/markdown-content.mdx b/src/content/docs/pt-br/guides/markdown-content.mdx
index 8e0e818232948..fbc6662f75c85 100644
--- a/src/content/docs/pt-br/guides/markdown-content.mdx
+++ b/src/content/docs/pt-br/guides/markdown-content.mdx
@@ -65,7 +65,7 @@ Astro providencia algumas funcionalidades extras integradas ao Markdown, dispon
 
 ### Frontmatter `layout`
 
-Astro fornece páginas Markdown e MDX com a propriedade frontmatter especial `layout`, que pode especificar o caminho relativo (ou [atalho](/pt-br/guides/aliases/)) para um [componente de layout](/pt-br/basics/layouts/#layouts-markdownmdx) Astro.
+Astro fornece páginas Markdown e MDX com a propriedade frontmatter especial `layout`, que pode especificar o caminho relativo (ou [atalho](/pt-br/guides/imports/#aliases)) para um [componente de layout](/pt-br/basics/layouts/#layouts-markdownmdx) Astro.
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/pt-br/guides/typescript.mdx b/src/content/docs/pt-br/guides/typescript.mdx
index 5bb3c77a32a62..e0b22ba97a297 100644
--- a/src/content/docs/pt-br/guides/typescript.mdx
+++ b/src/content/docs/pt-br/guides/typescript.mdx
@@ -95,7 +95,7 @@ Você pode configurar o TypeScript para reforçar importações de tipos no seu
 
 ## Aliases de Importação
 
-Astro suporta [aliases de importação](/pt-br/guides/aliases/) que você define na configuração `paths` do seu `tsconfig.json` e `jsconfig.json`. [Leia nosso guia](/pt-br/guides/aliases/) para aprender mais.
+Astro suporta [aliases de importação](/pt-br/guides/imports/#aliases) que você define na configuração `paths` do seu `tsconfig.json` e `jsconfig.json`. [Leia nosso guia](/pt-br/guides/imports/#aliases) para aprender mais.
 
 
 ```astro title="src/pages/sobre/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/ru/guides/markdown-content.mdx b/src/content/docs/ru/guides/markdown-content.mdx
index ba7551c096c03..614872643f882 100644
--- a/src/content/docs/ru/guides/markdown-content.mdx
+++ b/src/content/docs/ru/guides/markdown-content.mdx
@@ -68,7 +68,7 @@ Astro предоставляет некоторые дополнительные
 
 ### Frontmatter `layout`
 
-Astro предоставляет [страницам Markdown и MDX](/ru/basics/astro-pages/#markdownmdx-страницы) (расположенным в `src/pages/`) специальное свойство frontmatter `layout`, которое может указывать относительный путь (или [псевдоним](/ru/guides/aliases/)) к компоненту [макета Astro](/ru/basics/layouts/#markdownmdx-макеты).
+Astro предоставляет [страницам Markdown и MDX](/ru/basics/astro-pages/#markdownmdx-страницы) (расположенным в `src/pages/`) специальное свойство frontmatter `layout`, которое может указывать относительный путь (или [псевдоним](/ru/guides/imports/#aliases)) к компоненту [макета Astro](/ru/basics/layouts/#markdownmdx-макеты).
 
 ```markdown {3}
 ---
@@ -680,4 +680,4 @@ const markdown = await response.text();
 const content = marked.parse(markdown);
 ---
 <article set:html={content} />
-```
\ No newline at end of file
+```
diff --git a/src/content/docs/ru/guides/typescript.mdx b/src/content/docs/ru/guides/typescript.mdx
index e0e2ef956d8ef..c18b7bb9288ed 100644
--- a/src/content/docs/ru/guides/typescript.mdx
+++ b/src/content/docs/ru/guides/typescript.mdx
@@ -95,7 +95,7 @@ import type { SomeType } from './script';
 
 ## Импорт алиасов
 
-Astro поддерживает [импорт алиасов](/ru/guides/aliases/), которые вы определили в секции `paths` в файлах `tsconfig.json` и `jsconfig.json`. [Прочитайте наш гайд](/ru/guides/aliases/), чтобы узнать больше.
+Astro поддерживает [импорт алиасов](/ru/guides/imports/#aliases), которые вы определили в секции `paths` в файлах `tsconfig.json` и `jsconfig.json`. [Прочитайте наш гайд](/ru/guides/imports/#aliases), чтобы узнать больше.
 
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/zh-cn/guides/images.mdx b/src/content/docs/zh-cn/guides/images.mdx
index 9e0334c4007b8..e9758b9054350 100644
--- a/src/content/docs/zh-cn/guides/images.mdx
+++ b/src/content/docs/zh-cn/guides/images.mdx
@@ -93,7 +93,7 @@ import myImage from '../assets/my_image.png'; // Image is 1600x900
 
 图像文件的 `src` 值的格式取决于图像文件的位置：
 
-- **`src/` 中的本地图像** - 你必须**同时导入图像**，使用相对文件路径或配置并使用 [导入别名](/zh-cn/guides/aliases/)。然后使用导入名称作为 `src` 值：
+- **`src/` 中的本地图像** - 你必须**同时导入图像**，使用相对文件路径或配置并使用 [导入别名](/zh-cn/guides/imports/#aliases)。然后使用导入名称作为 `src` 值：
 
   ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
   ---
@@ -401,7 +401,7 @@ import myImage from "../my_image.png"; // 图像分辨率为 1600x900
 
 #### `src/` 中的本地图像
 
-本地图像必须从现有的 `.astro` 文件的相对路径**导入**，或者配置并使用 [导入别名](/zh-cn/guides/aliases/)。然后，你可以访问图像的 `src` 和其他属性，以在 `<img>` 标签中使用。
+本地图像必须从现有的 `.astro` 文件的相对路径**导入**，或者配置并使用 [导入别名](/zh-cn/guides/imports/#aliases)。然后，你可以访问图像的 `src` 和其他属性，以在 `<img>` 标签中使用。
 
 例如，使用图像自己的 `height` 和 `width` 属性，以避免布局位移累计 CLS 并改善核心 Web 性能指标。
 
@@ -776,7 +776,7 @@ export default defineConfig({
 
 #### 移除`~/assets` 导入别名
 
-这个导入别名不再默认包含在 `astro:assets` 中。如果你之前使用这个别名，你必须将它们转换为相对文件路径，或者 [创建你自己的导入别名](/zh-cn/guides/aliases/)。
+这个导入别名不再默认包含在 `astro:assets` 中。如果你之前使用这个别名，你必须将它们转换为相对文件路径，或者 [创建你自己的导入别名](/zh-cn/guides/imports/#aliases)。
 
 ```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
 ---
diff --git a/src/content/docs/zh-cn/guides/markdown-content.mdx b/src/content/docs/zh-cn/guides/markdown-content.mdx
index ccda308f9ccb5..337ddee5e3544 100644
--- a/src/content/docs/zh-cn/guides/markdown-content.mdx
+++ b/src/content/docs/zh-cn/guides/markdown-content.mdx
@@ -65,7 +65,7 @@ Astro 在使用 Markdown 和 MDX 文件时提供了一些额外的内置 Markdow
 
 ### Frontmatter `layout`
 
-Astro 为位于 `src/pages/` 中的 [Markdown 和 MDX 页面](/zh-cn/basics/astro-pages/#markdownmdx-页面) 提供了一个特殊的 frontmatter `layout` 属性，可以指定一个 Astro [布局组件](/zh-cn/basics/layouts/#markdownmdx-布局) 的相对路径（或 [别名](/zh-cn/guides/aliases/)）。
+Astro 为位于 `src/pages/` 中的 [Markdown 和 MDX 页面](/zh-cn/basics/astro-pages/#markdownmdx-页面) 提供了一个特殊的 frontmatter `layout` 属性，可以指定一个 Astro [布局组件](/zh-cn/basics/layouts/#markdownmdx-布局) 的相对路径（或 [别名](/zh-cn/guides/imports/#aliases)）。
 
 ```markdown {3}
 ---
diff --git a/src/content/docs/zh-cn/guides/typescript.mdx b/src/content/docs/zh-cn/guides/typescript.mdx
index 9a76ef56f21fc..99c7e7d94798b 100644
--- a/src/content/docs/zh-cn/guides/typescript.mdx
+++ b/src/content/docs/zh-cn/guides/typescript.mdx
@@ -94,7 +94,7 @@ import type { SomeType } from './script';
 
 ## 导入别名
 
-Astro 支持你在 `tsconfig.json` 和 `jsconfig.json` 文件里的 `paths` 配置所定义的 [导入别名](/zh-cn/guides/aliases/)。[阅读我们的指南](/zh-cn/guides/aliases/)以了解更多。
+Astro 支持你在 `tsconfig.json` 和 `jsconfig.json` 文件里的 `paths` 配置所定义的 [导入别名](/zh-cn/guides/imports/#aliases)。[阅读我们的指南](/zh-cn/guides/imports/#aliases)以了解更多。
 
 ```astro title="src/pages/about/nate.astro" "@components" "@layouts"
 ---
diff --git a/src/content/docs/zh-cn/install-and-setup.mdx b/src/content/docs/zh-cn/install-and-setup.mdx
index b2a15f6d2b7e8..cc38e998a3552 100644
--- a/src/content/docs/zh-cn/install-and-setup.mdx
+++ b/src/content/docs/zh-cn/install-and-setup.mdx
@@ -400,7 +400,7 @@ Astro 将在一个单独的文件夹（默认为 `dist/`）中构建你的网站
   <LinkCard
     title="导入别名"
     description="为你的文件导入创建方便的快捷方式。"
-    href="/zh-cn/guides/aliases/"
+    href="/zh-cn/guides/imports/#aliases"
   />
   <LinkCard
     title="环境变量"
@@ -412,4 +412,4 @@ Astro 将在一个单独的文件夹（默认为 `dist/`）中构建你的网站
     description="探索开发工具栏中好用的功能。"
     href="/zh-cn/guides/dev-toolbar/"
   />
-</CardGrid>
\ No newline at end of file
+</CardGrid>

From ff71cba83d02865b530160eac0cb4a7db98532ab Mon Sep 17 00:00:00 2001
From: Sarah Rainsberger <sarah@rainsberger.ca>
Date: Thu, 13 Jun 2024 16:04:17 +0000
Subject: [PATCH 3/4] added redirect, started to move some pages into old
 translations

---
 {src/content/docs => old-translations}/de/guides/aliases.mdx | 0
 {src/content/docs => old-translations}/es/guides/aliases.mdx | 0
 vercel.json                                                  | 2 ++
 3 files changed, 2 insertions(+)
 rename {src/content/docs => old-translations}/de/guides/aliases.mdx (100%)
 rename {src/content/docs => old-translations}/es/guides/aliases.mdx (100%)

diff --git a/src/content/docs/de/guides/aliases.mdx b/old-translations/de/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/de/guides/aliases.mdx
rename to old-translations/de/guides/aliases.mdx
diff --git a/src/content/docs/es/guides/aliases.mdx b/old-translations/es/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/es/guides/aliases.mdx
rename to old-translations/es/guides/aliases.mdx
diff --git a/vercel.json b/vercel.json
index 2af1a05b71cff..fae7b54048d47 100644
--- a/vercel.json
+++ b/vercel.json
@@ -108,6 +108,8 @@
 
     { "source": "/:lang/guides/assets/", "destination": "/:lang/guides/images/" },
 
+    { "source": "/:lang/guides/aliases/", "destination": "/:lang/guides/imports/" },
+
     { "source": "/:lang/guides/integrations-guide/image/", "destination": "/:lang/guides/images/" },
 
     { "source": "/:lang/migration/0.21.0", "destination": "/:lang/guides/upgrade-to/v1/" },

From b6a87368daa5e3b8a6b2bf0f8aece4f44cf368d6 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar <kzunigac@uvm.edu>
Date: Thu, 13 Jun 2024 12:27:21 -0400
Subject: [PATCH 4/4] move aliases to old translations

---
 {src/content/docs => old-translations}/fr/guides/aliases.mdx      | 0
 {src/content/docs => old-translations}/ja/guides/aliases.mdx      | 0
 {src/content/docs => old-translations}/ko/guides/aliases.mdx      | 0
 {src/content/docs => old-translations}/pl/guides/aliases.mdx      | 0
 {src/content/docs => old-translations}/pt-br/guides/aliases.mdx   | 0
 {src/content/docs => old-translations}/ru/guides/aliases.mdx      | 0
 .../docs/zh-cn => old-translations/zh-CN}/guides/aliases.mdx      | 0
 7 files changed, 0 insertions(+), 0 deletions(-)
 rename {src/content/docs => old-translations}/fr/guides/aliases.mdx (100%)
 rename {src/content/docs => old-translations}/ja/guides/aliases.mdx (100%)
 rename {src/content/docs => old-translations}/ko/guides/aliases.mdx (100%)
 rename {src/content/docs => old-translations}/pl/guides/aliases.mdx (100%)
 rename {src/content/docs => old-translations}/pt-br/guides/aliases.mdx (100%)
 rename {src/content/docs => old-translations}/ru/guides/aliases.mdx (100%)
 rename {src/content/docs/zh-cn => old-translations/zh-CN}/guides/aliases.mdx (100%)

diff --git a/src/content/docs/fr/guides/aliases.mdx b/old-translations/fr/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/fr/guides/aliases.mdx
rename to old-translations/fr/guides/aliases.mdx
diff --git a/src/content/docs/ja/guides/aliases.mdx b/old-translations/ja/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/ja/guides/aliases.mdx
rename to old-translations/ja/guides/aliases.mdx
diff --git a/src/content/docs/ko/guides/aliases.mdx b/old-translations/ko/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/ko/guides/aliases.mdx
rename to old-translations/ko/guides/aliases.mdx
diff --git a/src/content/docs/pl/guides/aliases.mdx b/old-translations/pl/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/pl/guides/aliases.mdx
rename to old-translations/pl/guides/aliases.mdx
diff --git a/src/content/docs/pt-br/guides/aliases.mdx b/old-translations/pt-br/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/pt-br/guides/aliases.mdx
rename to old-translations/pt-br/guides/aliases.mdx
diff --git a/src/content/docs/ru/guides/aliases.mdx b/old-translations/ru/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/ru/guides/aliases.mdx
rename to old-translations/ru/guides/aliases.mdx
diff --git a/src/content/docs/zh-cn/guides/aliases.mdx b/old-translations/zh-CN/guides/aliases.mdx
similarity index 100%
rename from src/content/docs/zh-cn/guides/aliases.mdx
rename to old-translations/zh-CN/guides/aliases.mdx