diff --git a/src/content/docs/en/basics/project-structure.mdx b/src/content/docs/en/basics/project-structure.mdx
index b2843eab2c7fb..a88a362fa841b 100644
--- a/src/content/docs/en/basics/project-structure.mdx
+++ b/src/content/docs/en/basics/project-structure.mdx
@@ -112,7 +112,7 @@ This is a file used by JavaScript package managers to manage your dependencies.
There are [two kinds of dependencies](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) you can specify in a `package.json`: `dependencies` and `devDependencies`. In most cases, these work the same: Astro needs all dependencies at build time, and your package manager will install both. We recommend putting all of your dependencies in `dependencies` to start, and only use `devDependencies` if you find a specific need to do so.
-For help creating a new `package.json` file for your project, check out the [manual setup](/en/install/manual/) instructions.
+For help creating a new `package.json` file for your project, check out the [manual setup](/en/install-and-setup/#manual-setup) instructions.
### `astro.config.mjs`
diff --git a/src/content/docs/en/community-resources/content.mdx b/src/content/docs/en/community-resources/content.mdx
index f33c153f61800..a15bb96f80c6c 100644
--- a/src/content/docs/en/community-resources/content.mdx
+++ b/src/content/docs/en/community-resources/content.mdx
@@ -36,14 +36,18 @@ Check out the following courses and tutorials to learn more about Astro.
## Recipes and Guides
-See guided examples of adding features to your Astro project, submitted by our community members!
+import RecipesNav from '~/components/RecipesNav.astro';
-[Astro recipes](/en/recipes/) are typically short, focused how-to guides that walk a reader through completing a working example of a specific task. Recipes are a great way to add new features or behavior to your Astro project by following step-by-step instructions!
+See guided examples of adding features to your Astro project.
-Other guides might explain concepts related to an area of content, such as using images or working with MDX.
+### Official Recipes
+
+Astro's official recipes are short, focused how-to guides that walk a reader through completing a working example of a specific task. Recipes are a great way to add new features or behavior to your Astro project by following step-by-step instructions!
+
+
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/cms/apostrophecms.mdx b/src/content/docs/en/guides/cms/apostrophecms.mdx
index 885fa2abb47dc..ac29a4d50cdbf 100644
--- a/src/content/docs/en/guides/cms/apostrophecms.mdx
+++ b/src/content/docs/en/guides/cms/apostrophecms.mdx
@@ -19,7 +19,7 @@ In this section, you will use the [Apostrophe integration](https://apostrophecms
To get started, you will need to have the following:
-1. **An on-demand rendered Astro project** with the [Node.js adapter](/en/guides/integrations-guide/node/) installed and `output: 'server'` configured - If you don't have an Astro project yet, our [installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An on-demand rendered Astro project** with the [Node.js adapter](/en/guides/integrations-guide/node/) installed and `output: 'server'` configured - If you don't have an Astro project yet, our [installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **An ApostropheCMS project with a configured environment variable called `APOS_EXTERNAL_FRONT_KEY`** - This environment variable can be set to any random string. If you don't have an ApostropheCMS project yet, the [installation guide](https://docs.apostrophecms.org/guide/development-setup.html) will get one setup quickly. We highly recommend using the [Apostrophe CLI tool](https://apostrophecms.com/extensions/apos-cli) to facilitate this.
diff --git a/src/content/docs/en/guides/cms/buttercms.mdx b/src/content/docs/en/guides/cms/buttercms.mdx
index 37f54260cd16c..9aab5933434fd 100644
--- a/src/content/docs/en/guides/cms/buttercms.mdx
+++ b/src/content/docs/en/guides/cms/buttercms.mdx
@@ -19,7 +19,7 @@ In this section, we'll use the [ButterCMS SDK](https://www.npmjs.com/package/but
To get started, you will need to have the following:
### Prerequisites
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A ButterCMS account**. If you don't have an account, you can [sign up](https://buttercms.com/join/) for a free trial.
diff --git a/src/content/docs/en/guides/cms/contentful.mdx b/src/content/docs/en/guides/cms/contentful.mdx
index 74da59ae156cd..7e98252a25820 100644
--- a/src/content/docs/en/guides/cms/contentful.mdx
+++ b/src/content/docs/en/guides/cms/contentful.mdx
@@ -19,7 +19,7 @@ In this section, we'll use the [Contentful SDK](https://github.com/contentful/co
To get started, you will need to have the following:
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A Contentful account and a Contentful space**. If you don't have an account, you can [sign up](https://www.contentful.com/sign-up/) for a free account and create a new Contentful space. You can also use an existing space if you have one.
diff --git a/src/content/docs/en/guides/cms/cosmic.mdx b/src/content/docs/en/guides/cms/cosmic.mdx
index d1c8a7279363f..c5aa5c1d41e4e 100644
--- a/src/content/docs/en/guides/cms/cosmic.mdx
+++ b/src/content/docs/en/guides/cms/cosmic.mdx
@@ -14,7 +14,7 @@ import { Steps } from '@astrojs/starlight/components';
## Prerequisites
-1. **An Astro project**- If you’d like to start with a fresh Astro project, read the [installation guide](/en/install/auto/). This guide follows a simplified version of the [Astro Headless CMS Theme](https://astro.build/themes/details/cosmic-cms-blog/) with [Tailwind CSS](https://tailwindcss.com/) for styling.
+1. **An Astro project**- If you’d like to start with a fresh Astro project, read the [installation guide](/en/install-and-setup/). This guide follows a simplified version of the [Astro Headless CMS Theme](https://astro.build/themes/details/cosmic-cms-blog/) with [Tailwind CSS](https://tailwindcss.com/) for styling.
2. **A Cosmic account and Bucket** - [Create a free Cosmic account](https://app.cosmicjs.com/signup) if you don’t have one. After creating your account, you'll be prompted to create a new empty project. There's also a [Simple Astro Blog template](https://www.cosmicjs.com/marketplace/templates/simple-astro-blog) available (this is the same template as the Astro Headless CMS Theme) to automatically import all of the content used in this guide.
3. **Your Cosmic API keys** - From your Cosmic dashboard, you will need to locate both the **Bucket slug** and **Bucket read key** in order to connect to Cosmic.
diff --git a/src/content/docs/en/guides/cms/datocms.mdx b/src/content/docs/en/guides/cms/datocms.mdx
index cdfbc972df9a9..45e6284c76bd9 100644
--- a/src/content/docs/en/guides/cms/datocms.mdx
+++ b/src/content/docs/en/guides/cms/datocms.mdx
@@ -19,7 +19,7 @@ In this guide, you will fetch content data from DatoCMS in your Astro project, t
To get started, you will need to have the following:
-- **An Astro project** - If you don’t have an Astro project yet, you can follow the instructions in our [Installation guide](/en/install/auto/).
+- **An Astro project** - If you don’t have an Astro project yet, you can follow the instructions in our [Installation guide](/en/install-and-setup/).
- **A DatoCMS account and project** - If you don't have an account, you can [sign up for a free account](https://dashboard.datocms.com/signup).
- **The read-only API Key for your DatoCMS project** - You can find it in the admin dashboard of your project, under "Settings" > "API Tokens".
diff --git a/src/content/docs/en/guides/cms/ghost.mdx b/src/content/docs/en/guides/cms/ghost.mdx
index 69ae78af31997..fda9e92fd82d2 100644
--- a/src/content/docs/en/guides/cms/ghost.mdx
+++ b/src/content/docs/en/guides/cms/ghost.mdx
@@ -18,7 +18,7 @@ In this section, we’ll use the [Ghost content API](https://ghost.org/docs/cont
### Prerequisites
To get started you will need to have the following:
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A Ghost site** - It is assumed that you have a site set up with Ghost. If you don't you can set one up on a [local environment.](https://ghost.org/docs/install/local/)
diff --git a/src/content/docs/en/guides/cms/hashnode.mdx b/src/content/docs/en/guides/cms/hashnode.mdx
index b8433f7a22a25..d624cdf1944ed 100644
--- a/src/content/docs/en/guides/cms/hashnode.mdx
+++ b/src/content/docs/en/guides/cms/hashnode.mdx
@@ -19,7 +19,7 @@ The [Hashnode Public API](https://apidocs.hashnode.com/) is a GraphQL API that a
### Prerequisites
To get started you will need to have the following:
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A Hashnode site** - You can create free personal site by visiting [Hashnode](https://hashnode.com/).
diff --git a/src/content/docs/en/guides/cms/payload.mdx b/src/content/docs/en/guides/cms/payload.mdx
index 29f24b4918716..0fdfc11510bd2 100644
--- a/src/content/docs/en/guides/cms/payload.mdx
+++ b/src/content/docs/en/guides/cms/payload.mdx
@@ -14,7 +14,7 @@ import { Steps } from '@astrojs/starlight/components';
### Prerequisites
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A MongoDB database** - PayloadCMS will ask you for a MongoDB connection string when creating a new project. You can set one up locally or use [MongoDBAtlas](https://www.mongodb.com/) to host a database on the web for free.
3. **A PayloadCMS REST API** - Create a [PayloadCMS](https://payloadcms.com/docs/getting-started/installation) project and connect it to your MongoDB database during the setup.
diff --git a/src/content/docs/en/guides/cms/statamic.mdx b/src/content/docs/en/guides/cms/statamic.mdx
index 3208a392ba44f..e0ebd2a8c7380 100644
--- a/src/content/docs/en/guides/cms/statamic.mdx
+++ b/src/content/docs/en/guides/cms/statamic.mdx
@@ -20,7 +20,7 @@ Statamic comes with a built-in [REST API](https://statamic.dev/rest-api) and [Gr
To get started, you will need to have the following:
1. REST API and GraphQL API are only available in a pro version of Statamic. You can try the Pro version free on your [local machine](https://statamic.dev/tips/how-to-enable-statamic-pro#trial-mode).
-2. **An Astro project** - If you still need an Astro project, our [Installation guide](/en/install/auto/) will get you up and running quickly.
+2. **An Astro project** - If you still need an Astro project, our [Installation guide](/en/install-and-setup/) will get you up and running quickly.
3. **A Statamic site** - If you need a Statamic website, [this guide](https://statamic.dev/quick-start-guide) will help you get started.
Remember to [enable REST API](https://statamic.dev/rest-api#enable-the-api) or [GraphQL API](https://statamic.dev/graphql#enable-graphql) by adding `STATAMIC_API_ENABLED=true` or `STATAMIC_GRAPHQL_ENABLED=true` in the `.env` file and enable required resources in the API configuration file.
diff --git a/src/content/docs/en/guides/cms/storyblok.mdx b/src/content/docs/en/guides/cms/storyblok.mdx
index e022153ba0862..90a6d99db96ce 100644
--- a/src/content/docs/en/guides/cms/storyblok.mdx
+++ b/src/content/docs/en/guides/cms/storyblok.mdx
@@ -20,7 +20,7 @@ In this section, you will use the [Storyblok integration](https://github.com/sto
To get started, you will need to have the following:
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A Storyblok account and space** - If you don't have an account yet, [sign up for free](https://app.storyblok.com/#/signup) and create a new space.
diff --git a/src/content/docs/en/guides/cms/strapi.mdx b/src/content/docs/en/guides/cms/strapi.mdx
index bc79d661c71c8..4ccfdfffeb0a7 100644
--- a/src/content/docs/en/guides/cms/strapi.mdx
+++ b/src/content/docs/en/guides/cms/strapi.mdx
@@ -20,7 +20,7 @@ This guide will build a wrapper function to connect Strapi with Astro.
To get started, you will need to have the following:
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A Strapi CMS server** - You can [set up a Strapi server on a local environment](https://docs.strapi.io/dev-docs/quick-start).
### Adding the Strapi URL in `.env`
diff --git a/src/content/docs/en/guides/cms/umbraco.mdx b/src/content/docs/en/guides/cms/umbraco.mdx
index 7e09ab5809751..9954d42a1ddb1 100644
--- a/src/content/docs/en/guides/cms/umbraco.mdx
+++ b/src/content/docs/en/guides/cms/umbraco.mdx
@@ -20,7 +20,7 @@ In this section you will use Umbraco's native [Content Delivery API](https://doc
To get started, you will need to have the following:
-1. **An Astro project** - If you don’t have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don’t have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **An Umbraco (v12+) project** - If you don’t have an Umbraco project yet, please see this [Installation guide](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/).
### Setting up the Content Delivery API
@@ -70,7 +70,7 @@ const articles = await res.json();
### Prerequisites
-- **An Astro project** - If you don’t have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+- **An Astro project** - If you don’t have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
- **An Umbraco project (v12+)** with the Content Delivery API enabled - Follow this [Installation guide](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/) to create a new project.
diff --git a/src/content/docs/en/guides/cms/wordpress.mdx b/src/content/docs/en/guides/cms/wordpress.mdx
index 1c348b6a25140..2547bb7b97df5 100644
--- a/src/content/docs/en/guides/cms/wordpress.mdx
+++ b/src/content/docs/en/guides/cms/wordpress.mdx
@@ -20,7 +20,7 @@ WordPress comes with a built-in [WordPress REST API](https://developer.wordpress
To get started, you will need to have the following:
-1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install/auto/) will get you up and running in no time.
+1. **An Astro project** - If you don't have an Astro project yet, our [Installation guide](/en/install-and-setup/) will get you up and running in no time.
2. **A WordPress site** - Your site's REST API is `[YOUR_SITE]/wp-json/wp/v2/` and is available by default with any WordPress site. It is also possible to [set up WordPress on a local environment](https://wordpress.org/support/article/installing-wordpress-on-your-own-computer/).
### Setting up Credentials
diff --git a/src/content/docs/en/guides/content.mdx b/src/content/docs/en/guides/content.mdx
index c9b1a556aa544..d799622c7a81a 100644
--- a/src/content/docs/en/guides/content.mdx
+++ b/src/content/docs/en/guides/content.mdx
@@ -29,7 +29,7 @@ Create and write a new `.md` file in your code editor or bring in an existing fi
Learn more about [writing Markdown content in Astro](/en/guides/markdown-content/).
### MDX Authoring
-If you add the MDX integration to your project, you can also write content using `.mdx` files, which let you include JavaScript expressions and custom components within your Markdown. This includes both static [Astro components](/en/basics/astro-components/) and interactive [framework components](/en/guides/framework-components/). Add UI elements such as a banner or an interactive carousel right in your text to turn your content into full-fledged web pages.
+If you add the [Astro MDX integration](/en/guides/integrations-guide/mdx/) to your project, you can also write content using `.mdx` files, which let you include JavaScript expressions and custom components within your Markdown. This includes both static [Astro components](/en/basics/astro-components/) and interactive [framework components](/en/guides/framework-components/). Add UI elements such as a banner or an interactive carousel right in your text to turn your content into full-fledged web pages.
Write and edit `.mdx` files directly in your code editor, alongside your project files.
@@ -39,20 +39,24 @@ Write and edit `.mdx` files directly in your code editor, alongside your project
Write blog posts in your existing Content Management System (CMS) such as Storyblok, WordPress, or Contentful. Some CMSes, like Storyblok, provide an official [Astro integration](https://www.storyblok.com/mp/announcing-storyblok-astro). Others expose a JavaScript SDK that Astro pages can use to [fetch your remote content](/en/guides/data-fetching/#fetch-from-a-headless-cms).
+Explore our collection of [CMS guides](/en/guides/cms/) and [Astro CMS integrations](https://astro.build/integrations/?search=cms) for a wide selection of resources.
+
## Managing content pages
Markdown and MDX files that live in your `src/pages` directory will automatically generate pages on your site using Astro's [file-based routing](/en/guides/routing/), built at a URL corresponding to the post's file path.
You can also choose to keep your Markdown and MDX files outside of the `src/pages` directory, and instead [import their content](/en/guides/markdown-content/#importing-markdown) into `.astro` pages.
+Astro's own [content collections](/en/guides/content-collections/) provide a powerful, type-safe way to work with your Markdown, MDX, or Markdoc content.
+
If you're writing your content in a CMS, you can fetch your posts and use [dynamic routing](/en/guides/routing/#dynamic-routes) to use one `.astro` file to generate a route for each post. In Astro's default static mode, these routes are generated at build time. If you opt-in to [SSR mode](/en/guides/server-side-rendering/), you respond to a request at runtime and fetch the content on demand.
## Showcasing your content
-To build common features to organize and display your content, such as a blog archive or a page for each blog tag, Astro allows you to [fetch filenames and metadata](/en/reference/api-reference/#astroglob) from your Markdown and MDX frontmatter and use these to generate page content and routes.
+To build common features to organize and display your content, such as a blog archive or a page for each blog tag, Astro allows you to [fetch filenames and metadata](/en/reference/api-reference/#astroglob) from your Markdown and MDX frontmatter or use [content collection helper utilities](/en/guides/content-collections/#querying-collections) to query your entries and generate page content and routes.
-![]()
` 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 `![]()
` 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 `![]()
` 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/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 `![]()
` 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.
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/migrate-to-astro/from-docusaurus.mdx b/src/content/docs/en/guides/migrate-to-astro/from-docusaurus.mdx
index 4f3865fa55086..5c13a45d37fc9 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-docusaurus.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-docusaurus.mdx
@@ -44,7 +44,7 @@ When you rebuild your Docusaurus site in Astro, you will notice some important d
To convert a Docusaurus documentation site to Astro, start with our official [Starlight docs theme starter template](https://starlight.astro.build), or explore more community docs themes in our [theme showcase](https://astro.build/themes?search=&categories%5B%5D=docs).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-eleventy.mdx b/src/content/docs/en/guides/migrate-to-astro/from-eleventy.mdx
index 197af5a1e14f7..d30227eadc468 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-eleventy.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-eleventy.mdx
@@ -35,7 +35,7 @@ When you rebuild your Eleventy (11ty) site in Astro, you will notice some import
To convert an Eleventy blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx b/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx
index 29f15c2552da6..feb581115eeb8 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx
@@ -43,7 +43,7 @@ Each project migration will look different, but there are some common actions yo
### Create a new Astro project
Use the `create astro` command for your package manager to launch Astro's CLI wizard or choose a community theme from the [Astro Theme Showcase](https://astro.build/themes).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters (e.g. `docs`, `blog`, `portfolio`). Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters (e.g. `docs`, `blog`, `portfolio`). Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-gitbook.mdx b/src/content/docs/en/guides/migrate-to-astro/from-gitbook.mdx
index 8d5d45feb37b0..ef10d6c45626a 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-gitbook.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-gitbook.mdx
@@ -35,7 +35,7 @@ When you migrate your GitBook docs to Astro, you will notice some important diff
To convert a GitBook documentation site to Astro, start with our official [Starlight docs theme starter template](https://starlight.astro.build), or explore more community docs themes in our [theme showcase](https://astro.build/themes?search=&categories%5B%5D=docs).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-gridsome.mdx b/src/content/docs/en/guides/migrate-to-astro/from-gridsome.mdx
index 2095e536ed211..cf92dc1283aec 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-gridsome.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-gridsome.mdx
@@ -37,7 +37,7 @@ When you rebuild your Gridsome site in Astro, you will notice some important dif
To convert a Gridsome blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-hugo.mdx b/src/content/docs/en/guides/migrate-to-astro/from-hugo.mdx
index acb62b8375d5e..1b996aa189397 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-hugo.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-hugo.mdx
@@ -37,7 +37,7 @@ When you rebuild your Hugo site in Astro, you will notice some important differe
To convert a Hugo blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-jekyll.mdx b/src/content/docs/en/guides/migrate-to-astro/from-jekyll.mdx
index 344876c09534f..7c2e89f7fea01 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-jekyll.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-jekyll.mdx
@@ -35,7 +35,7 @@ When you rebuild your Jekyll site in Astro, you will notice some important diffe
To convert a Jekyll blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx b/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx
index 86d3612704ad1..79a4691758f0b 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx
@@ -41,7 +41,7 @@ Each project migration will look different, but there are some common actions yo
Use the `create astro` command for your package manager to launch Astro's CLI wizard or choose a community theme from the [Astro Theme Showcase](https://astro.build/themes).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters (e.g. `docs`, `blog`, `portfolio`). Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters (e.g. `docs`, `blog`, `portfolio`). Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx b/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx
index 06441f92d22ff..9ed9ab851252f 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx
@@ -42,7 +42,7 @@ Each project migration will look different, but there are some common actions yo
### Create a new Astro project
Use the `create astro` command for your package manager to launch Astro's CLI wizard or choose a community theme from the [Astro Theme Showcase](https://astro.build/themes).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters (e.g. `docs`, `blog`, `portfolio`). Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters (e.g. `docs`, `blog`, `portfolio`). Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-pelican.mdx b/src/content/docs/en/guides/migrate-to-astro/from-pelican.mdx
index 70333a7ff27e0..1c7e2e0acb5a0 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-pelican.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-pelican.mdx
@@ -33,7 +33,7 @@ When you rebuild your Pelican site in Astro, you will notice some important diff
To convert a Pelican documentation site to Astro, start with our official [Starlight docs theme starter template](https://starlight.astro.build), or explore more community themes in our [theme showcase](https://astro.build/themes/).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-sveltekit.mdx b/src/content/docs/en/guides/migrate-to-astro/from-sveltekit.mdx
index 2c68924a1d54a..018d0ff727b91 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-sveltekit.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-sveltekit.mdx
@@ -40,7 +40,7 @@ When you rebuild your SvelteKit site in Astro, you will notice some important di
To convert a SvelteKit blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes/).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-vuepress.mdx b/src/content/docs/en/guides/migrate-to-astro/from-vuepress.mdx
index 89dbcc8360ab9..3f27f24754c13 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-vuepress.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-vuepress.mdx
@@ -35,7 +35,7 @@ When you rebuild your VuePress site in Astro, you will notice some important dif
To convert a VuePress documentation site to Astro, start with our official [Starlight docs theme starter template](https://starlight.astro.build), or explore more community docs themes in our [theme showcase](https://astro.build/themes?search=&categories%5B%5D=docs).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-wordpress.mdx b/src/content/docs/en/guides/migrate-to-astro/from-wordpress.mdx
index 21c2ba7f7f437..bfb4bdbfdd831 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-wordpress.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-wordpress.mdx
@@ -37,7 +37,7 @@ When you rebuild your WordPress site in Astro, you will notice some important di
To convert a WordPress blog to Astro, start with our blog theme starter template, or explore more community blog themes in our [theme showcase](https://astro.build/themes).
-You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install/auto/#starter-templates).
+You can pass a `--template` argument to the `create astro` command to start a new Astro project with one of our official starters. Or, you can [start a new project from any existing Astro repository on GitHub](/en/install-and-setup/#use-a-theme-or-starter-template).
diff --git a/src/content/docs/en/guides/rss.mdx b/src/content/docs/en/guides/rss.mdx
index 6f3bec6b1e2da..ba71b73d555bc 100644
--- a/src/content/docs/en/guides/rss.mdx
+++ b/src/content/docs/en/guides/rss.mdx
@@ -2,7 +2,6 @@
title: Add an RSS feed
description: Add an RSS feed to your Astro site to let users subscribe to your content.
i18nReady: true
-type: recipe
---
import Since from '~/components/Since.astro';
import { Steps } from '@astrojs/starlight/components';
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/auto.mdx b/src/content/docs/en/install/auto.mdx
deleted file mode 100644
index 3120dc4078ec4..0000000000000
--- a/src/content/docs/en/install/auto.mdx
+++ /dev/null
@@ -1,154 +0,0 @@
----
-title: Install Astro with the Automatic CLI
-description: 'How to install Astro with NPM, PNPM, or Yarn via the create-astro CLI tool.'
-i18nReady: true
----
-import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
-
-
-Ready to install Astro? Follow this guide to using the `create astro` CLI to get started.
-
-:::note[Prefer to install Astro manually?]
-Read our [step-by-step manual installation guide](/en/install/manual/) instead.
-:::
-#### Prerequisites
-
-- **Node.js** - `v18.17.1` or `v20.3.0` or higher. ( `v19` is not supported.)
-- **Text editor** - We recommend [VS Code](https://code.visualstudio.com/) with our [Official Astro extension](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode).
-- **Terminal** - Astro is accessed through its command-line interface (CLI).
-
-#### Installation
-
-`create astro` is the fastest way to start a new Astro project from scratch. It will walk you through every step of setting up your new Astro project. It allows you to choose from a few different official starter templates or you can [use any existing project on GitHub with the `--template` argument](#starter-templates).
-
-:::tip[Online previews]
-Prefer to try Astro in your browser? Visit [astro.new](https://astro.new/) to browse our starter templates and spin up a new Astro project without ever leaving your browser.
-:::
-
-## 1. Run the Setup Wizard
-
-Run the following command in your terminal to start our handy install wizard:
-
-
-
- ```shell
- # create a new project with npm
- npm create astro@latest
- ```
-
-
- ```shell
- # create a new project with pnpm
- pnpm create astro@latest
- ```
-
-
- ```shell
- # create a new project with yarn
- yarn create astro
- ```
-
-
-
-You can run `create astro` anywhere on your machine, so there's no need to create a new empty directory for your project before you begin. If you don't have an empty directory yet for your new project, the wizard will help create one for you automatically.
-
-If all goes well, you should see a "Liftoff confirmed. Explore your project!" message followed by some recommended next steps. `cd` into your new project directory to begin using Astro.
-
-If you skipped the `npm install` step during the CLI wizard, then be sure to install your dependencies before continuing.
-
-## 2. Start Astro ✨
-
-Astro comes with a built-in development server that has everything you need for project development. The `astro dev` command will start the local development server so that you can see your new website in action for the very first time.
-
-Every starter template comes with a pre-configured script that will run `astro dev` for you. Use your favorite package manager to run this command and start the Astro development server.
-
-
-
- ```shell
- npm run dev
- ```
-
-
- ```shell
- pnpm run dev
- ```
-
-
- ```shell
- yarn run dev
- ```
-
-
-
-
-If all goes well, Astro should now be serving your project on [http://localhost:4321/](http://localhost:4321/)!
-
-Astro will listen for live file changes in your `src/` directory, so you will not need to restart the server as you make changes during development.
-
-When viewing your site in the browser, you'll have access to the [Astro dev toolbar](/en/guides/dev-toolbar/). As you build, it will help you inspect your [islands](/en/concepts/islands/), spot accessibility issues, and more.
-
-If you aren't able to open your project in the browser, go back to the terminal where you ran the `dev` command and look to see if an error occurred, or if your project is being served at a different URL than the one linked to above.
-
-## Starter Templates
-
-You can also start a new astro project based on an [official example](https://github.com/withastro/astro/tree/main/examples) or the `main` branch of any GitHub repository by passing a `--template` argument to the `create astro` command.
-
-
-
- ```shell
- # create a new project with an official example
- npm create astro@latest -- --template
-
- # create a new project based on a GitHub repository’s main branch
- npm create astro@latest -- --template /
- ```
-
-
- ```shell
- # create a new project with an official example
- pnpm create astro@latest --template
-
- # create a new project based on a GitHub repository’s main branch
- pnpm create astro@latest --template /
- ```
-
-
- ```shell
- # create a new project with an official example
- yarn create astro --template
-
- # create a new project based on a GitHub repository’s main branch
- yarn create astro --template /
- ```
-
-
-
-By default, this command will use the template repository’s `main` branch. To use a different branch name, pass it as part of the `--template` argument: `/#`.
-
-Explore our [themes and starters showcase](https://astro.build/themes/) where you can browse themes for blogs, portfolios, documentation, landing pages, and more! Or, [search on GitHub](https://github.com/search?o=desc&q=astro+starter&s=stars&type=Repositories) for even more starter projects.
-
-## Next Steps
-
-Success! You are now ready to start building with Astro! 🥳
-
-Here are a few topics that we recommend exploring next. You can read them in any order. You can even leave our documentation for a bit and go play in your new Astro project codebase, coming back here whenever you run into trouble or have a question.
-
-import { CardGrid, LinkCard } from '@astrojs/starlight/components';
-
-
-
diff --git a/src/content/docs/en/install/manual.mdx b/src/content/docs/en/install/manual.mdx
deleted file mode 100644
index 476e661c63f07..0000000000000
--- a/src/content/docs/en/install/manual.mdx
+++ /dev/null
@@ -1,198 +0,0 @@
----
-title: Install Astro manually
-description: 'How to install Astro manually with NPM, PNPM, or Yarn.'
-i18nReady: true
----
-import Button from '~/components/Button.astro'
-import { FileTree } from '@astrojs/starlight/components';
-import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
-import ReadMore from '~/components/ReadMore.astro'
-
-This guide will walk you through the steps to manually install and configure a new Astro project.
-
-:::tip[Prefer a quicker way to get started?]
-Follow the [create astro CLI wizard](/en/install/auto/) instead.
-:::
-
-#### Prerequisites
-
-- **Node.js** - `v18.17.1` or `v20.3.0` or higher. ( `v19` is not supported.)
-- **Text editor** - We recommend [VS Code](https://code.visualstudio.com/) with our [Official Astro extension](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode).
-- **Terminal** - Astro is accessed through its command-line interface (CLI).
-
-#### Installation
-
-If you prefer not to use our automatic `create astro` CLI tool, you can set up your project yourself by following the guide below.
-
-## 1. Create your directory
-
-Create an empty directory with the name of your project, and then navigate into it.
-
-```bash
-mkdir my-astro-project
-cd my-astro-project
-```
-
-Once you are in your new directory, create your project `package.json` file. This is how you will manage your project dependencies, including Astro. If you aren't familiar with this file format, run the following command to create one.
-
-
-
- ```shell
- npm init --yes
- ```
-
-
- ```shell
- pnpm init
- ```
-
-
- ```shell
- yarn init --yes
- ```
-
-
-
-
-
-## 2. Install Astro
-
-First, install the Astro project dependencies inside your project.
-
-:::note[Important]
-Astro must be installed locally, not globally. Make sure you are *not* running `npm install -g astro` `pnpm add -g astro` or `yarn add global astro`.
-:::
-
-
-
- ```shell
- npm install astro
- ```
-
-
- ```shell
- pnpm add astro
- ```
-
-
- ```shell
- yarn add astro
- ```
-
-
-
-Then, replace any placeholder "scripts" section of your `package.json` with the following:
-
-```json title="package.json" del={2} ins={3-6}
- "scripts": {
- "test": "echo \"Error: no test specified\" && exit 1",
- "dev": "astro dev",
- "start": "astro dev",
- "build": "astro build",
- "preview": "astro preview"
- },
-```
-
-You'll use these scripts later in the guide to start Astro and run its different commands.
-
-## 3. Create your first page
-
-In your text editor, create a new file in your directory at `src/pages/index.astro`. This will be your first Astro page in the project.
-
-For this guide, copy-and-paste the following code snippet (including `---` dashes) into your new file:
-
-```astro title="src/pages/index.astro"
----
-// Welcome to Astro! Everything between these triple-dash code fences
-// is your "component frontmatter". It never runs in the browser.
-console.log('This runs in your terminal, not the browser!');
----
-
-
-
- Read Astro's [API configuration reference](/en/reference/configuration-reference/) for more information.
-
-## 6. Add TypeScript support
-
-TypeScript is configured using `tsconfig.json`. Even if you don’t write TypeScript code, this file is important so that tools like Astro and VS Code know how to understand your project. Some features (like npm package imports) aren’t fully supported in the editor without a `tsconfig.json` file.
-
-If you do intend to write TypeScript code, using Astro's `strict` or `strictest` template is recommended. You can view and compare the three template configurations at [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/).
-
-Create `tsconfig.json` at the root of your project, and copy the code below into it. (You can use `base`, `strict` or `strictest` for your TypeScript template):
-
-```json title="tsconfig.json" "base"
-{
- "extends": "astro/tsconfigs/base"
-}
-```
-
-Finally, create `src/env.d.ts` to let TypeScript know about ambient types available in an Astro project:
-
-```ts title="src/env.d.ts"
-/// Read Astro's [TypeScript setup guide](/en/guides/typescript/#setup) for more information.
-
-## 7. Next Steps
-
-If you have followed the steps above, your project directory should now look like this:
-
-
-- node_modules/
-- public/
- - robots.txt
-- src/
- - pages/
- - index.astro
- - env.d.ts
-- astro.config.mjs
-- package-lock.json or `yarn.lock`, `pnpm-lock.yaml`, etc.
-- package.json
-- tsconfig.json
-
-
-Congratulations, you're now set up to use Astro!
-
-If you followed this guide completely, you can jump directly to [Step 2: Start Astro](/en/install/auto/#2-start-astro-) to continue and learn how to run Astro for the first time.
diff --git a/src/content/docs/en/recipes.mdx b/src/content/docs/en/recipes.mdx
index 830f914041dcd..df933ea01b588 100644
--- a/src/content/docs/en/recipes.mdx
+++ b/src/content/docs/en/recipes.mdx
@@ -1,20 +1,7 @@
---
-title: More Recipes
-description: See guided examples of building features in Astro.
-i18nReady: true
+title: old recipes page
+description: old recipes page
+i18nReady: false
---
-import RecipesNav from '~/components/RecipesNav.astro';
-
-See guided examples of adding features to your Astro project.
-
-
-## Official Recipes
-
-See even more recipes written and maintained by the community in our [community recipes and guides](/en/community-resources/content/#recipes-and-guides)
+this is a fake placeholder page.
\ No newline at end of file
diff --git a/src/content/docs/en/recipes/bun.mdx b/src/content/docs/en/recipes/bun.mdx
index b1a8404a2bb70..3da98d6224df9 100644
--- a/src/content/docs/en/recipes/bun.mdx
+++ b/src/content/docs/en/recipes/bun.mdx
@@ -26,7 +26,7 @@ bunx create-astro@latest my-astro-project-using-bun
```
:::tip
-You may also [create a new Astro project from any existing Astro GitHub repository](/en/install/auto/#starter-templates) using the `--template` flag:
+You may also [create a new Astro project from any existing Astro GitHub repository](/en/install-and-setup/#use-a-theme-or-starter-template) using the `--template` flag:
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
diff --git a/src/content/docs/en/reference/cli-reference.mdx b/src/content/docs/en/reference/cli-reference.mdx
index ae7f77e916c09..065c5d4304a21 100644
--- a/src/content/docs/en/reference/cli-reference.mdx
+++ b/src/content/docs/en/reference/cli-reference.mdx
@@ -92,9 +92,9 @@ The extra `--` before any flag is necessary for `npm` to pass your flags to the
You can also use scripts in `package.json` for shorter versions of these commands. Using a script allows you to use the same commands that you may be familiar with from other projects, such as `npm run build`.
-The following scripts for the most common `astro` commands (`astro dev`, `astro build`, and `astro preview`) are added for you automatically when you create a project using [the `create astro` wizard](/en/install/auto/#1-run-the-setup-wizard).
+The following scripts for the most common `astro` commands (`astro dev`, `astro build`, and `astro preview`) are added for you automatically when you create a project using [the `create astro` wizard](/en/install-and-setup/).
-When you follow the instructions to [install Astro manually](/en/install/manual/#2-install-astro), you are instructed to add these scripts yourself. You can also add more scripts to this list manually for any commands you use frequently.
+When you follow the instructions to [install Astro manually](/en/install-and-setup/#manual-setup), you are instructed to add these scripts yourself. You can also add more scripts to this list manually for any commands you use frequently.
```json title="package.json"
{
@@ -167,7 +167,7 @@ In most cases you will use the CLI via your package manager:
-If you started your project using [the `create astro` wizard](/en/install/auto/#1-run-the-setup-wizard), you can also use the scripts in `package.json` for a shorter version of these commands. See the `README.md` in your project for details of which commands are available.
+If you started your project using [the `create astro` wizard](/en/install-and-setup/), you can also use the scripts in `package.json` for a shorter version of these commands. See the `README.md` in your project for details of which commands are available.
diff --git a/src/content/docs/en/tutorial/0-introduction/1.mdx b/src/content/docs/en/tutorial/0-introduction/1.mdx
index dbf911f4019fd..ecf7a76ed59db 100644
--- a/src/content/docs/en/tutorial/0-introduction/1.mdx
+++ b/src/content/docs/en/tutorial/0-introduction/1.mdx
@@ -30,7 +30,7 @@ Using the tracker is optional, but it can help you remember your place if you co
You can use the lessons inside [Unit 1](/en/tutorial/1-setup/) to make sure you have the development tools and online accounts you'll need to complete the tutorial. It will walk you through creating a new Astro project, storing it on GitHub, and deploying it to Netlify.
-If you [create a new, empty Astro project](/en/install/auto/) and are comfortable with your setup, you can safely skip ahead to [Unit 2](/en/tutorial/2-pages/) where you will start making new pages in your project.
+If you [create a new, empty Astro project](/en/install-and-setup/) and are comfortable with your setup, you can safely skip ahead to [Unit 2](/en/tutorial/2-pages/) where you will start making new pages in your project.
Hello, World!
- - - -``` - -## 4. Create your first static asset - -You will also want to create a `public/` directory to store your static assets. Astro will always include these assets in your final build, so you can safely reference them from inside your component templates. - -In your text editor, create a new file in your directory at `public/robots.txt`. `robots.txt` is a simple file that most sites will include to tell search bots like Google how to treat your site. - -For this guide, copy-and-paste the following code snippet into your new file: - -```diff title="public/robots.txt" -# Example: Allow all bots to scan and index your site. -# Full syntax: https://developers.google.com/search/docs/advanced/robots/create-robots-txt -User-agent: * -Allow: / -``` - -## 5. Create `astro.config.mjs` - -Astro is configured using `astro.config.mjs`. This file is optional if you do not need to configure Astro, but you may wish to create it now. - -Create `astro.config.mjs` at the root of your project, and copy the code below into it: - -```js title="astro.config.mjs" -import { defineConfig } from 'astro/config'; - -// https://astro.build/config -export default defineConfig({}); -``` - -If you want to include [UI framework components](/en/guides/framework-components/) such as React, Svelte, etc. or use other tools such as Tailwind or Partytown in your project, here is where you will [manually import and configure integrations](/en/guides/integrations-guide/). - -
@@ -41,6 +41,12 @@ Our [friendly Astro Discord server](https://astro.build/chat) is the place to be
Hop into the support forum channel to ask questions, or say hi and chat in `#general` or `#off-topic`.
+
+
+
What can I do after I complete this tutorial?
+ +At the end of this tutorial, you will have a functioning blog using Astro's built-in file-based routing. You can enhance this project's final code by [refactoring it to manage your content with content collections](/en/tutorials/add-content-collections/) or [adding view transitions to customize page navigation](/en/tutorials/add-view-transitions/). +Where can I leave feedback about this tutorial?
diff --git a/src/content/docs/es/basics/project-structure.mdx b/src/content/docs/es/basics/project-structure.mdx index 02b8c3fedfc28..af189247669af 100644 --- a/src/content/docs/es/basics/project-structure.mdx +++ b/src/content/docs/es/basics/project-structure.mdx @@ -116,7 +116,7 @@ Es un archivo utilizado por los gestores de paquetes de JavaScript para administ Hay [dos tipos de dependencias](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) que puedes especificar en `package.json`: `dependencies` (dependencias) y `devDependencies` (dependencias de desarrollo). En la mayoría de los casos, estas funcionan de la misma manera: Astro necesita todas las dependencias al hacer *build*, y tu gestor de paquetes instalará ambos. Recomendamos poner todas tus dependencias en `dependencies` para comenzar, y solo usar `devDependencies` si encuentras la necesidad de hacerlo. -Para obtener ayuda sobre crear un nuevo archivo `package.json` para tu proyecto, consulta las instrucciones en [instalación manual](/es/install/manual/). +Para obtener ayuda sobre crear un nuevo archivo `package.json` para tu proyecto, consulta las instrucciones en [instalación manual](/es/install-and-setup/#configuración-manual). ### `astro.config.mjs` diff --git a/src/content/docs/es/getting-started.mdx b/src/content/docs/es/getting-started.mdx index e0816650e73e4..37869fb77c4da 100644 --- a/src/content/docs/es/getting-started.mdx +++ b/src/content/docs/es/getting-started.mdx @@ -11,7 +11,7 @@ hero: actions: - text: Instalar Astro icon: rocket - link: /es/install/auto/ + link: /es/install-and-setup/ variant: primary - text: Conoce las características de Astro icon: right-arrow @@ -42,7 +42,7 @@ import Discord from '~/components/Landing/Discord.astro' npm create astro@latest ``` - Nuestra [guía de instalación](/es/install/auto/) tiene instrucciones paso a paso para instalar Astro usando nuestro asistente CLI, para crear un nuevo proyecto a partir de un repositorio de Astro en GitHub y para instalar Astro manualmente. + Nuestra [guía de instalación](/es/install-and-setup/) tiene instrucciones paso a paso para instalar Astro usando nuestro asistente CLI, para crear un nuevo proyecto a partir de un repositorio de Astro en GitHub y para instalar Astro manualmente.
diff --git a/src/content/docs/fr/basics/project-structure.mdx b/src/content/docs/fr/basics/project-structure.mdx
index 6065ecff075db..7075098aa7842 100644
--- a/src/content/docs/fr/basics/project-structure.mdx
+++ b/src/content/docs/fr/basics/project-structure.mdx
@@ -112,7 +112,7 @@ C'est un fichier utilisé par les gestionnaires de paquets JavaScript pour gére
Il existe [deux types de dépendances](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) que vous pouvez spécifier dans le fichier `package.json` : `dependencies` et `devDependencies`. Dans la plupart des cas, elles fonctionnent de la même manière : Astro a besoin de toutes les dépendances au moment de la construction, et votre gestionnaire de paquets les installera toutes les deux. Nous recommandons de mettre toutes vos dépendances dans `dependencies` pour commencer, et de n'utiliser `devDependencies` que si vous avez un besoin spécifique.
-Pour plus d'informations en ce qui concerne la création d'un nouveau fichier `package.json` pour votre projet, consultez les instructions de [configuration manuelle](/fr/install/manual/).
+Pour plus d'informations en ce qui concerne la création d'un nouveau fichier `package.json` pour votre projet, consultez les instructions de [configuration manuelle](/fr/install-and-setup/#manual-setup).
### `astro.config.mjs`
diff --git a/src/content/docs/fr/guides/cms/apostrophecms.mdx b/src/content/docs/fr/guides/cms/apostrophecms.mdx
index 13f5e3219def2..7638b77d3228b 100644
--- a/src/content/docs/fr/guides/cms/apostrophecms.mdx
+++ b/src/content/docs/fr/guides/cms/apostrophecms.mdx
@@ -19,7 +19,7 @@ Dans cette section, vous utiliserez l'[intégration Apostrophe](https://apostrop
Pour commencer, vous devez disposer des éléments suivants :
-1. **Un projet Astro affiché à la demande** avec l'[adaptateur Node.js](/fr/guides/integrations-guide/node/) installé et `output : 'server'` configuré - Si vous n'avez pas encore de projet Astro, notre [guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro affiché à la demande** avec l'[adaptateur Node.js](/fr/guides/integrations-guide/node/) installé et `output : 'server'` configuré - Si vous n'avez pas encore de projet Astro, notre [guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Un projet ApostropheCMS avec une variable d'environnement configurée appelée `APOS_EXTERNAL_FRONT_KEY`** - Cette variable d'environnement peut être configurée avec n'importe quelle chaîne de caractères aléatoire. Si vous n'avez pas encore de projet ApostropheCMS, le [guide d'installation](https://docs.apostrophecms.org/guide/development-setup.html) vous permettra de l'installer rapidement. Nous recommandons fortement l'utilisation de l'[outil CLI d'Apostrophe](https://apostrophecms.com/extensions/apos-cli) pour faciliter cette opération.
diff --git a/src/content/docs/fr/guides/cms/buttercms.mdx b/src/content/docs/fr/guides/cms/buttercms.mdx
index b42c0193ec8d1..b11bf5263773b 100644
--- a/src/content/docs/fr/guides/cms/buttercms.mdx
+++ b/src/content/docs/fr/guides/cms/buttercms.mdx
@@ -19,7 +19,7 @@ Dans cette section, nous allons utiliser le [SDK ButterCMS](https://www.npmjs.co
Pour démarrer, vous aurez besoin de ce qui suit :
### Prérequis
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [guide d'installation](/fr/install/auto/) vous permettra de démarrer en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [guide d'installation](/fr/install-and-setup/) vous permettra de démarrer en un rien de temps.
2. **Un compte ButterCMS** - Si vous n'avez pas de compte, vous pouvez [vous inscrire](https://buttercms.com/join/) pour un essai gratuit.
diff --git a/src/content/docs/fr/guides/cms/contentful.mdx b/src/content/docs/fr/guides/cms/contentful.mdx
index 8405b37dad334..d756a005e0eb3 100644
--- a/src/content/docs/fr/guides/cms/contentful.mdx
+++ b/src/content/docs/fr/guides/cms/contentful.mdx
@@ -20,7 +20,7 @@ Dans cette section, nous utiliserons le [Contentful SDK](https://github.com/cont
Pour commencer, vous devez disposer des éléments suivants :
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Un compte Contentful et un espace Contentful**. Si vous n'avez pas de compte, vous pouvez [vous inscrire](https://www.contentful.com/sign-up/) pour un compte gratuit et créer un nouvel espace Contentful. Vous pouvez également utiliser un espace existant si vous en avez un.
diff --git a/src/content/docs/fr/guides/cms/cosmic.mdx b/src/content/docs/fr/guides/cms/cosmic.mdx
index 60fa48d73ae8c..530e76e8f14c2 100644
--- a/src/content/docs/fr/guides/cms/cosmic.mdx
+++ b/src/content/docs/fr/guides/cms/cosmic.mdx
@@ -14,7 +14,7 @@ import { Steps } from '@astrojs/starlight/components';
## Prérequis
-1. **Un projet Astro**- Si vous souhaitez démarrer avec un nouveau projet Astro, lisez le [guide d'installation](/fr/install/auto/). Ce guide suit une version simplifiée du [Theme Astro Headless CMS](https://astro.build/themes/details/cosmic-cms-blog/) avec [Tailwind CSS](https://tailwindcss.com/) pour le style.
+1. **Un projet Astro**- Si vous souhaitez démarrer avec un nouveau projet Astro, lisez le [guide d'installation](/fr/install-and-setup/). Ce guide suit une version simplifiée du [Theme Astro Headless CMS](https://astro.build/themes/details/cosmic-cms-blog/) avec [Tailwind CSS](https://tailwindcss.com/) pour le style.
2. **Un compte Cosmic et un Bucket** - [Créez un compte Cosmic gratuitement](https://app.cosmicjs.com/signup) si vous n'en avez pas. Après avoir créé votre compte, vous serez invité à créer un nouveau projet vide. Il y a aussi un [modèle simple de Blog Astro](https://www.cosmicjs.com/marketplace/templates/simple-astro-blog) disponible (c'est le même modèle que le thème Astro Headless CMS) pour importer automatiquement tout le contenu utilisé dans ce guide.
3. **Vos clés API Cosmic** - A partir de votre tableau de bord Cosmic, vous devrez localiser à la fois le **Bucket slug** et la **Bucket read key** afin de vous connecter à Cosmic.
diff --git a/src/content/docs/fr/guides/cms/datocms.mdx b/src/content/docs/fr/guides/cms/datocms.mdx
index 1b900311a714c..92f234701fb2e 100644
--- a/src/content/docs/fr/guides/cms/datocms.mdx
+++ b/src/content/docs/fr/guides/cms/datocms.mdx
@@ -19,7 +19,7 @@ Dans ce guide, vous allez récupérer les données de contenu de DatoCMS dans vo
Pour commencer, vous devez disposer des éléments suivants :
-- **Un projet Astro** - Si vous n'avez pas encore de projet Astro, vous pouvez suivre les instructions de notre [Guide d'installation](/fr/install/auto/).
+- **Un projet Astro** - Si vous n'avez pas encore de projet Astro, vous pouvez suivre les instructions de notre [Guide d'installation](/fr/install-and-setup/).
- **Un compte et un projet DatoCMS** - Si vous n'avez pas de compte, vous pouvez [créer un compte gratuit](https://dashboard.datocms.com/signup).
- **La clé API en lecture seule de votre projet DatoCMS** - Vous pouvez la trouver dans le tableau de bord d'administration de votre projet, sous "Settings" > "API Tokens".
diff --git a/src/content/docs/fr/guides/cms/ghost.mdx b/src/content/docs/fr/guides/cms/ghost.mdx
index c492198f22102..a83fdddbc852f 100644
--- a/src/content/docs/fr/guides/cms/ghost.mdx
+++ b/src/content/docs/fr/guides/cms/ghost.mdx
@@ -18,7 +18,7 @@ Dans cette section, nous utiliserons l'API [Ghost content API](https://ghost.org
### Prérequis
Pour commencer, vous devez disposer des éléments suivants :
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Un site Ghost** - Nous supposons que vous avez un site configuré avec Ghost. Si ce n'est pas le cas, vous pouvez en configurer un sur un [environnement local](https://ghost.org/docs/install/local/).
diff --git a/src/content/docs/fr/guides/cms/payload.mdx b/src/content/docs/fr/guides/cms/payload.mdx
index 75fd4f318d545..1ee96af455afb 100644
--- a/src/content/docs/fr/guides/cms/payload.mdx
+++ b/src/content/docs/fr/guides/cms/payload.mdx
@@ -14,7 +14,7 @@ import { Steps } from '@astrojs/starlight/components';
### Prérequis
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Une base de données MongoDB** - PayloadCMS vous demandera une chaîne de connexion MongoDB lors de la création d'un nouveau projet. Vous pouvez en installer une localement ou utiliser [MongoDBAtlas](https://www.mongodb.com/) pour héberger une base de données sur le web gratuitement.
3. **Une API REST PayloadCMS** - Créez un projet [PayloadCMS](https://payloadcms.com/docs/getting-started/installation) et connectez-le à votre base de données MongoDB pendant l'installation.
diff --git a/src/content/docs/fr/guides/cms/statamic.mdx b/src/content/docs/fr/guides/cms/statamic.mdx
index b94f75102a1ce..da8c803db0f27 100644
--- a/src/content/docs/fr/guides/cms/statamic.mdx
+++ b/src/content/docs/fr/guides/cms/statamic.mdx
@@ -20,7 +20,7 @@ Statamic est livré avec une [API REST](https://statamic.dev/rest-api) et une [A
Pour commencer, vous devez disposer des éléments suivants :
1. Les API REST et GraphQL ne sont disponibles que dans la version pro de Statamic. Vous pouvez essayer la version Pro gratuitement sur votre [machine locale](https://statamic.dev/tips/how-to-enable-statamic-pro#trial-mode).
-2. **Un projet Astro** - Si vous avez besoin d'un projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être rapidement opérationnel.
+2. **Un projet Astro** - Si vous avez besoin d'un projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être rapidement opérationnel.
3. **Un site Statamic** - Si vous avez besoin d'un site Statamic, [ce guide](https://statamic.dev/quick-start-guide) vous aidera à démarrer.
N'oubliez pas d'activer l'[API REST](https://statamic.dev/rest-api#enable-the-api) ou l'[API GraphQL](https://statamic.dev/graphql#enable-graphql) en ajoutant `STATAMIC_API_ENABLED=true` ou `STATAMIC_GRAPHQL_ENABLED=true` dans le fichier `.env` et d'activer les ressources nécessaires dans le fichier de configuration de l'API.
diff --git a/src/content/docs/fr/guides/cms/storyblok.mdx b/src/content/docs/fr/guides/cms/storyblok.mdx
index 3968a2634d131..313ff12876339 100644
--- a/src/content/docs/fr/guides/cms/storyblok.mdx
+++ b/src/content/docs/fr/guides/cms/storyblok.mdx
@@ -20,7 +20,7 @@ Dans cette section, vous utiliserez l'[intégration Storyblok](https://github.co
Pour commencer, vous devez disposer des éléments suivants :
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Un compte Storyblok et un espace** - Si vous n'avez pas encore de compte, [inscrivez-vous gratuitement](https://app.storyblok.com/#/signup) et créez un nouvel espace.
diff --git a/src/content/docs/fr/guides/cms/strapi.mdx b/src/content/docs/fr/guides/cms/strapi.mdx
index f73bb3db3cc94..aa6f687f8a708 100644
--- a/src/content/docs/fr/guides/cms/strapi.mdx
+++ b/src/content/docs/fr/guides/cms/strapi.mdx
@@ -20,7 +20,7 @@ Ce guide va construire une fonction wrapper pour connecter Strapi avec Astro.
Pour commencer, vous devez disposer des éléments suivants :
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Un serveur CMS Strapi** - Vous pouvez [configurer un serveur Strapi dans un environnement local](https://docs.strapi.io/dev-docs/quick-start).
### Ajouter l'URL de Strapi dans `.env`
diff --git a/src/content/docs/fr/guides/cms/wordpress.mdx b/src/content/docs/fr/guides/cms/wordpress.mdx
index 81afe507baf82..8f98b0256e876 100644
--- a/src/content/docs/fr/guides/cms/wordpress.mdx
+++ b/src/content/docs/fr/guides/cms/wordpress.mdx
@@ -20,7 +20,7 @@ WordPress est doté d'un système intégré de l'[API REST WordPress](https://de
Pour commencer, vous devez disposer des éléments suivants :
-1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install/auto/) vous permettra d'être opérationnel en un rien de temps.
+1. **Un projet Astro** - Si vous n'avez pas encore de projet Astro, notre [Guide d'installation](/fr/install-and-setup/) vous permettra d'être opérationnel en un rien de temps.
2. **Un site WordPress** - L'API REST de votre site est `[VOTRE_SITE]/wp-json/wp/v2/` et est disponible par défaut avec tout site WordPress. Il est également possible de [configurer WordPress dans un environnement local](https://wordpress.org/support/article/installing-wordpress-on-your-own-computer/).
### Mise en place des informations d'identification
diff --git a/src/content/docs/fr/guides/deploy/render.mdx b/src/content/docs/fr/guides/deploy/render.mdx
index debd3d784660d..eca3fbef273e5 100644
--- a/src/content/docs/fr/guides/deploy/render.mdx
+++ b/src/content/docs/fr/guides/deploy/render.mdx
@@ -20,7 +20,7 @@ Vous pouvez déployer votre projet Astro sur [Render](https://render.com/), un s
4. Donnez un nom à votre site web, sélectionnez la branche et spécifiez la commande de construction et le répertoire de publication
- **build command:** `npm run build` (Commande de construction)
- **publish directory:** `dist` (Répertoire de publication)
- - **Environment variables (advanced)**: (Variables d'environnement) Par défaut, Render utilise Node.js 14.17.0, mais Astro [nécessite une version supérieure](/fr/install/auto/#prérequis). Ajoutez une variable d'environnement avec une **Variable key** (clé de variable) de `NODE_VERSION` et une **Value** (Valeur) de `18.14.1` ou plus pour dire à Render d'utiliser une version compatible de Node.js. Alternativement, ajoutez un fichier [`.node-version`](https://render.com/docs/node-version) ou [`.nvmrc`](https://render.com/docs/node-version) a votre projet pour spécifier la version de Node.js.
+ - **Environment variables (advanced)**: (Variables d'environnement) Par défaut, Render utilise Node.js 14.17.0, mais Astro [nécessite une version supérieure](/fr/install-and-setup/#prerequisites). Ajoutez une variable d'environnement avec une **Variable key** (clé de variable) de `NODE_VERSION` et une **Value** (Valeur) de `18.14.1` ou plus pour dire à Render d'utiliser une version compatible de Node.js. Alternativement, ajoutez un fichier [`.node-version`](https://render.com/docs/node-version) ou [`.nvmrc`](https://render.com/docs/node-version) a votre projet pour spécifier la version de Node.js.
5. Cliquez sur le bouton **Create Static Site**
diff --git a/src/content/docs/fr/guides/images.mdx b/src/content/docs/fr/guides/images.mdx
index 6c29f07f81148..37ac77def873f 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/#alias). 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 `![]()
` , 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 `![]()
`.
+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/#alias). Ensuite, vous pouvez accéder au `src` de l'image et à d'autres propriétés à utiliser dans la balise `![]()
`.
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/#alias).
```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
---
diff --git a/src/content/docs/fr/guides/imports.mdx b/src/content/docs/fr/guides/imports.mdx
index 5afe9fa743ec5..3df8acf066609 100644
--- a/src/content/docs/fr/guides/imports.mdx
+++ b/src/content/docs/fr/guides/imports.mdx
@@ -146,6 +146,50 @@ Il peut également être utile de placer des images dans le dossier `public/` co
L'ajout d'un texte **alt** aux balises `![]()
` est encouragé pour des raisons d'accessibilité ! N'oubliez pas d'ajouter un attribut `alt="a helpful description"` à vos éléments d'image. Vous pouvez laisser l'attribut vide si l'image est purement décorative.
:::
+## Alias
+
+Un **alias** est une façon de créer des raccourcis pour vos imports.
+
+Les alias peuvent aider à améliorer l'expérience de développement dans les codebases avec de nombreux dossiers ou importations relatives.
+
+```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';
+---
+```
+
+Dans cet exemple, un développeur devra comprendre la relation de l'arborescente entre `src/pages/about/company.astro`, `src/components/controls/Button.astro`, et `src/assets/logo.png`. Et si le fichier `company.astro` devait être déplacé, ces importations devraient également être mises à jour.
+
+Vous pouvez ajouter des alias d'importation à partir de `tsconfig.json` ou `jsconfig.json`.
+
+```json title="tsconfig.json" ins={5-6}
+{
+ "compilerOptions": {
+ "baseUrl": ".",
+ "paths": {
+ "@components/*": ["src/components/*"],
+ "@assets/*": ["src/assets/*"]
+ }
+ }
+}
+```
+
+:::note
+Assurez-vous que `compilerOptions.baseUrl` est défini pour que les chemins aliasés puissent être résolus.
+:::
+
+Le serveur de développement redémarrera automatiquement après ce changement de configuration. Vous pouvez maintenant importer en utilisant les alias n'importe où dans votre projet :
+
+```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';
+---
+```
+
+Ces alias sont également intégrés automatiquement dans [VS Code](https://code.visualstudio.com/docs/languages/jsconfig) et d'autres éditeurs de code.
+
## `Astro.glob()`
[`Astro.glob()`](/fr/reference/api-reference/#astroglob) est un moyen d'importer plusieurs fichiers à la fois.
diff --git a/src/content/docs/fr/guides/markdown-content.mdx b/src/content/docs/fr/guides/markdown-content.mdx
index b4d7c32d0461b..e324f21450bce 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/#alias)) 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..ea1d67f1c3438 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/#alias) que vous définissez dans votre configuration `tsconfig.json` & `jsconfig.json` `paths`.
```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/fr/recipes/bun.mdx b/src/content/docs/fr/recipes/bun.mdx
index 254ba7e726c39..6ff5dbac1c80b 100644
--- a/src/content/docs/fr/recipes/bun.mdx
+++ b/src/content/docs/fr/recipes/bun.mdx
@@ -26,7 +26,7 @@ bunx create-astro@latest my-astro-project-using-bun
```
:::tip
-Vous pouvez également [créer un nouveau projet Astro à partir d'un dépôt Astro GitHub existant](/fr/install/auto/#modèles-de-démarrage) en utilisant l'option `--template` :
+Vous pouvez également [créer un nouveau projet Astro à partir d'un dépôt Astro GitHub existant](/fr/install-and-setup/#use-a-theme-or-starter-template) en utilisant l'option `--template` :
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
diff --git a/src/content/docs/fr/reference/cli-reference.mdx b/src/content/docs/fr/reference/cli-reference.mdx
index c9782d947de94..4853bb5105479 100644
--- a/src/content/docs/fr/reference/cli-reference.mdx
+++ b/src/content/docs/fr/reference/cli-reference.mdx
@@ -92,9 +92,9 @@ Le `--` supplémentaire avant chaque option est nécessaire pour que `npm` trans
Vous pouvez également utiliser des scripts dans `package.json` pour des versions plus courtes de ces commandes. L'utilisation d'un script vous permet d'utiliser les mêmes commandes avec lesquelles vous pourriez être familier dans d'autres projets, telles que `npm run build`.
-Pour les commandes `astro` les plus courantes (`astro dev`, `astro build` et `astro preview`), les scripts suivants sont ajoutés automatiquement lorsque vous créez un projet en utilisant [l'assistant d'installation `create astro`](/fr/install/auto/#1-utiliser-lassistant-dinstallation).
+Pour les commandes `astro` les plus courantes (`astro dev`, `astro build` et `astro preview`), les scripts suivants sont ajoutés automatiquement lorsque vous créez un projet en utilisant [l'assistant d'installation `create astro`](/fr/install-and-setup/).
-Lorsque vous suivez les instructions pour [installer Astro manuellement](/fr/install/manual/#2-installer-astro), vous êtes invité à ajouter vous-même ces scripts. Vous pouvez également ajouter manuellement d'autres scripts à cette liste pour toute commande que vous utilisez fréquemment.
+Lorsque vous suivez les instructions pour [installer Astro manuellement](/fr/install-and-setup/#manual-setup), vous êtes invité à ajouter vous-même ces scripts. Vous pouvez également ajouter manuellement d'autres scripts à cette liste pour toute commande que vous utilisez fréquemment.
```json title="package.json"
{
@@ -167,7 +167,7 @@ Dans la plupart des cas, vous utiliserez le CLI via votre gestionnaire de paquet
-Si vous avez démarré votre projet en utilisant [l'assistant `create astro`](/fr/install/auto/#1-utiliser-lassistant-dinstallation), vous pouvez également utiliser les scripts dans `package.json` pour une version abrégée de ces commandes. Consultez le fichier README.md de votre projet pour savoir quelles commandes sont disponibles.
+Si vous avez démarré votre projet en utilisant [l'assistant `create astro`](/fr/install-and-setup/), vous pouvez également utiliser les scripts dans `package.json` pour une version abrégée de ces commandes. Consultez le fichier README.md de votre projet pour savoir quelles commandes sont disponibles.
diff --git a/src/content/docs/fr/tutorial/0-introduction/1.mdx b/src/content/docs/fr/tutorial/0-introduction/1.mdx
index 31bea43265389..78b24dd0cb6b9 100644
--- a/src/content/docs/fr/tutorial/0-introduction/1.mdx
+++ b/src/content/docs/fr/tutorial/0-introduction/1.mdx
@@ -31,7 +31,7 @@ L'utilisation du suivi est facultative, mais elle peut vous aider à vous rappel
Vous pouvez utiliser les leçons de l'[Unité 1](/fr/tutorial/1-setup/) pour vous assurer que vous disposez des outils de développement et des comptes en ligne nécessaires pour terminer le tutoriel. Elle vous guidera pour créer un nouveau projet Astro, le stocker sur GitHub et le déployer sur Netlify.
-Si vous [créez un nouveau projet Astro vide](/fr/install/auto/) et que vous vous sentez à l'aise avec votre configuration, vous pouvez passer directement à [l'Unité 2](/fr/tutorial/2-pages/) où vous commencerez à créer de nouvelles pages dans votre projet.
+Si vous [créez un nouveau projet Astro vide](/fr/install-and-setup/) et que vous vous sentez à l'aise avec votre configuration, vous pouvez passer directement à [l'Unité 2](/fr/tutorial/2-pages/) où vous commencerez à créer de nouvelles pages dans votre projet.
diff --git a/src/content/docs/hi/basics/project-structure.mdx b/src/content/docs/hi/basics/project-structure.mdx
index 46ee450b50535..06aa48ac05631 100644
--- a/src/content/docs/hi/basics/project-structure.mdx
+++ b/src/content/docs/hi/basics/project-structure.mdx
@@ -112,7 +112,7 @@ Astro परियोजनाओं में यह एक सामान्
`package.json` में आप [दो प्रकार की निर्भरताएँ](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) निर्दिष्ट कर सकते हैं: `dependencies` और `devDependencies`। ज्यादातर मामलों में, ये समान रूप से काम करते हैं: Astro को निर्माण के समय सभी निर्भरताओं की आवश्यकता होती है, और आपका पैकेज प्रबंधक दोनों को स्थापित करेगा। हम अनुशंसा करते हैं कि शुरू करने के लिए अपनी सभी निर्भरताओं को `dependencies` में रखें, और यदि आपको ऐसा करने की कोई विशिष्ट आवश्यकता लगती है तो केवल `devDependencies` का उपयोग करें।
-अपने परियोजना के लिए एक नई `package.json` फ़ाइल बनाने में सहायता के लिए, [मैन्युअल सेटअप](/hi/install/manual/) निर्देश देखें।
+अपने परियोजना के लिए एक नई `package.json` फ़ाइल बनाने में सहायता के लिए, [मैन्युअल सेटअप](/hi/install-and-setup/#manual-setup) निर्देश देखें।
### `astro.config.mjs`
diff --git a/src/content/docs/hi/getting-started.mdx b/src/content/docs/hi/getting-started.mdx
index 1b1a6c5df46c0..10ab1eff756db 100644
--- a/src/content/docs/hi/getting-started.mdx
+++ b/src/content/docs/hi/getting-started.mdx
@@ -14,7 +14,7 @@ hero:
actions:
- text: Astro इंस्टॉल करे
icon: rocket
- link: /hi/install/auto/
+ link: /hi/install-and-setup/
variant: primary
- text: Astro की विशेषताओं को जानें
icon: right-arrow
@@ -46,7 +46,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- हमारे [इंस्टॉलेशन मार्गदर्शक](/hi/install/auto/) में हमारे CLI विज़ार्ड का उपयोग करके Astro को इंस्टॉल करने, मौजूदा Astro GitHub रिपॉजिटरी से एक नयी परियोजना बनाने और Astro को नियमावली रूप से इंस्टॉल करने के लिए चरण-दर-चरण निर्देश हैं।
+ हमारे [इंस्टॉलेशन मार्गदर्शक](/hi/install-and-setup/) में हमारे CLI विज़ार्ड का उपयोग करके Astro को इंस्टॉल करने, मौजूदा Astro GitHub रिपॉजिटरी से एक नयी परियोजना बनाने और Astro को नियमावली रूप से इंस्टॉल करने के लिए चरण-दर-चरण निर्देश हैं।
diff --git a/src/content/docs/it/basics/project-structure.mdx b/src/content/docs/it/basics/project-structure.mdx
index 2eca8769b4f12..37ab8b2126872 100644
--- a/src/content/docs/it/basics/project-structure.mdx
+++ b/src/content/docs/it/basics/project-structure.mdx
@@ -112,7 +112,7 @@ Questo è un file utilizzato dai gestori di pacchetti JavaScript per gestire le
Esistono [due tipi di dipendenze](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) che puoi specificare in un `package.json`: `dependencies` e `devDependencies`. Nella maggior parte dei casi, funzionano allo stesso modo: Astro ha bisogno di tutte le dipendenze in fase di creazione e il tuo gestore pacchetti le installerà entrambe. Ti consigliamo di inserire tutte le tue dipendenze in `dependencies` per iniziare e di utilizzare `devDependencies` solo se trovi una necessità specifica per farlo.
-Per assistenza nella creazione di un nuovo file `package.json` per il tuo progetto, consulta le istruzioni di [configurazione manuale](/it/install/manual/).
+Per assistenza nella creazione di un nuovo file `package.json` per il tuo progetto, consulta le istruzioni di [configurazione manuale](/it/install-and-setup/#manual-setup).
### `astro.config.mjs`
diff --git a/src/content/docs/it/getting-started.mdx b/src/content/docs/it/getting-started.mdx
index 03f90f39c9c2f..da2330c04d5ca 100644
--- a/src/content/docs/it/getting-started.mdx
+++ b/src/content/docs/it/getting-started.mdx
@@ -15,7 +15,7 @@ hero:
actions:
- text: Inizia
icon: rocket
- link: /it/install/auto/
+ link: /it/install-and-setup/
variant: primary
- text: Scopri le funzionalità di Astro
icon: right-arrow
@@ -47,7 +47,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- La nostra [guida all'installazione](/it/install/auto/) ha istruzioni passo passo per installare Astro utilizzando il nostro wizard CLI, creare un nuovo progetto da un repository GitHub Astro esistente e per installare Astro manualmente.
+ La nostra [guida all'installazione](/it/install-and-setup/) ha istruzioni passo passo per installare Astro utilizzando il nostro wizard CLI, creare un nuovo progetto da un repository GitHub Astro esistente e per installare Astro manualmente.
diff --git a/src/content/docs/it/recipes/bun.mdx b/src/content/docs/it/recipes/bun.mdx
index f99a668535e6b..ffd084e0a5002 100644
--- a/src/content/docs/it/recipes/bun.mdx
+++ b/src/content/docs/it/recipes/bun.mdx
@@ -26,7 +26,7 @@ bunx create-astro@latest my-astro-project-using-bun
```
:::tip
-Puoi creare anche un [nuovo progetto Astro da qualsiasi repository Astro GitHub esistente](/it/install/auto/#template-di-partenza) usando il flag `--template`:
+Puoi creare anche un [nuovo progetto Astro da qualsiasi repository Astro GitHub esistente](/it/install-and-setup/#use-a-theme-or-starter-template) usando il flag `--template`:
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
diff --git a/src/content/docs/ja/basics/project-structure.mdx b/src/content/docs/ja/basics/project-structure.mdx
index c04380217252b..b4a768d4f8c75 100644
--- a/src/content/docs/ja/basics/project-structure.mdx
+++ b/src/content/docs/ja/basics/project-structure.mdx
@@ -112,7 +112,7 @@ CSSやJavaScriptを`public/`ディレクトリに置くことはできますが
`package.json`には、`dependencies`と`devDependencies`という[2種類の依存関係](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file)を指定できます。多くの場合、同じように動作します。Astroはビルド時に全ての依存関係を必要とし、パッケージマネージャーはどちらともインストールを行います。まずは`dependencies`にすべての依存関係を含め、特に必要な場合のみ`devDependencies`を利用することをおすすめします。
-あなたのプロジェクトに新しい`package.json`ファイルを作成する方法については、[手動セットアップ](/ja/install/manual/)の説明を参照してください。
+あなたのプロジェクトに新しい`package.json`ファイルを作成する方法については、[手動セットアップ](/ja/install-and-setup/#manual-setup)の説明を参照してください。
### `astro.config.mjs`
diff --git a/src/content/docs/ja/getting-started.mdx b/src/content/docs/ja/getting-started.mdx
index 9e8bc7f9008c5..92a8de399fb87 100644
--- a/src/content/docs/ja/getting-started.mdx
+++ b/src/content/docs/ja/getting-started.mdx
@@ -15,7 +15,7 @@ hero:
actions:
- text: はじめる
icon: rocket
- link: /ja/install/auto/
+ link: /ja/install-and-setup/
variant: primary
- text: Astroの特徴について学ぶ
icon: right-arrow
@@ -47,7 +47,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- [インストールガイド](/ja/install/auto/)には、CLIウィザードによるAstroのインストール、既存のAstro GitHubリポジトリからの新しいプロジェクトの作成、Astroの手動インストールについて、ステップバイステップの手順が記載されています。
+ [インストールガイド](/ja/install-and-setup/)には、CLIウィザードによるAstroのインストール、既存のAstro GitHubリポジトリからの新しいプロジェクトの作成、Astroの手動インストールについて、ステップバイステップの手順が記載されています。
diff --git a/src/content/docs/ja/guides/cms/buttercms.mdx b/src/content/docs/ja/guides/cms/buttercms.mdx
index f674a21b088fe..3d0c173837d09 100644
--- a/src/content/docs/ja/guides/cms/buttercms.mdx
+++ b/src/content/docs/ja/guides/cms/buttercms.mdx
@@ -24,7 +24,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
### 必須要件
-1. **Astroプロジェクト** - もしAstroプロジェクトをまだ持っていない場合は、[自動CLIでAstroをインストール](/ja/install/auto/)を見ると、すぐに使い始めることができます。
+1. **Astroプロジェクト** - もしAstroプロジェクトをまだ持っていない場合は、[自動CLIでAstroをインストール](/ja/install-and-setup/)を見ると、すぐに使い始めることができます。
2. **ButterCMSアカウント** - もしアカウントを持っていない場合は、無料トライアルとして[登録](https://buttercms.com/join/)できます。
diff --git a/src/content/docs/ja/guides/cms/contentful.mdx b/src/content/docs/ja/guides/cms/contentful.mdx
index 7395329ede277..2e2a98bb857b7 100644
--- a/src/content/docs/ja/guides/cms/contentful.mdx
+++ b/src/content/docs/ja/guides/cms/contentful.mdx
@@ -20,7 +20,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
始めるには以下のものが必要です。
-1. **Astroプロジェクト** - もしAstroプロジェクトをまだ持っていない場合は、[自動CLIでAstroをインストール](/ja/install/auto/)を見ると、すぐに使い始めることができます。
+1. **Astroプロジェクト** - もしAstroプロジェクトをまだ持っていない場合は、[自動CLIでAstroをインストール](/ja/install-and-setup/)を見ると、すぐに使い始めることができます。
2. **ContentfulアカウントとContentfulスペース** - もしアカウントを持っていない場合は、フリーアカウントを[登録](https://www.contentful.com/sign-up/)できて、Contentfulスペースを作成できます。既に持っている場合は既存のスペースを利用できます。
diff --git a/src/content/docs/ja/guides/cms/storyblok.mdx b/src/content/docs/ja/guides/cms/storyblok.mdx
index 6228218e321e4..2972856727478 100644
--- a/src/content/docs/ja/guides/cms/storyblok.mdx
+++ b/src/content/docs/ja/guides/cms/storyblok.mdx
@@ -19,7 +19,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
始めるには、以下の手順を行っている必要があります。
-1. **Astroプロジェクト** - もしAstroプロジェクトをまだ持っていない場合は、[自動CLIでAstroをインストール](/ja/install/auto/)を見ると、すぐに使い始めることができます。
+1. **Astroプロジェクト** - もしAstroプロジェクトをまだ持っていない場合は、[自動CLIでAstroをインストール](/ja/install-and-setup/)を見ると、すぐに使い始めることができます。
2. **Storyblok**アカウントとスペース - もしアカウントを持っていない場合は、[無料で登録](https://app.storyblok.com/#/signup)してスペースを作成します。
diff --git a/src/content/docs/ja/guides/deploy/render.mdx b/src/content/docs/ja/guides/deploy/render.mdx
index b3597ff722aef..a2713710eda1a 100644
--- a/src/content/docs/ja/guides/deploy/render.mdx
+++ b/src/content/docs/ja/guides/deploy/render.mdx
@@ -15,5 +15,5 @@ i18nReady: true
4. ウェブサイトに名前を付け、ブランチを選択し、ビルドコマンドと公開ディレクトリを指定します。
- **build command:** `npm run build`
- **publish directory:** `dist`
- - **Environment variables (advanced)**: 初期設定では、RenderはNode.js 14.17.0を使用しますが、Astroは[より高いバージョンを必要とします](/ja/install/auto/#前提条件)。Renderに互換性のあるNode.jsバージョンを使用するよう指示をするため、**Variable key**を`NODE_VERSION`に、**Value**を`18.14.1`またはそれ以上に設定する環境変数を追加します。もしくは、[`.node-version`](https://render.com/docs/node-version)または[`.nvmrc`](https://render.com/docs/node-version)ファイルをプロジェクトに追加し、Node.jsバージョンを指定します。
+ - **Environment variables (advanced)**: 初期設定では、RenderはNode.js 14.17.0を使用しますが、Astroは[より高いバージョンを必要とします](/ja/install-and-setup/#prerequisites)。Renderに互換性のあるNode.jsバージョンを使用するよう指示をするため、**Variable key**を`NODE_VERSION`に、**Value**を`18.14.1`またはそれ以上に設定する環境変数を追加します。もしくは、[`.node-version`](https://render.com/docs/node-version)または[`.nvmrc`](https://render.com/docs/node-version)ファイルをプロジェクトに追加し、Node.jsバージョンを指定します。
5. **Create Static Site**ボタンをクリックします。
\ No newline at end of file
diff --git a/src/content/docs/ja/guides/images.mdx b/src/content/docs/ja/guides/images.mdx
index d7dcc5c42f524..4105ad40cd6f1 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/#importエイリアス)を設定して**、画像もインポート**する必要があります。インポート名を`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/)を設定して使用する必要があります。これにより、`![]()
`タグで使用する画像の`src`やその他のプロパティにアクセスできます。
+ローカル画像は、`.astro`ファイルからの相対パスにより**インポート**するか、[インポートエイリアス](/ja/guides/imports/#importエイリアス)を設定して使用する必要があります。これにより、`![]()
`タグで使用する画像の`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/#importエイリアス)する必要があります。
```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
---
diff --git a/src/content/docs/ja/guides/imports.mdx b/src/content/docs/ja/guides/imports.mdx
index f3b8e5132bfbd..21a4888dd75b0 100644
--- a/src/content/docs/ja/guides/imports.mdx
+++ b/src/content/docs/ja/guides/imports.mdx
@@ -157,6 +157,49 @@ import txtReference from './words.txt'; // txt === '/src/words.txt'
アクセシビリティの観点から、`![]()
`タグに**altテキスト**を付加することが推奨されています！画像要素に`alt="役に立つ説明"`属性を追加することを忘れないでください。画像が単なる装飾である場合は、この属性を空で指定します。
:::
+## importエイリアス
+
+**エイリアス**は、インポートのためのショートカットを作成する方法です。
+
+エイリアスは、多くのディレクトリや相対的なインポートを持つコードベースにおいて、開発体験を改善するのに役立ちます。
+
+```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';
+---
+```
+
+この例では、開発者は`src/pages/about/company.astro`、`src/components/controls/Button.astro`、そして`src/assets/logo.png`間のツリーの関係を理解する必要があります。そして、`company.astro`ファイルが移動された場合、これらのインポートも更新しなければなりません。
+
+インポートエイリアスは`tsconfig.json`または`jsconfig.json`のどちらかから追加できます。
+
+```json title="tsconfig.json" ins={5-6}
+{
+ "compilerOptions": {
+ "baseUrl": ".",
+ "paths": {
+ "@components/*": ["src/components/*"],
+ "@assets/*": ["src/assets/*"]
+ }
+ }
+}
+```
+
+:::note
+エイリアスのパスが解決できるように`compilerOptions.baseUrl`が設定されていることを確認してください。
+:::
+
+設定を変更すると、開発サーバーが自動的に再起動します。これにより、プロジェクト内の任意の場所でエイリアスを使用してインポートできるようになりました。
+
+```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';
+---
+```
+
+これらのエイリアスは、[VS Code](https://code.visualstudio.com/docs/languages/jsconfig)や他のエディタにも自動的に統合されます。
## `Astro.glob()`
diff --git a/src/content/docs/ja/guides/markdown-content.mdx b/src/content/docs/ja/guides/markdown-content.mdx
index a697a6aabf665..c72ceb8f22378 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/#importエイリアス)）を指定できる特別なフロントマター用の`layout`プロパティを提供します。
```markdown {3}
---
diff --git a/src/content/docs/ja/guides/typescript.mdx b/src/content/docs/ja/guides/typescript.mdx
index 1642369a5f1f5..a93fbb38c4e29 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/#importエイリアス)をサポートしています。
```astro title="src/pages/about/nate.astro" "@components" "@layouts"
diff --git a/src/content/docs/ja/recipes/bun.mdx b/src/content/docs/ja/recipes/bun.mdx
index b199f14124730..bc9b02242da91 100644
--- a/src/content/docs/ja/recipes/bun.mdx
+++ b/src/content/docs/ja/recipes/bun.mdx
@@ -26,7 +26,7 @@ bunx create-astro@latest my-astro-project-using-bun
```
:::tip
-また、`--template`フラグを使用して、[既存のAstro GitHubリポジトリから新しいAstroプロジェクトを作成する](/ja/install/auto/#スターターテンプレート)こともできます。
+また、`--template`フラグを使用して、[既存のAstro GitHubリポジトリから新しいAstroプロジェクトを作成する](/ja/install-and-setup/#use-a-theme-or-starter-template)こともできます。
```bash
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
```
diff --git a/src/content/docs/ja/reference/cli-reference.mdx b/src/content/docs/ja/reference/cli-reference.mdx
index c9aed4f097d22..47d4d51db0ce0 100644
--- a/src/content/docs/ja/reference/cli-reference.mdx
+++ b/src/content/docs/ja/reference/cli-reference.mdx
@@ -92,9 +92,9 @@ Global Flags
これらのコマンドの短縮版として`package.json`のスクリプトも使用できます。スクリプトにより、他のプロジェクトでよく見る`npm run build`のようなコマンドを使用できます。
-最もよく使う`astro`コマンド（`astro dev`、`astro build`、`astro preview`）に対応する以下のスクリプトは、[`create astro`ウィザード](/ja/install/auto/#1-セットアップウィザードを実行する)を使用してプロジェクトを作成すると自動的に追加されます。
+最もよく使う`astro`コマンド（`astro dev`、`astro build`、`astro preview`）に対応する以下のスクリプトは、[`create astro`ウィザード](/ja/install-and-setup/)を使用してプロジェクトを作成すると自動的に追加されます。
-[手動でAstroをインストールする](/ja/install/manual/#2-astroのインストール)手順に従うと、これらのスクリプトを自分で追加するよう促されます。また、このリストにその他のよく使用するコマンド用のスクリプトを手動で追加することもできます。
+[手動でAstroをインストールする](/ja/install-and-setup/#manual-setup) 手順に従うと、これらのスクリプトを自分で追加するよう促されます。また、このリストにその他のよく使用するコマンド用のスクリプトを手動で追加することもできます。
```json title="package.json"
{
@@ -167,7 +167,7 @@ In most cases you will use the CLI via your package manager:
-If you started your project using [the `create astro` wizard](/en/install/auto/#1-run-the-setup-wizard), you can also use the scripts in `package.json` for a shorter version of these commands. See the `README.md` in your project for details of which commands are available.
+If you started your project using [the `create astro` wizard](/en/install-and-setup/), you can also use the scripts in `package.json` for a shorter version of these commands. See the `README.md` in your project for details of which commands are available.
diff --git a/src/content/docs/ja/tutorial/0-introduction/1.mdx b/src/content/docs/ja/tutorial/0-introduction/1.mdx
index d3d0cd61acea9..e3b409b945ef5 100644
--- a/src/content/docs/ja/tutorial/0-introduction/1.mdx
+++ b/src/content/docs/ja/tutorial/0-introduction/1.mdx
@@ -32,7 +32,7 @@ import Box from '~/components/tutorial/Box.astro';
[ユニット1](/ja/tutorial/1-setup/)の各レッスンでは、チュートリアルを完了するために必要な開発ツールとオンラインアカウントを確認できます。また、新しいAstroプロジェクトの作成、GitHubへの保存、Netlifyへのデプロイの手順を説明しています。
-[空の新しいAstroプロジェクトを作成](/ja/install/auto/)し、セットアップすることに慣れている場合は、そのまま[ユニット2](/ja/tutorial/2-pages/)に進み、プロジェクトに新しいページを作成していっても問題ありません。
+[空の新しいAstroプロジェクトを作成](/ja/install-and-setup/)し、セットアップすることに慣れている場合は、そのまま[ユニット2](/ja/tutorial/2-pages/)に進み、プロジェクトに新しいページを作成していっても問題ありません。
diff --git a/src/content/docs/ko/basics/project-structure.mdx b/src/content/docs/ko/basics/project-structure.mdx
index 0d64c8527aeec..f274400f806d0 100644
--- a/src/content/docs/ko/basics/project-structure.mdx
+++ b/src/content/docs/ko/basics/project-structure.mdx
@@ -112,7 +112,7 @@ JavaScript 패키지 관리자가 종속성을 관리하는 데 사용하는 파
`dependencies`와 `devDependencies`는 `package.json` 파일에서 설정할 수 있는 [두 종류의 종속성](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file)입니다. 대부분의 경우 이는 동일하게 작동합니다. Astro는 빌드 시 모든 종속성을 필요로 하며 패키지 관리자는 두 종류의 종속성을 모두 설치합니다. 프로젝트를 시작하기 위해 모든 종속성을 `dependencies`에 두고, 특정 요구 사항이 있는 경우에만 `devDependencies`를 사용하는 것을 권장합니다.
-프로젝트에 새 `package.json` 파일을 생성하는 데 도움이 필요하면 [수동 설치](/ko/install/manual/)를 확인하세요.
+프로젝트에 새 `package.json` 파일을 생성하는 데 도움이 필요하면 [수동 설치](/ko/install-and-setup/#수동-설정)를 확인하세요.
### `astro.config.mjs`
diff --git a/src/content/docs/ko/getting-started.mdx b/src/content/docs/ko/getting-started.mdx
index 408e84797c618..c2510e029ae1a 100644
--- a/src/content/docs/ko/getting-started.mdx
+++ b/src/content/docs/ko/getting-started.mdx
@@ -11,7 +11,7 @@ hero:
actions:
- text: Astro 설치
icon: rocket
- link: /ko/install/auto/
+ link: /ko/install-and-setup/
variant: primary
- text: Astro의 기능에 대해 알아보세요
icon: right-arrow
@@ -43,7 +43,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- [설치 가이드](/ko/install/auto/)에는 CLI 마법사를 사용하여 Astro를 설치하고, 기존 Astro GitHub 저장소에서 새 프로젝트를 생성하고, Astro를 수동으로 직접 설치하는 단계별 지침이 있습니다.
+ [설치 가이드](/ko/install-and-setup/)에는 CLI 마법사를 사용하여 Astro를 설치하고, 기존 Astro GitHub 저장소에서 새 프로젝트를 생성하고, Astro를 수동으로 직접 설치하는 단계별 지침이 있습니다.
diff --git a/src/content/docs/ko/guides/cms/apostrophecms.mdx b/src/content/docs/ko/guides/cms/apostrophecms.mdx
index c5723bafa195b..2243385c97154 100644
--- a/src/content/docs/ko/guides/cms/apostrophecms.mdx
+++ b/src/content/docs/ko/guides/cms/apostrophecms.mdx
@@ -19,7 +19,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
시작하려면 다음이 필요합니다.
-1. [Node.js 어댑터](/ko/guides/integrations-guide/node/)가 설치되고 `output: 'server'`가 구성된 **주문형 렌더링된 Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하여 실행할 수 있습니다.
+1. [Node.js 어댑터](/ko/guides/integrations-guide/node/)가 설치되고 `output: 'server'`가 구성된 **주문형 렌더링된 Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하여 실행할 수 있습니다.
2. **`APOS_EXTERNAL_FRONT_KEY`라는 환경 변수가 구성된 ApostropheCMS 프로젝트** - 이 환경 변수는 임의의 문자열로 설정할 수 있습니다. 아직 ApostropheCMS 프로젝트가 없다면 [설치 가이드](https://docs.apostrophecms.org/guide/development-setup.html)를 통해 빠르게 설치할 수 있습니다. [Apostrophe CLI 도구](https://apostrophecms.com/extensions/apos-cli)를 사용하면 설치가 쉬워지므로 이를 사용하는 것을 권장합니다.
diff --git a/src/content/docs/ko/guides/cms/buttercms.mdx b/src/content/docs/ko/guides/cms/buttercms.mdx
index 4ec5811d0c204..655f069359e74 100644
--- a/src/content/docs/ko/guides/cms/buttercms.mdx
+++ b/src/content/docs/ko/guides/cms/buttercms.mdx
@@ -23,7 +23,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
### 전제 조건
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **ButterCMS 계정**. 계정이 없다면 무료 평가판에 [가입](https://buttercms.com/join/)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/cms/contentful.mdx b/src/content/docs/ko/guides/cms/contentful.mdx
index 9a0976f0e60f4..774ae2cbacb56 100644
--- a/src/content/docs/ko/guides/cms/contentful.mdx
+++ b/src/content/docs/ko/guides/cms/contentful.mdx
@@ -20,7 +20,7 @@ import { Steps } from '@astrojs/starlight/components';
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **Contentful 계정과 Contentful space**. 계정이 없다면 무료 계정에 [가입](https://www.contentful.com/sign-up/)하고 새로운 Contentful space를 만들 수 있습니다. 기존 space가 있는 경우 이를 사용할 수도 있습니다.
diff --git a/src/content/docs/ko/guides/cms/cosmic.mdx b/src/content/docs/ko/guides/cms/cosmic.mdx
index 8e190d8cb5f3f..fdd9a64b7df3c 100644
--- a/src/content/docs/ko/guides/cms/cosmic.mdx
+++ b/src/content/docs/ko/guides/cms/cosmic.mdx
@@ -15,7 +15,7 @@ import { Steps } from '@astrojs/starlight/components';
## 전제 조건
-1. **Astro 프로젝트** - 새로운 Astro 프로젝트를 시작하고 싶다면 [설치 가이드](/ko/install/auto/)를 읽어보세요. 이 가이드는 스타일링을 위해 Tailwind CSS를 사용하는 [Astro 헤드리스 CMS 테마](https://astro.build/themes/details/cosmic-cms-blog/)의 단순화된 버전을 따릅니다.
+1. **Astro 프로젝트** - 새로운 Astro 프로젝트를 시작하고 싶다면 [설치 가이드](/ko/install-and-setup/)를 읽어보세요. 이 가이드는 스타일링을 위해 Tailwind CSS를 사용하는 [Astro 헤드리스 CMS 테마](https://astro.build/themes/details/cosmic-cms-blog/)의 단순화된 버전을 따릅니다.
2. **Cosmic 계정과 Bucket** - Cosmic 계정이 없다면 [무료로 계정을 만드세요](https://app.cosmicjs.com/signup). 계정을 생성한 후에는 비어 있는 새 프로젝트를 생성하라는 메시지가 표시됩니다. 이 가이드에 사용된 모든 콘텐츠를 자동으로 가져오는 데 사용할 수 있는 [Simple Astro Blog 템플릿](https://www.cosmicjs.com/marketplace/templates/simple-astro-blog) (Astro 헤드리스 CMS 테마와 동일한 템플릿)도 있습니다.
3. **Cosmic API keys** - Cosmic 대시보드에서 Cosmic에 연결하려면 **Bucket slug** 및 **Bucket read key**를 모두 찾아야 합니다.
diff --git a/src/content/docs/ko/guides/cms/datocms.mdx b/src/content/docs/ko/guides/cms/datocms.mdx
index a8c66f2760882..3b67247397c10 100644
--- a/src/content/docs/ko/guides/cms/datocms.mdx
+++ b/src/content/docs/ko/guides/cms/datocms.mdx
@@ -20,7 +20,7 @@ import { FileTree } from '@astrojs/starlight/components';
시작하려면 다음이 필요합니다.
-- **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)의 안내를 따르세요.
+- **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)의 안내를 따르세요.
- **DatoCMS 계정 및 프로젝트** - 계정이 없으면 [무료 계정에 가입](https://dashboard.datocms.com/signup)할 수 있습니다.
- **DatoCMS 프로젝트의 읽기 전용 API 키** - 프로젝트 관리 대시보드의 "Settings" > "API Tokens"에서 찾을 수 있습니다.
diff --git a/src/content/docs/ko/guides/cms/ghost.mdx b/src/content/docs/ko/guides/cms/ghost.mdx
index f82be6518b4df..88d76ae2a18f2 100644
--- a/src/content/docs/ko/guides/cms/ghost.mdx
+++ b/src/content/docs/ko/guides/cms/ghost.mdx
@@ -20,7 +20,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **Ghost 사이트** - Ghost로 설정된 사이트가 있다고 가정합니다. 그렇지 않은 경우 [로컬 환경](https://ghost.org/docs/install/local/)에서 설정할 수 있습니다.
diff --git a/src/content/docs/ko/guides/cms/hashnode.mdx b/src/content/docs/ko/guides/cms/hashnode.mdx
index f7ce6e4b738bb..542df66493cb0 100644
--- a/src/content/docs/ko/guides/cms/hashnode.mdx
+++ b/src/content/docs/ko/guides/cms/hashnode.mdx
@@ -19,7 +19,7 @@ import { Steps } from '@astrojs/starlight/components';
### 전제조건
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **Hashnode 사이트** - [Hashnode](https://hashnode.com/)에 접속하면 무료로 개인 사이트를 생성할 수 있습니다.
diff --git a/src/content/docs/ko/guides/cms/payload.mdx b/src/content/docs/ko/guides/cms/payload.mdx
index 2cc2aea01441a..567c43d94d6e2 100644
--- a/src/content/docs/ko/guides/cms/payload.mdx
+++ b/src/content/docs/ko/guides/cms/payload.mdx
@@ -14,7 +14,7 @@ import { Steps } from '@astrojs/starlight/components';
### 전제 조건
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 바로 실행해 보세요.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 바로 실행해 보세요.
2. **MongoDB 데이터베이스** - PayloadCMS는 새 프로젝트를 생성할 때 MongoDB 연결 문자열을 요청합니다. 로컬로 설정하거나 [MongoDBAtlas](https://www.mongodb.com/)를 사용하여 웹에서 무료로 데이터베이스를 호스팅할 수 있습니다.
3. **PayloadCMS REST API** - [PayloadCMS](https://payloadcms.com/docs/getting-started/installation) 프로젝트를 생성하고 설정 중에 MongoDB 데이터베이스에 연결합니다.
diff --git a/src/content/docs/ko/guides/cms/statamic.mdx b/src/content/docs/ko/guides/cms/statamic.mdx
index 7beab5c70a70b..3b7c34b3888ee 100644
--- a/src/content/docs/ko/guides/cms/statamic.mdx
+++ b/src/content/docs/ko/guides/cms/statamic.mdx
@@ -21,7 +21,7 @@ Statamic에는 데이터를 Astro에 연결하기 위한 [REST API](https://stat
시작하려면 다음이 필요합니다.
1. REST API 및 GraphQL API는 Statamic의 프로 버전에서만 사용할 수 있습니다. [로컬 장치](https://statamic.dev/tips/how-to-enable-statamic-pro#trial-mode)에서 Pro 버전을 무료로 사용해 볼 수 있습니다.
-2. **Astro 프로젝트** - Astro 프로젝트가 여전히 필요한 경우 [설치 가이드](/ko/install/auto/)를 통해 빠르게 시작하고 실행할 수 있습니다.
+2. **Astro 프로젝트** - Astro 프로젝트가 여전히 필요한 경우 [설치 가이드](/ko/install-and-setup/)를 통해 빠르게 시작하고 실행할 수 있습니다.
3. **Statamic 사이트** - Statamic 웹사이트가 필요한 경우 [이 가이드](https://statamic.dev/quick-start-guide)가 시작하는 데 도움이 될 것입니다.
`.env` 파일에 `STATAMIC_API_ENABLED=true` 또는 `STATAMIC_GRAPHQL_ENABLED=true`를 추가하여 [REST API](https://statamic.dev/rest-api#enable-the-api) 또는 [GraphQL API를 활성화](https://statamic.dev/graphql#enable-graphql)하고 API 구성 파일에서 필수 리소스를 활성화해야 합니다.
diff --git a/src/content/docs/ko/guides/cms/storyblok.mdx b/src/content/docs/ko/guides/cms/storyblok.mdx
index 1e0e2b6f54683..664161357a75c 100644
--- a/src/content/docs/ko/guides/cms/storyblok.mdx
+++ b/src/content/docs/ko/guides/cms/storyblok.mdx
@@ -21,7 +21,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **Storyblok 계정 및 space** - 아직 계정이 없다면 [무료로 회원가입](https://app.storyblok.com/#/signup)하고 새로운 space를 만드세요.
diff --git a/src/content/docs/ko/guides/cms/strapi.mdx b/src/content/docs/ko/guides/cms/strapi.mdx
index 840de63205e84..51efdecf4b557 100644
--- a/src/content/docs/ko/guides/cms/strapi.mdx
+++ b/src/content/docs/ko/guides/cms/strapi.mdx
@@ -21,7 +21,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **Strapi CMS 서버** - [로컬 환경에 Strapi 서버를 설정](https://docs.strapi.io/dev-docs/quick-start)할 수 있습니다.
### `.env`에 Strapi URL 추가
diff --git a/src/content/docs/ko/guides/cms/umbraco.mdx b/src/content/docs/ko/guides/cms/umbraco.mdx
index 433ee4566f076..b272cbffa2b64 100644
--- a/src/content/docs/ko/guides/cms/umbraco.mdx
+++ b/src/content/docs/ko/guides/cms/umbraco.mdx
@@ -19,7 +19,7 @@ import ReadMore from '~/components/ReadMore.astro';
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 통해 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 통해 즉시 설치하고 실행할 수 있습니다.
2. **Umbraco (v12+) 프로젝트** - 아직 Umbraco 프로젝트가 없다면 이 [설치 가이드](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/)를 참조하세요.
### Content Delivery API 설정
@@ -69,7 +69,7 @@ const articles = await res.json();
### 전제조건
-- **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 바로 실행해 보세요.
+- **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 바로 실행해 보세요.
- Content Delivery API가 활성화된 **Umbraco 프로젝트 (v12+)** - 이 [설치 가이드](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/)에 따라 새 프로젝트를 생성하세요.
diff --git a/src/content/docs/ko/guides/cms/wordpress.mdx b/src/content/docs/ko/guides/cms/wordpress.mdx
index a8ec58bf32c06..61f0b16f5791b 100644
--- a/src/content/docs/ko/guides/cms/wordpress.mdx
+++ b/src/content/docs/ko/guides/cms/wordpress.mdx
@@ -21,7 +21,7 @@ WordPress에는 WordPress 데이터를 Astro에 연결하기 위한 [WordPress R
시작하려면 다음이 필요합니다.
-1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install/auto/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
+1. **Astro 프로젝트** - 아직 Astro 프로젝트가 없다면 [설치 가이드](/ko/install-and-setup/)를 참조하여 즉시 설치하고 실행할 수 있습니다.
2. **WordPress 사이트** - 사이트의 REST API는 `[YOUR_SITE]/wp-json/wp/v2/`이며 기본적으로 모든 WordPress 사이트에서 사용할 수 있습니다. [로컬 환경에서 WordPress를 설정](https://wordpress.org/support/article/installing-wordpress-on-your-own-computer/)하는 것도 가능합니다.
### 자격 증명 설정
diff --git a/src/content/docs/ko/guides/deploy/render.mdx b/src/content/docs/ko/guides/deploy/render.mdx
index 4e119f5658a53..5cd6b76403ba1 100644
--- a/src/content/docs/ko/guides/deploy/render.mdx
+++ b/src/content/docs/ko/guides/deploy/render.mdx
@@ -20,7 +20,7 @@ Astro 프로젝트를 [Render](https://render.com/)에 배포할 수 있습니
4. 웹 사이트 이름을 지정하고 브랜치를 선택한 다음 빌드 명령과 게시 디렉터리를 지정합니다.
- **빌드 명령:** `npm run build`
- **게시 디렉터리:** `dist`
- - **환경 변수 (고급)**: 기본적으로 Render는 Node.js 14.17.0을 사용하지만 Astro에서는 [더 높은 버전이 필요합니다](/ko/install/auto/#요구사항). Render에 호환되는 Node.js 버전을 사용하도록 지시하려면 **Variable key**가 `NODE_VERSION`이고 **Value**가 `v18.17.1` 또는 `v20.3.0` 이상인 환경 변수를 추가하세요. 또는 Node.js 버전을 지정하기 위해 프로젝트에 [`.node-version`](https://render.com/docs/node-version)이나 [`.nvmrc`](https://render.com/docs/node-version) 파일을 추가하세요.
+ - **환경 변수 (고급)**: 기본적으로 Render는 Node.js 14.17.0을 사용하지만 Astro에서는 [더 높은 버전이 필요합니다](/ko/install-and-setup/#전제-조건). Render에 호환되는 Node.js 버전을 사용하도록 지시하려면 **Variable key**가 `NODE_VERSION`이고 **Value**가 `v18.17.1` 또는 `v20.3.0` 이상인 환경 변수를 추가하세요. 또는 Node.js 버전을 지정하기 위해 프로젝트에 [`.node-version`](https://render.com/docs/node-version)이나 [`.nvmrc`](https://render.com/docs/node-version) 파일을 추가하세요.
5. **Create Static Site** 버튼을 클릭하세요.
diff --git a/src/content/docs/ko/guides/images.mdx b/src/content/docs/ko/guides/images.mdx
index f64d66833f31f..35c8b3fdf9568 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/#별칭)을 구성하고 사용해야 합니다. 그런 다음 가져오기 이름을 `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` 및 `![]()
` 태그에 사용할 기타 속성에 액세스할 수 있습니다.
+로컬 이미지는 기존 `.astro` 파일의 **상대 경로에서 가져오거나** [가져오기 별칭](/ko/guides/imports/#별칭)을 구성하고 사용해야 합니다. 그런 다음 이미지의 `src` 및 `![]()
` 태그에 사용할 기타 속성에 액세스할 수 있습니다.
예를 들어, CLS를 방지하고 Core Web Vitals를 개선하려면 이미지 자체의 `height` 및 `width` 속성을 사용하세요.
@@ -778,7 +778,7 @@ export default defineConfig({
#### `~/assets` 가져오기 별칭 제거
-이 가져오기 별칭은 더 이상 `astro:assets`에 기본적으로 포함되지 않습니다. 실험적 자산과 함께 이 별칭을 사용하는 경우 이를 상대 파일 경로로 변환하거나 [자신만의 가져오기 별칭을 생성](/ko/guides/aliases/)해야 합니다.
+이 가져오기 별칭은 더 이상 `astro:assets`에 기본적으로 포함되지 않습니다. 실험적 자산과 함께 이 별칭을 사용하는 경우 이를 상대 파일 경로로 변환하거나 [자신만의 가져오기 별칭을 생성](/ko/guides/imports/#별칭)해야 합니다.
```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
---
diff --git a/src/content/docs/ko/guides/imports.mdx b/src/content/docs/ko/guides/imports.mdx
index b81fb27b37da8..270b41c6dcf2b 100644
--- a/src/content/docs/ko/guides/imports.mdx
+++ b/src/content/docs/ko/guides/imports.mdx
@@ -146,6 +146,50 @@ import txtReference from './words.txt'; // txtReference === '/src/words.txt'
접근성을 위해 `![]()
` 태그에 **대체 텍스트**를 추가하는 것이 좋습니다! 이미지 요소에 `alt="유용한 설명"` 속성을 추가하는 것을 잊지 마세요. 이미지가 순전히 장식용인 경우 속성을 비워 둘 수 있습니다.
:::
+## 별칭
+
+**별칭**은 가져오기에 대한 바로가기를 만드는 방법입니다.
+
+별칭은 디렉터리 또는 상대 경로에서 가져오는 경우가 많은 코드베이스의 개발 경험을 개선하는 데 도움이 됩니다.
+
+```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';
+---
+```
+
+이 예에서 개발자는 `src/pages/about/company.astro`, `src/components/controls/Button.astro`, `src/assets/logo.png` 세 파일 간의 트리 관계를 이해해야 합니다. 그리고 `company.astro` 파일을 옮기려면 가져오는 경로도 함께 업데이트해야 합니다.
+
+`tsconfig.json` 또는 `jsconfig.json` 파일에서 가져오기 별칭을 추가할 수 있습니다.
+
+```json title="tsconfig.json" ins={5-6}
+{
+ "compilerOptions": {
+ "baseUrl": ".",
+ "paths": {
+ "@components/*": ["src/components/*"],
+ "@assets/*": ["src/assets/*"]
+ }
+ }
+}
+```
+
+:::note
+별칭 경로를 확인할 수 있도록 `compilerOptions.baseUrl`이 설정되어 있는지 확인하세요.
+:::
+
+이 구성이 변경되면 개발 서버가 자동으로 다시 시작됩니다. 이제 프로젝트의 어느 곳에서나 별칭을 사용하여 가져올 수 있습니다.
+
+```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';
+---
+```
+
+이러한 별칭은 [VS Code](https://code.visualstudio.com/docs/languages/jsconfig) 및 기타 편집기에 자동으로 통합됩니다.
+
## `Astro.glob()`
[`Astro.glob()`](/ko/reference/api-reference/#astroglob)은 한 번에 많은 파일을 가져오는 방법입니다.
diff --git a/src/content/docs/ko/guides/markdown-content.mdx b/src/content/docs/ko/guides/markdown-content.mdx
index bc6eb62dbbefe..fca4c202404aa 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/#별칭))를 지정할 수 있는 특별한 프런트매터 `layout` 속성이 있는 [Markdown 및 MDX 페이지](/ko/basics/astro-pages/#markdownmdx-페이지) (`src/pages/`에 위치하는)를 제공합니다.
```markdown {3}
---
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-docusaurus.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-docusaurus.mdx
index afd3f128c5696..30b76cfb9bcd4 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-docusaurus.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-docusaurus.mdx
@@ -41,7 +41,7 @@ Astro에서 Docusaurus 사이트를 다시 구축하면 몇 가지 중요한 차
Docusaurus 문서 사이트를 Astro로 변환하려면 공식 [Starlight 문서 테마 시작 템플릿](https://starlight.astro.build/ko)으로 시작하거나 [테마 쇼케이스](https://astro.build/themes?search=&categories%5B%5D=docs)에서 더 많은 커뮤니티 문서 테마를 탐색하세요.
-`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-eleventy.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-eleventy.mdx
index 90ad082f48ad5..3eb93816b74ae 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-eleventy.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-eleventy.mdx
@@ -35,7 +35,7 @@ Astro에서 Eleventy (11ty) 사이트를 재빌드하면 몇 가지 중요한
Eleventy 블로그를 Astro로 변환하려면 블로그 테마 시작 템플릿으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 블로그 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-gatsby.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-gatsby.mdx
index 84718e6c5382d..7aa7382c445de 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-gatsby.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-gatsby.mdx
@@ -44,7 +44,7 @@ Astro에서 Gatsby 사이트를 다시 빌드하면 몇 가지 중요한 차이
패키지 관리자의 `create astro` 명령을 사용하여 Astro의 CLI 마법사를 시작하거나 [Astro 테마 쇼케이스](https://astro.build/themes)에서 커뮤니티 테마를 선택하세요.
-`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 (예: `docs`, `blog`, `portfolio`) 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 (예: `docs`, `blog`, `portfolio`) 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-gitbook.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-gitbook.mdx
index f0958d67a72ed..f6a448082f21b 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-gitbook.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-gitbook.mdx
@@ -33,7 +33,7 @@ GitBook 문서를 Astro로 마이그레이션하면 몇 가지 중요한 차이
GitBook 문서 사이트를 Astro로 변환하려면 공식 [Starlight 문서 테마 시작 템플릿](https://starlight.astro.build)으로 시작하거나 [테마 쇼케이스](https://astro.build/themes?search=&categories%5B%5D=docs)에서 더 많은 커뮤니티 문서 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-gridsome.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-gridsome.mdx
index 725d17cd59f45..681b41b08fbbc 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-gridsome.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-gridsome.mdx
@@ -37,7 +37,7 @@ Astro에서 Gridsome 사이트를 다시 구축하면 몇 가지 중요한 차
Gridsome 블로그를 Astro로 변환하려면 블로그 테마 시작 템플릿으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 블로그 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-hugo.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-hugo.mdx
index d0e5379807341..888756a5f9ef9 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-hugo.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-hugo.mdx
@@ -35,7 +35,7 @@ Astro에서 Hugo 사이트를 다시 구축하면 다음과 같은 몇 가지
Hugo 블로그를 Astro로 변환하려면 블로그 테마 시작 템플릿으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 블로그 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-jekyll.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-jekyll.mdx
index 351dc7043c8a4..c92c5c1532f18 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-jekyll.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-jekyll.mdx
@@ -33,7 +33,7 @@ Astro에서 Jekyll 사이트를 다시 구축하면 몇 가지 중요한 차이
Jekyll 블로그를 Astro로 변환하려면 블로그 테마 시작 템플릿으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 블로그 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-nextjs.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-nextjs.mdx
index 38930016eb995..cd8c0fa7ab758 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-nextjs.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-nextjs.mdx
@@ -41,7 +41,7 @@ Astro에서 Next.js 사이트를 다시 빌드하면 몇 가지 중요한 차이
패키지 관리자의 `create astro` 명령을 사용하여 Astro의 CLI 마법사를 시작하거나 [Astro 테마 쇼케이스](https://astro.build/themes)에서 커뮤니티 테마를 선택하세요.
-`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 (예: `docs`, `blog`, `portfolio`) 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 (예: `docs`, `blog`, `portfolio`) 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-nuxtjs.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-nuxtjs.mdx
index 6beacab620bb9..708cbc3bac090 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-nuxtjs.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-nuxtjs.mdx
@@ -43,7 +43,7 @@ Astro에서 Nuxt 사이트를 재빌드하면 몇 가지 중요한 차이점을
패키지 관리자의 `create astro` 명령을 사용하여 Astro의 CLI 마법사를 시작하거나 [Astro 테마 쇼케이스](https://astro.build/themes)에서 커뮤니티 테마를 선택하세요.
-`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 (예: `docs`, `blog`, `portfolio`) 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+`create astro` 명령에 `--template` 인수를 전달하여 공식 스타터 (예: `docs`, `blog`, `portfolio`) 중 하나를 사용하여 새 Astro 프로젝트를 시작할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-pelican.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-pelican.mdx
index fb815e84dfb48..432f5a3f4fe79 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-pelican.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-pelican.mdx
@@ -33,7 +33,7 @@ Astro에서 Pelican 사이트를 다시 빌드하면 몇 가지 중요한 차이
Pelican 문서 사이트를 Astro로 변환하려면 공식 [Starlight 문서 테마 시작 템플릿](https://starlight.astro.build)으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-sveltekit.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-sveltekit.mdx
index 0181ee4eaf02d..8010ab6c80e08 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-sveltekit.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-sveltekit.mdx
@@ -39,7 +39,7 @@ Astro에서 SvelteKit 사이트를 다시 구축하면 몇 가지 중요한 차
SvelteKit 블로그를 Astro로 변환하려면 블로그 테마 시작 템플릿으로 시작하거나 [테마 쇼케이스](https://astro.build/themes/)에서 더 많은 커뮤니티 블로그 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-vuepress.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-vuepress.mdx
index f4b6eb358fcb9..34b743982a960 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-vuepress.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-vuepress.mdx
@@ -35,7 +35,7 @@ Astro에서 VuePress 사이트를 다시 구축하면 몇 가지 중요한 차
VuePress 문서 사이트를 Astro로 변환하려면 공식 [Starlight 문서 테마 시작 템플릿](https://starlight.astro.build)으로 시작하거나 [테마 쇼케이스](https://astro.build/themes?search=&categories%5B%5D=docs)에서 더 많은 커뮤니티 문서 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/migrate-to-astro/from-wordpress.mdx b/src/content/docs/ko/guides/migrate-to-astro/from-wordpress.mdx
index 2b74459a04904..e54c698c539cf 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/from-wordpress.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/from-wordpress.mdx
@@ -37,7 +37,7 @@ Astro에서 WordPress 사이트를 다시 빌드하면 몇 가지 중요한 차
WordPress 블로그를 Astro로 변환하려면 블로그 테마 시작 템플릿으로 시작하거나 [테마 쇼케이스](https://astro.build/themes)에서 더 많은 커뮤니티 블로그 테마를 탐색하세요.
-공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install/auto/#시작-템플릿)할 수 있습니다.
+공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 `--template` 인수를 `create astro` 명령에 전달할 수 있습니다. 또는 [GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작](/ko/install-and-setup/#테마-또는-시작-템플릿-사용)할 수 있습니다.
diff --git a/src/content/docs/ko/guides/typescript.mdx b/src/content/docs/ko/guides/typescript.mdx
index 10156283d91fd..1459103ed4f8d 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/#별칭)을 지원합니다.
```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..00e370ef714e4 100644
--- a/src/content/docs/ko/install-and-setup.mdx
+++ b/src/content/docs/ko/install-and-setup.mdx
@@ -408,7 +408,7 @@ Astro는 배포 가능한 버전의 사이트를 별도의 폴더 (기본적으
-If you started your project using [the `create astro` wizard](/en/install/auto/#1-run-the-setup-wizard), you can also use the scripts in `package.json` for a shorter version of these commands. See the `README.md` in your project for details of which commands are available.
+If you started your project using [the `create astro` wizard](/en/install-and-setup/), you can also use the scripts in `package.json` for a shorter version of these commands. See the `README.md` in your project for details of which commands are available.
diff --git a/src/content/docs/ko/tutorial/0-introduction/1.mdx b/src/content/docs/ko/tutorial/0-introduction/1.mdx
index fc764828b82a0..1c29d9ad3f88a 100644
--- a/src/content/docs/ko/tutorial/0-introduction/1.mdx
+++ b/src/content/docs/ko/tutorial/0-introduction/1.mdx
@@ -32,7 +32,7 @@ import Box from '~/components/tutorial/Box.astro';
[1단계](/ko/tutorial/1-setup/) 강의를 통해 튜토리얼을 완료하는 데 필요한 개발 도구와 온라인 계정이 있는지 확인할 수 있습니다. 새 Astro 프로젝트를 생성하고, GitHub에 저장하고, Netlify에 배포하는 과정을 안내합니다.
-[비어있는 새 Astro 프로젝트를 생성](/ko/install/auto/)하고 설정에 익숙하다면 안전하게 [2단계](/ko/tutorial/2-pages/)로 건너뛸 수 있습니다. 프로젝트에서 새 페이지를 만들기 시작합니다.
+[비어있는 새 Astro 프로젝트를 생성](/ko/install-and-setup/)하고 설정에 익숙하다면 안전하게 [2단계](/ko/tutorial/2-pages/)로 건너뛸 수 있습니다. 프로젝트에서 새 페이지를 만들기 시작합니다.
diff --git a/src/content/docs/pl/getting-started.mdx b/src/content/docs/pl/getting-started.mdx
index ff79711dd3f7a..7d48cd671b795 100644
--- a/src/content/docs/pl/getting-started.mdx
+++ b/src/content/docs/pl/getting-started.mdx
@@ -11,7 +11,7 @@ hero:
actions:
- text: Rozpocznij
icon: rocket
- link: /pl/install/auto/
+ link: /pl/install-and-setup/
variant: primary
- text: Dowiedz się więcej o funkcjach Astro
icon: right-arrow
@@ -43,7 +43,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- Nasz [przewodnik instalacji](/pl/install/auto/) zawiera instrukcje mówiące krok po kroku jak zainstalować Astro za pomocą instalatora CLI, jak stworzyć nowy projekt z istniejącego repozytorium Astro na GitHubie, oraz jak ręcznie zainstalować Astro.
+ Nasz [przewodnik instalacji](/pl/install-and-setup/) zawiera instrukcje mówiące krok po kroku jak zainstalować Astro za pomocą instalatora CLI, jak stworzyć nowy projekt z istniejącego repozytorium Astro na GitHubie, oraz jak ręcznie zainstalować Astro.
diff --git a/src/content/docs/pt-br/basics/project-structure.mdx b/src/content/docs/pt-br/basics/project-structure.mdx
index 20c5f88a48e14..f18ed0b31c1f3 100644
--- a/src/content/docs/pt-br/basics/project-structure.mdx
+++ b/src/content/docs/pt-br/basics/project-structure.mdx
@@ -112,7 +112,7 @@ Este é um arquivo utilizado por gerenciadores de pacotes de JavaScript para ger
Existem [dois tipos de dependências](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) que você pode especificar em um arquivo `package.json`: `dependencies` e `devDependencies`. Na maioria dos casos, elas funcionam da mesma forma: Astro precisa de todas as dependências em tempo de build e seu gerenciador de pacotes irá instalar ambas. Nós recomendados colocar todas as suas dependências em `dependencies` de início e apenas utilizar `devDependencies` se você tiver um motivo específico para fazer isso.
-Caso precise de ajuda em como criar um novo arquivo `package.json` para o seu projeto, veja as instruções de [instalação manual](/pt-br/install/manual/).
+Caso precise de ajuda em como criar um novo arquivo `package.json` para o seu projeto, veja as instruções de [instalação manual](/pt-br/install-and-setup/#manual-setup).
### `astro.config.mjs`
diff --git a/src/content/docs/pt-br/getting-started.mdx b/src/content/docs/pt-br/getting-started.mdx
index 7d3071e6619c6..8ced777e933cb 100644
--- a/src/content/docs/pt-br/getting-started.mdx
+++ b/src/content/docs/pt-br/getting-started.mdx
@@ -15,7 +15,7 @@ hero:
actions:
- text: Instalar Astro
icon: rocket
- link: /pt-br/install/auto/
+ link: /pt-br/install-and-setup/
variant: primary
- text: Leia sobre as funcionalidades do Astro
icon: right-arrow
@@ -47,7 +47,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- Nosso [guia de instalação](/pt-br/install/auto/) tem instruções passo a passo para instalar o Astro usando nosso assistente de linha de comando, criar um novo projeto de um repositório Astro no GitHub e para instalar o Astro manualmente.
+ Nosso [guia de instalação](/pt-br/install-and-setup/) tem instruções passo a passo para instalar o Astro usando nosso assistente de linha de comando, criar um novo projeto de um repositório Astro no GitHub e para instalar o Astro manualmente.
diff --git a/src/content/docs/pt-br/guides/cms/wordpress.mdx b/src/content/docs/pt-br/guides/cms/wordpress.mdx
index 6f4b99a6fc212..e4c6c90b980cb 100644
--- a/src/content/docs/pt-br/guides/cms/wordpress.mdx
+++ b/src/content/docs/pt-br/guides/cms/wordpress.mdx
@@ -20,7 +20,7 @@ WordPress vem com uma [WordPress REST API](https://developer.wordpress.org/rest-
Para começar, você precisa ter o seguinte:
-1. **Um projeto Astro** - Se você ainda não tem um projeto Astro, nosso [Guia de Instalação](/pt-br/install/auto/) fará você construir um projeto o quanto antes.
+1. **Um projeto Astro** - Se você ainda não tem um projeto Astro, nosso [Guia de Instalação](/pt-br/install-and-setup/) fará você construir um projeto o quanto antes.
2. **Um site WordPress** - A API REST do seu site é `[SEU_SITE]/wp-json/wp/v2/` e está disponível por padrão em qualquer site WordPress. Também é possível [configurar WordPress em um ambiente local](https://wordpress.org/support/article/installing-wordpress-on-your-own-computer/).
### Configurando Credenciais
diff --git a/src/content/docs/pt-br/guides/deploy/render.mdx b/src/content/docs/pt-br/guides/deploy/render.mdx
index c05b44a1d9765..6ecf63ba5867b 100644
--- a/src/content/docs/pt-br/guides/deploy/render.mdx
+++ b/src/content/docs/pt-br/guides/deploy/render.mdx
@@ -15,5 +15,5 @@ Você pode fazer deploy do seu projeto Astro no [Render](https://render.com/), u
4. Dê um nome ao seu site, selecione a branch e especifique o comando de build e diretório de publicação
- **build command:** `npm run build`
- **publish directory:** `dist`
- - **Environment variables (advanced)**: Por padrão, o Render utiliza Node.js 14.17.0, mas o Astro [requer uma versão maior](/pt-br/install/auto/#pré-requisitos). Adicione uma variável de ambiente com uma **Variable key** de `NODE_VERSION` e um **Value** de `18.14.1` ou maior para instruir o Render a usar uma versão compatível do Node.js. Alternativamente, adicione um arquivo [`.node-version`](https://render.com/docs/node-version) ou [`.nvmrc`](https://render.com/docs/node-version) em seu projeto para especificar uma versão do Node.js.
+ - **Environment variables (advanced)**: Por padrão, o Render utiliza Node.js 14.17.0, mas o Astro [requer uma versão maior](/pt-br/install-and-setup/#prerequisites). Adicione uma variável de ambiente com uma **Variable key** de `NODE_VERSION` e um **Value** de `18.14.1` ou maior para instruir o Render a usar uma versão compatível do Node.js. Alternativamente, adicione um arquivo [`.node-version`](https://render.com/docs/node-version) ou [`.nvmrc`](https://render.com/docs/node-version) em seu projeto para especificar uma versão do Node.js.
5. Clique no botão **Create Static Site**
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 `![]()
`, 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 `![]()
`.
+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 `![]()
`.
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/imports.mdx b/src/content/docs/pt-br/guides/imports.mdx
index b24a0c249de2e..a1f80d1d355db 100644
--- a/src/content/docs/pt-br/guides/imports.mdx
+++ b/src/content/docs/pt-br/guides/imports.mdx
@@ -146,6 +146,51 @@ Também pode ser útil colocar as imagens no diretório `public/` como explicado
Adicionar **texto alternativo** a tags `![]()
` é encorajado por acessibilidade! Não se esqueça de adicionar um atributo `alt="uma descrição útil"` para seus elementos de imagem. Você pode deixar o atributo vazio se a imagem for puramente decorativa.
:::
+## Aliases
+
+Um **alias** é uma maneira de criar atalhos para as suas importações.
+
+Os aliases podem ajudar a melhorar a experiência de desenvolvimento em bases de código com muitos diretórios ou importações relativas.
+
+```astro title="src/pages/sobre/empresa.astro" del="../../components" del="../../assets"
+---
+import Botao from '../../components/controles/Botao.astro';
+import logoUrl from '../../assets/logo.png?url';
+---
+```
+
+Nesse exemplo, um desenvolvedor precisaria entender a relação de árvore entre `src/pages/sobre/empresa.astro`, `src/components/controles/Botao.astro` e `src/assets/logo.png`. E então, se o arquivo `empresa.astro` fosse movido, essas importações também precisariam ser atualizadas.
+
+
+Você pode adicionar aliases de importação a partir de `tsconfig.json` ou `jsconfig.json`.
+
+```json title="tsconfig.json" ins={5-6}
+{
+ "compilerOptions": {
+ "baseUrl": ".",
+ "paths": {
+ "@components/*": ["src/components/*"],
+ "@assets/*": ["src/assets/*"]
+ }
+ }
+}
+```
+
+:::note
+Certifique-se de que `compilerOptions.baseUrl` foi definido para que assim os caminhos com aliases sejam resolvidos.
+:::
+
+O servidor de desenvolvimento será reiniciado automaticamente após essa alteração de configuração. Agora você pode importar usando os aliases em qualquer lugar do seu projeto:
+
+```astro title="src/pages/sobre/empresa.astro" ins="@components" ins="@assets"
+---
+import Botao from '@components/Botao.astro';
+import logoUrl from '@assets/logo.png?url';
+---
+```
+
+Esses aliases também são integrados automaticamente ao [VS Code](https://code.visualstudio.com/docs/languages/jsconfig) e a outros editores.
+
## `Astro.glob()`
[`Astro.glob()`](/pt-br/reference/api-reference/#astroglob) é uma forma de importar vários arquivos de uma vez.
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/pt-br/reference/cli-reference.mdx b/src/content/docs/pt-br/reference/cli-reference.mdx
index b45bd3c5691e9..df07b82a70d99 100644
--- a/src/content/docs/pt-br/reference/cli-reference.mdx
+++ b/src/content/docs/pt-br/reference/cli-reference.mdx
@@ -92,9 +92,9 @@ Os `--` extras antes de qualquer flag são necessários para que o `npm` passe s
Você também pode usar scripts no `package.json` para versões mais curtas desses comandos. Usando um script permite você usar os mesmos comandos que você pode estar familiarizado com outros projetos, como o `npm run build`.
-Os seguintes scripts para os comandos `astro` comuns (`astro dev`, `astro build` e `astro preview`) são adicionados pra você automaticamente quando você cria um projeto usando [o assistente `create astro`](/pt-br/install/auto/#1-execute-o-assistente-de-instalação).
+Os seguintes scripts para os comandos `astro` comuns (`astro dev`, `astro build` e `astro preview`) são adicionados pra você automaticamente quando você cria um projeto usando [o assistente `create astro`](/pt-br/install-and-setup/).
-Quando você segue as instruções para [instalar o Astro manualmente](/pt-br/install/manual/#2-instale-astro), você é instruído a adicionar esses scripts você mesmo. Você também pode adicionar mais scripts para essa lista manualmente para qualquer comando que você usa frequentemente.
+Quando você segue as instruções para [instalar o Astro manualmente](/pt-br/install-and-setup/#manual-setup), você é instruído a adicionar esses scripts você mesmo. Você também pode adicionar mais scripts para essa lista manualmente para qualquer comando que você usa frequentemente.
```json title="package.json"
{
@@ -167,7 +167,7 @@ Na maioria dos casos você usará a CLI pelo seu gerenciador de pacotes:
-Se você iniciou seu projeto utilizando [o assistente `create astro`](/pt-br/install/auto/#1-execute-o-assistente-de-instalação), você pode também utilizar os scripts em `package.json` para uma versão mais curta desses comandos. Veja o `README.md` no seu projeto para detalhes sobre quais comandos estão disponíveis.
+Se você iniciou seu projeto utilizando [o assistente `create astro`](/pt-br/install-and-setup/), você pode também utilizar os scripts em `package.json` para uma versão mais curta desses comandos. Veja o `README.md` no seu projeto para detalhes sobre quais comandos estão disponíveis.
diff --git a/src/content/docs/pt-br/tutorial/0-introduction/1.mdx b/src/content/docs/pt-br/tutorial/0-introduction/1.mdx
index f6ddd42e37cd6..ddea1a38a764c 100644
--- a/src/content/docs/pt-br/tutorial/0-introduction/1.mdx
+++ b/src/content/docs/pt-br/tutorial/0-introduction/1.mdx
@@ -32,7 +32,7 @@ Utilizá-lo é opcional, mas pode te ajudar a lembrar sua posição se você com
Você pode usar as lições dentro da [Unidade 1](/pt-br/tutorial/1-setup/) para certificar-se de que você tem as ferramentas de desenvolvimento e contas online que você vai precisar para completar o tutorial. Elas irão te guiar através da criação de um novo projeto Astro, o armazenando no GitHub, e fazendo deploy para a Netlify.
-Se você [criar um novo projeto Astro vazio](/pt-br/install/auto/) e está confortável com sua configuração, você pode pular de forma segura para a [Unidade 2](/pt-br/tutorial/2-pages/) onde você irá começar a fazer novas páginas em seu projeto.
+Se você [criar um novo projeto Astro vazio](/pt-br/install-and-setup/) e está confortável com sua configuração, você pode pular de forma segura para a [Unidade 2](/pt-br/tutorial/2-pages/) onde você irá começar a fazer novas páginas em seu projeto.
diff --git a/src/content/docs/ru/basics/project-structure.mdx b/src/content/docs/ru/basics/project-structure.mdx
index 4e4d90db9bbd7..0167e6b39e438 100644
--- a/src/content/docs/ru/basics/project-structure.mdx
+++ b/src/content/docs/ru/basics/project-structure.mdx
@@ -113,7 +113,7 @@ Astro обрабатывает, оптимизирует и объединяет
В файле `package.json` есть [два вида зависимостей](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file): `dependencies` и `devDependencies`. В большинстве случаев они работают одинаково: Astro нуждается во всех зависимостях на этапе сборки, и ваш менеджер пакетов установит оба. Мы рекомендуем начать с помещения всех ваших зависимостей в `dependencies`, и использовать `devDependencies` только при наличии конкретной необходимости.
-Для помощи в создании нового файла `package.json` для вашего проекта, ознакомьтесь с инструкциями по [ручной установке](/ru/install/manual/).
+Для помощи в создании нового файла `package.json` для вашего проекта, ознакомьтесь с инструкциями по [ручной установке](/ru/install-and-setup/#manual-setup).
### `astro.config.mjs`
diff --git a/src/content/docs/ru/getting-started.mdx b/src/content/docs/ru/getting-started.mdx
index 6d3c979917bf3..8ffca34345cc9 100644
--- a/src/content/docs/ru/getting-started.mdx
+++ b/src/content/docs/ru/getting-started.mdx
@@ -15,7 +15,7 @@ hero:
actions:
- text: Начать
icon: rocket
- link: /ru/install/auto/
+ link: /ru/install-and-setup/
variant: primary
- text: Узнать о возможностях Astro
icon: right-arrow
@@ -47,7 +47,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- В нашем [руководстве по установке] (/ru/install/auto/) есть пошаговые инструкции по установке Astro с помощью мастера CLI, созданию нового проекта из существующего репозитория Astro на GitHub, а также по установке Astro вручную.
+ В нашем [руководстве по установке] (/ru/install-and-setup/) есть пошаговые инструкции по установке Astro с помощью мастера CLI, созданию нового проекта из существующего репозитория Astro на GitHub, а также по установке Astro вручную.
diff --git a/src/content/docs/ru/guides/cms/buttercms.mdx b/src/content/docs/ru/guides/cms/buttercms.mdx
index c21a50973c22c..e2081d4c71946 100644
--- a/src/content/docs/ru/guides/cms/buttercms.mdx
+++ b/src/content/docs/ru/guides/cms/buttercms.mdx
@@ -23,7 +23,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
### Необходимые условия
-1. **Проект Astro** — Если у вас еще нет проекта Astro, наше [Руководство по установке](/ru/install/auto/) поможет вам быстро начать работу.
+1. **Проект Astro** — Если у вас еще нет проекта Astro, наше [Руководство по установке](/ru/install-and-setup/) поможет вам быстро начать работу.
2. **Аккаунт ButterCMS**. Если у вас нет учетной записи, вы можете [зарегистрироваться](https://buttercms.com/join/) для бесплатного пробного периода.
diff --git a/src/content/docs/ru/guides/cms/wordpress.mdx b/src/content/docs/ru/guides/cms/wordpress.mdx
index c97641a1903c5..93948beb08a53 100644
--- a/src/content/docs/ru/guides/cms/wordpress.mdx
+++ b/src/content/docs/ru/guides/cms/wordpress.mdx
@@ -20,7 +20,7 @@ WordPress поставляется со встроенным [WordPress REST API
Чтобы начать работу, вам потребуется следующее:
-1. **Проект Astro** — Если у вас еще нет проекта Astro, наше [Руководство по установке](/ru/install/auto/) поможет вам быстро начать работу.
+1. **Проект Astro** — Если у вас еще нет проекта Astro, наше [Руководство по установке](/ru/install-and-setup/) поможет вам быстро начать работу.
2. **Сайт WordPress** — REST API вашего сайта находится по адресу `[ВАШ_САЙТ]/wp-json/wp/v2/` и доступен по умолчанию на любом сайте WordPress. Также можно [установить WordPress в локальной среде](https://wordpress.org/support/article/installing-wordpress-on-your-own-computer/).
### Настройка учетных данных
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);
---
-```
\ 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/ru/reference/cli-reference.mdx b/src/content/docs/ru/reference/cli-reference.mdx
index 87e1b4a4fb776..5cc0408245458 100644
--- a/src/content/docs/ru/reference/cli-reference.mdx
+++ b/src/content/docs/ru/reference/cli-reference.mdx
@@ -92,9 +92,9 @@ Global Flags
Вы также можете использовать скрипты в `package.json` для более коротких версий этих команд. Использование скриптов позволяет вам использовать те же команды, с которыми вы можете быть знакомы по другим проектам, например `npm run build`.
-Следующие скрипты для наиболее распространённых команд `astro` (`astro dev`, `astro build` и `astro preview`) добавляются автоматически при создании проекта с помощью [инструмента `create astro`](/ru/install/auto/#1-запустите-мастер-настройки).
+Следующие скрипты для наиболее распространённых команд `astro` (`astro dev`, `astro build` и `astro preview`) добавляются автоматически при создании проекта с помощью [инструмента `create astro`](/ru/install-and-setup/).
-Когда вы следуете инструкциям по [установке Astro вручную](/ru/install/manual/#2-установите-astro), вам предлагается самостоятельно добавить эти скрипты. Вы также можете добавить в этот список дополнительные скрипты вручную для часто используемых команд.
+Когда вы следуете инструкциям по [установке Astro вручную](/ru/install-and-setup/#manual-setup), вам предлагается самостоятельно добавить эти скрипты. Вы также можете добавить в этот список дополнительные скрипты вручную для часто используемых команд.
```json title="package.json"
{
diff --git a/src/content/docs/ru/tutorial/0-introduction/1.mdx b/src/content/docs/ru/tutorial/0-introduction/1.mdx
index 52b4951f908b7..62792db6a20cf 100644
--- a/src/content/docs/ru/tutorial/0-introduction/1.mdx
+++ b/src/content/docs/ru/tutorial/0-introduction/1.mdx
@@ -32,7 +32,7 @@ import Box from '~/components/tutorial/Box.astro';
Вы можете использовать уроки [Шага 1](/ru/tutorial/1-setup/) для того, чтобы убедиться, что вы располагаете необходимыми для разработки инструментами и онлайн-аккаунтами. Это позволит вам создать новый проект Astro, сохранить его на GitHub и разместить на Netlify.
-Если вы [создадите новый пустой проект Astro](/ru/install/auto/) и уверены в своей настройке, вы можете спокойно перейти к [Шагу 2](/ru/tutorial/2-pages/) где вы начнете создавать новые страницы в своем проекте.
+Если вы [создадите новый пустой проект Astro](/ru/install-and-setup/) и уверены в своей настройке, вы можете спокойно перейти к [Шагу 2](/ru/tutorial/2-pages/) где вы начнете создавать новые страницы в своем проекте.
diff --git a/src/content/docs/zh-cn/basics/project-structure.mdx b/src/content/docs/zh-cn/basics/project-structure.mdx
index 61fd959f9aa5d..b6b3fda4cd0cd 100644
--- a/src/content/docs/zh-cn/basics/project-structure.mdx
+++ b/src/content/docs/zh-cn/basics/project-structure.mdx
@@ -111,7 +111,7 @@ JavaScript 包管理器用它来管理依赖关系。它也定义了通常用于
在 `package.json` 中可以指定[两种依赖关系](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file)：`dependencies` 和 `devDependencies`。在大多数情况下它们效果一样，Astro 在构建时需要所有依赖，而你的包管理器则会同时安装这两种依赖。我们建议把所有的依赖项放在 `dependencies` 中，只有在你发现有特殊需要后，再使用 `devDependencies`。
-如果想要为你的项目创建新的 `package.json` 文件时遇到困难，请查看[手动设置](/zh-cn/install/manual/)中的说明。
+如果想要为你的项目创建新的 `package.json` 文件时遇到困难，请查看[手动设置](/zh-cn/install-and-setup/#手动设置)中的说明。
### `astro.config.mjs`
diff --git a/src/content/docs/zh-cn/getting-started.mdx b/src/content/docs/zh-cn/getting-started.mdx
index bcdd8cbde59c2..5b245c2e0c148 100644
--- a/src/content/docs/zh-cn/getting-started.mdx
+++ b/src/content/docs/zh-cn/getting-started.mdx
@@ -11,7 +11,7 @@ hero:
actions:
- text: 安装 Astro
icon: rocket
- link: /zh-cn/install/auto/
+ link: /zh-cn/install-and-setup/
variant: primary
- text: 了解 Astro 的特性
icon: right-arrow
@@ -43,7 +43,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- 我们的 [安装指南](/zh-cn/install/auto/) 提供了使用 CLI 向导安装 Astro、从现有的 Astro GitHub 仓库创建新项目以及手动安装 Astro 的逐步说明。
+ 我们的 [安装指南](/zh-cn/install-and-setup/) 提供了使用 CLI 向导安装 Astro、从现有的 Astro GitHub 仓库创建新项目以及手动安装 Astro 的逐步说明。
diff --git a/src/content/docs/zh-cn/guides/cms/apostrophecms.mdx b/src/content/docs/zh-cn/guides/cms/apostrophecms.mdx
index 81d9e6e8fda4e..c60e0ae83c129 100644
--- a/src/content/docs/zh-cn/guides/cms/apostrophecms.mdx
+++ b/src/content/docs/zh-cn/guides/cms/apostrophecms.mdx
@@ -19,7 +19,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
要开始集成，你需要具备以下条件：
-1. **一个按需渲染的 Astro 项目**，已安装 [Node.js 适配器](/zh-cn/guides/integrations-guide/node/) 并配置了 `output: 'server'` - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)将帮助你快速启动。
+1. **一个按需渲染的 Astro 项目**，已安装 [Node.js 适配器](/zh-cn/guides/integrations-guide/node/) 并配置了 `output: 'server'` - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)将帮助你快速启动。
2. **一个配置了名为 `APOS_EXTERNAL_FRONT_KEY` 环境变量的 ApostropheCMS 项目** - 这个环境变量可以设置为任意随机字符串。如果你还没有 ApostropheCMS 项目，[安装指南](https://docs.apostrophecms.org/guide/development-setup.html)将快速帮你设置。我们强烈推荐使用 [Apostrophe CLI 工具](https://apostrophecms.com/extensions/apos-cli) 来简化这个过程。
diff --git a/src/content/docs/zh-cn/guides/cms/buttercms.mdx b/src/content/docs/zh-cn/guides/cms/buttercms.mdx
index c8ba750189e4a..8bfc320cecb20 100644
--- a/src/content/docs/zh-cn/guides/cms/buttercms.mdx
+++ b/src/content/docs/zh-cn/guides/cms/buttercms.mdx
@@ -19,7 +19,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
要开始使用，你将需要以下内容：
### 前置准备
-1. **Astro 项目** -如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)将帮助你快速创建并运行一个项目。
+1. **Astro 项目** -如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)将帮助你快速创建并运行一个项目。
2. **ButterCMS 账号**. 如果你还没有 ButterCMS 账号，你可以通过[注册](https://buttercms.com/join/) 免费试用来创建一个。
diff --git a/src/content/docs/zh-cn/guides/cms/contentful.mdx b/src/content/docs/zh-cn/guides/cms/contentful.mdx
index 33b4b4a09b638..ff8009640115c 100644
--- a/src/content/docs/zh-cn/guides/cms/contentful.mdx
+++ b/src/content/docs/zh-cn/guides/cms/contentful.mdx
@@ -19,7 +19,7 @@ import { Steps } from '@astrojs/starlight/components';
首先，你需要以下内容：
-1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)会帮助你迅速上手。
+1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)会帮助你迅速上手。
2. **Contentful 账号和 Contentful 空间**。如果你还没有账号，可以[注册](https://www.contentful.com/sign-up/)一个免费账号并创建一个新的 Contentful 空间。如果你已经有一个空间，也可以使用现有空间。
diff --git a/src/content/docs/zh-cn/guides/cms/cosmic.mdx b/src/content/docs/zh-cn/guides/cms/cosmic.mdx
index 30a4a5b8c66ff..91acb37d8d500 100644
--- a/src/content/docs/zh-cn/guides/cms/cosmic.mdx
+++ b/src/content/docs/zh-cn/guides/cms/cosmic.mdx
@@ -14,7 +14,7 @@ import { Steps } from '@astrojs/starlight/components';
## 前期准备
-1. **一个 Astro 项目** - 如果你想从一个全新的 Astro 项目开始，请阅读 [安装指南](/zh-cn/install/auto/)。而本指南基于一个简化版本的 [Astro 无头 CMS 主题](https://astro.build/themes/details/cosmic-cms-blog/)，使用 [Tailwind CSS](https://tailwindcss.com/) 进行样式设计。
+1. **一个 Astro 项目** - 如果你想从一个全新的 Astro 项目开始，请阅读 [安装指南](/zh-cn/install-and-setup/)。而本指南基于一个简化版本的 [Astro 无头 CMS 主题](https://astro.build/themes/details/cosmic-cms-blog/)，使用 [Tailwind CSS](https://tailwindcss.com/) 进行样式设计。
2. **一个 Cosmic 账号和 Bucket** - 如果你还没有，那么可以[创建一个免费的 Cosmic 账号](https://app.cosmicjs.com/signup)。创建账号后，你将被提示创建一个新的空项目；还有一个 [简单的 Astro 博客模板](https://www.cosmicjs.com/marketplace/templates/simple-astro-blog) 可用（这是与 Astro 无头 CMS 主题相同的模板），可以自动导入本指南中使用的所有内容。
3. **你的 Cosmic API 密钥** - 在你的 Cosmic 仪表板中，你需要找到 **Bucket slug** 和 **Bucket read key**，以便连接到 Cosmic。
diff --git a/src/content/docs/zh-cn/guides/cms/datocms.mdx b/src/content/docs/zh-cn/guides/cms/datocms.mdx
index c84d2c7474246..dab074e880678 100644
--- a/src/content/docs/zh-cn/guides/cms/datocms.mdx
+++ b/src/content/docs/zh-cn/guides/cms/datocms.mdx
@@ -19,7 +19,7 @@ import { FileTree } from '@astrojs/starlight/components';
要开始，你需要准备以下内容：
-- **Astro 项目** - 如果你还没有 Astro 项目，请按照我们的[安装指南](/zh-cn/install/auto/)中的说明进行设置。
+- **Astro 项目** - 如果你还没有 Astro 项目，请按照我们的[安装指南](/zh-cn/install-and-setup/)中的说明进行设置。
- **DatoCMS 账号和项目** - 如果你还没有账号，请[注册一个免费账号](https://dashboard.datocms.com/signup)。
- **DatoCMS 项目的只读 API 密钥** - 你可以在项目的管理面板中找到它，在“设置”>“API令牌”下。
diff --git a/src/content/docs/zh-cn/guides/cms/ghost.mdx b/src/content/docs/zh-cn/guides/cms/ghost.mdx
index 1c57464141c20..b2809ac773b69 100644
--- a/src/content/docs/zh-cn/guides/cms/ghost.mdx
+++ b/src/content/docs/zh-cn/guides/cms/ghost.mdx
@@ -18,7 +18,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
### 前置准备
在开始使用之前，你需要：
-1. **一个 Astro 项目** - 如果没有 Astro 项目, 我们的 [安装指南](/zh-cn/install/auto/) 将在短时间内帮助你启动并运行。
+1. **一个 Astro 项目** - 如果没有 Astro 项目, 我们的 [安装指南](/zh-cn/install-and-setup/) 将在短时间内帮助你启动并运行。
2. **一个 Ghost 站点** - 假定你已经配置了一个使用 Ghost 的站点。如果没有，可以根据 [Ghost 本地配置](https://ghost.org/docs/install/local/)在本地环境配置一个。
diff --git a/src/content/docs/zh-cn/guides/cms/hashnode.mdx b/src/content/docs/zh-cn/guides/cms/hashnode.mdx
index f0814bad15274..67fdf58f20c54 100644
--- a/src/content/docs/zh-cn/guides/cms/hashnode.mdx
+++ b/src/content/docs/zh-cn/guides/cms/hashnode.mdx
@@ -19,7 +19,7 @@ import { Steps } from '@astrojs/starlight/components';
### 前提条件
要开始，你需要具备以下条件：
-1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)将帮助你快速启动并运行。
+1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)将帮助你快速启动并运行。
2. **一个 Hashnode 站点** - 你可以通过访问 [Hashnode](https://hashnode.com/) 免费创建个人站点。
diff --git a/src/content/docs/zh-cn/guides/cms/payload.mdx b/src/content/docs/zh-cn/guides/cms/payload.mdx
index 749130563c115..e43846459c5c1 100644
--- a/src/content/docs/zh-cn/guides/cms/payload.mdx
+++ b/src/content/docs/zh-cn/guides/cms/payload.mdx
@@ -16,7 +16,7 @@ import { Steps } from '@astrojs/starlight/components';
在开始使用之前，你需要：
-1. **一个 Astro 项目** - 如果还没有 Astro 项目, 我们的 [安装指南](/zh-cn/install/auto/) 将在短时间内帮助你启动并运行。
+1. **一个 Astro 项目** - 如果还没有 Astro 项目, 我们的 [安装指南](/zh-cn/install-and-setup/) 将在短时间内帮助你启动并运行。
2. **一个 MongoDB 数据库** - 在创建新项目时，PayloadCMS 会要求你提供一个 MongoDB 连接字符串。你可以在本地部署一个，也可以使用 [MongoDBAtlas](https://www.mongodb.com/zh-cn/atlas/database) 在 Web 上免费托管数据库。
3. **一个 PayloadCMS REST API** - 创建一个 [PayloadCMS](https://payloadcms.com/docs/getting-started/installation) 项目，并在安装过程中将其连接到你的 MongoDB 数据库。
diff --git a/src/content/docs/zh-cn/guides/cms/statamic.mdx b/src/content/docs/zh-cn/guides/cms/statamic.mdx
index 57330638c6cb2..87d77e8b81dfe 100644
--- a/src/content/docs/zh-cn/guides/cms/statamic.mdx
+++ b/src/content/docs/zh-cn/guides/cms/statamic.mdx
@@ -20,7 +20,7 @@ Statamic 提供了内置的 [REST API](https://statamic.dev/rest-api) 和 [Graph
首先，你需要具备以下条件：
1. REST API 和 GraphQL API 仅在 Statamic 的专业版中可用。你可以在 [本地机器](https://statamic.dev/tips/how-to-enable-statamic-pro#trial-mode) 上免费试用专业版。
-2. **Astro 项目** - 如果你还需要一个 Astro 项目，我们的 [安装指南](/zh-cn/install/auto/) 将帮助你快速启动。
+2. **Astro 项目** - 如果你还需要一个 Astro 项目，我们的 [安装指南](/zh-cn/install-and-setup/) 将帮助你快速启动。
3. **Statamic 站点** - 如果你需要一个 Statamic 网站，[这个指南](https://statamic.dev/quick-start-guide) 将帮助你入门。记得在 `.env` 文件中添加 `STATAMIC_API_ENABLED=true` 或 `STATAMIC_GRAPHQL_ENABLED=true` 来启用 REST API 或 GraphQL API，并在 API 配置文件中启用所需资源。
:::caution
diff --git a/src/content/docs/zh-cn/guides/cms/storyblok.mdx b/src/content/docs/zh-cn/guides/cms/storyblok.mdx
index bfffffb0bfffe..6fb0ecc27cec0 100644
--- a/src/content/docs/zh-cn/guides/cms/storyblok.mdx
+++ b/src/content/docs/zh-cn/guides/cms/storyblok.mdx
@@ -20,7 +20,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
开始前，你需要具备以下条件：
-1. **Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)将帮助你快速启动；
+1. **Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)将帮助你快速启动；
2. **Storyblok 账号和空间** - 如果你还没有账号，可以[免费注册](https://app.storyblok.com/#/signup)并创建一个新的空间；
3. **Storyblok 预览令牌** - 这个令牌将用于获取你的草稿内容和已发布版本。你可以在 Storyblok 空间设置的访问令牌选项卡中找到并生成你的 API 令牌。
diff --git a/src/content/docs/zh-cn/guides/cms/strapi.mdx b/src/content/docs/zh-cn/guides/cms/strapi.mdx
index 0e17475ee4ced..78602fd934550 100644
--- a/src/content/docs/zh-cn/guides/cms/strapi.mdx
+++ b/src/content/docs/zh-cn/guides/cms/strapi.mdx
@@ -20,7 +20,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
在开始之前，你需要准备以下内容：
-1. **Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)将帮助你快速入门；
+1. **Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)将帮助你快速入门；
2. **Strapi CMS 服务器** - 你可以在本地环境中[设置 Strapi 服务器](https://docs.strapi.io/dev-docs/quick-start)。
### 在 `.env` 文件中添加 Strapi URL
diff --git a/src/content/docs/zh-cn/guides/cms/umbraco.mdx b/src/content/docs/zh-cn/guides/cms/umbraco.mdx
index 4abc25bb2aeb6..6456208712ccc 100644
--- a/src/content/docs/zh-cn/guides/cms/umbraco.mdx
+++ b/src/content/docs/zh-cn/guides/cms/umbraco.mdx
@@ -19,7 +19,7 @@ import ReadMore from '~/components/ReadMore.astro';
要开始，你需要具备以下条件：
-1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的 [安装指南](/zh-cn/install/auto/) 将帮助你快速启动和运行。
+1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的 [安装指南](/zh-cn/install-and-setup/) 将帮助你快速启动和运行。
2. **一个 Umbraco（v12+）项目** - 如果你还没有 Umbraco 项目，请参阅这个 [安装指南](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/)。
### 设置 Content Delivery API
@@ -69,7 +69,7 @@ const articles = await res.json();
### 前提条件
-- **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的 [安装指南](/zh-cn/install/auto/) 将帮助你快速启动和运行。
+- **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的 [安装指南](/zh-cn/install-and-setup/) 将帮助你快速启动和运行。
- **一个启用了 Content Delivery API 的 Umbraco 项目（v12+）** - 遵循这个 [安装指南](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/) 来创建一个新项目。
diff --git a/src/content/docs/zh-cn/guides/cms/wordpress.mdx b/src/content/docs/zh-cn/guides/cms/wordpress.mdx
index 865185d05d9f1..48d8ada3d0dd5 100644
--- a/src/content/docs/zh-cn/guides/cms/wordpress.mdx
+++ b/src/content/docs/zh-cn/guides/cms/wordpress.mdx
@@ -20,7 +20,7 @@ WordPress 自带了内置的 [WordPress REST API](https://developer.wordpress.or
在开始前，你需要具备以下条件：
-1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install/auto/)可以帮助你快速上手；
+1. **一个 Astro 项目** - 如果你还没有 Astro 项目，我们的[安装指南](/zh-cn/install-and-setup/)可以帮助你快速上手；
2. **一个 WordPress 站点** - 你的站点的 REST API 是 `[YOUR_SITE]/wp-json/wp/v2/`，并在任何 WordPress 站点上都是默认提供的。你也可以在[本地环境上安装 WordPress](https://wordpress.org/support/article/installing-wordpress-on-your-own-computer/)。
### 设置凭据
diff --git a/src/content/docs/zh-cn/guides/deploy/render.mdx b/src/content/docs/zh-cn/guides/deploy/render.mdx
index 5a7d530f4c59c..51251e1a8278f 100644
--- a/src/content/docs/zh-cn/guides/deploy/render.mdx
+++ b/src/content/docs/zh-cn/guides/deploy/render.mdx
@@ -20,7 +20,7 @@ import { Steps } from '@astrojs/starlight/components';
4. 为你的网站取一个名称，选择分支，并指定构建命令和发布目录：
- **构建命令：** `npm run build`
- **发布目录：** `dist`
- - **环境变量（高级）：** Render 默认使用 Node.js 14.17.0，但 Astro [需要更高版本](/zh-cn/install/auto/#前提准备)。添加一个名为 `NODE_VERSION` 的环境变量，值为 `v18.17.1` 或 `v20.3.0` 或更高版本，告诉 Render 使用兼容的 Node.js 版本。或者，向项目添加一个 [`.node-version`](https://render.com/docs/node-version) 或 [`.nvmrc`](https://render.com/docs/node-version) 文件来指定一个 Node.js 版本。
+ - **环境变量（高级）：** Render 默认使用 Node.js 14.17.0，但 Astro [需要更高版本](/zh-cn/install-and-setup/#前提条件)。添加一个名为 `NODE_VERSION` 的环境变量，值为 `v18.17.1` 或 `v20.3.0` 或更高版本，告诉 Render 使用兼容的 Node.js 版本。或者，向项目添加一个 [`.node-version`](https://render.com/docs/node-version) 或 [`.nvmrc`](https://render.com/docs/node-version) 文件来指定一个 Node.js 版本。
5. 点击 **Create Static Site** 按钮。
\ No newline at end of file
diff --git a/src/content/docs/zh-cn/guides/images.mdx b/src/content/docs/zh-cn/guides/images.mdx
index 9e0334c4007b8..5b6a5dad1718a 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/#别名)。然后使用导入名称作为 `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` 和其他属性，以在 `![]()
` 标签中使用。
+本地图像必须从现有的 `.astro` 文件的相对路径**导入**，或者配置并使用 [导入别名](/zh-cn/guides/imports/#别名)。然后，你可以访问图像的 `src` 和其他属性，以在 `![]()
` 标签中使用。
例如，使用图像自己的 `height` 和 `width` 属性，以避免布局位移累计 CLS 并改善核心 Web 性能指标。
@@ -776,7 +776,7 @@ export default defineConfig({
#### 移除`~/assets` 导入别名
-这个导入别名不再默认包含在 `astro:assets` 中。如果你之前使用这个别名，你必须将它们转换为相对文件路径，或者 [创建你自己的导入别名](/zh-cn/guides/aliases/)。
+这个导入别名不再默认包含在 `astro:assets` 中。如果你之前使用这个别名，你必须将它们转换为相对文件路径，或者 [创建你自己的导入别名](/zh-cn/guides/imports/#别名)。
```astro title="src/pages/posts/post-1.astro" del={2} ins={3}
---
diff --git a/src/content/docs/zh-cn/guides/imports.mdx b/src/content/docs/zh-cn/guides/imports.mdx
index bb3cca7e2825d..1e5ab7b5757ec 100644
--- a/src/content/docs/zh-cn/guides/imports.mdx
+++ b/src/content/docs/zh-cn/guides/imports.mdx
@@ -145,6 +145,50 @@ import txtReference from './words.txt'; // txt === '/src/words.txt'
鼓励将**替代文本**添加到 `![]()
` 标记以提高可访问性！不要忘记向图像元素添加 `alt="一段有用的描述"` 属性。如果图像纯粹是装饰性的，则可以将该属性留空。
:::
+## 别名
+
+**别名**可以用于创建简洁的导入。
+
+别名有助于改善在项目中大量使用绝对或相对引用的体验。
+
+```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';
+---
+```
+
+在这个示例中，开发者需要理解 `src/pages/about/company.astro`, `src/components/controls/Button.astro` 和 `src/assets/logo.png` 间的关系。如果移动了 `company.astro` 文件，那么这些导入也都需要更新。
+
+你可以在 `tsconfig.json` 或 `jsconfig.json` 中添加导入别名。
+
+```json title="tsconfig.json" ins={5-6}
+{
+ "compilerOptions": {
+ "baseUrl": ".",
+ "paths": {
+ "@components/*": ["src/components/*"],
+ "@assets/*": ["src/assets/*"]
+ }
+ }
+}
+```
+
+:::note
+确保 `compilerOptions.baseUrl` 已设置，以便可以解析别名路径。
+:::
+
+在这个配置更改完之后，开发服务器会自动重启。然后，你可以在项目中的任何地方使用这些别名进行导入：
+
+```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';
+---
+```
+
+[VS Code](https://code.visualstudio.com/docs/languages/jsconfig) 或其他编辑器会自动集成这些别名。
+
## `Astro.glob()`
[`Astro.glob()`](/zh-cn/reference/api-reference/#astroglob) 是一种一次性导入多个文件的方法。
diff --git a/src/content/docs/zh-cn/guides/markdown-content.mdx b/src/content/docs/zh-cn/guides/markdown-content.mdx
index ccda308f9ccb5..eea9d5b46fc97 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/#别名)）。
```markdown {3}
---
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-docusaurus.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-docusaurus.mdx
index 81f25f420d9c6..61dec1d58a465 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-docusaurus.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-docusaurus.mdx
@@ -42,7 +42,7 @@ Docusaurus 和 Astro 之间有一些相似之处，这将有助于你迁移你
要把一个 Docusaurus 文档站点转换为 Astro，首先使用我们的官方 [Starlight 文档主题启动模板](https://starlight.astro.build)，或者在我们的[主题展示](https://astro.build/themes?search=&categories%5B%5D=docs)中探索更多社区文档主题。
-你可以向`create astro`命令传递一个`--template`参数，以一个我们的官方启动器开始一个新的 Astro 项目。或者，你可以[从 GitHub 上任何现有的 Astro 存储库开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以向`create astro`命令传递一个`--template`参数，以一个我们的官方启动器开始一个新的 Astro 项目。或者，你可以[从 GitHub 上任何现有的 Astro 存储库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-eleventy.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-eleventy.mdx
index ed340755afadc..bab33ee79ca61 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-eleventy.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-eleventy.mdx
@@ -36,7 +36,7 @@ Eleventy (11ty) 和 Astro 有一些相似之处，这将帮助你迁移你的项
要将 Eleventy 博客转换为 Astro，首先从我们的博客主题启动模板开始，或者在我们的[主题展示](https://astro.build/themes/)中探索更多社区博客主题。
-你可以向`create astro`命令传递一个`--template`参数，以使用我们的官方启动器开始一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有 Astro 库开始一个新项目](/zh-cn/install/auto/#入门模板)
+你可以向`create astro`命令传递一个`--template`参数，以使用我们的官方启动器开始一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有 Astro 库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-gatsby.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-gatsby.mdx
index 72e3023b56821..036ba29944a76 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-gatsby.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-gatsby.mdx
@@ -43,7 +43,7 @@ Gatsby 和 Astro 共享一些相似性，这将帮助你迁移你的项目：
### 创建一个新的 Astro 项目
使用你的包管理器的 `create astro` 命令启动 Astro 的 CLI 向导，或从 [Astro 主题展示](https://astro.build/themes)中选择一个社区主题。
-你可以向 `create astro` 命令传递一个 `--template` 参数，以使用我们的官方起始器（例如 `docs`，`blog`，`portfolio`）启动一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有 Astro 存储库开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以向 `create astro` 命令传递一个 `--template` 参数，以使用我们的官方起始器（例如 `docs`，`blog`，`portfolio`）启动一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有 Astro 存储库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-gitbook.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-gitbook.mdx
index 28a501658145c..f3b08f30a591d 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-gitbook.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-gitbook.mdx
@@ -33,7 +33,7 @@ GitBook 与 Astro 之间有一些相似点，可以帮助你迁移项目：
要将 GitBook 文档站点转换为 Astro，可以从我们的官方 [Starlight 文档主题模版](https://starlight.astro.build)开始操作，或者在我们的 [主题展示](https://astro.build/themes?search=&categories%5B%5D=docs)中查看更多社区文档主题。
-你可以通过 `create astro` 命令传递一个 `--template` 参数来启动一个带有我们官方起始器的新 Astro 项目。或者，你可以[从 GitHub 上任何现有的 Astro 仓库开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以通过 `create astro` 命令传递一个 `--template` 参数来启动一个带有我们官方起始器的新 Astro 项目。或者，你可以[从 GitHub 上任何现有的 Astro 仓库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-gridsome.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-gridsome.mdx
index 2f7d57559e4f8..87c781e7850a8 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-gridsome.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-gridsome.mdx
@@ -37,7 +37,7 @@ Gridsome 和 Astro 有一些相似之处，这将帮助你迁移你的项目：
要将 Gridsome 博客转换为 Astro，可以从我们的博客主题启动模板开始，或者在我们的[主题展示](https://astro.build/themes/)中查看更多社区博客主题。
-你可以向`create astro`命令传递一个 `--template` 参数来使用我们的官方启动器开始一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有 Astro 仓库开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以向`create astro`命令传递一个 `--template` 参数来使用我们的官方启动器开始一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有 Astro 仓库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-hugo.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-hugo.mdx
index 1e038fff2e87f..9015690e1176c 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-hugo.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-hugo.mdx
@@ -35,7 +35,7 @@ Hugo 和 Astro 有一些相似之处，可以帮助你迁移项目：
要将 Hugo 博客转换为 Astro，请从博客主题入门模板开始，或者在[主题展示](https://astro.build/themes/)中探索更多社区博客主题。
-你可以向 `create astro` 命令传递 `--template` 参数，以使用我们的官方启动器之一启动新的 `Astro` 项目。或者你可以在 [从 GitHub 上任何现有的 Astro 存储库启动一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以向 `create astro` 命令传递 `--template` 参数，以使用我们的官方启动器之一启动新的 `Astro` 项目。或者你可以在 [从 GitHub 上任何现有的 Astro 存储库启动一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-jekyll.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-jekyll.mdx
index 2ada6c1cc6cca..c00672b0aca8a 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-jekyll.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-jekyll.mdx
@@ -33,7 +33,7 @@ Jekyll 和 Astro 有一些相似之处，可以帮助你迁移项目：
要将 Jekyll 博客转换为 Astro，请从我们的博客主题启动器模板开始，或者在[主题展示](https://astro.build/themes/)中探索更多社区博客主题。
-你可以向 `create astro` 命令传递 `--template` 参数，以使用我们的官方启动器之一启动新的 Astro 项目。或者你可以[从 GitHub 上任何现有的 Astro 项目启动一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以向 `create astro` 命令传递 `--template` 参数，以使用我们的官方启动器之一启动新的 Astro 项目。或者你可以[从 GitHub 上任何现有的 Astro 项目启动一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-nextjs.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-nextjs.mdx
index 4fb37fa9505fb..067684bb2dc47 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-nextjs.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-nextjs.mdx
@@ -41,7 +41,7 @@ Next.js 和 Astro 有一些相似之处，可以帮助你迁移你的项目：
通过你的包管理器执行命令 `create astro` 来启动 Astro 的 CLI 向导，或从 [Astro Theme Showcase](https://astro.build/themes) 选择一个社区主题。
-你可以在 `create astro` 命令中传递一个 `--template` 参数，用我们的官方启动器（如 `docs`、`blog`、`portfolio`）启动一个新的 Astro 项目。或者，你可以[从 GitHub 上任何现有的 Astro 仓库开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以在 `create astro` 命令中传递一个 `--template` 参数，用我们的官方启动器（如 `docs`、`blog`、`portfolio`）启动一个新的 Astro 项目。或者，你可以[从 GitHub 上任何现有的 Astro 仓库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-nuxtjs.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-nuxtjs.mdx
index c431d8f09d4b6..0031251fd9604 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-nuxtjs.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-nuxtjs.mdx
@@ -42,7 +42,7 @@ Nuxt 和 Astro 有一些相似之处，这些相似性能够帮助你完成迁
### 新建一个 Astro 项目
使用你的包管理器的 `create astro` 来启动 Astro 的 CLI 向导，或者从 [Astro 主题展示](https://astro.build/themes) 中选择一个社区主题。
-你可以将 `--template` 参数传给 `create astro` 命令，使用我们的官方入门模板之一启动新的 Astro 项目 (例如 `docs`, `blog`, `portfolio`)。或者，你可以从 [GitHub 上的任何现有的 Astro 库开始一个新项目](/zh-cn/install/auto/#入门模板) 。
+你可以将 `--template` 参数传给 `create astro` 命令，使用我们的官方入门模板之一启动新的 Astro 项目 (例如 `docs`, `blog`, `portfolio`)。或者，你可以从 [GitHub 上的任何现有的 Astro 库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板) 。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-pelican.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-pelican.mdx
index 507256c1667e2..7e83f7c8eb57a 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-pelican.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-pelican.mdx
@@ -33,7 +33,7 @@ Pelican 和 Astro 的一些相似点会帮助你完成迁移。
为了将 Pelican 文档转换成 Astro，你可以从我们的 [Starlight 文档主题模板](https://starlight.astro.build)开始，或者从[主题展示](https://astro.build/themes/)里面的社区主题开始。
-你可以通过传入`--template`参数到`create astro`命令开启一个 Astro 项目，并选择我们提供的某个模板。或者，你也可以从一个 [Astro Github 仓库](/zh-cn/install/auto/#入门模板)开始你的项目。
+你可以通过传入`--template`参数到`create astro`命令开启一个 Astro 项目，并选择我们提供的某个模板。或者，你也可以从一个 [Astro Github 仓库](/zh-cn/install-and-setup/#使用主题或起始模板)开始你的项目。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-sveltekit.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-sveltekit.mdx
index 8c6192efd9533..31995ac00629b 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-sveltekit.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-sveltekit.mdx
@@ -38,7 +38,7 @@ SvelteKit 和 Astro 有一些相似之处，可以帮助你迁移你的项目：
要将 SvelteKit 博客转换为 Astro，请从我们的博客主题起始模板开始，或者在我们的[主题展示](https://astro.build/themes/)中探索更多社区博客主题。
-你可以将 `--template` 参数传递给 `create astro` 命令，以便使用其中一个模板开始一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有的 Astro 的存储库中开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以将 `--template` 参数传递给 `create astro` 命令，以便使用其中一个模板开始一个新的 Astro 项目。或者，你可以[从 GitHub 上的任何现有的 Astro 的存储库中开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-vuepress.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-vuepress.mdx
index 8d9abff9a64de..3b25f7d67de00 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-vuepress.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-vuepress.mdx
@@ -35,7 +35,7 @@ VuePress 和 Astro 有一些共同的特点，这些相似之处将有助于你
要将 VuePress 文档网站转换为 Astro ，可以通过我们的官方 [Starlight 文档主题起始模板](https://starlight.astro.build/zh/)开始创建，或者在我们的 [主题展示页面](https://astro.build/themes?search=&categories%5B%5D=docs) 中探索更多社区文档主题。
-你可以在 `create astro` 命令中使用 `--template` 参数，并选择其中一个官方起始模板来开始一个新的 Astro 项目。另外，你也可以 [从 GitHub 上的任意现有 Astro 存储库开始一个新项目](/zh-cn/install/auto/#入门模板)。
+你可以在 `create astro` 命令中使用 `--template` 参数，并选择其中一个官方起始模板来开始一个新的 Astro 项目。另外，你也可以 [从 GitHub 上的任意现有 Astro 存储库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)。
diff --git a/src/content/docs/zh-cn/guides/migrate-to-astro/from-wordpress.mdx b/src/content/docs/zh-cn/guides/migrate-to-astro/from-wordpress.mdx
index a78e0945bda67..4b2f03f31ec1a 100644
--- a/src/content/docs/zh-cn/guides/migrate-to-astro/from-wordpress.mdx
+++ b/src/content/docs/zh-cn/guides/migrate-to-astro/from-wordpress.mdx
@@ -36,7 +36,7 @@ WordPress 和 Astro 在以下方面有一些相似之处，这将有助于你迁
你可以在 `create astro` 命令中传递 `--template` 参数，使用我们官方的任意启动器开始一个新的 Astro 项目。
-或者，你可以从 [GitHub 上任何现有的 Astro 存储库开始一个新项目](/zh-cn/install/auto/#入门模板)
+或者，你可以从 [GitHub 上任何现有的 Astro 存储库开始一个新项目](/zh-cn/install-and-setup/#使用主题或起始模板)
diff --git a/src/content/docs/zh-cn/guides/typescript.mdx b/src/content/docs/zh-cn/guides/typescript.mdx
index 9a76ef56f21fc..a58e8a1e31ced 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/#别名)。
```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..8458bae1794fa 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/`）中构建你的网站
diff --git a/src/content/docs/zh-tw/basics/project-structure.mdx b/src/content/docs/zh-tw/basics/project-structure.mdx
index bf77482f89abf..ad25aaa70c74a 100644
--- a/src/content/docs/zh-tw/basics/project-structure.mdx
+++ b/src/content/docs/zh-tw/basics/project-structure.mdx
@@ -112,7 +112,7 @@ Astro 會處理、最佳化並將你的 `src/` 捆起來建立最後瀏覽器會
這裡有[兩種相依性](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file)你可以在 `package.json` 中指定： `dependencies` 和 `devDependencies` 。在大多情況下運作起來相同：Astro 在建立時會需要所有的相依性，而你的套件管理器會下載這兩個。我們推薦將你所有的依賴模組放在 `dependencies` 來開始，並只在你特別需要的時候才使用 `devDependencies` 。
-若需要為你專案建立一個新的 `package.json` 檔案，可以看看[手動安裝](/zh-tw/install/manual/)教學來取得協助。
+若需要為你專案建立一個新的 `package.json` 檔案，可以看看[手動安裝](/zh-tw/install-and-setup/#manual-setup)教學來取得協助。
### `astro.config.mjs`
diff --git a/src/content/docs/zh-tw/getting-started.mdx b/src/content/docs/zh-tw/getting-started.mdx
index 2e4e710448f6e..fa993c15cd8b1 100644
--- a/src/content/docs/zh-tw/getting-started.mdx
+++ b/src/content/docs/zh-tw/getting-started.mdx
@@ -11,7 +11,7 @@ hero:
actions:
- text: 新手上路
icon: rocket
- link: /zh-tw/install/auto/
+ link: /zh-tw/install-and-setup/
variant: primary
- text: 瞭解 Astro 的特色
icon: right-arrow
@@ -43,7 +43,7 @@ import Discord from '~/components/Landing/Discord.astro'
npm create astro@latest
```
- [安裝指南](/zh-tw/install/auto/)提供詳細步驟，教你如何透過 CLI 精靈安裝 Astro、從現有 Astro GitHub 倉儲新增專案，以及手動安裝 Astro。
+ [安裝指南](/zh-tw/install-and-setup/)提供詳細步驟，教你如何透過 CLI 精靈安裝 Astro、從現有 Astro GitHub 倉儲新增專案，以及手動安裝 Astro。
diff --git a/src/i18n/en/nav.ts b/src/i18n/en/nav.ts
index 9b60cba1dfbfb..4af03ad69ecaa 100644
--- a/src/i18n/en/nav.ts
+++ b/src/i18n/en/nav.ts
@@ -18,194 +18,108 @@
* `src/i18n/ja/nav.ts`: `'getting-started': 'はじめに',`
*/
export default [
- { text: 'Start Here', header: true, type: 'learn', key: 'startHere' },
+ { text: 'Welcome, World!', header: true, type: 'learn', key: 'welcomeWorld' },
{ text: 'Getting Started', slug: 'getting-started', key: 'getting-started' },
- { text: 'Installation', slug: 'install/auto', key: 'install' },
- { text: 'Editor Setup', slug: 'editor-setup', key: 'editor-setup' },
- { text: 'Upgrade Astro', slug: 'upgrade-astro', key: 'upgrade-astro' },
+ { text: 'Installation and Setup', slug: 'install-and-setup', key: 'install-and-setup' },
+ { text: 'Deploy Your Site', slug: 'guides/deploy', key: 'guides/deploy' },
+ { text: 'Migrate to Astro', slug: 'guides/migrate-to-astro', key: 'guides/migrate-to-astro' },
+ { text: 'Tutorial: Build a Blog', slug: 'tutorial/0-introduction', key: 'blog-tutorial' },
+
{ text: 'Core Concepts', header: true, type: 'learn', key: 'coreConcepts' },
- { text: 'Why Astro', slug: 'concepts/why-astro', key: 'concepts/why-astro' },
+ { text: 'Why Astro?', slug: 'concepts/why-astro', key: 'concepts/why-astro' },
{ text: 'Astro Islands', slug: 'concepts/islands', key: 'concepts/islands' },
- { text: 'Tutorials', header: true, type: 'learn', key: 'tutorials' },
- { text: 'Build a Blog', slug: 'tutorial/0-introduction', key: 'blog-tutorial' },
- {
- text: 'Extend with Content Collections',
- slug: 'tutorials/add-content-collections',
- key: 'add-collections-tutorial',
- },
- {
- text: 'Extend with View Transitions',
- slug: 'tutorials/add-view-transitions',
- key: 'add-transitions-tutorial',
- },
- // { text: 'Thinking with Islands', slug: 'tutorial/0-introduction', key: 'island-tutorial' },
-
- { text: 'Basics', header: true, type: 'learn', key: 'basics' },
-
- {
- text: 'Project Structure',
- slug: 'basics/project-structure',
- key: 'basics/project-structure',
- },
- {
- text: 'Components',
- slug: 'basics/astro-components',
- key: 'basics/astro-components',
- },
+
+ { text: 'Learn the Basics', header: true, type: 'learn', key: 'basics' },
+ { text: 'Project Structure', slug: 'basics/project-structure', key: 'basics/project-structure' },
+ { text: 'Components', slug: 'basics/astro-components', key: 'basics/astro-components' },
{ text: 'Pages', slug: 'basics/astro-pages', key: 'basics/astro-pages' },
{ text: 'Layouts', slug: 'basics/layouts', key: 'basics/layouts' },
- {
- text: 'Astro Template Syntax',
- slug: 'basics/astro-syntax',
- key: 'basics/astro-syntax',
- },
- {
- text: 'Rendering Modes',
- slug: 'basics/rendering-modes',
- key: 'basics/rendering-modes',
- },
-
- { text: 'Built-ins', header: true, type: 'learn', key: 'builtins' },
- {
- text: 'Content Collections',
- slug: 'guides/content-collections',
- key: 'guides/content-collections',
- },
- {
- text: 'View Transitions',
- slug: 'guides/view-transitions',
- key: 'guides/view-transitions',
- },
- {
- text: 'Prefetch',
- slug: 'guides/prefetch',
- key: 'guides/prefetch',
- },
- {
- text: 'Dev Toolbar',
- slug: 'guides/dev-toolbar',
- key: 'guides/dev-toolbar',
- },
-
- { text: 'Integrations', header: true, type: 'learn', key: 'addons' },
- { text: 'Add integrations', slug: 'guides/integrations-guide', key: 'guides/integrations-guide' },
- {
- text: 'UI Frameworks',
- slug: 'guides/framework-components',
- key: 'guides/framework-components',
- },
- {
- text: 'SSR Adapters',
- slug: 'guides/server-side-rendering',
- key: 'guides/server-side-rendering',
- },
- {
- text: 'Astro DB',
- slug: 'guides/astro-db',
- key: 'guides/astro-db',
- },
-
- { text: 'Recipes', header: true, type: 'learn', key: 'examples' },
- { text: 'Migrate to Astro', slug: 'guides/migrate-to-astro', key: 'guides/migrate-to-astro' },
+ { text: 'Astro Template Syntax', slug: 'basics/astro-syntax', key: 'basics/astro-syntax' },
+ { text: 'Rendering Modes', slug: 'basics/rendering-modes', key: 'basics/rendering-modes' },
+ { text: 'Imports', slug: 'guides/imports', key: 'guides/imports' },
+ { text: 'Integrations', slug: 'guides/integrations-guide', key: 'guides/integrations-guide' },
+
+
+ { text: 'Manage Your Content', header: true, type: 'learn', key: 'content' },
+ { text: 'Authoring Content', slug: 'guides/content', key: 'guides/content' },
+ { text: 'Markdown', slug: 'guides/markdown-content', key: 'guides/markdown-content' },
+ { text: 'Content Collections', slug: 'guides/content-collections', key: 'guides/content-collections' },
{ text: 'Connect a CMS', slug: 'guides/cms', key: 'guides/cms' },
- { text: 'Add backend services', slug: 'guides/backend', key: 'guides/backend' },
- { text: 'Deploy your site', slug: 'guides/deploy', key: 'guides/deploy' },
- { text: 'More recipes', slug: 'recipes', key: 'guides/recipes' },
+ { text: 'Add an RSS feed', slug: 'guides/rss', key: 'guides/rss' },
- { text: 'Guides', header: true, type: 'learn', key: 'features' },
+
+ { text: 'Routes and Navigation', header: true, type: 'learn', key: 'routes' },
{ text: 'Routing', slug: 'guides/routing', key: 'guides/routing' },
- { text: 'Markdown', slug: 'guides/markdown-content', key: 'guides/markdown-content' },
- {
- text: 'Scripts & Event Handling',
- slug: 'guides/client-side-scripts',
- key: 'guides/client-side-scripts',
- },
+ { text: 'Endpoints', slug: 'guides/endpoints', key: 'guides/endpoints' },
+ { text: 'Prefetch', slug: 'guides/prefetch', key: 'guides/prefetch' },
+ { text: 'Middleware', slug: 'guides/middleware', key: 'guides/middleware' },
+ { text: 'Internationalization', slug: 'guides/internationalization', key: 'guides/internationalization' },
+ { text: 'View Transitions', slug: 'guides/view-transitions', key: 'guides/view-transitions' },
+
+
+ { text: 'Assets', header: true, type: 'learn', key: 'assets' },
{ text: 'CSS & Styling', slug: 'guides/styling', key: 'guides/styling' },
{ text: 'Images', slug: 'guides/images', key: 'guides/images' },
{ text: 'Fonts', slug: 'guides/fonts', key: 'guides/fonts' },
- { text: 'Imports', slug: 'guides/imports', key: 'guides/imports' },
- { text: 'Endpoints', slug: 'guides/endpoints', key: 'guides/endpoints' },
- { text: 'Data Fetching', slug: 'guides/data-fetching', key: 'guides/data-fetching' },
- {
- text: 'Internationalization',
- slug: 'guides/internationalization',
- key: 'guides/internationalization',
- },
- { text: 'Middleware', slug: 'guides/middleware', key: 'guides/middleware' },
+
+ { text: 'Connect Your Data', header: true, type: 'learn', key: 'data' },
+ { text: 'Data Fetching', slug: 'guides/data-fetching', key: 'guides/data-fetching' },
+ { text: 'Astro DB', slug: 'guides/astro-db', key: 'guides/astro-db' },
+ { text: 'Add Backend Services', slug: 'guides/backend', key: 'guides/backend' },
{ text: 'E-commerce', slug: 'guides/ecommerce', key: 'guides/ecommerce' },
- { text: 'Testing', slug: 'guides/testing', key: 'guides/testing' },
{ text: 'Authentication', slug: 'guides/authentication', key: 'guides/authentication' },
+ { text: 'Environment Variables', slug: 'guides/environment-variables', key: 'guides/environment-variables' },
+
+
+ { text: 'Client-Side Interactivity', header: true, type: 'learn', key: 'clientSide' },
+ { text: 'UI Frameworks', slug: 'guides/framework-components', key: 'guides/framework-components' },
+ { text: 'Scripts & Event Handling', slug: 'guides/client-side-scripts', key: 'guides/client-side-scripts' },
+
+
+ { text: 'Maintain Your Project', header: true, type: 'learn', key: 'maintain' },
+ { text: 'Upgrade Astro', slug: 'upgrade-astro', key: 'upgrade-astro' },
+ { text: 'Testing', slug: 'guides/testing', key: 'guides/testing' },
{ text: 'Troubleshooting', slug: 'guides/troubleshooting', key: 'guides/troubleshooting' },
- { text: 'Configuration', header: true, type: 'learn', key: 'configuration' },
- {
- text: 'The Astro Config File',
- slug: 'guides/configuring-astro',
- key: 'guides/configuring-astro',
- },
- { text: 'TypeScript', slug: 'guides/typescript', key: 'guides/typescript' },
- { text: 'Import Aliases', slug: 'guides/aliases', key: 'guides/aliases' },
- {
- text: 'Environment Variables',
- slug: 'guides/environment-variables',
- key: 'guides/environment-variables',
- },
{ text: 'Reference', header: true, type: 'api', key: 'reference' },
- {
- text: 'Configuration',
- slug: 'reference/configuration-reference',
- key: 'reference/configuration-reference',
- },
- { text: 'Runtime API', slug: 'reference/api-reference', key: 'reference/api-reference' },
- {
- text: 'Integrations API',
- slug: 'reference/integrations-reference',
- key: 'reference/integrations-reference',
- },
+ { text: 'Configuration', slug: 'reference/configuration-reference', key: 'reference/configuration-reference' },
+ { text: 'Astro Runtime API', slug: 'reference/api-reference', key: 'reference/api-reference' },
+ { text: 'Astro CLI', slug: 'reference/cli-reference', key: 'reference/cli-reference' },
+ { text: 'Directives Reference', slug: 'reference/directives-reference', key: 'reference/directives-reference' },
+ { text: 'TypeScript Reference', slug: 'guides/typescript', key: 'guides/typescript' },
+ { text: 'Error Reference', slug: 'reference/error-reference', key: 'reference/error-reference' },
+
+
+ { text: 'Other Development APIs', header: true, type: 'api', key: 'dev' },
+ { text: 'Integrations API', slug: 'reference/integrations-reference', key: 'reference/integrations-reference' },
{ text: 'Adapter API', slug: 'reference/adapter-reference', key: 'reference/adapter-reference' },
- {
- text: 'Image Service API',
- slug: 'reference/image-service-reference',
- key: 'reference/image-service-reference',
- },
- {
- text: 'Dev Toolbar App API',
- slug: 'reference/dev-toolbar-app-reference',
- key: 'reference/dev-toolbar-app-reference',
- },
- {
- text: 'Container API',
- slug: 'reference/container-reference',
- key: 'reference/container-reference',
- },
- {
- text: 'Template Directives',
- slug: 'reference/directives-reference',
- key: 'reference/directives-reference',
- },
- { text: 'The Astro CLI', slug: 'reference/cli-reference', key: 'reference/cli-reference' },
- {
- text: 'Error Reference',
- slug: 'reference/error-reference',
- key: 'reference/error-reference',
- },
- { text: 'NPM Package Format', slug: 'reference/publish-to-npm', key: 'guides/publish-to-npm' },
-
- { text: 'Community Resources', header: true, type: 'learn', key: 'communityResources' },
- {
- text: 'Courses, Guides, and Recipes',
- slug: 'community-resources/content',
- key: 'community-resources/content',
- },
- {
- text: 'Talks, Interviews, and Streams',
- slug: 'community-resources/talks',
- key: 'community-resources/talks',
- },
+ { text: 'Image Service API', slug: 'reference/image-service-reference', key: 'reference/image-service-reference' },
+ { text: 'Dev Toolbar App API', slug: 'reference/dev-toolbar-app-reference', key: 'reference/dev-toolbar-app-reference' },
+ { text: 'Container API (Experimental)', slug: 'reference/container-reference', key: 'reference/container-reference' },
+
+ { text: 'Community Resources', header: true, type: 'learn', key: 'communityResources' },
+ { text: 'Courses, Guides, and Recipes', slug: 'community-resources/content', key: 'community-resources/content' },
+ { text: 'Talks, Interviews, and Streams', slug: 'community-resources/talks', key: 'community-resources/talks' },
+
+
+ // { text: 'Configuration', header: true, type: 'learn', key: 'configuration' },
+ // {
+ // text: 'The Astro Config File',
+ // slug: 'guides/configuring-astro',
+ // key: 'guides/configuring-astro',
+ // },
+ // { text: 'TypeScript', slug: 'guides/typescript', key: 'guides/typescript' },
+ // { text: 'Import Aliases', slug: 'guides/aliases', key: 'guides/aliases' },
+ // {
+ // text: 'Environment Variables',
+ // slug: 'guides/environment-variables',
+ // key: 'guides/environment-variables',
+ // },
+
] satisfies NavEntry[];
type NavEntry = {
diff --git a/src/pages/[lang]/install.astro b/src/pages/[lang]/install.astro
index 76cb0bbc74f06..04127ef949c2f 100644
--- a/src/pages/[lang]/install.astro
+++ b/src/pages/[lang]/install.astro
@@ -6,4 +6,4 @@ export const getStaticPaths = () => Object.keys(languages).map((lang) => ({ para
const { lang } = Astro.params;
---
-
+
diff --git a/src/util/getPageCategory.ts b/src/util/getPageCategory.ts
index 7d0699582178c..f5878b65aca26 100644
--- a/src/util/getPageCategory.ts
+++ b/src/util/getPageCategory.ts
@@ -16,6 +16,7 @@ const categories = [
['reference/errors/', 'Error Reference'],
['reference/', 'Reference'],
['tutorial/', 'Tutorials'],
+ ['tutorials/', 'Tutorials'],
] as const;
/**
diff --git a/src/util/isSubPage.ts b/src/util/isSubPage.ts
index b24bf4818d939..485b85955b016 100644
--- a/src/util/isSubPage.ts
+++ b/src/util/isSubPage.ts
@@ -24,6 +24,13 @@ const typeIndexes: Partial['data']['type'], strin
const categoryIndex: Partial, string>> = {
'Error Reference': 'reference/error-reference',
+ Tutorials: 'tutorial/0-introduction',
+};
+
+/** Map of page slugs to the slug of their parent page. */
+const parentIndex: Record = {
+ 'editor-setup': 'install-and-setup',
+ 'guides/dev-toolbar': 'install-and-setup',
};
/** Slugs of pages that appear at the top level even though they are in a sub-category. */
@@ -35,7 +42,7 @@ const topLevelExceptions = ['recipes/studio'];
* @param parentSlug The language-less slug for the parent to test against e.g. `'guides/content-collections'`
*/
export function isSubPage(currentPage: string, parentSlug: string): boolean {
- // Test 1: is this page a known, top-level page? Don’t match its parent.
+ // Test: is this page a known, top-level page? Don’t match its parent.
for (const slug of topLevelExceptions) {
const currentIsExceptionPage = currentPage.endsWith('/' + slug);
const parentIsExceptionPage = parentSlug === slug;
@@ -47,16 +54,21 @@ export function isSubPage(currentPage: string, parentSlug: string): boolean {
}
}
- // Test 2: do the two pages share a base URL segment?
+ // Test: is there a known parent page hardcoded for this page?
+ const currentSlug = currentPage.split('/').slice(1).join('/');
+ if (parentIndex[currentSlug] === parentSlug) {
+ return true;
+ }
+ // Test: do the two pages share a base URL segment?
if (removeSubPageSegment(currentPage).endsWith(removeSubPageSegment(parentSlug))) {
return true;
}
- // Test 3: is there a known parent page for this page category?
+ // Test: is there a known parent page for this page category?
const category = getPageCategory({ pathname: '/' + currentPage + '/' });
if (categoryIndex[category] === parentSlug) {
return true;
}
- // Test 4: is there a known parent page for this page type?
+ // Test: is there a known parent page for this page type?
const type = englishPages.find(({ slug }) => slug === currentPage)?.data.type;
if (type && typeIndexes[type] === parentSlug) {
return true;
diff --git a/vercel.json b/vercel.json
index 2af1a05b71cff..9cf46d934d06a 100644
--- a/vercel.json
+++ b/vercel.json
@@ -5,6 +5,8 @@
"cleanUrls": true,
"redirects": [
+ { "source": "/:lang/install/auto/", "destination": "/:lang/install-and-setup/" },
+ { "source": "/:lang/install/manual/", "destination": "/:lang/install-and-setup/" },
{
"source": "/:lang/core-concepts/project-structure/",
"destination": "/:lang/basics/project-structure/"
@@ -63,7 +65,7 @@
{ "source": "/core-concepts/component-hydration/", "destination": "/en/concepts/islands/" },
- { "source": "/en/getting-started/quick-start/", "destination": "/en/install/auto/" },
+ { "source": "/en/getting-started/quick-start/", "destination": "/en/install-and-setup/" },
{
"source": "/:lang/core-concepts/partial-hydration/",
@@ -93,7 +95,7 @@
{ "source": "/en/guides/debugging/", "destination": "/en/guides/troubleshooting/" },
- { "source": "/en/quick-start/", "destination": "/en/installation/" },
+ { "source": "/en/quick-start/", "destination": "/en/install-and-setup/" },
{ "source": "/:lang/concepts/mpa-vs-spa/", "destination": "/:lang/concepts/why-astro/" },
@@ -108,6 +110,10 @@
{ "source": "/:lang/guides/assets/", "destination": "/:lang/guides/images/" },
+ { "source": "/en/guides/aliases/", "destination": "/en/guides/imports/#aliases" },
+
+ { "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/" },
@@ -119,6 +125,11 @@
{
"source": "/:lang/recipes/studio/",
"destination": "/:lang/guides/astro-db/"
+ },
+
+ {
+ "source": "/:lang/recipes/",
+ "destination": "/:lang/community-resources/content/"
}
]
}