From 52d79c4e0cf8876903aa079cf8cbcd46f265505a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= Date: Fri, 15 Sep 2023 19:44:35 +0200 Subject: [PATCH] chore: v3.0.0-beta.0 release (#9311) --- admin/new.docusaurus.io/package.json | 2 +- argos/package.json | 2 +- lerna.json | 2 +- packages/create-docusaurus/package.json | 6 +- .../templates/classic-typescript/package.json | 10 +- .../templates/classic/package.json | 8 +- .../docusaurus-cssnano-preset/package.json | 2 +- packages/docusaurus-logger/package.json | 2 +- packages/docusaurus-mdx-loader/package.json | 10 +- packages/docusaurus-migrate/package.json | 6 +- .../package.json | 4 +- .../package.json | 14 +- .../package.json | 16 +-- .../package.json | 16 +-- .../package.json | 12 +- packages/docusaurus-plugin-debug/package.json | 8 +- .../package.json | 8 +- .../package.json | 8 +- .../package.json | 8 +- .../package.json | 14 +- packages/docusaurus-plugin-pwa/package.json | 16 +-- .../docusaurus-plugin-sitemap/package.json | 14 +- .../docusaurus-preset-classic/package.json | 28 ++-- .../package.json | 2 +- .../docusaurus-theme-classic/package.json | 26 ++-- packages/docusaurus-theme-common/package.json | 20 +-- .../package.json | 12 +- .../docusaurus-theme-mermaid/package.json | 12 +- .../package.json | 18 +-- .../package.json | 6 +- packages/docusaurus-tsconfig/package.json | 2 +- packages/docusaurus-types/package.json | 2 +- packages/docusaurus-utils-common/package.json | 2 +- .../docusaurus-utils-validation/package.json | 6 +- packages/docusaurus-utils/package.json | 6 +- packages/docusaurus/package.json | 18 +-- packages/eslint-plugin/package.json | 2 +- packages/lqip-loader/package.json | 4 +- packages/stylelint-copyright/package.json | 2 +- website/package.json | 32 ++--- .../advanced/architecture.mdx | 0 .../advanced/client.mdx | 2 - .../advanced/index.mdx | 0 .../advanced/plugins.mdx | 0 .../advanced/routing.mdx | 0 .../advanced/ssg.mdx | 0 .../api/docusaurus.config.js.mdx | 42 +++++- .../api/misc/_category_.yml | 0 .../api/misc/create-docusaurus.mdx | 4 +- .../api/misc/eslint-plugin/README.mdx | 0 .../api/misc/eslint-plugin/no-html-links.mdx | 0 .../eslint-plugin/no-untranslated-text.mdx | 0 .../prefer-docusaurus-heading.mdx | 0 .../string-literal-i18n-messages.mdx | 0 .../api/misc/logger/demo.png | Bin .../api/misc/logger/logger.mdx | 2 + .../api/plugin-methods/README.mdx | 0 .../api/plugin-methods/_category_.yml | 0 .../plugin-methods/extend-infrastructure.mdx | 0 .../api/plugin-methods/i18n-lifecycles.mdx | 0 .../api/plugin-methods/lifecycle-apis.mdx | 0 .../api/plugin-methods/static-methods.mdx | 0 .../api/plugins/_category_.yml | 0 .../api/plugins/overview.mdx | 0 .../api/plugins/plugin-client-redirects.mdx | 0 .../api/plugins/plugin-content-blog.mdx | 1 + .../api/plugins/plugin-content-docs.mdx | 0 .../api/plugins/plugin-content-pages.mdx | 0 .../api/plugins/plugin-debug.mdx | 0 .../api/plugins/plugin-google-analytics.mdx | 0 .../api/plugins/plugin-google-gtag.mdx | 0 .../api/plugins/plugin-google-tag-manager.mdx | 0 .../api/plugins/plugin-ideal-image.mdx | 0 .../api/plugins/plugin-pwa.mdx | 0 .../api/plugins/plugin-sitemap.mdx | 0 .../api/themes/_category_.yml | 0 .../api/themes/overview.mdx | 0 .../api/themes/theme-classic.mdx | 0 .../api/themes/theme-configuration.mdx | 2 +- .../api/themes/theme-live-codeblock.mdx | 0 .../api/themes/theme-mermaid.mdx | 0 .../api/themes/theme-search-algolia.mdx | 0 .../docusaurus-asset-example-banner.png | Bin .../assets/docusaurus-asset-example.docx | Bin .../assets/docusaurus-asset-example.xyz | Bin .../blog.mdx | 1 + .../browser-support.mdx | 0 .../cli.mdx | 0 .../configuration.mdx | 0 .../deployment.mdx | 124 ++++++++++-------- .../docusaurus-core.mdx | 0 .../guides/creating-pages.mdx | 0 .../guides/docs/docs-create-doc.mdx | 0 .../guides/docs/docs-introduction.mdx | 40 +++--- .../guides/docs/docs-multi-instance.mdx | 0 .../guides/docs/sidebar/autogenerated.mdx | 0 .../guides/docs/sidebar/index.mdx | 0 .../guides/docs/sidebar/items.mdx | 0 .../guides/docs/sidebar/multiple-sidebars.mdx | 0 .../guides/docs/versioning.mdx | 0 .../_markdown-partial-example.mdx | 0 .../markdown-features-admonitions.mdx | 8 +- .../markdown-features-assets.mdx | 0 .../markdown-features-code-blocks.mdx | 0 .../markdown-features-diagrams.mdx | 0 .../markdown-features-head-metadata.mdx | 0 .../markdown-features-intro.mdx | 50 +++++-- .../markdown-features-links.mdx | 0 .../markdown-features-math-equations.mdx | 0 .../markdown-features-plugins.mdx | 0 .../markdown-features-react.mdx | 17 +-- .../markdown-features-react.module.css | 0 .../markdown-features-tabs-styles.module.css | 0 .../markdown-features-tabs.mdx | 0 .../markdown-features-toc.mdx | 0 .../guides/whats-next.mdx | 0 .../i18n/i18n-crowdin.mdx | 0 .../i18n/i18n-git.mdx | 0 .../i18n/i18n-introduction.mdx | 0 .../i18n/i18n-tutorial.mdx | 0 .../installation.mdx | 6 +- .../introduction.mdx | 0 .../migration/migration-automated.mdx | 0 .../migration/migration-manual.mdx | 0 .../migration/migration-overview.mdx | 0 .../migration/migration-translated-sites.mdx | 0 .../migration/migration-versioned-sites.mdx | 0 .../playground.mdx | 0 .../search.mdx | 0 .../seo.mdx | 0 .../static-assets.mdx | 0 .../styling-layout.mdx | 0 .../swizzling.mdx | 2 +- .../typescript-support.mdx | 0 .../using-plugins.mdx | 0 ...son => version-3.0.0-beta.0-sidebars.json} | 0 website/versions.json | 2 +- 137 files changed, 382 insertions(+), 309 deletions(-) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/advanced/architecture.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/advanced/client.mdx (99%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/advanced/index.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/advanced/plugins.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/advanced/routing.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/advanced/ssg.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/docusaurus.config.js.mdx (91%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/_category_.yml (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/create-docusaurus.mdx (92%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/eslint-plugin/README.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/eslint-plugin/no-html-links.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/eslint-plugin/no-untranslated-text.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/eslint-plugin/prefer-docusaurus-heading.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/eslint-plugin/string-literal-i18n-messages.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/logger/demo.png (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/misc/logger/logger.mdx (98%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugin-methods/README.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugin-methods/_category_.yml (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugin-methods/extend-infrastructure.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugin-methods/i18n-lifecycles.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugin-methods/lifecycle-apis.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugin-methods/static-methods.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/_category_.yml (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/overview.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-client-redirects.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-content-blog.mdx (98%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-content-docs.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-content-pages.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-debug.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-google-analytics.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-google-gtag.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-google-tag-manager.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-ideal-image.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-pwa.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/plugins/plugin-sitemap.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/_category_.yml (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/overview.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/theme-classic.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/theme-configuration.mdx (99%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/theme-live-codeblock.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/theme-mermaid.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/api/themes/theme-search-algolia.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/assets/docusaurus-asset-example-banner.png (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/assets/docusaurus-asset-example.docx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/assets/docusaurus-asset-example.xyz (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/blog.mdx (99%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/browser-support.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/cli.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/configuration.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/deployment.mdx (78%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/docusaurus-core.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/creating-pages.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/docs-create-doc.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/docs-introduction.mdx (86%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/docs-multi-instance.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/sidebar/autogenerated.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/sidebar/index.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/sidebar/items.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/sidebar/multiple-sidebars.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/docs/versioning.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/_markdown-partial-example.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-admonitions.mdx (98%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-assets.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-code-blocks.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-diagrams.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-head-metadata.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-intro.mdx (63%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-links.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-math-equations.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-plugins.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-react.mdx (94%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-react.module.css (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-tabs-styles.module.css (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-tabs.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/markdown-features/markdown-features-toc.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/guides/whats-next.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/i18n/i18n-crowdin.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/i18n/i18n-git.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/i18n/i18n-introduction.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/i18n/i18n-tutorial.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/installation.mdx (95%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/introduction.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/migration/migration-automated.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/migration/migration-manual.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/migration/migration-overview.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/migration/migration-translated-sites.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/migration/migration-versioned-sites.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/playground.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/search.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/seo.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/static-assets.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/styling-layout.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/swizzling.mdx (98%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/typescript-support.mdx (100%) rename website/versioned_docs/{version-3.0.0-alpha.0 => version-3.0.0-beta.0}/using-plugins.mdx (100%) rename website/versioned_sidebars/{version-3.0.0-alpha.0-sidebars.json => version-3.0.0-beta.0-sidebars.json} (100%) diff --git a/admin/new.docusaurus.io/package.json b/admin/new.docusaurus.io/package.json index 15a0928013..f786012420 100644 --- a/admin/new.docusaurus.io/package.json +++ b/admin/new.docusaurus.io/package.json @@ -1,6 +1,6 @@ { "name": "new.docusaurus.io", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "private": true, "scripts": { "start": "npx --package netlify-cli netlify dev" diff --git a/argos/package.json b/argos/package.json index cd1a2735d4..e856801112 100644 --- a/argos/package.json +++ b/argos/package.json @@ -1,6 +1,6 @@ { "name": "argos", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Argos visual diff tests", "license": "MIT", "private": true, diff --git a/lerna.json b/lerna.json index b493cc6464..e128b29778 100644 --- a/lerna.json +++ b/lerna.json @@ -1,5 +1,5 @@ { - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "npmClient": "yarn", "useWorkspaces": true, "useNx": false, diff --git a/packages/create-docusaurus/package.json b/packages/create-docusaurus/package.json index e303c56a1d..5a35242af8 100755 --- a/packages/create-docusaurus/package.json +++ b/packages/create-docusaurus/package.json @@ -1,6 +1,6 @@ { "name": "create-docusaurus", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Create Docusaurus apps easily.", "type": "module", "repository": { @@ -22,8 +22,8 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", "commander": "^5.1.0", "fs-extra": "^11.1.1", "lodash": "^4.17.21", diff --git a/packages/create-docusaurus/templates/classic-typescript/package.json b/packages/create-docusaurus/templates/classic-typescript/package.json index d85b5ea3b5..70599e25f2 100644 --- a/packages/create-docusaurus/templates/classic-typescript/package.json +++ b/packages/create-docusaurus/templates/classic-typescript/package.json @@ -1,6 +1,6 @@ { "name": "docusaurus-2-classic-typescript-template", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "private": true, "scripts": { "docusaurus": "docusaurus", @@ -15,8 +15,8 @@ "typecheck": "tsc" }, "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/preset-classic": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/preset-classic": "3.0.0-beta.0", "@mdx-js/react": "^2.3.0", "clsx": "^1.2.1", "prism-react-renderer": "^1.3.5", @@ -24,8 +24,8 @@ "react-dom": "^18.0.0" }, "devDependencies": { - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", - "@docusaurus/tsconfig": "3.0.0-alpha.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", + "@docusaurus/tsconfig": "3.0.0-beta.0", "typescript": "~5.2.2" }, "browserslist": { diff --git a/packages/create-docusaurus/templates/classic/package.json b/packages/create-docusaurus/templates/classic/package.json index 58e3fb50dc..75cf68f28e 100644 --- a/packages/create-docusaurus/templates/classic/package.json +++ b/packages/create-docusaurus/templates/classic/package.json @@ -1,6 +1,6 @@ { "name": "docusaurus-2-classic-template", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "private": true, "scripts": { "docusaurus": "docusaurus", @@ -14,8 +14,8 @@ "write-heading-ids": "docusaurus write-heading-ids" }, "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/preset-classic": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/preset-classic": "3.0.0-beta.0", "@mdx-js/react": "^2.3.0", "clsx": "^1.2.1", "prism-react-renderer": "^1.3.5", @@ -23,7 +23,7 @@ "react-dom": "^18.0.0" }, "devDependencies": { - "@docusaurus/module-type-aliases": "3.0.0-alpha.0" + "@docusaurus/module-type-aliases": "3.0.0-beta.0" }, "browserslist": { "production": [ diff --git a/packages/docusaurus-cssnano-preset/package.json b/packages/docusaurus-cssnano-preset/package.json index 98c9cee22a..385f33da70 100644 --- a/packages/docusaurus-cssnano-preset/package.json +++ b/packages/docusaurus-cssnano-preset/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/cssnano-preset", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Advanced cssnano preset for maximum optimization.", "main": "lib/index.js", "license": "MIT", diff --git a/packages/docusaurus-logger/package.json b/packages/docusaurus-logger/package.json index fdd764c539..067172b0c2 100644 --- a/packages/docusaurus-logger/package.json +++ b/packages/docusaurus-logger/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/logger", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "An encapsulated logger for semantically formatting console messages.", "main": "./lib/index.js", "repository": { diff --git a/packages/docusaurus-mdx-loader/package.json b/packages/docusaurus-mdx-loader/package.json index c2023b3df5..fe4792e9c8 100644 --- a/packages/docusaurus-mdx-loader/package.json +++ b/packages/docusaurus-mdx-loader/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/mdx-loader", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus Loader for MDX", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -20,9 +20,9 @@ "dependencies": { "@babel/parser": "^7.22.7", "@babel/traverse": "^7.22.8", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@mdx-js/mdx": "^2.1.5", "@slorber/remark-comment": "^1.0.0", "escape-html": "^1.0.3", @@ -45,7 +45,7 @@ "webpack": "^5.88.1" }, "devDependencies": { - "@docusaurus/types": "3.0.0-alpha.0", + "@docusaurus/types": "3.0.0-beta.0", "@types/escape-html": "^1.0.2", "@types/mdast": "^3.0.12", "@types/stringify-object": "^3.3.1", diff --git a/packages/docusaurus-migrate/package.json b/packages/docusaurus-migrate/package.json index cbf03c5c50..908c90d6e8 100644 --- a/packages/docusaurus-migrate/package.json +++ b/packages/docusaurus-migrate/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/migrate", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "A CLI tool to migrate from older versions of Docusaurus.", "license": "MIT", "engines": { @@ -24,8 +24,8 @@ "dependencies": { "@babel/core": "^7.22.9", "@babel/preset-env": "^7.22.9", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", "@mapbox/hast-util-to-jsx": "^2.0.0", "color": "^4.2.3", "commander": "^5.1.0", diff --git a/packages/docusaurus-module-type-aliases/package.json b/packages/docusaurus-module-type-aliases/package.json index 1b1b60cd7c..2c5fd39182 100644 --- a/packages/docusaurus-module-type-aliases/package.json +++ b/packages/docusaurus-module-type-aliases/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/module-type-aliases", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus module type aliases.", "types": "./src/index.d.ts", "publishConfig": { @@ -13,7 +13,7 @@ }, "dependencies": { "@docusaurus/react-loadable": "5.5.2", - "@docusaurus/types": "3.0.0-alpha.0", + "@docusaurus/types": "3.0.0-beta.0", "@types/history": "^4.7.11", "@types/react": "*", "@types/react-router-config": "*", diff --git a/packages/docusaurus-plugin-client-redirects/package.json b/packages/docusaurus-plugin-client-redirects/package.json index bf2e4d31a7..d5392524bd 100644 --- a/packages/docusaurus-plugin-client-redirects/package.json +++ b/packages/docusaurus-plugin-client-redirects/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-client-redirects", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Client redirects plugin for Docusaurus.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -18,18 +18,18 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "eta": "^2.2.0", "fs-extra": "^11.1.1", "lodash": "^4.17.21", "tslib": "^2.6.0" }, "devDependencies": { - "@docusaurus/types": "3.0.0-alpha.0" + "@docusaurus/types": "3.0.0-beta.0" }, "peerDependencies": { "react": "^18.0.0", diff --git a/packages/docusaurus-plugin-content-blog/package.json b/packages/docusaurus-plugin-content-blog/package.json index adbed098b5..95575e84a6 100644 --- a/packages/docusaurus-plugin-content-blog/package.json +++ b/packages/docusaurus-plugin-content-blog/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-content-blog", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Blog plugin for Docusaurus.", "main": "lib/index.js", "types": "src/plugin-content-blog.d.ts", @@ -19,13 +19,13 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/mdx-loader": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/mdx-loader": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "cheerio": "^1.0.0-rc.12", "feed": "^4.2.2", "fs-extra": "^11.1.1", diff --git a/packages/docusaurus-plugin-content-docs/package.json b/packages/docusaurus-plugin-content-docs/package.json index b3cd70138e..0dc3073526 100644 --- a/packages/docusaurus-plugin-content-docs/package.json +++ b/packages/docusaurus-plugin-content-docs/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-content-docs", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docs plugin for Docusaurus.", "main": "lib/index.js", "sideEffects": false, @@ -35,13 +35,13 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/mdx-loader": "3.0.0-alpha.0", - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/mdx-loader": "3.0.0-beta.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@types/react-router-config": "^5.0.7", "combine-promises": "^1.1.0", "fs-extra": "^11.1.1", diff --git a/packages/docusaurus-plugin-content-pages/package.json b/packages/docusaurus-plugin-content-pages/package.json index 0212ea1ce6..8beeecad9c 100644 --- a/packages/docusaurus-plugin-content-pages/package.json +++ b/packages/docusaurus-plugin-content-pages/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-content-pages", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Pages plugin for Docusaurus.", "main": "lib/index.js", "types": "src/plugin-content-pages.d.ts", @@ -18,11 +18,11 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/mdx-loader": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/mdx-loader": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "fs-extra": "^11.1.1", "tslib": "^2.6.0", "webpack": "^5.88.1" diff --git a/packages/docusaurus-plugin-debug/package.json b/packages/docusaurus-plugin-debug/package.json index abe9417b00..b96f687549 100644 --- a/packages/docusaurus-plugin-debug/package.json +++ b/packages/docusaurus-plugin-debug/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-debug", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Debug plugin for Docusaurus.", "main": "lib/index.js", "types": "src/plugin-debug.d.ts", @@ -20,9 +20,9 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", "@microlink/react-json-view": "^1.22.2", "fs-extra": "^11.1.1", "tslib": "^2.6.0" diff --git a/packages/docusaurus-plugin-google-analytics/package.json b/packages/docusaurus-plugin-google-analytics/package.json index 7ca06a5dbe..e65d1df03a 100644 --- a/packages/docusaurus-plugin-google-analytics/package.json +++ b/packages/docusaurus-plugin-google-analytics/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-google-analytics", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Global analytics (analytics.js) plugin for Docusaurus.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -18,9 +18,9 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "tslib": "^2.6.0" }, "peerDependencies": { diff --git a/packages/docusaurus-plugin-google-gtag/package.json b/packages/docusaurus-plugin-google-gtag/package.json index 17efd74cca..158d1d3660 100644 --- a/packages/docusaurus-plugin-google-gtag/package.json +++ b/packages/docusaurus-plugin-google-gtag/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-google-gtag", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Global Site Tag (gtag.js) plugin for Docusaurus.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -18,9 +18,9 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@types/gtag.js": "^0.0.12", "tslib": "^2.6.0" }, diff --git a/packages/docusaurus-plugin-google-tag-manager/package.json b/packages/docusaurus-plugin-google-tag-manager/package.json index 3c3ffb865a..a6460b21d4 100644 --- a/packages/docusaurus-plugin-google-tag-manager/package.json +++ b/packages/docusaurus-plugin-google-tag-manager/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-google-tag-manager", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Google Tag Manager (gtm.js) plugin for Docusaurus.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -18,9 +18,9 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "tslib": "^2.6.0" }, "peerDependencies": { diff --git a/packages/docusaurus-plugin-ideal-image/package.json b/packages/docusaurus-plugin-ideal-image/package.json index da0d811a5f..eb030bd821 100644 --- a/packages/docusaurus-plugin-ideal-image/package.json +++ b/packages/docusaurus-plugin-ideal-image/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-ideal-image", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus Plugin to generate an almost ideal image (responsive, lazy-loading, and low quality placeholder).", "main": "lib/index.js", "types": "src/plugin-ideal-image.d.ts", @@ -20,12 +20,12 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/lqip-loader": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/lqip-loader": "3.0.0-beta.0", "@docusaurus/responsive-loader": "^1.7.0", - "@docusaurus/theme-translations": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/theme-translations": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@slorber/react-ideal-image": "^0.0.12", "react-waypoint": "^10.3.0", "sharp": "^0.32.3", @@ -33,7 +33,7 @@ "webpack": "^5.88.1" }, "devDependencies": { - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", "fs-extra": "^11.1.0" }, "peerDependencies": { diff --git a/packages/docusaurus-plugin-pwa/package.json b/packages/docusaurus-plugin-pwa/package.json index 30bb2b6eb1..e3137d10f8 100644 --- a/packages/docusaurus-plugin-pwa/package.json +++ b/packages/docusaurus-plugin-pwa/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-pwa", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus Plugin to add PWA support.", "main": "lib/index.js", "types": "src/plugin-pwa.d.ts", @@ -22,12 +22,12 @@ "dependencies": { "@babel/core": "^7.22.9", "@babel/preset-env": "^7.22.9", - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/theme-translations": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/theme-translations": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "babel-loader": "^9.1.3", "clsx": "^1.2.1", "core-js": "^3.31.1", @@ -41,7 +41,7 @@ "workbox-window": "^6.6.1" }, "devDependencies": { - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", "fs-extra": "^11.1.0" }, "peerDependencies": { diff --git a/packages/docusaurus-plugin-sitemap/package.json b/packages/docusaurus-plugin-sitemap/package.json index 39bcd397bb..12799ffcd4 100644 --- a/packages/docusaurus-plugin-sitemap/package.json +++ b/packages/docusaurus-plugin-sitemap/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/plugin-sitemap", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Simple sitemap generation plugin for Docusaurus.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -18,12 +18,12 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "fs-extra": "^11.1.1", "sitemap": "^7.1.1", "tslib": "^2.6.0" diff --git a/packages/docusaurus-preset-classic/package.json b/packages/docusaurus-preset-classic/package.json index 347cc67f43..a5e79bb78c 100644 --- a/packages/docusaurus-preset-classic/package.json +++ b/packages/docusaurus-preset-classic/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/preset-classic", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Classic preset for Docusaurus.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -18,19 +18,19 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/plugin-content-blog": "3.0.0-alpha.0", - "@docusaurus/plugin-content-docs": "3.0.0-alpha.0", - "@docusaurus/plugin-content-pages": "3.0.0-alpha.0", - "@docusaurus/plugin-debug": "3.0.0-alpha.0", - "@docusaurus/plugin-google-analytics": "3.0.0-alpha.0", - "@docusaurus/plugin-google-gtag": "3.0.0-alpha.0", - "@docusaurus/plugin-google-tag-manager": "3.0.0-alpha.0", - "@docusaurus/plugin-sitemap": "3.0.0-alpha.0", - "@docusaurus/theme-classic": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/theme-search-algolia": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0" + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/plugin-content-blog": "3.0.0-beta.0", + "@docusaurus/plugin-content-docs": "3.0.0-beta.0", + "@docusaurus/plugin-content-pages": "3.0.0-beta.0", + "@docusaurus/plugin-debug": "3.0.0-beta.0", + "@docusaurus/plugin-google-analytics": "3.0.0-beta.0", + "@docusaurus/plugin-google-gtag": "3.0.0-beta.0", + "@docusaurus/plugin-google-tag-manager": "3.0.0-beta.0", + "@docusaurus/plugin-sitemap": "3.0.0-beta.0", + "@docusaurus/theme-classic": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/theme-search-algolia": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0" }, "peerDependencies": { "react": "^18.0.0", diff --git a/packages/docusaurus-remark-plugin-npm2yarn/package.json b/packages/docusaurus-remark-plugin-npm2yarn/package.json index 89b337858d..84b9fa4282 100644 --- a/packages/docusaurus-remark-plugin-npm2yarn/package.json +++ b/packages/docusaurus-remark-plugin-npm2yarn/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/remark-plugin-npm2yarn", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Remark plugin for converting npm commands to Yarn commands as tabs.", "main": "lib/index.js", "publishConfig": { diff --git a/packages/docusaurus-theme-classic/package.json b/packages/docusaurus-theme-classic/package.json index 3b7cf9bc2e..45b81bf13b 100644 --- a/packages/docusaurus-theme-classic/package.json +++ b/packages/docusaurus-theme-classic/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/theme-classic", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Classic theme for Docusaurus", "main": "lib/index.js", "types": "src/theme-classic.d.ts", @@ -20,18 +20,18 @@ "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch" }, "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/mdx-loader": "3.0.0-alpha.0", - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", - "@docusaurus/plugin-content-blog": "3.0.0-alpha.0", - "@docusaurus/plugin-content-docs": "3.0.0-alpha.0", - "@docusaurus/plugin-content-pages": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/theme-translations": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/mdx-loader": "3.0.0-beta.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", + "@docusaurus/plugin-content-blog": "3.0.0-beta.0", + "@docusaurus/plugin-content-docs": "3.0.0-beta.0", + "@docusaurus/plugin-content-pages": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/theme-translations": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@mdx-js/react": "^2.1.5", "clsx": "^1.2.1", "copy-text-to-clipboard": "^3.2.0", diff --git a/packages/docusaurus-theme-common/package.json b/packages/docusaurus-theme-common/package.json index 193c2e9f2b..f3cbb319ff 100644 --- a/packages/docusaurus-theme-common/package.json +++ b/packages/docusaurus-theme-common/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/theme-common", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Common code for Docusaurus themes.", "main": "./lib/index.js", "types": "./lib/index.d.ts", @@ -30,13 +30,13 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/mdx-loader": "3.0.0-alpha.0", - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", - "@docusaurus/plugin-content-blog": "3.0.0-alpha.0", - "@docusaurus/plugin-content-docs": "3.0.0-alpha.0", - "@docusaurus/plugin-content-pages": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", + "@docusaurus/mdx-loader": "3.0.0-beta.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", + "@docusaurus/plugin-content-blog": "3.0.0-beta.0", + "@docusaurus/plugin-content-docs": "3.0.0-beta.0", + "@docusaurus/plugin-content-pages": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", "@types/history": "^4.7.11", "@types/react": "*", "@types/react-router-config": "*", @@ -47,8 +47,8 @@ "utility-types": "^3.10.0" }, "devDependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", "fs-extra": "^11.1.1", "lodash": "^4.17.21" }, diff --git a/packages/docusaurus-theme-live-codeblock/package.json b/packages/docusaurus-theme-live-codeblock/package.json index 4d4a7c3003..710c7ffcee 100644 --- a/packages/docusaurus-theme-live-codeblock/package.json +++ b/packages/docusaurus-theme-live-codeblock/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/theme-live-codeblock", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus live code block component.", "main": "lib/index.js", "types": "src/theme-live-codeblock.d.ts", @@ -23,10 +23,10 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/theme-translations": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/theme-translations": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@philpl/buble": "^0.19.7", "clsx": "^1.2.1", "fs-extra": "^11.1.1", @@ -34,7 +34,7 @@ "tslib": "^2.6.0" }, "devDependencies": { - "@docusaurus/types": "3.0.0-alpha.0", + "@docusaurus/types": "3.0.0-beta.0", "@types/buble": "^0.20.1" }, "peerDependencies": { diff --git a/packages/docusaurus-theme-mermaid/package.json b/packages/docusaurus-theme-mermaid/package.json index 455e21aac1..f907ad52d7 100644 --- a/packages/docusaurus-theme-mermaid/package.json +++ b/packages/docusaurus-theme-mermaid/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/theme-mermaid", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Mermaid components for Docusaurus.", "main": "lib/index.js", "types": "src/theme-mermaid.d.ts", @@ -33,11 +33,11 @@ "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch" }, "dependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "mermaid": "^10.4.0", "tslib": "^2.6.0" }, diff --git a/packages/docusaurus-theme-search-algolia/package.json b/packages/docusaurus-theme-search-algolia/package.json index 8a30e89527..15a6ff4d71 100644 --- a/packages/docusaurus-theme-search-algolia/package.json +++ b/packages/docusaurus-theme-search-algolia/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/theme-search-algolia", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Algolia search component for Docusaurus.", "main": "lib/index.js", "sideEffects": [ @@ -34,13 +34,13 @@ }, "dependencies": { "@docsearch/react": "~3.3.3", - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/plugin-content-docs": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/theme-translations": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/plugin-content-docs": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/theme-translations": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "algoliasearch": "^4.18.0", "algoliasearch-helper": "^3.13.3", "clsx": "^1.2.1", @@ -51,7 +51,7 @@ "utility-types": "^3.10.0" }, "devDependencies": { - "@docusaurus/module-type-aliases": "3.0.0-alpha.0" + "@docusaurus/module-type-aliases": "3.0.0-beta.0" }, "peerDependencies": { "react": "^18.0.0", diff --git a/packages/docusaurus-theme-translations/package.json b/packages/docusaurus-theme-translations/package.json index e97dcf3f5f..c5a9868801 100644 --- a/packages/docusaurus-theme-translations/package.json +++ b/packages/docusaurus-theme-translations/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/theme-translations", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus theme translations.", "main": "lib/index.js", "types": "lib/index.d.ts", @@ -23,8 +23,8 @@ "tslib": "^2.6.0" }, "devDependencies": { - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", "lodash": "^4.17.21" }, "engines": { diff --git a/packages/docusaurus-tsconfig/package.json b/packages/docusaurus-tsconfig/package.json index 2801b213e3..0fb55ed943 100644 --- a/packages/docusaurus-tsconfig/package.json +++ b/packages/docusaurus-tsconfig/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/tsconfig", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Docusaurus base TypeScript configuration.", "main": "tsconfig.json", "publishConfig": { diff --git a/packages/docusaurus-types/package.json b/packages/docusaurus-types/package.json index cb46482f3e..cdeee38918 100644 --- a/packages/docusaurus-types/package.json +++ b/packages/docusaurus-types/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/types", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Common types for Docusaurus packages.", "types": "./src/index.d.ts", "publishConfig": { diff --git a/packages/docusaurus-utils-common/package.json b/packages/docusaurus-utils-common/package.json index f6522e2a40..3cb446bdbf 100644 --- a/packages/docusaurus-utils-common/package.json +++ b/packages/docusaurus-utils-common/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/utils-common", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Common (Node/Browser) utility functions for Docusaurus packages.", "main": "./lib/index.js", "types": "./lib/index.d.ts", diff --git a/packages/docusaurus-utils-validation/package.json b/packages/docusaurus-utils-validation/package.json index bb63b2b2d5..4760dfee38 100644 --- a/packages/docusaurus-utils-validation/package.json +++ b/packages/docusaurus-utils-validation/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/utils-validation", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Node validation utility functions for Docusaurus packages.", "main": "./lib/index.js", "types": "./lib/index.d.ts", @@ -18,8 +18,8 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", "joi": "^17.9.2", "js-yaml": "^4.1.0", "tslib": "^2.6.0" diff --git a/packages/docusaurus-utils/package.json b/packages/docusaurus-utils/package.json index 2591e507b4..fe00585bd8 100644 --- a/packages/docusaurus-utils/package.json +++ b/packages/docusaurus-utils/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/utils", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Node utility functions for Docusaurus packages.", "main": "./lib/index.js", "types": "./lib/index.d.ts", @@ -18,7 +18,7 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/logger": "3.0.0-alpha.0", + "@docusaurus/logger": "3.0.0-beta.0", "@svgr/webpack": "^6.5.1", "escape-string-regexp": "^4.0.0", "file-loader": "^6.2.0", @@ -39,7 +39,7 @@ "node": ">=16.14" }, "devDependencies": { - "@docusaurus/types": "3.0.0-alpha.0", + "@docusaurus/types": "3.0.0-beta.0", "@types/dedent": "^0.7.0", "@types/github-slugger": "^1.3.0", "@types/micromatch": "^4.0.2", diff --git a/packages/docusaurus/package.json b/packages/docusaurus/package.json index 5fc2aa1a29..ff242b908f 100644 --- a/packages/docusaurus/package.json +++ b/packages/docusaurus/package.json @@ -1,7 +1,7 @@ { "name": "@docusaurus/core", "description": "Easy to Maintain Open Source Documentation Websites", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "license": "MIT", "publishConfig": { "access": "public" @@ -43,13 +43,13 @@ "@babel/runtime": "^7.22.6", "@babel/runtime-corejs3": "^7.22.6", "@babel/traverse": "^7.22.8", - "@docusaurus/cssnano-preset": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/mdx-loader": "3.0.0-alpha.0", + "@docusaurus/cssnano-preset": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/mdx-loader": "3.0.0-beta.0", "@docusaurus/react-loadable": "5.5.2", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", - "@docusaurus/utils-validation": "3.0.0-alpha.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", + "@docusaurus/utils-validation": "3.0.0-beta.0", "@slorber/static-site-generator-webpack-plugin": "^4.0.7", "@svgr/webpack": "^6.5.1", "autoprefixer": "^10.4.14", @@ -106,8 +106,8 @@ "webpackbar": "^5.0.2" }, "devDependencies": { - "@docusaurus/module-type-aliases": "3.0.0-alpha.0", - "@docusaurus/types": "3.0.0-alpha.0", + "@docusaurus/module-type-aliases": "3.0.0-beta.0", + "@docusaurus/types": "3.0.0-beta.0", "@types/detect-port": "^1.3.3", "@types/react-dom": "^18.2.7", "@types/react-router-config": "^5.0.7", diff --git a/packages/eslint-plugin/package.json b/packages/eslint-plugin/package.json index 3ff5c3ede1..6b5c4cadad 100644 --- a/packages/eslint-plugin/package.json +++ b/packages/eslint-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/eslint-plugin", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "ESLint plugin to enforce best Docusaurus practices.", "main": "lib/index.js", "keywords": [ diff --git a/packages/lqip-loader/package.json b/packages/lqip-loader/package.json index a8b8911ea6..feee403dce 100644 --- a/packages/lqip-loader/package.json +++ b/packages/lqip-loader/package.json @@ -1,6 +1,6 @@ { "name": "@docusaurus/lqip-loader", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Low Quality Image Placeholders (LQIP) loader for webpack.", "main": "lib/index.js", "publishConfig": { @@ -17,7 +17,7 @@ }, "license": "MIT", "dependencies": { - "@docusaurus/logger": "3.0.0-alpha.0", + "@docusaurus/logger": "3.0.0-beta.0", "file-loader": "^6.2.0", "lodash": "^4.17.21", "sharp": "^0.32.3", diff --git a/packages/stylelint-copyright/package.json b/packages/stylelint-copyright/package.json index f3c2ee257c..2e486c3439 100644 --- a/packages/stylelint-copyright/package.json +++ b/packages/stylelint-copyright/package.json @@ -1,6 +1,6 @@ { "name": "stylelint-copyright", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "description": "Stylelint plugin to check CSS files for a copyright header.", "main": "lib/index.js", "license": "MIT", diff --git a/website/package.json b/website/package.json index db298fbec3..16b6abd53b 100644 --- a/website/package.json +++ b/website/package.json @@ -1,6 +1,6 @@ { "name": "website", - "version": "3.0.0-alpha.0", + "version": "3.0.0-beta.0", "private": true, "scripts": { "docusaurus": "docusaurus", @@ -36,19 +36,19 @@ "dependencies": { "@crowdin/cli": "^3.13.0", "@crowdin/crowdin-api-client": "^1.23.3", - "@docusaurus/core": "3.0.0-alpha.0", - "@docusaurus/logger": "3.0.0-alpha.0", - "@docusaurus/plugin-client-redirects": "3.0.0-alpha.0", - "@docusaurus/plugin-ideal-image": "3.0.0-alpha.0", - "@docusaurus/plugin-pwa": "3.0.0-alpha.0", - "@docusaurus/preset-classic": "3.0.0-alpha.0", - "@docusaurus/remark-plugin-npm2yarn": "3.0.0-alpha.0", - "@docusaurus/theme-classic": "3.0.0-alpha.0", - "@docusaurus/theme-common": "3.0.0-alpha.0", - "@docusaurus/theme-live-codeblock": "3.0.0-alpha.0", - "@docusaurus/theme-mermaid": "3.0.0-alpha.0", - "@docusaurus/utils": "3.0.0-alpha.0", - "@docusaurus/utils-common": "3.0.0-alpha.0", + "@docusaurus/core": "3.0.0-beta.0", + "@docusaurus/logger": "3.0.0-beta.0", + "@docusaurus/plugin-client-redirects": "3.0.0-beta.0", + "@docusaurus/plugin-ideal-image": "3.0.0-beta.0", + "@docusaurus/plugin-pwa": "3.0.0-beta.0", + "@docusaurus/preset-classic": "3.0.0-beta.0", + "@docusaurus/remark-plugin-npm2yarn": "3.0.0-beta.0", + "@docusaurus/theme-classic": "3.0.0-beta.0", + "@docusaurus/theme-common": "3.0.0-beta.0", + "@docusaurus/theme-live-codeblock": "3.0.0-beta.0", + "@docusaurus/theme-mermaid": "3.0.0-beta.0", + "@docusaurus/utils": "3.0.0-beta.0", + "@docusaurus/utils-common": "3.0.0-beta.0", "@popperjs/core": "^2.11.8", "@swc/core": "1.2.197", "clsx": "^1.2.1", @@ -83,8 +83,8 @@ ] }, "devDependencies": { - "@docusaurus/eslint-plugin": "3.0.0-alpha.0", - "@docusaurus/tsconfig": "3.0.0-alpha.0", + "@docusaurus/eslint-plugin": "3.0.0-beta.0", + "@docusaurus/tsconfig": "3.0.0-beta.0", "@types/jest": "^29.5.3", "cross-env": "^7.0.3", "rimraf": "^3.0.2" diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/architecture.mdx b/website/versioned_docs/version-3.0.0-beta.0/advanced/architecture.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/advanced/architecture.mdx rename to website/versioned_docs/version-3.0.0-beta.0/advanced/architecture.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx b/website/versioned_docs/version-3.0.0-beta.0/advanced/client.mdx similarity index 99% rename from website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx rename to website/versioned_docs/version-3.0.0-beta.0/advanced/client.mdx index 6a01e76346..dd77268610 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/advanced/client.mdx @@ -137,8 +137,6 @@ For every route transition, there will be several important timings: Note that the new page's DOM is only available during event (4). If you need to manipulate the new page's DOM, you'll likely want to use `onRouteDidUpdate`, which will be fired as soon as the DOM on the new page has mounted. ```js title="myClientModule.js" -import type {Location} from 'history'; - export function onRouteDidUpdate({location, previousLocation}) { // Don't execute if we are still on the same page; the lifecycle may be fired // because the hash changes (e.g. when navigating between headings) diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/index.mdx b/website/versioned_docs/version-3.0.0-beta.0/advanced/index.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/advanced/index.mdx rename to website/versioned_docs/version-3.0.0-beta.0/advanced/index.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/plugins.mdx b/website/versioned_docs/version-3.0.0-beta.0/advanced/plugins.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/advanced/plugins.mdx rename to website/versioned_docs/version-3.0.0-beta.0/advanced/plugins.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/routing.mdx b/website/versioned_docs/version-3.0.0-beta.0/advanced/routing.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/advanced/routing.mdx rename to website/versioned_docs/version-3.0.0-beta.0/advanced/routing.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx b/website/versioned_docs/version-3.0.0-beta.0/advanced/ssg.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx rename to website/versioned_docs/version-3.0.0-beta.0/advanced/ssg.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/docusaurus.config.js.mdx similarity index 91% rename from website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/docusaurus.config.js.mdx index 9259b0e185..35ab29326a 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/api/docusaurus.config.js.mdx @@ -6,6 +6,8 @@ slug: /api/docusaurus-config # `docusaurus.config.js` +import APITable from '@site/src/components/APITable'; + :::info Refer to the Getting Started [**Configuration**](../configuration.mdx) for examples. @@ -400,8 +402,24 @@ The global Docusaurus Markdown config. - Type: `MarkdownConfig` ```ts +type MarkdownPreprocessor = (args: { + filePath: string; + fileContent: string; +}) => string; + +type MDX1CompatOptions = + | boolean + | { + comments: boolean; + admonitions: boolean; + headingIds: boolean; + }; + type MarkdownConfig = { + format: 'mdx' | 'md' | 'detect'; mermaid: boolean; + preprocessor?: MarkdownPreprocessor; + mdx1Compat: MDX1CompatOptions; }; ``` @@ -410,12 +428,34 @@ Example: ```js title="docusaurus.config.js" module.exports = { markdown: { + format: 'mdx', mermaid: true, + preprocessor: ({filePath, fileContent}) => { + return fileContent.replaceAll('{{MY_VAR}}', 'MY_VALUE'); + }, + mdx1Compat: { + comments: true, + admonitions: true, + headingIds: true, + }, }, }; ``` -- `mermaid`: when `true`, allows Docusaurus to render Markdown code blocks with `mermaid` language as Mermaid diagrams. +```mdx-code-block + +``` + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| `format` | `'mdx' \| 'md' \| 'detect'` | `'mdx'` | The default parser format to use for Markdown content. Using 'detect' will select the appropriate format automatically based on file extensions: `.md` vs `.mdx`. | +| `mermaid` | `boolean` | `false` | When `true`, allows Docusaurus to render Markdown code blocks with `mermaid` language as Mermaid diagrams. | +| `preprocessor` | `MarkdownPreprocessor` | `undefined` | Gives you the ability to alter the Markdown content string before parsing. Use it as a last-resort escape hatch or workaround: it is almost always better to implement a Remark/Rehype plugin. | +| `mdx1Compat` | `MDX1CompatOptions` | `{comments: true, admonitions: true, headingIds: true}` | Compatibility options to make it easier to upgrade to Docusaurus v3+. See the [MDX 2 PR for details](https://github.com/facebook/docusaurus/pull/8288). | + +```mdx-code-block + +``` ### `customFields` {#customFields} diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/_category_.yml b/website/versioned_docs/version-3.0.0-beta.0/api/misc/_category_.yml similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/_category_.yml rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/_category_.yml diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/create-docusaurus.mdx similarity index 92% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/create-docusaurus.mdx index 039145e1df..c79540e564 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/api/misc/create-docusaurus.mdx @@ -47,10 +47,10 @@ Used when the template argument is a git repo. It needs to be one of: ### `-p, --package-manager` {#package-manager} -Value should be one of `npm`, `yarn`, or `pnpm`. If it's not explicitly provided, Docusaurus will infer one based on: +Value should be one of `npm`, `yarn`, `pnpm`, or `bun`. If it's not explicitly provided, Docusaurus will infer one based on: - The lockfile already present in the CWD (e.g. if you are setting up website in an existing project) -- The command used to invoke `create-docusaurus` (e.g. `npm init`, `npx`, `yarn create`, etc.) +- The command used to invoke `create-docusaurus` (e.g. `npm init`, `npx`, `yarn create`, `bunx`, etc.) - Interactive prompting, in case all heuristics are not present ### `-s, --skip-install` {#skip-install} diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/README.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/README.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/README.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/README.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/no-html-links.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/no-html-links.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/no-html-links.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/no-html-links.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/no-untranslated-text.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/no-untranslated-text.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/no-untranslated-text.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/no-untranslated-text.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/prefer-docusaurus-heading.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/prefer-docusaurus-heading.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/prefer-docusaurus-heading.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/prefer-docusaurus-heading.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/string-literal-i18n-messages.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/string-literal-i18n-messages.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/eslint-plugin/string-literal-i18n-messages.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/eslint-plugin/string-literal-i18n-messages.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/demo.png b/website/versioned_docs/version-3.0.0-beta.0/api/misc/logger/demo.png similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/demo.png rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/logger/demo.png diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/misc/logger/logger.mdx similarity index 98% rename from website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/misc/logger/logger.mdx index 18ecf3ef07..4c0b37371e 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/api/misc/logger/logger.mdx @@ -49,6 +49,8 @@ In addition, `warn` and `error` will color the **entire** message for better att The template literal tag evaluates the template and expressions embedded. `interpolate` returns a new string, while other logging functions prints it. Below is a typical usage: ```js +import logger from '@docusaurus/logger'; + logger.info`Hello name=${name}! You have number=${money} dollars. Here are the ${ items.length > 1 ? 'items' : 'item' } on the shelf: ${items} diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/README.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/README.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/_category_.yml b/website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/_category_.yml similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/_category_.yml rename to website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/_category_.yml diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/extend-infrastructure.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/extend-infrastructure.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/i18n-lifecycles.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/i18n-lifecycles.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/i18n-lifecycles.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/i18n-lifecycles.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/lifecycle-apis.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/lifecycle-apis.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/static-methods.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/static-methods.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/static-methods.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugin-methods/static-methods.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/_category_.yml b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/_category_.yml similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/_category_.yml rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/_category_.yml diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/overview.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/overview.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/overview.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/overview.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-client-redirects.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-client-redirects.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-blog.mdx similarity index 98% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-blog.mdx index 54adf6d725..17fbe8c36e 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-blog.mdx @@ -68,6 +68,7 @@ Accepted fields: | `feedOptions` | _See below_ | `{type: ['rss', 'atom']}` | Blog feed. | | `feedOptions.type` | FeedType \| FeedType[] \| 'all' \| null | **Required** | Type of feed to be generated. Use `null` to disable generation. | | `feedOptions.createFeedItems` | CreateFeedItemsFn \| undefined | `undefined` | An optional function which can be used to transform and / or filter the items in the feed. | +| `feedOptions.limit` | `number \| null \| false` | `20` | Limits the feed to the specified number of posts, `false` or `null` for all entries. Defaults to `20`. | | `feedOptions.title` | `string` | `siteConfig.title` | Title of the feed. | | `feedOptions.description` | `string` | \`$\{siteConfig.title} Blog\` | Description of the feed. | | `feedOptions.copyright` | `string` | `undefined` | Copyright message. | diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-docs.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-docs.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-docs.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-docs.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-pages.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-pages.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-pages.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-pages.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-debug.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-debug.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-debug.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-debug.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-google-analytics.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-google-analytics.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-google-gtag.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-google-gtag.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-google-tag-manager.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-google-tag-manager.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-ideal-image.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-ideal-image.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-pwa.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-pwa.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-sitemap.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-sitemap.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/_category_.yml b/website/versioned_docs/version-3.0.0-beta.0/api/themes/_category_.yml similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/_category_.yml rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/_category_.yml diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/themes/overview.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/overview.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-classic.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-classic.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-classic.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-classic.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-configuration.mdx similarity index 99% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-configuration.mdx index 1c41523e4a..1ca38a6a35 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-configuration.mdx @@ -767,7 +767,7 @@ Accepted fields: | --- | --- | --- | --- | | `theme` | `PrismTheme` | `palenight` | The Prism theme to use for light-theme code blocks. | | `darkTheme` | `PrismTheme` | `palenight` | The Prism theme to use for dark-theme code blocks. | -| `defaultLanguage` | `string` | `undefined` | The side of the navbar this item should appear on. | +| `defaultLanguage` | `string` | `undefined` | The default language to use for code blocks not declaring any explicit language. | | `magicComments` | `MagicCommentConfig[]` | _see below_ | The list of [magic comments](../../guides/markdown-features/markdown-features-code-blocks.mdx#custom-magic-comments). | ```mdx-code-block diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-live-codeblock.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-live-codeblock.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-live-codeblock.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-live-codeblock.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-mermaid.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-mermaid.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-mermaid.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-mermaid.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-search-algolia.mdx b/website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-search-algolia.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-search-algolia.mdx rename to website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-search-algolia.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/assets/docusaurus-asset-example-banner.png b/website/versioned_docs/version-3.0.0-beta.0/assets/docusaurus-asset-example-banner.png similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/assets/docusaurus-asset-example-banner.png rename to website/versioned_docs/version-3.0.0-beta.0/assets/docusaurus-asset-example-banner.png diff --git a/website/versioned_docs/version-3.0.0-alpha.0/assets/docusaurus-asset-example.docx b/website/versioned_docs/version-3.0.0-beta.0/assets/docusaurus-asset-example.docx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/assets/docusaurus-asset-example.docx rename to website/versioned_docs/version-3.0.0-beta.0/assets/docusaurus-asset-example.docx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/assets/docusaurus-asset-example.xyz b/website/versioned_docs/version-3.0.0-beta.0/assets/docusaurus-asset-example.xyz similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/assets/docusaurus-asset-example.xyz rename to website/versioned_docs/version-3.0.0-beta.0/assets/docusaurus-asset-example.xyz diff --git a/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx b/website/versioned_docs/version-3.0.0-beta.0/blog.mdx similarity index 99% rename from website/versioned_docs/version-3.0.0-alpha.0/blog.mdx rename to website/versioned_docs/version-3.0.0-beta.0/blog.mdx index 5f8e553ab9..0e13e66f3f 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/blog.mdx @@ -520,6 +520,7 @@ type BlogOptions = { description?: string; copyright: string; language?: string; // possible values: http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes + limit?: number | false | null; // defaults to 20 /** Allow control over the construction of BlogFeedItems */ createFeedItems?: (params: { blogPosts: BlogPost[]; diff --git a/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx b/website/versioned_docs/version-3.0.0-beta.0/browser-support.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx rename to website/versioned_docs/version-3.0.0-beta.0/browser-support.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx b/website/versioned_docs/version-3.0.0-beta.0/cli.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/cli.mdx rename to website/versioned_docs/version-3.0.0-beta.0/cli.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/configuration.mdx b/website/versioned_docs/version-3.0.0-beta.0/configuration.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/configuration.mdx rename to website/versioned_docs/version-3.0.0-beta.0/configuration.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx b/website/versioned_docs/version-3.0.0-beta.0/deployment.mdx similarity index 78% rename from website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx rename to website/versioned_docs/version-3.0.0-beta.0/deployment.mdx index ecaa0be8f6..18a7e71e91 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/deployment.mdx @@ -20,7 +20,7 @@ It is now up to you to choose how to host those static files. ::: -You can deploy your site to static site hosting services such as [Vercel](https://vercel.com/), [GitHub Pages](https://pages.github.com/), [Netlify](https://www.netlify.com/), [Render](https://render.com/docs/static-sites), [Surge](https://surge.sh/help/getting-started-with-surge)... +You can deploy your site to static site hosting services such as [Vercel](https://vercel.com/), [GitHub Pages](https://pages.github.com/), [Netlify](https://www.netlify.com/), [Render](https://render.com/docs/static-sites), and [Surge](https://surge.sh/help/getting-started-with-surge). A Docusaurus site is statically rendered, and it can generally work without JavaScript! @@ -45,7 +45,7 @@ By default, this will load your site at [`http://localhost:3000/`](http://localh ## Trailing slash configuration {#trailing-slashes} -Docusaurus has a [`trailingSlash` config](./api/docusaurus.config.js.mdx#trailingSlash), to allow customizing URLs/links and emitted filename patterns. +Docusaurus has a [`trailingSlash` config](./api/docusaurus.config.js.mdx#trailingSlash) to allow customizing URLs/links and emitted filename patterns. The default value generally works fine. Unfortunately, each static hosting provider has a **different behavior**, and deploying the exact same site to various hosts can lead to distinct results. Depending on your host, it can be useful to change this config. @@ -57,7 +57,7 @@ Use [slorber/trailing-slash-guide](https://github.com/slorber/trailing-slash-gui ## Using environment variables {#using-environment-variables} -Putting potentially sensitive information in the environment is common practice. However, in a typical Docusaurus website, the `docusaurus.config.js` file is the only interface to the Node.js environment (see [our architecture overview](advanced/architecture.mdx)), while everything else—MDX pages, React components... are client side and do not have direct access to the `process` global. In this case, you can consider using [`customFields`](api/docusaurus.config.js.mdx#customFields) to pass environment variables to the client side. +Putting potentially sensitive information in the environment is common practice. However, in a typical Docusaurus website, the `docusaurus.config.js` file is the only interface to the Node.js environment (see [our architecture overview](advanced/architecture.mdx)), while everything else (MDX pages, React components, etc.) are client side and do not have direct access to the `process` global variable. In this case, you can consider using [`customFields`](api/docusaurus.config.js.mdx#customFields) to pass environment variables to the client side. ```js title="docusaurus.config.js" // If you are using dotenv (https://www.npmjs.com/package/dotenv) @@ -90,39 +90,39 @@ export default function Home() { There are a few common hosting options: -- [Self hosting](#self-hosting) with an HTTP server like Apache2 or Nginx; -- Jamstack providers, e.g. [Netlify](#deploying-to-netlify) and [Vercel](#deploying-to-vercel). We will use them as references, but the same reasoning can apply to other providers. -- [GitHub Pages](#deploying-to-github-pages). (By definition, it is also Jamstack, but we compare it separately.) +- [Self hosting](#self-hosting) with an HTTP server like Apache2 or Nginx. +- Jamstack providers (e.g. [Netlify](#deploying-to-netlify) and [Vercel](#deploying-to-vercel)). We will use them as references, but the same reasoning can apply to other providers. +- [GitHub Pages](#deploying-to-github-pages) (by definition, it is also Jamstack, but we compare it separately). If you are unsure of which one to choose, ask the following questions:
- How much resource (person-hours, money) am I willing to invest in this? + How many resources (money, person-hours, etc.) am I willing to invest in this? -- 🔴 Self-hosting is the hardest to set up—you would usually need an experienced person to manage this. Cloud services are almost never free, and setting up an on-site server and connecting it to the WAN can be even more costly. -- 🟢 Jamstack providers can help you set up a working website in almost no time and offers features like server-side redirects that are easily configurable. Many providers offer generous build time quotas even for free plans that you would almost never exceed. However, it's still ultimately limited—you would need to pay once you hit the limit. Check the pricing page of your provider for details. +- 🔴 Self-hosting requires experience in networking as well as Linux and web server administration. It's the most difficult option, and would require the most time to manage successfully. Expense-wise, cloud services are almost never free, and purchasing/deploying an onsite server can be even more costly. +- 🟢 Jamstack providers can help you set up a working website in almost no time and offers features like server-side redirects that are easily configurable. Many providers offer generous build-time quotas even for free plans that you would almost never exceed. However, free plans have limits, and you would need to pay once you hit those limits. Check the pricing page of your provider for details. - 🟡 The GitHub Pages deployment workflow can be tedious to set up. (Evidence: see the length of [Deploying to GitHub Pages](#deploying-to-github-pages)!) However, this service (including build and deployment) is always free for public repositories, and we have detailed instructions to help you make it work.
-How much server-side configuration would I need? +How much server-side customization do I need? -- 🟢 With self-hosting, you have access to the entire server's configuration. You can configure the virtual host to serve different content based on the request URL; you can do complicated server-side redirects; you can put part of the site behind authentication... If you need a lot of server-side features, self-host your website. -- 🟡 Jamstack usually offers some server-side configurations, e.g. URLs formatting (trailing slashes), server-side redirects... -- 🔴 GitHub Pages doesn't expose server-side configurations besides enforcing HTTPS and setting CNAME. +- 🟢 With self-hosting, you have access to the entire server's configuration. You can configure the virtual host to serve different content based on the request URL, you can do complicated server-side redirects, you can implement authentication, and so on. If you need a lot of server-side features, self-host your website. +- 🟡 Jamstack usually offers some server-side configuration (e.g. URL formatting (trailing slashes), server-side redirects, etc.). +- 🔴 GitHub Pages doesn't expose server-side configuration besides enforcing HTTPS and setting CNAME records.
-Do I have needs to cooperate? +Do I need collaboration-friendly deployment workflows? -- 🟡 Self-hosted services can achieve the same effect as Netlify, but with much more heavy-lifting. Usually, you would have a specific person who looks after the deployment, and the workflow won't be very git-based as opposed to the other two options. +- 🟡 Self-hosted services can leverage continuous deployment functionality like Netlify, but more heavy-lifting is involved. Usually, you would designate a specific person to manage the deployment, and the workflow wouldn't be very git-based as opposed to the other two options. - 🟢 Netlify and Vercel have deploy previews for every pull request, which is useful for a team to review work before merging to production. You can also manage a team with different member access to the deployment. - 🟡 GitHub Pages cannot do deploy previews in a non-convoluted way. One repo can only be associated with one site deployment. On the other hand, you can control who has write access to the site's deployment. @@ -146,9 +146,9 @@ It is not the best option, compared to a static hosting provider / CDN. :::warning -In the following sections, we will introduce a few common hosting providers and how they should be configured to deploy Docusaurus sites most efficiently. Some of the writeups are provided by external contributors. Docusaurus is not interest-related with any of the services. The documentation may not be up-to-date: recent changes in their API may not be reflected on our side. If you see outdated content, PRs are welcome. +In the following sections, we will introduce a few common hosting providers and how they should be configured to deploy Docusaurus sites most efficiently. Docusaurus is not affiliated with any of these services, and this information is provided for convenience only. Some of the write-ups are provided by third-parties, and recent API changes may not be reflected on our side. If you see outdated content, PRs are welcome. -For the same concern of up-to-datedness, we have stopped accepting PRs adding new hosting options. You can, however, publish your writeup on a separate site (e.g. your blog, or the provider's official website), and ask us to include a link to your writeup. +Because we can only provide this content on a best-effort basis only, we have stopped accepting PRs adding new hosting options. You can, however, publish your writeup on a separate site (e.g. your blog, or the provider's official website), and ask us to include a link to your writeup. ::: @@ -200,7 +200,7 @@ If you decide to use the `website` folder as Netlify's base directory, Netlify w By default, Netlify adds trailing slashes to Docusaurus URLs. -It is recommended to disable the Netlify setting `Post Processing > Asset Optimization > Pretty Urls` to prevent lowercased URLs, unnecessary redirects, and 404 errors. +It is recommended to disable the Netlify setting `Post Processing > Asset Optimization > Pretty Urls` to prevent lowercase URLs, unnecessary redirects, and 404 errors. **Be very careful**: the `Disable asset optimization` global checkbox is broken and does not really disable the `Pretty URLs` setting in practice. Please make sure to **uncheck it independently**. @@ -216,19 +216,19 @@ Deploying your Docusaurus project to [Vercel](https://vercel.com/) will provide To deploy your Docusaurus project with a [Vercel for Git Integration](https://vercel.com/docs/concepts/git), make sure it has been pushed to a Git repository. -Import the project into Vercel using the [Import Flow](https://vercel.com/import/git). During the import, you will find all relevant options preconfigured for you; however, you can choose to change any of these options, a list of which can be found [here](https://vercel.com/docs/build-step#build-&-development-settings). +Import the project into Vercel using the [Import Flow](https://vercel.com/import/git). During the import, you will find all relevant options preconfigured for you; however, you can choose to change any of these [options](https://vercel.com/docs/build-step#build-&-development-settings). After your project has been imported, all subsequent pushes to branches will generate [Preview Deployments](https://vercel.com/docs/platform/deployments#preview), and all changes made to the [Production Branch](https://vercel.com/docs/git-integrations#production-branch) (usually "main" or "master") will result in a [Production Deployment](https://vercel.com/docs/platform/deployments#production). ## Deploying to GitHub Pages {#deploying-to-github-pages} -Docusaurus provides an easy way to publish to [GitHub Pages](https://pages.github.com/), which comes for free with every GitHub repository. +Docusaurus provides an easy way to publish to [GitHub Pages](https://pages.github.com/), which comes free with every GitHub repository. ### Overview {#github-pages-overview} -Usually, there are two repositories (at least, two branches) involved in a publishing process: the branch containing the source files, and the branch containing the build output to be served with GitHub Pages. In the following tutorial, they will be referred to as **"source"** and **"deployment"**, respectively. +Usually, there are two repositories (at least two branches) involved in a publishing process: the branch containing the source files, and the branch containing the build output to be served with GitHub Pages. In the following tutorial, they will be referred to as **"source"** and **"deployment"**, respectively. -Each GitHub repository is associated with a GitHub Pages service. If the deployment repository is called `my-org/my-project` (where `my-org` is the organization name or username), the deployed site will appear at `https://my-org.github.io/my-project/`. Specially, if the deployment repository is called `my-org/my-org.github.io` (the _organization GitHub Pages repo_), the site will appear at `https://my-org.github.io/`. +Each GitHub repository is associated with a GitHub Pages service. If the deployment repository is called `my-org/my-project` (where `my-org` is the organization name or username), the deployed site will appear at `https://my-org.github.io/my-project/`. If the deployment repository is called `my-org/my-org.github.io` (the _organization GitHub Pages repo_), the site will appear at `https://my-org.github.io/`. :::info @@ -250,9 +250,9 @@ First, modify your `docusaurus.config.js` and add the following params: | --- | --- | | `organizationName` | The GitHub user or organization that owns the deployment repository. | | `projectName` | The name of the deployment repository. | -| `deploymentBranch` | The name of deployment branch. Defaults to `'gh-pages'` for non-organization GitHub Pages repos (`projectName` not ending in `.github.io`). Otherwise, this needs to be explicit as a config field or environment variable. | +| `deploymentBranch` | The name of the deployment branch. It defaults to `'gh-pages'` for non-organization GitHub Pages repos (`projectName` not ending in `.github.io`). Otherwise, it needs to be explicit as a config field or environment variable. | -These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`. +These fields also have their environment variable counterparts which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`. :::warning @@ -290,6 +290,8 @@ By default, GitHub Pages runs published files through [Jekyll](https://jekyllrb. | `GIT_USER` | The username for a GitHub account that **has push access to the deployment repo**. For your own repositories, this will usually be your GitHub username. Required if not using SSH, and ignored otherwise. | | `GIT_PASS` | Personal access token of the git user (specified by `GIT_USER`), to facilitate non-interactive deployment (e.g. continuous deployment) | | `CURRENT_BRANCH` | The source branch. Usually, the branch will be `main` or `master`, but it could be any branch except for `gh-pages`. If nothing is set for this variable, then the current branch from which `docusaurus deploy` is invoked will be used. | +| `GIT_USER_NAME` | The `git config user.name` value to use when pushing to the deployment repo | +| `GIT_USER_EMAIL` | The `git config user.email` value to use when pushing to the deployment repo | GitHub enterprise installations should work in the same manner as github.com; you only need to set the organization's GitHub Enterprise host as an environment variable: @@ -363,7 +365,7 @@ Here are two approaches to deploying your docs with GitHub Actions. Based on the ``` -While you can have both jobs defined in the same workflow file, the original `deploy` workflow will always be listed as skipped in the PR check suite status, which is not communicative of the actual status and provides no value to the review process. We therefore propose to manage them as separate workflows instead. +While you can have both jobs defined in the same workflow file, the original `deploy` workflow will always be listed as skipped in the PR check suite status, which is not indicative of the actual status and provides no value to the review process. We therefore propose to manage them as separate workflows instead. We will use a popular third-party deployment action: [peaceiris/actions-gh-pages](https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus). @@ -460,7 +462,7 @@ jobs: ``` -A cross-repo publish is more difficult to set up, because you need to push to another repo with permission checks. We will be using SSH to do the authentication. +A cross-repo publish is more difficult to set up because you need to push to another repo with permission checks. We will be using SSH to do the authentication. 1. Generate a new [SSH key](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). Since this SSH key will be used in CI, make sure to not enter any passphrase. 2. By default, your public key should have been created in `~/.ssh/id_rsa.pub`; otherwise, use the name you've provided in the previous step to add your key to [GitHub deploy keys](https://developer.github.com/v3/guides/managing-deploy-keys/). @@ -468,7 +470,11 @@ A cross-repo publish is more difficult to set up, because you need to push to an 4. You'll need your private key as a [GitHub secret](https://help.github.com/en/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) to allow Docusaurus to run the deployment for you. 5. Copy your private key with `pbcopy < ~/.ssh/id_rsa` and paste a GitHub secret with the name `GH_PAGES_DEPLOY` on your source repository. Copy the file content if the command line doesn't work for you. Save your secret. 6. Create your [documentation workflow file](https://help.github.com/en/actions/configuring-and-managing-workflows/configuring-a-workflow#creating-a-workflow-file) in `.github/workflows/`. In this example it's `deploy.yml`. -7. You should have essentially: the source repo with the GitHub workflow set with the private SSH key as GitHub Secret and your deployment repo set with the public SSH key in GitHub Deploy Keys. + +At this point, you should have: + +- the source repo with the GitHub workflow set with the private SSH key as the GitHub Secret, and +- your deployment repo set with the public SSH key in GitHub Deploy Keys.
@@ -541,13 +547,16 @@ jobs: Site not deployed properly? -After pushing to main, if you don't see your site published at the desired location (for example, it says "There isn't a GitHub Pages site here", or it's showing your repo's README.md file), check the following: +After pushing to main, if you don't see your site published at the desired location (for example, it says "There isn't a GitHub Pages site here", or it's showing your repo's README.md file), try the following: -- It may take a few minutes for GitHub pages to pick up the new files, so wait for about 3 minutes and refresh before concluding it isn't working. -- On your repo's landing page, you should see a little green tick next to the last commit's title, indicating the CI has passed. If you see a cross, it means the build or deployment failed, and you should check the log for more debugging information. -- Click on the tick and make sure your see a "Deploy to GitHub Pages" workflow. Names like "pages build and deployment / deploy" are GitHub's default workflows, indicating your custom deployment workflow failed to be triggered at all. Make sure the YAML files are put under the `.github/workflows` folder, and the trigger condition is set correctly (for example, if your default branch is "master" instead of "main", you need to change the `on.push` property). -- We are using `gh-pages` as the deployment branch. Under your repo's Settings > Pages, make sure the "Source" (which is the source for the _deployment_ files, not "source" as in our terminology) is set to "gh-pages" + "/ (root)". -- If you are using a custom domain, make sure the DNS record is pointing to the GitHub pages servers' IP. +- Wait about three minutes and refresh. It may take a few minutes for GitHub pages to pick up the new files. +- Check your repo's landing page for a little green tick next to the last commit's title, indicating the CI has passed. If you see a cross, it means the build or deployment failed, and you should check the log for more debugging information. +- Click on the tick and make sure you see a "Deploy to GitHub Pages" workflow. Names like "pages build and deployment / deploy" are GitHub's default workflows, indicating your custom deployment workflow failed to be triggered at all. Make sure the YAML files are placed under the `.github/workflows` folder, and that the trigger condition is set correctly (e.g., if your default branch is "master" instead of "main", you need to change the `on.push` property). +- Under your repo's Settings > Pages, make sure the "Source" (which is the source for the _deployment_ files, not "source" as in our terminology) is set to "gh-pages" + "/ (root)", since we are using `gh-pages` as the deployment branch. + +If you are using a custom domain: + +- Verify that you have the correct DNS records set up if you're using a custom domain. See [GitHub pages documentation on configuring custom domains](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages). Also, please be aware that it may take up to 24 hours for DNS changes to propagate through the internet.
@@ -673,6 +682,12 @@ trigger: Now, whenever you push a new tag to GitHub, this trigger will start the drone CI job to publish your website. +## Deploying to Flightcontrol {#deploying-to-flightcontrol} + +[Flightcontrol](https://www.flightcontrol.dev/?ref=docusaurus) is a service that automatically builds and deploys your web apps to AWS Fargate directly from your Git repository. It gives you full access to inspect and make infrastructure changes without the limitations of a traditional PaaS. + +Get started by following [Flightcontrol's step-by-step Docusaurus guide](https://www.flightcontrol.dev/docs/reference/examples/docusaurus/?ref=docusaurus). + ## Deploying to Koyeb {#deploying-to-koyeb} [Koyeb](https://www.koyeb.com) is a developer-friendly serverless platform to deploy apps globally. The platform lets you seamlessly run Docker containers, web apps, and APIs with git-based deployment, native autoscaling, a global edge network, and built-in service mesh and discovery. Check out the [Koyeb's Docusaurus deployment guide](https://www.koyeb.com/tutorials/deploy-docusaurus-on-koyeb) to get started. @@ -698,7 +713,8 @@ Now, whenever you push a new tag to GitHub, this trigger will start the drone CI - Navigate to your application **Settings** - Select **Port** - Add port used by your Docusaurus application -5. Deploy All you have to do now is to navigate to your application and click on **Deploy**. +5. Deploy + - All you have to do now is to navigate to your application and click on **Deploy**. ![Deploy the app](https://hub.qovery.com/img/heroku/heroku-1.png) @@ -706,47 +722,47 @@ That's it. Watch the status and wait till the app is deployed. To open the appli ## Deploying to Hostman {#deploying-to-hostman} -[Hostman](https://hostman.com/) allows you to host static websites for free. Hostman automates everything, you just need to connect your repository and follow easy steps: +[Hostman](https://hostman.com/) allows you to host static websites for free. Hostman automates everything, you just need to connect your repository and follow these easy steps: 1. Create a service. - To deploy a Docusaurus static website, click **Create** in the top-left corner of your [Dashboard](https://dashboard.hostman.com/) and choose **Front-end app or static website**. + - To deploy a Docusaurus static website, click **Create** in the top-left corner of your [Dashboard](https://dashboard.hostman.com/) and choose **Front-end app or static website**. 2. Select the project to deploy. - If you are logged in to Hostman with your GitHub, GitLab, or Bitbucket account, at this point you will see the repository with your projects, including the private ones. + - If you are logged in to Hostman with your GitHub, GitLab, or Bitbucket account, you will see the repository with your projects, including the private ones. - Choose the project you want to deploy. It must contain the directory with the project's files (e.g. `website`). + - Choose the project you want to deploy. It must contain the directory with the project's files (e.g. `website`). - To access a different repository, click **Connect another repository**. + - To access a different repository, click **Connect another repository**. - If you didn't use your Git account credentials to log in, you'll be able to access the necessary account now, and then select the project. + - If you didn't use your Git account credentials to log in, you'll be able to access the necessary account now, and then select the project. 3. Configure the build settings. - Next, the **Website customization** window will appear. Choose the **Static website** option from the list of frameworks. + - Next, the **Website customization** window will appear. Choose the **Static website** option from the list of frameworks. - The **Directory with app** points at the directory that will contain the project's files after the build. You can leave it empty if during Step 2 you selected the repository with the contents of the website (or `my_website`) directory. + - The **Directory with app** points at the directory that will contain the project's files after the build. If you selected the repository with the contents of the website (or `my_website`) directory during Step 2, you can leave it empty. - The standard build command for Docusaurus will be: + - The standard build command for Docusaurus is: - ```bash npm2yarn - npm run build - ``` + ```bash npm2yarn + npm run build + ``` - You can modify the build command if needed. You can enter multiple commands separated by `&&`. + - You can modify the build command if needed. You can enter multiple commands separated by `&&`. 4. Deploy. - Click **Deploy** to start the build process. + - Click **Deploy** to start the build process. - Once it starts, you will enter the deployment log. If there are any issues with the code, you will get warning or error messages in the log, specifying the cause of the problem. Usually, the log contains all the debugging data you'll need. + - Once it starts, you will enter the deployment log. If there are any issues with the code, you will get warning or error messages in the log specifying the cause of the problem. Usually, the log contains all the debugging data you'll need. - When the deployment is complete, you will receive an email notification and also see a log entry. All done! Your project is up and ready. + - When the deployment is complete, you will receive an email notification and also see a log entry. All done! Your project is up and ready. ## Deploying to Surge {#deploying-to-surge} -Surge is a [static web hosting platform](https://surge.sh/help/getting-started-with-surge), it is used to deploy your Docusaurus project from the command line in a minute. Deploying your project to Surge is easy and it is also free (including a custom domain and SSL). +Surge is a [static web hosting platform](https://surge.sh/help/getting-started-with-surge) that you can use to deploy your Docusaurus project from the command line in seconds. Deploying your project to Surge is easy and free (including custom domains and SSL certs). Deploy your app in a matter of seconds using surge with the following steps: @@ -765,11 +781,11 @@ Deploy your app in a matter of seconds using surge with the following steps: First-time users of Surge would be prompted to create an account from the command line (which happens only once). -Confirm that the site you want to publish is in the `build` directory, a randomly generated subdomain `*.surge.sh subdomain` is always given (which can be edited). +Confirm that the site you want to publish is in the `build` directory. A randomly generated subdomain `*.surge.sh subdomain` is always given (which can be edited). ### Using your domain {#using-your-domain} -If you have a domain name you can deploy your site using surge to your domain using the command: +If you have a domain name you can deploy your site using the command: ```bash surge build/ your-domain.com @@ -812,7 +828,7 @@ See [docs](https://docs.quantcdn.io/docs/cli/continuous-integration) and [blog]( ## Deploying to Azure Static Web Apps {#deploying-to-azure-static-web-apps} -[Azure Static Web Apps](https://docs.microsoft.com/en-us/azure/static-web-apps/overview) is a service that automatically builds and deploys full-stack web apps to Azure directly from the code repository, simplifying the developer experience for CI/CD. Static Web Apps separates the web application's static assets from its dynamic (API) endpoints. Static assets are served from globally-distributed content servers, making it faster for clients to retrieve files using servers nearby. Dynamic APIs are scaled with serverless architectures, using an event-driven functions-based approach that is more cost-effective and scales on demand. Get started in a few minutes by following [this step-by-step guide](https://dev.to/azure/11-share-content-with-docusaurus-azure-static-web-apps-30hc). +[Azure Static Web Apps](https://docs.microsoft.com/en-us/azure/static-web-apps/overview) is a service that automatically builds and deploys full-stack web apps to Azure directly from the code repository, simplifying the developer experience for CI/CD. Static Web Apps separates the web application's static assets from its dynamic (API) endpoints. Static assets are served from globally-distributed content servers, making it faster for clients to retrieve files using servers nearby. Dynamic APIs are scaled with serverless architectures using an event-driven functions-based approach that is more cost-effective and scales on demand. Get started in a few minutes by following [this step-by-step guide](https://dev.to/azure/11-share-content-with-docusaurus-azure-static-web-apps-30hc). ## Deploying to Kinsta Application Hosting {#deploying-to-kinsta} diff --git a/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx b/website/versioned_docs/version-3.0.0-beta.0/docusaurus-core.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx rename to website/versioned_docs/version-3.0.0-beta.0/docusaurus-core.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/creating-pages.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/creating-pages.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-create-doc.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-create-doc.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-create-doc.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-create-doc.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-introduction.mdx similarity index 86% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-introduction.mdx index 6e27e6be77..fc24f14c7e 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-introduction.mdx @@ -47,16 +47,18 @@ Assume that you have the following in your configuration: module.exports = { // ... presets: [ - '@docusaurus/preset-classic', - { - docs: { - /* docs plugin options */ + [ + '@docusaurus/preset-classic', + { + docs: { + /* docs plugin options */ + }, + blog: { + /* blog plugin options */ + }, + // ... }, - blog: { - /* blog plugin options */ - }, - // ... - }, + ], ], }; ``` @@ -67,17 +69,19 @@ To enter docs-only mode, change it to like this: module.exports = { // ... presets: [ - '@docusaurus/preset-classic', - { - docs: { + [ + '@docusaurus/preset-classic', + { + docs: { + // highlight-next-line + routeBasePath: '/', // Serve the docs at the site's root + /* other docs plugin options */ + }, // highlight-next-line - routeBasePath: '/', // Serve the docs at the site's root - /* other docs plugin options */ + blog: false, // Optional: disable the blog plugin + // ... }, - // highlight-next-line - blog: false, // Optional: disable the blog plugin - // ... - }, + ], ], }; ``` diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-multi-instance.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/docs-multi-instance.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/autogenerated.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/autogenerated.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/index.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/index.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/index.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/index.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/items.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/items.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/multiple-sidebars.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/multiple-sidebars.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/multiple-sidebars.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/sidebar/multiple-sidebars.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/docs/versioning.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/docs/versioning.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/_markdown-partial-example.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/_markdown-partial-example.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/_markdown-partial-example.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/_markdown-partial-example.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-admonitions.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-admonitions.mdx similarity index 98% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-admonitions.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-admonitions.mdx index d1ae159315..dde6799aab 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-admonitions.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-admonitions.mdx @@ -34,7 +34,7 @@ Some **content** with _Markdown_ `syntax`. Check [this `api`](#). ::: -:::caution +:::warning Some **content** with _Markdown_ `syntax`. Check [this `api`](#). @@ -68,7 +68,7 @@ Some **content** with _Markdown_ `syntax`. Check [this `api`](#). ::: -:::caution +:::warning Some **content** with _Markdown_ `syntax`. Check [this `api`](#). @@ -231,7 +231,7 @@ export default function MyReactPage() { } ``` -The types that are accepted are the same as above: `note`, `tip`, `danger`, `info`, `caution`. Optionally, you can specify an icon by passing a JSX element or a string, or a title: +The types that are accepted are the same as above: `note`, `tip`, `danger`, `info`, `warning`. Optionally, you can specify an icon by passing a JSX element or a string, or a title: ```jsx title="MyReactPage.jsx" @@ -282,7 +282,7 @@ module.exports = { { docs: { admonitions: { - keywords: ['note', 'tip', 'info', 'caution', 'danger'], + keywords: ['note', 'tip', 'info', 'warning', 'danger'], extendDefaults: true, }, }, diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-assets.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-assets.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-assets.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-assets.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-code-blocks.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-code-blocks.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-diagrams.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-diagrams.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-diagrams.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-diagrams.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-head-metadata.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-head-metadata.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-head-metadata.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-head-metadata.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-intro.mdx similarity index 63% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-intro.mdx index 980f8dc99e..2ab48769c6 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-intro.mdx @@ -8,13 +8,47 @@ slug: /markdown-features import BrowserWindow from '@site/src/components/BrowserWindow'; -Documentation is one of your product's interfaces with your users. A well-written and well-organized set of docs helps your users understand your product quickly. Our aligned goal here is to help your users find and understand the information they need, as quickly as possible. +Docusaurus uses **[Markdown](https://commonmark.org/)** as its main content authoring format. -Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users. +:::tip Learn Markdown -:::info +You can [learn Markdown in 10 minutes](https://commonmark.org/help/). -This section assumes you are using the official Docusaurus content plugins. +::: + +Docusaurus uses modern tooling to help you create **interactive documentation**. + +The **[MDX](https://mdxjs.com/)** compiler transforms **Markdown files to React components**, and allows you to use JSX in your Markdown content. This enables you to easily interleave React components within your content, and create delightful learning experiences. + +:::tip Use the MDX Playground + +The **[MDX playground](https://mdxjs.com/playground/)** is your new best friend! + +It is a very helpful debugging tool that shows how the MDX compiler transforms Markdown to React. + +**Options**: select the right format (MDX or CommonMark) and the following plugins Docusaurus uses: `remark-gfm`, `remark-directive`, `rehype-raw`. + +::: + +## MDX vs. CommonMark {#mdx-vs-commonmark} + +Docusaurus compiles both `.md` and `.mdx` files to React components using the MDX compiler, but **the syntax can be interpreted differently** depending on your settings. + +The MDX compiler supports [2 formats](https://mdxjs.com/packages/mdx/#optionsformat): + +- The [MDX format](https://mdxjs.com/docs/what-is-mdx/): a powerful parser allowing the usage of JSX +- The [CommonMark format](https://commonmark.org/): a standard-compliant Markdown parser that does not allow the usage of JSX + +By default, **Docusaurus v3 uses the MDX format for all files** (including `.md` files) for historical reasons. + +It is possible to **opt-in for CommonMark** using the [`siteConfig.markdown.format`](../../api/docusaurus.config.js.mdx#markdown) setting or the `format: md` front matter. + +:::tip how to use CommonMark + +If you plan to use CommonMark, we recommend the [`siteConfig.markdown.format: 'detect'`](../../api/docusaurus.config.js.mdx#markdown) setting. The appropriate format will be selected automatically, based on file extensions: + +- `.md` files will use the CommonMark format +- `.mdx` files will use the MDX format ::: @@ -22,8 +56,6 @@ This section assumes you are using the official Docusaurus content plugins. Markdown is a syntax that enables you to write formatted content in a readable syntax. -We use [MDX](https://mdxjs.com/) as the parsing engine, which can do much more than just parsing [standard Markdown syntax](https://daringfireball.net/projects/markdown/syntax), like rendering React components inside your documents as well. - ```md ### My Doc Section @@ -143,9 +175,3 @@ Markdown can embed HTML elements, and [`details`](https://developer.mozilla.org/ ``` - -:::note - -In practice, those are not really HTML elements, but React JSX elements, which we'll cover next! - -::: diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-links.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-links.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-links.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-links.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-math-equations.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-math-equations.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-plugins.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-plugins.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-react.mdx similarity index 94% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-react.mdx index 8805651886..7722a6e5c5 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-react.mdx @@ -13,24 +13,9 @@ import TabItem from '@theme/TabItem'; import styles from './markdown-features-react.module.css'; ``` -## Using JSX in Markdown {#using-jsx-in-markdown} - Docusaurus has built-in support for [MDX v2](https://mdxjs.com/), which allows you to write JSX within your Markdown files and render them as React components. -:::info MDX vs. CommonMark - -Docusaurus parses both `.md` and `.mdx` files using MDX, but **the syntax is interpreted differently based on the file extension**: - -- With the `.md` extension, the parser is compatible with [CommonMark](https://commonmark.org/) and does not allow the usage of JSX. -- With the `.mdx` extension, the parser is stricter than [CommonMark](https://commonmark.org/) and is not 100% compatible with it, but it becomes possible to use JSX. - -It is also possible to override the file extension format with front matter: `format: mdx`. - -The rest of this page assumes usage of the `mdx` format. - -::: - -Check out the [MDX docs](https://mdxjs.com/) to see what other fancy stuff you can do with MDX. +Check out the [MDX docs](https://mdxjs.com/) to see what fancy stuff you can do with MDX. :::tip Debugging MDX diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.module.css b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-react.module.css similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.module.css rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-react.module.css diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-tabs-styles.module.css b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-tabs-styles.module.css similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-tabs-styles.module.css rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-tabs-styles.module.css diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-tabs.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-tabs.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-tabs.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-tabs.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-toc.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/markdown-features/markdown-features-toc.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/whats-next.mdx b/website/versioned_docs/version-3.0.0-beta.0/guides/whats-next.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/guides/whats-next.mdx rename to website/versioned_docs/version-3.0.0-beta.0/guides/whats-next.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-crowdin.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx rename to website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-crowdin.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-git.mdx b/website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-git.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-git.mdx rename to website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-git.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-introduction.mdx b/website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-introduction.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-introduction.mdx rename to website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-introduction.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-tutorial.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx rename to website/versioned_docs/version-3.0.0-beta.0/i18n/i18n-tutorial.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/installation.mdx b/website/versioned_docs/version-3.0.0-beta.0/installation.mdx similarity index 95% rename from website/versioned_docs/version-3.0.0-alpha.0/installation.mdx rename to website/versioned_docs/version-3.0.0-beta.0/installation.mdx index aa460aa88a..613fc252dc 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/installation.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/installation.mdx @@ -9,7 +9,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; ``` -Docusaurus is essentially a set of npm [packages](https://github.com/facebook/docusaurus/tree/main/packages). +Docusaurus consists of a set of npm [packages](https://github.com/facebook/docusaurus/tree/main/packages). :::tip @@ -106,7 +106,7 @@ my-website ### Monorepos {#monorepos} -If you are using Docusaurus for documentation of an existing project, a monorepo may be the solution for you. Monorepos allow you to share dependencies between similar projects. For example, your website may use your local packages to showcase the latest features, instead of depending on a released version; your contributors can also conveniently update the docs as they implement features. An example monorepo folder structure is below: +If you are using Docusaurus for documentation of an existing project, a monorepo may be the solution for you. Monorepos allow you to share dependencies between similar projects. For example, your website may use your local packages to showcase latest features instead of depending on a released version. Then, your contributors can update the docs as they implement features. An example monorepo folder structure is below: ```bash my-monorepo @@ -174,7 +174,7 @@ You should see the correct version as output. Alternatively, if you are using Yarn, you can do: ```bash -yarn upgrade @docusaurus/core@latest @docusaurus/preset-classic@latest +yarn add @docusaurus/core @docusaurus/preset-classic ``` :::tip diff --git a/website/versioned_docs/version-3.0.0-alpha.0/introduction.mdx b/website/versioned_docs/version-3.0.0-beta.0/introduction.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/introduction.mdx rename to website/versioned_docs/version-3.0.0-beta.0/introduction.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-automated.mdx b/website/versioned_docs/version-3.0.0-beta.0/migration/migration-automated.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/migration/migration-automated.mdx rename to website/versioned_docs/version-3.0.0-beta.0/migration/migration-automated.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-manual.mdx b/website/versioned_docs/version-3.0.0-beta.0/migration/migration-manual.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/migration/migration-manual.mdx rename to website/versioned_docs/version-3.0.0-beta.0/migration/migration-manual.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-overview.mdx b/website/versioned_docs/version-3.0.0-beta.0/migration/migration-overview.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/migration/migration-overview.mdx rename to website/versioned_docs/version-3.0.0-beta.0/migration/migration-overview.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-translated-sites.mdx b/website/versioned_docs/version-3.0.0-beta.0/migration/migration-translated-sites.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/migration/migration-translated-sites.mdx rename to website/versioned_docs/version-3.0.0-beta.0/migration/migration-translated-sites.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-versioned-sites.mdx b/website/versioned_docs/version-3.0.0-beta.0/migration/migration-versioned-sites.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/migration/migration-versioned-sites.mdx rename to website/versioned_docs/version-3.0.0-beta.0/migration/migration-versioned-sites.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/playground.mdx b/website/versioned_docs/version-3.0.0-beta.0/playground.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/playground.mdx rename to website/versioned_docs/version-3.0.0-beta.0/playground.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/search.mdx b/website/versioned_docs/version-3.0.0-beta.0/search.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/search.mdx rename to website/versioned_docs/version-3.0.0-beta.0/search.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/seo.mdx b/website/versioned_docs/version-3.0.0-beta.0/seo.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/seo.mdx rename to website/versioned_docs/version-3.0.0-beta.0/seo.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/static-assets.mdx b/website/versioned_docs/version-3.0.0-beta.0/static-assets.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/static-assets.mdx rename to website/versioned_docs/version-3.0.0-beta.0/static-assets.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx b/website/versioned_docs/version-3.0.0-beta.0/styling-layout.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx rename to website/versioned_docs/version-3.0.0-beta.0/styling-layout.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx b/website/versioned_docs/version-3.0.0-beta.0/swizzling.mdx similarity index 98% rename from website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx rename to website/versioned_docs/version-3.0.0-beta.0/swizzling.mdx index 6f4759c50d..02f4d9a438 100644 --- a/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx +++ b/website/versioned_docs/version-3.0.0-beta.0/swizzling.mdx @@ -8,7 +8,7 @@ In this section, we will introduce how customization of layout is done in Docusa > Déja vu...? -This section is similar to [Styling and Layout](./styling-layout.mdx), but this time, we will write actual React code instead of playing with stylesheets. We will talk about a central concept in Docusaurus: **swizzling**, which allows **deeper site customizations**. +This section is similar to [Styling and Layout](./styling-layout.mdx), but this time, we will customize React components themselves, rather than what they look like. We will talk about a central concept in Docusaurus: **swizzling**, which allows **deeper site customizations**. In practice, swizzling permits to **swap a theme component with your own implementation**, and it comes in 2 patterns: diff --git a/website/versioned_docs/version-3.0.0-alpha.0/typescript-support.mdx b/website/versioned_docs/version-3.0.0-beta.0/typescript-support.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/typescript-support.mdx rename to website/versioned_docs/version-3.0.0-beta.0/typescript-support.mdx diff --git a/website/versioned_docs/version-3.0.0-alpha.0/using-plugins.mdx b/website/versioned_docs/version-3.0.0-beta.0/using-plugins.mdx similarity index 100% rename from website/versioned_docs/version-3.0.0-alpha.0/using-plugins.mdx rename to website/versioned_docs/version-3.0.0-beta.0/using-plugins.mdx diff --git a/website/versioned_sidebars/version-3.0.0-alpha.0-sidebars.json b/website/versioned_sidebars/version-3.0.0-beta.0-sidebars.json similarity index 100% rename from website/versioned_sidebars/version-3.0.0-alpha.0-sidebars.json rename to website/versioned_sidebars/version-3.0.0-beta.0-sidebars.json diff --git a/website/versions.json b/website/versions.json index ca85998e56..c1a5ded01e 100644 --- a/website/versions.json +++ b/website/versions.json @@ -1,5 +1,5 @@ [ - "3.0.0-alpha.0", + "3.0.0-beta.0", "2.4.1", "2.3.1", "2.2.0",