diff --git a/admin/new.docusaurus.io/package.json b/admin/new.docusaurus.io/package.json index 15a0928013a7..f786012420d7 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 cd1a2735d444..e856801112b3 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 b493cc646473..e128b2977871 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 e303c56a1d92..5a35242af86d 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 d85b5ea3b556..70599e25f2c2 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 58e3fb50dc78..75cf68f28e79 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 98c9cee22aa5..385f33da7018 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 fdd764c53960..067172b0c20c 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 c2023b3df5e4..fe4792e9c81c 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 cbf03c5c5090..908c90d6e86a 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 1b1b60cd7cc7..2c5fd39182d8 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 bf2e4d31a783..d5392524bde9 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 adbed098b5d9..95575e84a623 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 b3cd70138e56..0dc30735264e 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 0212ea1ce66a..8beeecad9c5e 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 abe9417b009f..b96f687549df 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 7ca06a5dbe5c..e65d1df03ab2 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 17efd74ccad3..158d1d3660ab 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 3c3ffb865ae4..a6460b21d489 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 da0d811a5fe7..eb030bd821a9 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 30bb2b6eb1fe..e3137d10f8ef 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 39bcd397bb89..12799ffcd46e 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 347cc67f4358..a5e79bb78ceb 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 89b337858d5e..84b9fa4282b5 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 3b7cf9bc2e66..45b81bf13bc9 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 193c2e9f2b35..f3cbb319ff24 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 4d4a7c300366..710c7ffceec3 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 455e21aac102..f907ad52d7e6 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 8a30e8952786..15a6ff4d71ec 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 e97dcf3f5f42..c5a98688013d 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 2801b213e377..0fb55ed943eb 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 cb46482f3ea5..cdeee38918fe 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 f6522e2a40ce..3cb446bdbf4f 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 bb63b2b2d5b1..4760dfee389f 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 2591e507b42e..fe00585bd80c 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 5fc2aa1a29b7..ff242b908f19 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 3ff5c3ede14f..6b5c4cadad61 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 a8b8911ea636..feee403dce82 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 f3c2ee257cf4..2e486c34395b 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 db298fbec308..16b6abd53b88 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 6a01e76346da..dd77268610f3 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 9259b0e1856d..35ab29326a61 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 039145e1dfc5..c79540e5641f 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 18ecf3ef07b1..4c0b37371eea 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 54adf6d725a6..17fbe8c36e98 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 1c41523e4ab4..1ca38a6a3537 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 5f8e553ab99c..0e13e66f3f76 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 ecaa0be8f6ed..18a7e71e9126 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: + +- 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. -- 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. +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 6e27e6be7705..fc24f14c7e1b 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 d1ae1593159f..dde6799aabd8 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 980f8dc99e7f..2ab48769c6ea 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/). + +::: + +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} -This section assumes you are using the official Docusaurus content plugins. +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 880565188678..7722a6e5c5e6 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 aa460aa88abb..613fc252dcc6 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 6f4759c50da7..02f4d9a4386c 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 ca85998e5664..c1a5ded01ec8 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",