docs: add extend pages page

docs/content/2.guide/14.extend-pages.md

@@ -0,0 +1,54 @@
+# Extending pages
+
+Adding localized pages from a module.
+
+---
+
+::alert{type="info"}
+This is a workaround, support for extending pages with localization regardless of module registration order may be added in the future.
+::
+::alert{type="warning"}
+Your module has to registered before `@nuxtjs/i18n` to ensure localized routes are generated for the added pages.
+::
+
+
+If you're a **module author** and want your module to add extra pages to your project, you can add these by using the `pages:extend` Nuxt hook.
+
+::code-group
+ ::code-block{label="Nuxt config" active}
+ ```ts {}[nuxt.config.ts]
+ import ExampleModule from './modules/example-module'
+
+ export default defineNuxtConfig({
+ modules: [
+ ExampleModule, // Register module before `@nuxtjs/i18n`
+ '@nuxtjs/i18n',
+ ],
+ })
+ ```
+ ::
+ ::code-block{label="Module configuration"}
+ ```ts {}[modules/example-module/index.ts]
+ import { defineNuxtModule, resolve } from '@nuxt/kit'
+
+ export default defineNuxtModule({
+ setup(options, nuxt) {
+ const { resolve } = createResolver(import.meta.url);
+
+ nuxt.hook('pages:extend', (pages) => {
+ pages.push({
+ name: 'example-page',
+ path: '/example-page',
+ file: resolve(__dirname, './pages/example-page.vue'),
+ });
+ });
+ }
+ })
+ ```
+ ::
+::
+
+
+
+
+