Skip to content
This repository has been archived by the owner on Apr 6, 2023. It is now read-only.

docs: fix more redirect issues #8045

Merged
merged 1 commit into from Oct 7, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/content/1.getting-started/2.installation.md
Expand Up @@ -107,4 +107,4 @@ Well done! A browser window should automatically open for <http://localhost:3000

Now that you've created your Nuxt 3 project, you are ready to start building your application.

* Learn about the framework [concepts](/guide/concepts)
* Learn about the framework [concepts](/guide/concepts/auto-imports)
2 changes: 1 addition & 1 deletion docs/content/1.getting-started/4.assets.md
Expand Up @@ -49,7 +49,7 @@ Nuxt won't serve files in the `assets/` directory at a static URL like `/assets/

### Global Styles Imports

To globally insert statements in your Nuxt components styles, you can use the [`Vite`](/api/configuration/nuxt.config#vite) option at your [`nuxt.config`](/api/configuration/nuxt.config) file.
To globally insert statements in your Nuxt components styles, you can use the [`Vite`](/api/configuration/nuxt-config#vite) option at your [`nuxt.config`](/api/configuration/nuxt-config) file.

#### Example

Expand Down
2 changes: 1 addition & 1 deletion docs/content/1.getting-started/5.seo-meta.md
Expand Up @@ -7,7 +7,7 @@ description: Nuxt provides good default values for meta tags, but you can overri

Out-of-the-box, Nuxt provides good default values for `charset` and `viewport` meta tags, but you can override these if you need to, as well as customize other meta tags for your site in several different ways.

:ReadMore{link="/api/configuration/nuxt.config#head"}
:ReadMore{link="/api/configuration/nuxt-config#head"}

## `useHead` Composable

Expand Down
2 changes: 1 addition & 1 deletion docs/content/1.getting-started/6.data-fetching.md
Expand Up @@ -219,7 +219,7 @@ Using `<script setup lang="ts">` is the recommended way of declaring Vue compone

When we call `fetch` in the browser, user headers like `cookie` will be directly sent to the API. But during server-side-rendering, since the `fetch` request takes place 'internally' within the server, it doesn't include the user's browser cookies, nor does it pass on cookies from the fetch response.

::ReadMore{link="/api/utils/$fetch"}
::ReadMore{link="/api/utils/dollarfetch"}
::

### Example: Pass Client Headers to the API
Expand Down
2 changes: 1 addition & 1 deletion docs/content/2.guide/1.concepts/1.auto-imports.md
Expand Up @@ -10,7 +10,7 @@ Contrary to a classic global declaration, Nuxt preserves typings and IDEs comple

::alert{type=info icon=πŸ’‘}
In the documentation, every function that is not explicitly imported is auto-imported by Nuxt and can be used as-is in your code.
You can find a reference for auto-imported [composables](/api/composables/use-async-data) and [utilities](/api/utils/$fetch) in the API section.
You can find a reference for auto-imported [composables](/api/composables/use-async-data) and [utilities](/api/utils/dollarfetch) in the API section.
::

::alert{type=warning}
Expand Down
2 changes: 1 addition & 1 deletion docs/content/2.guide/1.concepts/3.rendering.md
Expand Up @@ -61,7 +61,7 @@ Universal rendering is very versatile and can fit almost any use case, and is es

Client-side and universal rendering are different strategies to display an interface in a browser.

By default, Nuxt uses **universal rendering** to provide better user experience and performance, and to optimize search engine indexing, but you can switch rendering modes in [one line of configuration](/api/configuration/nuxt.config#ssr).
By default, Nuxt uses **universal rendering** to provide better user experience and performance, and to optimize search engine indexing, but you can switch rendering modes in [one line of configuration](/api/configuration/nuxt-config#ssr).

## Coming in Nuxt 3

Expand Down
2 changes: 1 addition & 1 deletion docs/content/2.guide/1.concepts/5.modules.md
Expand Up @@ -4,7 +4,7 @@ description: "Nuxt provides a module system to extend the framework core and sim

# Modules

Nuxt provides a module system to extend the framework core and simplify integrations. You don't need to develop everything from scratch or maintain boilerplate if there is already a Nuxt module for it. Adding Nuxt modules is possible using [`nuxt.config`](/api/configuration/nuxt.config#modules).
Nuxt provides a module system to extend the framework core and simplify integrations. You don't need to develop everything from scratch or maintain boilerplate if there is already a Nuxt module for it. Adding Nuxt modules is possible using [`nuxt.config`](/api/configuration/nuxt-config#modules).

## Exploring Nuxt Modules

Expand Down
2 changes: 1 addition & 1 deletion docs/content/2.guide/1.concepts/8.typescript.md
Expand Up @@ -8,7 +8,7 @@ Nuxt 3 is fully typed and provides helpful shortcuts to ensure you have access t

## Type-checking

By default, Nuxt doesn't check types when you run `nuxi dev` or `nuxi build`, for performance reasons. However, you can enable type-checking at build or development time by installing `vue-tsc` and `typescript` as devDependencies and either enabling [the `typescript.typeCheck` option in your `nuxt.config` file](/api/configuration/nuxt.config#typescript) or [manually checking your types with nuxi](/api/commands/typecheck).
By default, Nuxt doesn't check types when you run `nuxi dev` or `nuxi build`, for performance reasons. However, you can enable type-checking at build or development time by installing `vue-tsc` and `typescript` as devDependencies and either enabling [the `typescript.typeCheck` option in your `nuxt.config` file](/api/configuration/nuxt-config#typescript) or [manually checking your types with nuxi](/api/commands/typecheck).

```bash
yarn nuxi typecheck
Expand Down
4 changes: 2 additions & 2 deletions docs/content/2.guide/2.directory-structure/1.pages.md
Expand Up @@ -269,7 +269,7 @@ Of course, you are welcome to define metadata for your own use throughout your a

Nuxt will automatically wrap your page in [the Vue `<KeepAlive>` component](https://vuejs.org/guide/built-ins/keep-alive.html#keepalive) if you set `keepalive: true` in your `definePageMeta`. This might be useful to do, for example, in a parent route that has dynamic child routes, if you want to preserve page state across route changes. You can also set props to be passed to `<KeepAlive>` (see a full list [here](https://vuejs.org/api/built-in-components.html#keepalive)).

You can set a default value for this property [in your `nuxt.config`](/api/configuration/nuxt.config#keepalive).
You can set a default value for this property [in your `nuxt.config`](/api/configuration/nuxt-config#keepalive).

#### `key`

Expand All @@ -287,7 +287,7 @@ You can define middleware to apply before loading this page. It will be merged w

You can define transition properties for the `<transition>` component that wraps your pages and layouts, or pass `false` to disable the `<transition>` wrapper for that route. You can see a list of options that can be passed [here](https://vuejs.org/api/built-in-components.html#transition) or read [more about how transitions work](https://vuejs.org/guide/built-ins/transition.html#transition).

You can set default values for these properties [in your `nuxt.config`](/api/configuration/nuxt.config#layouttransition).
You can set default values for these properties [in your `nuxt.config`](/api/configuration/nuxt-config#layouttransition).

#### `alias`

Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/1.composables/use-fetch.md
@@ -1,6 +1,6 @@
# `useFetch`

This composable provides a convenient wrapper around [`useAsyncData`](/api/composables/use-async-data) and [`$fetch`](/api/utils/$fetch).
This composable provides a convenient wrapper around [`useAsyncData`](/api/composables/use-async-data) and [`$fetch`](/api/utils/dollarfetch).

It automatically generates a key based on URL and fetch options, provides type hints for request url based on server routes, and infers API response type.

Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/1.composables/use-head.md
Expand Up @@ -30,7 +30,7 @@ interface MetaObject extends Record<string, any> {
}
```

Application-wide configuration of the head metadata is possible through [nuxt.config](/api/configuration/nuxt.config#head), or by placing the `useHead` in the `app.vue` file.
Application-wide configuration of the head metadata is possible through [nuxt.config](/api/configuration/nuxt-config#head), or by placing the `useHead` in the `app.vue` file.

::alert{type=info}
The properties of `useHead` can be dynamic, accepting `ref`, `computed` and `reactive` properties. `meta` parameter can also accept a function returning an object to make the entire object reactive.
Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/3.utils/add-route-middleware.md
Expand Up @@ -8,7 +8,7 @@ description: addRouteMiddleware() is a helper function to dynamically add middle
`addRouteMiddleware()` is a helper function to dynamically add route middleware in your Nuxt application.

::alert{type=info}
Route middleware are navigation guards stored in the [`middleware/`](/guide/directory-structure/middleware) directory of your Nuxt application (unless [set otherwise](/api/configuration/nuxt.config#middleware)).
Route middleware are navigation guards stored in the [`middleware/`](/guide/directory-structure/middleware) directory of your Nuxt application (unless [set otherwise](/api/configuration/nuxt-config#middleware)).
::

## Usage
Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/3.utils/define-nuxt-route-middleware.md
Expand Up @@ -6,7 +6,7 @@ title: "defineNuxtRouteMiddleware"

Create named route middleware using `defineNuxtRouteMiddleware` helper function.

Route middleware are stored in the `middleware/` directory of your Nuxt application (unless [set otherwise](/api/configuration/nuxt.config#middleware)).
Route middleware are stored in the `middleware/` directory of your Nuxt application (unless [set otherwise](/api/configuration/nuxt-config#middleware)).

## Type

Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/3.utils/define-page-meta.md
Expand Up @@ -4,7 +4,7 @@ title: "definePageMeta"

# `definePageMeta`

`definePageMeta` is a compiler macro that you can use to set metadata for your **page** components located in the `pages/` directory (unless [set otherwise](https://v3.nuxtjs.org/api/configuration/nuxt.config#pages)). This way you can set custom metadata for each static or dynamic route of your Nuxt application.
`definePageMeta` is a compiler macro that you can use to set metadata for your **page** components located in the `pages/` directory (unless [set otherwise](https://v3.nuxtjs.org/api/configuration/nuxt-config#pages)). This way you can set custom metadata for each static or dynamic route of your Nuxt application.

```vue [pages/some-page.vue]
<script setup>
Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/3.utils/prefetch-components.md
Expand Up @@ -17,7 +17,7 @@ await prefetchComponents(['MyGlobalComponent1', 'MyGlobalComponent2'])
```

::alert{icon=πŸ‘‰}
Current implementation behaves exactly the same as [`preloadComponents`](/api/composables/preload-components) by preloading components instead of just prefetching we are working to improve this behavior.
Current implementation behaves exactly the same as [`preloadComponents`](/api/utils/preload-components) by preloading components instead of just prefetching we are working to improve this behavior.
::

::alert{icon=πŸ‘‰}
Expand Down
2 changes: 1 addition & 1 deletion docs/content/3.api/5.commands/typecheck.md
Expand Up @@ -18,5 +18,5 @@ Option | Default | Description
This command sets `process.env.NODE_ENV` to `production`. To override, define `NODE_ENV` in a `.env` file or as a command-line argument.

::alert
You can also enable type-checking at build or development time by installing `vue-tsc` and `typescript` as devDependencies and enabling [the `typescript.typeCheck` option in your `nuxt.config` file](/api/configuration/nuxt.config#typescript).
You can also enable type-checking at build or development time by installing `vue-tsc` and `typescript` as devDependencies and enabling [the `typescript.typeCheck` option in your `nuxt.config` file](/api/configuration/nuxt-config#typescript).
::
2 changes: 1 addition & 1 deletion docs/content/4.examples/3.composables/use-head.md
Expand Up @@ -11,7 +11,7 @@ Learn more about [meta tags](/guide/features/head-management#meta-components).
::ReadMore{link="/api/composables/use-head"}
::

::ReadMore{link="/getting-started/head-management"}
::ReadMore{link="/getting-started/seo-meta"}
::

::sandbox{repo="nuxt/framework" branch="main" dir="examples/composables/use-head" file="app.vue"}
Expand Down
4 changes: 2 additions & 2 deletions docs/content/5.community/4.framework-contribution.md
Expand Up @@ -5,7 +5,7 @@ description: Some specific points about contributions to the nuxt/framework repo

# nuxt/framework

Once you've read the [general contribution guide](./contribution), here are some specific points to make about contributions to the `nuxt/framework` repository.
Once you've read the [general contribution guide](/community/contribution), here are some specific points to make about contributions to the `nuxt/framework` repository.

## Using the Playground

Expand All @@ -25,7 +25,7 @@ You might have noticed already that we use ESLint to enforce a coding standard.

### Documentation

If you are adding a new feature or refactoring or changing the behavior of Nuxt in any other manner, you'll likely want to document the changes. Please include any changes to the docs in the same PR. You don't have to write documentation up on the first commit (but please do so as soon as your pull request is mature enough). Make sure to make changes according to the [Documentation Guide](./contribution#documentation-guide).
If you are adding a new feature or refactoring or changing the behavior of Nuxt in any other manner, you'll likely want to document the changes. Please include any changes to the docs in the same PR. You don't have to write documentation up on the first commit (but please do so as soon as your pull request is mature enough). Make sure to make changes according to the [Documentation Guide](/community/contribution#documentation-guide).

### Final Checklist

Expand Down
4 changes: 2 additions & 2 deletions docs/content/6.bridge/1.overview.md
Expand Up @@ -7,7 +7,7 @@ If you're starting a fresh Nuxt 3 project, please skip this section and go to [N
::

::alert{type=warning}
Nuxt Bridge provides identical features to Nuxt 3 ([docs](/guide)) but there are some limitations, notably that `useAsyncData` and `useFetch` composables are not available. Please read the rest of this page for details.
Nuxt Bridge provides identical features to Nuxt 3 ([docs](/guide/concepts/auto-imports)) but there are some limitations, notably that `useAsyncData` and `useFetch` composables are not available. Please read the rest of this page for details.
::

Bridge is a forward-compatibility layer that allows you to experience many of the new Nuxt 3 features by simply installing and enabling a Nuxt module.
Expand Down Expand Up @@ -255,7 +255,7 @@ export default defineNuxtConfig({
This `useHead` composable uses `@vueuse/head` under the hood (rather than `vue-meta`) to manipulate your `<head>`.
Accordingly, we recommend not to use both the native Nuxt 2 `head()` properties as well as `useHead`, as they may conflict.

For more information on how to use this composable, see [the docs](/getting-started/head-management).
For more information on how to use this composable, see [the docs](/getting-started/seo-meta).

## Feature Flags

Expand Down
2 changes: 1 addition & 1 deletion docs/content/6.bridge/2.bridge-composition-api.md
Expand Up @@ -270,4 +270,4 @@ export default defineNuxtConfig({

This `useHead` composable uses `@vueuse/head` under the hood (rather than `vue-meta`) to manipulate your `<head>`. Accordingly, it is recommended not to use both the native Nuxt 2 `head()` properties as well as `useHead`, as they may conflict.

For more information on how to use this composable, see [the Nuxt 3 docs](/getting-started/head-management).
For more information on how to use this composable, see [the Nuxt 3 docs](/getting-started/seo-meta).
2 changes: 1 addition & 1 deletion docs/content/7.migration/1.overview.md
Expand Up @@ -21,5 +21,5 @@ Some of these significant changes include:
1. Moving from a runtime Nuxt dependency to a minimal, standalone server compiled with nitropack.

::alert{type=info}
If you need to remain on Nuxt 2, but want to benefit from Nuxt 3 features in Nuxt 2, you can alternatively check out [how to get started with Bridge](/bridge).
If you need to remain on Nuxt 2, but want to benefit from Nuxt 3 features in Nuxt 2, you can alternatively check out [how to get started with Bridge](/bridge/overview).
::
6 changes: 3 additions & 3 deletions docs/content/7.migration/4.meta.md
Expand Up @@ -3,16 +3,16 @@
Nuxt 3 provides several different ways to manage your meta tags.

1. Through your `nuxt.config`.
2. Through the `useHead` [composable](/getting-started/head-management)
3. Through [global meta components](/getting-started/head-management)
2. Through the `useHead` [composable](/getting-started/seo-meta)
3. Through [global meta components](/getting-started/seo-meta)

You can customize `title`, `titleTemplate`, `base`, `script`, `noscript`, `style`, `meta`, `link`, `htmlAttrs` and `bodyAttrs`.

::alert{icon=πŸ“¦}
Nuxt currently uses [`vueuse/head`](https://github.com/vueuse/head) to manage your meta tags, but implementation details may change.
::

[Read more about meta tags](/getting-started/head-management).
[Read more about meta tags](/getting-started/seo-meta).

## Migration

Expand Down
9 changes: 8 additions & 1 deletion docs/public/_redirects
Expand Up @@ -3,6 +3,11 @@
/getting-started/bridge /bridge 302!
/getting-started/bridge-composition-api /bridge/bridge-composition-api 302!

/contribution /community/contribution 302!
/bridge /bridge/overview 302!
/guide /guide/concepts/auto-imports 302!
/guide/concepts /guide/concepts/auto-imports 302!

# Concepts
/concepts/introduction /getting-started/introduction 302!
/concepts/vuejs-development /guide/concepts/vuejs-development 302!
Expand Down Expand Up @@ -50,8 +55,10 @@
/guide/features/app-config /guide/directory-structure/app.config 302!
/guide/features/runtime-config /guide/going-further/runtime-config 302!
/guide/features/teleports /api/components/teleports 302!
/api/utils/$fetch /api/utils/dollarfetch 302!
/api/composables/preload-components /api/utils/preload-components 302
# https://github.com/nuxt/framework/pull/8038
/api/configuration/nuxt.config /api/configuration/nuxt-config 302!
/api/configuration/nuxt.config /api/configuration/nuxt-config 302!

/guide/deploy/node-server /getting-started/deployment 302!
/guide/deploy/static-hosting /getting-started/deployment 302!
Expand Down
2 changes: 1 addition & 1 deletion scripts/crawl.mjs
Expand Up @@ -18,7 +18,7 @@ const errorsToIgnore = [
'/guide/directory-structure/nuxt.config',
'/guide/directory-structure',
'/guide/directory-structure/app.config',
'/api/configuration/nuxt.config',
'/api/configuration/nuxt-config',
'/guide/deploy',
'/guide/features/app-config'
]
Expand Down