@modern-js/main-doc 2.0.0-beta.1 → 2.0.0-beta.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (415) hide show
  1. package/.turbo/turbo-build.log +1 -1
  2. package/en/docusaurus-plugin-content-docs/current/apis/app/commands/build.md +1 -1
  3. package/en/docusaurus-plugin-content-docs/current/apis/app/commands/dev.md +1 -1
  4. package/en/docusaurus-plugin-content-docs/current/apis/app/commands/lint.md +1 -1
  5. package/en/docusaurus-plugin-content-docs/current/apis/app/commands/new.md +1 -4
  6. package/en/docusaurus-plugin-content-docs/current/apis/app/commands/start.md +1 -1
  7. package/en/docusaurus-plugin-content-docs/current/apis/app/commands/test.md +1 -1
  8. package/en/docusaurus-plugin-content-docs/current/apis/app/overview.md +1 -1
  9. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/core/bootstrap.md +17 -3
  10. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/auto-actions.md +1 -1
  11. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/connect.md +1 -1
  12. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/create-app.md +2 -2
  13. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/create-store.md +1 -1
  14. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/handle-effect.md +1 -1
  15. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/model_.md +1 -1
  16. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/use-local-model.md +1 -1
  17. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/use-model.md +1 -1
  18. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/use-static-model.md +1 -1
  19. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/use-store.md +1 -23
  20. package/en/docusaurus-plugin-content-docs/current/components/command-tip.md +56 -0
  21. package/en/docusaurus-plugin-content-docs/current/components/reduck-migration.md +1 -0
  22. package/en/docusaurus-plugin-content-docs/current/components/reduck-tip.md +5 -0
  23. package/en/docusaurus-plugin-content-docs/current/configure/app/dev/asset-prefix.md +1 -1
  24. package/en/docusaurus-plugin-content-docs/current/configure/app/dev/hmr.md +1 -1
  25. package/en/docusaurus-plugin-content-docs/current/configure/app/dev/https.md +1 -1
  26. package/en/docusaurus-plugin-content-docs/current/configure/app/dev/port.md +1 -1
  27. package/en/docusaurus-plugin-content-docs/current/configure/app/dev/progress-bar.md +1 -1
  28. package/en/docusaurus-plugin-content-docs/current/configure/app/dev/start-url.md +1 -1
  29. package/en/docusaurus-plugin-content-docs/current/configure/app/experiments/lazy-compilation.md +1 -1
  30. package/en/docusaurus-plugin-content-docs/current/configure/app/html/app-icon.md +1 -1
  31. package/en/docusaurus-plugin-content-docs/current/configure/app/html/crossorigin.md +1 -1
  32. package/en/docusaurus-plugin-content-docs/current/configure/app/html/disable-html-folder.md +1 -1
  33. package/en/docusaurus-plugin-content-docs/current/configure/app/html/favicon-by-entries.md +1 -1
  34. package/en/docusaurus-plugin-content-docs/current/configure/app/html/favicon.md +1 -1
  35. package/en/docusaurus-plugin-content-docs/current/configure/app/html/inject-by-entries.md +1 -1
  36. package/en/docusaurus-plugin-content-docs/current/configure/app/html/inject.md +1 -1
  37. package/en/docusaurus-plugin-content-docs/current/configure/app/html/meta-by-entries.md +1 -1
  38. package/en/docusaurus-plugin-content-docs/current/configure/app/html/meta.md +1 -1
  39. package/en/docusaurus-plugin-content-docs/current/configure/app/html/mount-id.md +1 -1
  40. package/en/docusaurus-plugin-content-docs/current/configure/app/html/template-by-entries.md +1 -1
  41. package/en/docusaurus-plugin-content-docs/current/configure/app/html/template-parameters-by-entries.md +1 -1
  42. package/en/docusaurus-plugin-content-docs/current/configure/app/html/template-parameters.md +1 -1
  43. package/en/docusaurus-plugin-content-docs/current/configure/app/html/template.md +1 -1
  44. package/en/docusaurus-plugin-content-docs/current/configure/app/html/title-by-entries.md +1 -1
  45. package/en/docusaurus-plugin-content-docs/current/configure/app/html/title.md +1 -1
  46. package/en/docusaurus-plugin-content-docs/current/configure/app/output/asset-prefix.md +1 -1
  47. package/en/docusaurus-plugin-content-docs/current/configure/app/output/assets-retry.md +1 -1
  48. package/en/docusaurus-plugin-content-docs/current/configure/app/output/charset.md +1 -1
  49. package/en/docusaurus-plugin-content-docs/current/configure/app/output/clean-dist-path.md +1 -1
  50. package/en/docusaurus-plugin-content-docs/current/configure/app/output/convert-to-rem.md +1 -1
  51. package/en/docusaurus-plugin-content-docs/current/configure/app/output/copy.md +1 -1
  52. package/en/docusaurus-plugin-content-docs/current/configure/app/output/css-module-local-ident-name.md +1 -1
  53. package/en/docusaurus-plugin-content-docs/current/configure/app/output/data-uri-limit.md +1 -1
  54. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-css-extract.md +12 -0
  55. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-css-module-extension.md +1 -1
  56. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-filename-hash.md +1 -1
  57. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-inline-runtime-chunk.md +1 -1
  58. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-minimize.md +1 -1
  59. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-source-map.md +1 -1
  60. package/en/docusaurus-plugin-content-docs/current/configure/app/output/disable-ts-checker.md +1 -1
  61. package/en/docusaurus-plugin-content-docs/current/configure/app/output/dist-path.md +1 -1
  62. package/en/docusaurus-plugin-content-docs/current/configure/app/output/enable-asset-fallback.md +1 -1
  63. package/en/docusaurus-plugin-content-docs/current/configure/app/output/enable-asset-manifest.md +1 -1
  64. package/en/docusaurus-plugin-content-docs/current/configure/app/output/enable-css-module-tsdeclaration.md +1 -1
  65. package/en/docusaurus-plugin-content-docs/current/configure/app/output/enable-inline-scripts.md +1 -1
  66. package/en/docusaurus-plugin-content-docs/current/configure/app/output/enable-inline-styles.md +1 -1
  67. package/en/docusaurus-plugin-content-docs/current/configure/app/output/enable-latest-decorators.md +1 -1
  68. package/en/docusaurus-plugin-content-docs/current/configure/app/output/externals.md +1 -1
  69. package/en/docusaurus-plugin-content-docs/current/configure/app/output/filename.md +1 -1
  70. package/en/docusaurus-plugin-content-docs/current/configure/app/output/legal-comments.md +1 -1
  71. package/en/docusaurus-plugin-content-docs/current/configure/app/output/override-browserslist.md +1 -1
  72. package/en/docusaurus-plugin-content-docs/current/configure/app/output/polyfill.md +1 -1
  73. package/en/docusaurus-plugin-content-docs/current/configure/app/output/svg-default-export.md +1 -1
  74. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/build-cache.md +1 -1
  75. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/bundle-analyze.md +1 -1
  76. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/chunk-split.md +1 -1
  77. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/print-file-size.md +1 -1
  78. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/profile.md +1 -1
  79. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/remove-console.md +1 -1
  80. package/en/docusaurus-plugin-content-docs/current/configure/app/performance/remove-moment-locale.md +1 -1
  81. package/en/docusaurus-plugin-content-docs/current/configure/app/plugins.md +1 -1
  82. package/en/docusaurus-plugin-content-docs/current/configure/app/runtime/router.md +1 -1
  83. package/en/docusaurus-plugin-content-docs/current/configure/app/security/sri.md +1 -1
  84. package/en/docusaurus-plugin-content-docs/current/configure/app/source/alias.md +1 -1
  85. package/en/docusaurus-plugin-content-docs/current/configure/app/source/compile-js-data-uri.md +1 -1
  86. package/en/docusaurus-plugin-content-docs/current/configure/app/source/define.md +1 -1
  87. package/en/docusaurus-plugin-content-docs/current/configure/app/source/exclude.md +1 -1
  88. package/en/docusaurus-plugin-content-docs/current/configure/app/source/global-vars.md +1 -1
  89. package/en/docusaurus-plugin-content-docs/current/configure/app/source/include.md +1 -1
  90. package/en/docusaurus-plugin-content-docs/current/configure/app/source/module-scopes.md +1 -1
  91. package/en/docusaurus-plugin-content-docs/current/configure/app/source/pre-entry.md +1 -1
  92. package/en/docusaurus-plugin-content-docs/current/configure/app/source/resolve-extension-prefix.md +1 -1
  93. package/en/docusaurus-plugin-content-docs/current/configure/app/source/resolve-main-fields.md +1 -1
  94. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/autoprefixer.md +1 -1
  95. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/babel.md +1 -1
  96. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/css-extract.md +1 -1
  97. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/css-loader.md +1 -1
  98. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/dev-server.md +1 -1
  99. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/html-plugin.md +1 -1
  100. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/inspector.md +1 -1
  101. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/less.md +1 -1
  102. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/minify-css.md +1 -1
  103. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/postcss.md +1 -1
  104. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/pug.md +1 -1
  105. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/sass.md +1 -1
  106. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/style-loader.md +1 -1
  107. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/styled-components.md +1 -1
  108. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/swc.md +42 -0
  109. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/terser.md +1 -1
  110. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/ts-checker.md +1 -1
  111. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/ts-loader.md +1 -1
  112. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/webpack-chain.md +1 -1
  113. package/en/docusaurus-plugin-content-docs/current/configure/app/tools/webpack.md +1 -1
  114. package/en/docusaurus-plugin-content-docs/current/guides/basic-features/builder.md +46 -0
  115. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/_category_.json +4 -0
  116. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/_category_.json +4 -0
  117. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/_category_.json +4 -0
  118. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/app.md +152 -0
  119. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/ejs.md +56 -0
  120. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/fs.md +54 -0
  121. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/git.md +49 -0
  122. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/handlebars.md +58 -0
  123. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/json.md +59 -0
  124. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/api/npm.md +49 -0
  125. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/develop.md +52 -0
  126. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/introduce.md +46 -0
  127. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/run-in-js.md +48 -0
  128. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/codesmith/structure.md +87 -0
  129. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/config/_category_.json +4 -0
  130. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/config/common.md +106 -0
  131. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/config/module.md +39 -0
  132. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/config/monorepo.md +28 -0
  133. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/config/mwa.md +89 -0
  134. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/_category_.json +4 -0
  135. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/abstract.md +26 -0
  136. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/_category_.json +4 -0
  137. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/_category_.json +4 -0
  138. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/addFile.md +52 -0
  139. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/addHelper.md +26 -0
  140. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/addManyFile.md +58 -0
  141. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/addPartial.md +26 -0
  142. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/introduce.md +38 -0
  143. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/rmDir.md +24 -0
  144. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/rmFile.md +24 -0
  145. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/updateJSONFile.md +54 -0
  146. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/updateModernConfig.md +26 -0
  147. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/updateTextRawFile.md +33 -0
  148. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/git/_category_.json +4 -0
  149. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/git/gitAddAndCommit.md +20 -0
  150. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/git/initGitRepo.md +16 -0
  151. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/git/isInGitRepo.md +16 -0
  152. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/hook/_category_.json +4 -0
  153. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/hook/afterForged.md +35 -0
  154. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/hook/onForged.md +36 -0
  155. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/info/_category_.json +4 -0
  156. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/info/isFileExit.md +22 -0
  157. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/info/locale.md +17 -0
  158. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/info/readDir.md +22 -0
  159. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/_category_.json +4 -0
  160. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/addInputAfter.md +57 -0
  161. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/addInputBefore.md +56 -0
  162. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/setInput.md +42 -0
  163. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/setInputValue.md +30 -0
  164. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/type.md +65 -0
  165. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/introduce.md +91 -0
  166. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/_category_.json +4 -0
  167. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/createElement.md +33 -0
  168. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/createSubProject.md +35 -0
  169. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/enableFunc.md +44 -0
  170. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/introduce.md +15 -0
  171. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/npm/_category_.json +4 -0
  172. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/npm/install.md +18 -0
  173. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/develop.md +125 -0
  174. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/use.md +61 -0
  175. package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/project.md +118 -0
  176. package/en/docusaurus-plugin-content-docs/current.json +57 -21
  177. package/package.json +3 -3
  178. package/scripts/config.ts +2 -2
  179. package/scripts/summary.en.json +1 -1
  180. package/scripts/summary.zh.json +1 -1
  181. package/zh/apis/app/commands/new.md +0 -3
  182. package/zh/apis/app/hooks/server/test.md +2 -2
  183. package/zh/apis/app/runtime/app/_category_.json +1 -1
  184. package/zh/apis/app/runtime/bff/_category_.json +1 -1
  185. package/zh/apis/app/runtime/core/_category_.json +1 -1
  186. package/zh/apis/app/runtime/core/bootstrap.md +17 -3
  187. package/zh/apis/app/runtime/model/_category_.json +1 -1
  188. package/zh/apis/app/runtime/model/create-app.md +1 -1
  189. package/zh/apis/app/runtime/model/use-store.md +1 -23
  190. package/zh/apis/app/runtime/router/_category_.json +1 -1
  191. package/zh/apis/app/runtime/ssr/_category_.json +1 -1
  192. package/zh/apis/app/runtime/testing/_category_.json +1 -1
  193. package/zh/apis/app/runtime/utility/_category_.json +1 -1
  194. package/zh/apis/app/runtime/web-server/_category_.json +1 -1
  195. package/zh/apis/app/runtime/web-server/hook.md +4 -4
  196. package/zh/apis/app/runtime/web-server/middleware.md +4 -4
  197. package/zh/components/reduck-migration.md +1 -0
  198. package/zh/configure/app/dev/asset-prefix.md +1 -1
  199. package/zh/configure/app/dev/hmr.md +1 -1
  200. package/zh/configure/app/dev/https.md +1 -1
  201. package/zh/configure/app/dev/port.md +1 -1
  202. package/zh/configure/app/dev/progress-bar.md +1 -1
  203. package/zh/configure/app/dev/start-url.md +1 -1
  204. package/zh/configure/app/experiments/_category_.json +4 -0
  205. package/zh/configure/app/experiments/lazy-compilation.md +1 -1
  206. package/zh/configure/app/html/_category_.json +4 -0
  207. package/zh/configure/app/html/app-icon.md +1 -1
  208. package/zh/configure/app/html/crossorigin.md +1 -1
  209. package/zh/configure/app/html/disable-html-folder.md +1 -1
  210. package/zh/configure/app/html/favicon-by-entries.md +1 -1
  211. package/zh/configure/app/html/favicon.md +1 -1
  212. package/zh/configure/app/html/inject-by-entries.md +1 -1
  213. package/zh/configure/app/html/inject.md +1 -1
  214. package/zh/configure/app/html/meta-by-entries.md +1 -1
  215. package/zh/configure/app/html/meta.md +1 -1
  216. package/zh/configure/app/html/mount-id.md +1 -1
  217. package/zh/configure/app/html/template-by-entries.md +1 -1
  218. package/zh/configure/app/html/template-parameters-by-entries.md +1 -1
  219. package/zh/configure/app/html/template-parameters.md +1 -1
  220. package/zh/configure/app/html/template.md +1 -1
  221. package/zh/configure/app/html/title-by-entries.md +1 -1
  222. package/zh/configure/app/html/title.md +1 -1
  223. package/zh/configure/app/output/asset-prefix.md +1 -1
  224. package/zh/configure/app/output/assets-retry.md +1 -1
  225. package/zh/configure/app/output/charset.md +1 -1
  226. package/zh/configure/app/output/clean-dist-path.md +1 -1
  227. package/zh/configure/app/output/convert-to-rem.md +1 -1
  228. package/zh/configure/app/output/copy.md +1 -1
  229. package/zh/configure/app/output/css-module-local-ident-name.md +1 -1
  230. package/zh/configure/app/output/data-uri-limit.md +1 -1
  231. package/zh/configure/app/output/disable-css-extract.md +12 -0
  232. package/zh/configure/app/output/disable-css-module-extension.md +1 -1
  233. package/zh/configure/app/output/disable-filename-hash.md +1 -1
  234. package/zh/configure/app/output/disable-inline-runtime-chunk.md +1 -1
  235. package/zh/configure/app/output/disable-minimize.md +1 -1
  236. package/zh/configure/app/output/disable-source-map.md +1 -1
  237. package/zh/configure/app/output/disable-ts-checker.md +1 -1
  238. package/zh/configure/app/output/dist-path.md +1 -1
  239. package/zh/configure/app/output/enable-asset-fallback.md +1 -1
  240. package/zh/configure/app/output/enable-asset-manifest.md +1 -1
  241. package/zh/configure/app/output/enable-css-module-tsdeclaration.md +1 -1
  242. package/zh/configure/app/output/enable-inline-scripts.md +1 -1
  243. package/zh/configure/app/output/enable-inline-styles.md +1 -1
  244. package/zh/configure/app/output/enable-latest-decorators.md +1 -1
  245. package/zh/configure/app/output/externals.md +1 -1
  246. package/zh/configure/app/output/filename.md +1 -1
  247. package/zh/configure/app/output/legal-comments.md +1 -1
  248. package/zh/configure/app/output/override-browserslist.md +1 -1
  249. package/zh/configure/app/output/polyfill.md +1 -1
  250. package/zh/configure/app/output/ssg.md +118 -114
  251. package/zh/configure/app/output/svg-default-export.md +1 -1
  252. package/zh/configure/app/performance/_category_.json +4 -0
  253. package/zh/configure/app/performance/build-cache.md +1 -1
  254. package/zh/configure/app/performance/bundle-analyze.md +1 -1
  255. package/zh/configure/app/performance/chunk-split.md +1 -1
  256. package/zh/configure/app/performance/print-file-size.md +1 -1
  257. package/zh/configure/app/performance/profile.md +1 -1
  258. package/zh/configure/app/performance/remove-console.md +1 -1
  259. package/zh/configure/app/performance/remove-moment-locale.md +1 -1
  260. package/zh/configure/app/plugins.md +1 -1
  261. package/zh/configure/app/runtime/state.md +13 -0
  262. package/zh/configure/app/security/_category_.json +4 -0
  263. package/zh/configure/app/security/sri.md +1 -1
  264. package/zh/configure/app/server/ssr.md +0 -2
  265. package/zh/configure/app/source/alias.md +1 -1
  266. package/zh/configure/app/source/compile-js-data-uri.md +1 -1
  267. package/zh/configure/app/source/define.md +1 -1
  268. package/zh/configure/app/source/exclude.md +1 -1
  269. package/zh/configure/app/source/global-vars.md +1 -1
  270. package/zh/configure/app/source/include.md +1 -1
  271. package/zh/configure/app/source/module-scopes.md +1 -1
  272. package/zh/configure/app/source/pre-entry.md +1 -1
  273. package/zh/configure/app/source/resolve-extension-prefix.md +1 -1
  274. package/zh/configure/app/source/resolve-main-fields.md +1 -1
  275. package/zh/configure/app/tools/autoprefixer.md +1 -1
  276. package/zh/configure/app/tools/babel.md +1 -1
  277. package/zh/configure/app/tools/css-extract.md +1 -1
  278. package/zh/configure/app/tools/css-loader.md +1 -1
  279. package/zh/configure/app/tools/dev-server.md +1 -1
  280. package/zh/configure/app/tools/html-plugin.md +1 -1
  281. package/zh/configure/app/tools/inspector.md +1 -1
  282. package/zh/configure/app/tools/less.md +1 -1
  283. package/zh/configure/app/tools/minify-css.md +1 -1
  284. package/zh/configure/app/tools/postcss.md +1 -1
  285. package/zh/configure/app/tools/pug.md +1 -1
  286. package/zh/configure/app/tools/sass.md +1 -1
  287. package/zh/configure/app/tools/style-loader.md +1 -1
  288. package/zh/configure/app/tools/styled-components.md +1 -1
  289. package/zh/configure/app/tools/swc.md +42 -0
  290. package/zh/configure/app/tools/terser.md +1 -1
  291. package/zh/configure/app/tools/ts-checker.md +1 -1
  292. package/zh/configure/app/tools/ts-loader.md +1 -1
  293. package/zh/configure/app/tools/webpack-chain.md +1 -1
  294. package/zh/configure/app/tools/webpack.md +1 -1
  295. package/zh/guides/advanced-features/bff/_category_.json +5 -1
  296. package/zh/guides/advanced-features/bff/bff-proxy.md +5 -3
  297. package/zh/guides/advanced-features/bff/frameworks.md +72 -51
  298. package/zh/guides/advanced-features/bff/function.md +16 -30
  299. package/zh/guides/advanced-features/bff/index.md +20 -0
  300. package/zh/guides/advanced-features/bff/type.md +43 -0
  301. package/zh/guides/advanced-features/custom-app.md +69 -1
  302. package/zh/guides/advanced-features/ssg.md +74 -63
  303. package/zh/guides/advanced-features/ssr.md +74 -11
  304. package/zh/guides/advanced-features/web-server.md +21 -110
  305. package/zh/guides/basic-features/builder.md +46 -0
  306. package/zh/guides/basic-features/css/_category_.json +1 -1
  307. package/zh/guides/basic-features/css/less-sass.md +1 -14
  308. package/zh/guides/basic-features/data-fetch.md +62 -1
  309. package/zh/guides/basic-features/env-vars.md +122 -41
  310. package/zh/guides/basic-features/routes.md +264 -0
  311. package/zh/guides/concept/entries.md +112 -0
  312. package/zh/guides/concept/lifecycle.md +10 -0
  313. package/zh/guides/get-started/quick-start.md +199 -1
  314. package/zh/guides/get-started/upgrade.md +75 -1
  315. package/zh/guides/topic-detail/framework-plugin/extend.md +3 -4
  316. package/zh/{apis/app/runtime/plugin/hook-api.md → guides/topic-detail/framework-plugin/hook-list.md} +42 -135
  317. package/zh/{apis/app/runtime/plugin → guides/topic-detail/framework-plugin}/hook.md +2 -3
  318. package/zh/guides/topic-detail/framework-plugin/implement.md +21 -10
  319. package/zh/guides/topic-detail/framework-plugin/introduction.md +49 -0
  320. package/{en/docusaurus-plugin-content-docs/current/apis/app/runtime/plugin → zh/guides/topic-detail/framework-plugin}/plugin-api.md +3 -4
  321. package/zh/guides/topic-detail/framework-plugin/relationship.md +2 -3
  322. package/zh/guides/topic-detail/generator/codesmith/api/_category_.json +4 -0
  323. package/zh/guides/topic-detail/generator/codesmith/api/app.md +152 -0
  324. package/zh/guides/topic-detail/generator/codesmith/api/ejs.md +56 -0
  325. package/zh/guides/topic-detail/generator/codesmith/api/fs.md +54 -0
  326. package/zh/guides/topic-detail/generator/codesmith/api/git.md +48 -0
  327. package/zh/guides/topic-detail/generator/codesmith/api/handlebars.md +56 -0
  328. package/zh/guides/topic-detail/generator/codesmith/api/json.md +58 -0
  329. package/zh/guides/topic-detail/generator/codesmith/api/npm.md +45 -0
  330. package/zh/guides/topic-detail/generator/codesmith/develop.md +52 -0
  331. package/zh/guides/topic-detail/generator/codesmith/introduce.md +42 -1
  332. package/zh/guides/topic-detail/generator/codesmith/run-in-js.md +48 -0
  333. package/zh/guides/topic-detail/generator/codesmith/structure.md +86 -0
  334. package/zh/guides/topic-detail/generator/config/mwa.md +4 -8
  335. package/zh/guides/topic-detail/generator/plugin/api/file/addFile.md +1 -1
  336. package/zh/guides/topic-detail/generator/plugin/api/file/addHelper.md +1 -1
  337. package/zh/guides/topic-detail/generator/plugin/api/file/addPartial.md +2 -2
  338. package/zh/guides/topic-detail/generator/plugin/api/file/introduce.md +1 -1
  339. package/zh/guides/topic-detail/generator/plugin/api/file/rmDir.md +1 -1
  340. package/zh/guides/topic-detail/generator/plugin/api/file/rmFile.md +1 -1
  341. package/zh/guides/topic-detail/generator/plugin/api/file/updateJSONFile.md +3 -2
  342. package/zh/guides/topic-detail/generator/plugin/api/file/updateModernConfig.md +2 -2
  343. package/zh/guides/topic-detail/generator/plugin/api/file/updateTextRawFile.md +1 -1
  344. package/zh/guides/topic-detail/generator/plugin/api/hook/afterForged.md +3 -3
  345. package/zh/guides/topic-detail/generator/plugin/api/hook/onForged.md +3 -3
  346. package/zh/guides/topic-detail/generator/plugin/api/input/addInputAfter.md +1 -1
  347. package/zh/guides/topic-detail/generator/plugin/api/input/addInputBefore.md +1 -1
  348. package/zh/guides/topic-detail/generator/plugin/api/input/type.md +1 -1
  349. package/zh/guides/topic-detail/generator/plugin/api/new/createElement.md +1 -1
  350. package/zh/guides/topic-detail/generator/plugin/api/new/createSubProject.md +1 -1
  351. package/zh/guides/topic-detail/generator/plugin/api/new/enableFunc.md +1 -1
  352. package/zh/guides/topic-detail/generator/plugin/api/npm/install.md +1 -1
  353. package/zh/guides/topic-detail/generator/plugin/develop.md +11 -7
  354. package/zh/guides/topic-detail/model/quick-start.md +4 -0
  355. package/zh/guides/topic-detail/monorepo/sub-project-interface.md +0 -2
  356. package/zh/tutorials/first-app/c01-getting-started/1.1-prerequisites.md +2 -2
  357. package/zh/tutorials/first-app/c01-getting-started/1.2-minimal-mwa.md +2 -2
  358. package/zh/tutorials/first-app/c01-getting-started/1.4-enable-ssr.md +5 -2
  359. package/zh/tutorials/first-app/c02-generator-and-studio/2.1-generator.md +0 -8
  360. package/zh/tutorials/first-app/c02-generator-and-studio/2.2-boilerplates.md +12 -6
  361. package/zh/tutorials/first-app/c02-generator-and-studio/2.3-configuration.md +2 -4
  362. package/zh/tutorials/first-app/c03-ide/3.1-setting-up.md +1 -1
  363. package/zh/tutorials/first-app/c03-ide/3.2-hints-in-ide.md +44 -50
  364. package/zh/tutorials/first-app/c03-ide/3.3-autofix-in-ide.md +1 -1
  365. package/zh/tutorials/first-app/c03-ide/3.4-autofix-in-cli.md +4 -4
  366. package/zh/tutorials/first-app/c04-es6-plus-and-ts/4.1-use-es6-plus.md +8 -21
  367. package/zh/tutorials/first-app/c04-es6-plus-and-ts/4.2-use-typescript.md +37 -13
  368. package/zh/tutorials/first-app/c05-component/5.1-use-ui-library.md +3 -13
  369. package/zh/tutorials/first-app/c05-component/5.2-use-standalone-component.md +1 -21
  370. package/zh/tutorials/first-app/c06-css-and-component/6.1-css-in-js.md +9 -9
  371. package/zh/tutorials/first-app/c06-css-and-component/6.2-utility-class.md +9 -14
  372. package/zh/tutorials/first-app/c06-css-and-component/6.3-postcss.md +7 -7
  373. package/zh/tutorials/first-app/c06-css-and-component/6.4-design-system.md +1 -1
  374. package/zh/tutorials/first-app/c06-css-and-component/6.5-storybook.md +2 -2
  375. package/zh/tutorials/first-app/c06-css-and-component/6.6-testing.md +8 -17
  376. package/zh/tutorials/first-app/c07-app-entry/7.1-intro.md +24 -19
  377. package/zh/tutorials/first-app/c07-app-entry/7.2-add-entry-in-cli.md +31 -35
  378. package/zh/tutorials/first-app/c07-app-entry/7.3-manage-entries-by-hand.md +4 -9
  379. package/zh/tutorials/first-app/c08-client-side-routing/8.1-code-based-routing.md +66 -63
  380. package/zh/tutorials/first-app/c09-bff/9.2-enable-bff.md +35 -33
  381. package/zh/tutorials/first-app/c09-bff/9.3-fetch-bff.md +28 -102
  382. package/zh/tutorials/first-app/c10-model/10.1-application-architecture.md +4 -6
  383. package/zh/tutorials/first-app/c10-model/10.2-add-model.md +3 -3
  384. package/zh/tutorials/first-app/c10-model/10.3-use-model.md +21 -20
  385. package/zh/tutorials/first-app/c10-model/10.4-testing.md +2 -2
  386. package/zh/tutorials/first-app/c11-container/11.1-use-model-with-app-state.md +34 -68
  387. package/zh/tutorials/first-app/c11-container/11.2-add-container.md +40 -37
  388. package/zh/tutorials/first-app/c11-container/11.3-use-loader.md +6 -4
  389. package/zh/tutorials/first-app/c11-container/11.4-testing.md +2 -2
  390. package/zh/tutorials/foundations/introduction.md +1 -1
  391. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/default-alias.md +0 -25
  392. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/env.md +0 -72
  393. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/plugin/_category_.json +0 -4
  394. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/plugin/abstract.md +0 -26
  395. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/plugin/hook-api.md +0 -896
  396. package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/plugin/hook.md +0 -170
  397. package/zh/apis/app/runtime/default-alias.md +0 -23
  398. package/zh/apis/app/runtime/env.md +0 -70
  399. package/zh/apis/app/runtime/plugin/_category_.json +0 -4
  400. package/zh/apis/app/runtime/plugin/abstract.md +0 -26
  401. package/zh/apis/app/runtime/plugin/plugin-api.md +0 -117
  402. package/zh/components/deploy.md +0 -60
  403. package/zh/components/dev-ide.md +0 -1
  404. package/zh/components/entry-name.md +0 -15
  405. package/zh/components/env-prepare.md +0 -1
  406. package/zh/components/launch-bff-choices.md +0 -6
  407. package/zh/guides/advanced-features/bff/bff-server.md +0 -142
  408. package/zh/guides/advanced-features/typescript.md +0 -4
  409. package/zh/guides/basic-features/image.md +0 -43
  410. package/zh/guides/concept/integrated.md +0 -4
  411. package/zh/guides/concept/solutions.md +0 -4
  412. package/zh/guides/topic-detail/compile-speed.md +0 -182
  413. package/zh/guides/topic-detail/framework-plugin/abstract.md +0 -27
  414. package/zh/guides/troubleshooting/compile.md +0 -379
  415. package/zh/tutorials/first-app/c08-client-side-routing/8.2-file-based-routing.md +0 -318
@@ -3,15 +3,13 @@ sidebar_label: ssg
3
3
  ---
4
4
  # output.ssg
5
5
 
6
-
7
-
8
6
  * 类型: `boolean` | `object` | `function`
9
7
  * 默认值: `undefined`
10
8
 
11
9
  开启**自控式路由**或**约定式路由** SSG 功能的配置。
12
10
 
13
11
  :::info 客户端路由
14
- 相关内容可以查看[自控式路由](/docs/tutorials/first-app/c08-client-side-routing/8.1-code-based-routing)或[约定式路由](/docs/tutorials/first-app/c08-client-side-routing/8.2-file-based-routing)
12
+ 相关内容可以查看[路由](/docs/guides/basic-features/routes)。
15
13
  :::
16
14
 
17
15
  ## 示例
@@ -20,115 +18,134 @@ sidebar_label: ssg
20
18
 
21
19
  当该配置设置为 `true` 时,将会默认开启所有入口的 SSG 功能。
22
20
 
23
- 对**自控式路由**而言,将会渲染入口路由。对**约定式路由**而言,将会渲染入口中每一条客户端路由。
21
+ 对**自控式路由**而言,将会渲染入口的根路由。对**约定式路由**而言,将会渲染入口中每一条路由。
24
22
 
25
23
  例如 `src/` 目录下有以下满足**约定式路由**的文件结构:
26
24
 
27
25
  ```bash
28
26
  .
29
- ├── pages/
30
-    ├── user/
31
-    │   └── info.tsx
32
-    ├── home.tsx
33
-    └── index.tsx
34
- ├── .eslintrc.json
27
+ ├── src
28
+ └── routes
29
+ ├── layout.tsx
30
+ ├── page.tsx
31
+ └── user
32
+ ├── layout.tsx
33
+ │ ├── page.tsx
34
+ │ └── profile
35
+ │ └── page.tsx
35
36
  ```
36
37
 
37
38
  在 `modern.js.config` 中做以下设置:
38
39
 
39
40
  ```js
40
- module.exports = {
41
+ export default defineConfig({
41
42
  output: {
42
43
  ssg: true,
43
44
  },
44
- };
45
+ });
45
46
  ```
46
47
 
47
- 执行 `pnpm build` 构建应用后。`dist/` 目录将会生成三张 HTML 分别对应三条路由(不开启 SSG 时只有一张 HTML 对应主入口),并且可以看到所有 HTML 都已经是渲染之后的。
48
+ 执行 `pnpm build` 构建应用后。`dist/` 目录将会生成三张 HTML 分别对应三条路由(不开启 SSG 时只有一张 HTML),并且所有 HTML 都已经渲染。
48
49
 
49
50
  而例如下面的**自控式路由**:
50
51
 
51
- ```ts title="App.tsx"
52
- import { Switch, Route } from '@modern-js/runtime/router';
53
-
54
- export default () => (
55
- <Switch>
56
- <Route path="/" exact={true}>
57
- <div>Home</div>
58
- </Route>
59
- <Route path="/foo" exact={true}>
60
- <div>Foo</div>
61
- </Route>
62
- </Switch>
63
- );
52
+ ```tsx title="App.tsx"
53
+ import { useRuntimeContext } from '@modern-js/runtime';
54
+ import { Routes, Route, BrowserRouter } from '@modern-js/runtime/router';
55
+ import { StaticRouter } from '@modern-js/runtime/router/server';
56
+
57
+ const Router = typeof window === 'undefined' ? StaticRouter : BrowserRouter;
58
+
59
+ export default () => {
60
+ const { context } = useRuntimeContext();
61
+ return (
62
+ <Router location={context.request.pathname}>
63
+ <Routes>
64
+ <Route index element={<div>index</div>} />
65
+ <Route path="about" element={<div>about</div>} />
66
+ </Routes>
67
+ </Router>
68
+ );
69
+ };
64
70
  ```
65
71
 
66
- 同样使用上面的配置,在执行 `pnpm build` 后,只有入口路由 `/` 会生成渲染后的 HTML。
72
+ 同样使用上面的配置,在执行 `pnpm run build` 后,只有入口路由 `/` 会生成渲染后的 HTML。
67
73
 
68
74
  ### 多入口
69
75
 
76
+ :::note
77
+ 多入口 SSG 暂未支持,敬请期待。
78
+ :::
79
+
70
80
  `output.ssg` 也可以按照入口配置,配置生效的规则同样由入口路由方式决定。
71
81
 
72
82
  例如以下目录结构:
73
83
 
74
84
  ```bash
75
- .
76
- ├── src/
77
- │   ├── contacts/
78
-       └── App.tsx
79
-    ├── landing-page/
80
-       └── pages/
81
-       ├── [user].tsx
82
-       ├── docs.tsx
83
-       └── index.tsx
85
+
86
+ ├── src
87
+ │   ├── entryA
88
+ └── routes
89
+ ├── layout.tsx
90
+ ├── page.tsx
91
+ └── user
92
+ ├── layout.tsx
93
+ ├── page.tsx
94
+ │ │ └── profile
95
+ │ │ └── page.tsx
96
+ │   └── entryB
97
+ │   └── App.tsx
84
98
  ```
85
99
 
86
- 默认情况下,所有约定式路由的入口,在设置 `output.ssg` 配置后都会在构建阶段渲染,可以配置 `false` 来取消指定入口的的默认行为,例如取消上述 landing-page 入口在构建时的渲染:
100
+ 默认情况下,所有约定式路由的入口,在设置 `output.ssg` 配置为 `true` 后都会在构建阶段渲染。可以配置 `false` 来取消指定入口的的默认行为,例如取消上述 entryA 入口在构建时的渲染:
87
101
 
88
102
  ```js
89
- module.exports = {
103
+ export default defineConfig({
90
104
  output: {
91
105
  ssg: {
92
- contacts: true,
93
- 'landing-page': false,
106
+ entryA: true,
107
+ entryB: false,
94
108
  },
95
109
  },
96
- };
110
+ });
97
111
  ```
98
112
 
99
113
  ### 配置路由
100
114
 
101
115
  上述内容中提到,**自控式路由**默认只会开启入口路由的 SSG 配置。
102
116
 
103
- 可以在 `output.ssg` 中设置具体的路由,告知 Modern.js 开启这些客户端路由的 SSG 功能。例如上述 `contacts/App.tsx` 的文件内容为:
104
-
105
- ```ts title="contacts/App.tsx"
106
- import { Switch, Route } from '@modern-js/runtime/router';
107
-
108
- export default () => (
109
- <Switch>
110
- <Route path="/" exact={true}>
111
- <div>Home</div>
112
- </Route>
113
- <Route path="/foo" exact={true}>
114
- <div>Foo</div>
115
- </Route>
116
- </Switch>
117
- );
117
+ 可以在 `output.ssg` 中设置具体的路由,告知 Modern.js 开启这些客户端路由的 SSG 功能。例如上述 `src/App.tsx` 的文件内容为:
118
+
119
+ ```tsx title="src/App.tsx"
120
+ import { useRuntimeContext } from '@modern-js/runtime';
121
+ import { Routes, Route, BrowserRouter } from '@modern-js/runtime/router';
122
+ import { StaticRouter } from '@modern-js/runtime/router/server';
123
+
124
+ const Router = typeof window === 'undefined' ? StaticRouter : BrowserRouter;
125
+
126
+ export default () => {
127
+ const { context } = useRuntimeContext();
128
+ return (
129
+ <Router location={context.request.pathname}>
130
+ <Routes>
131
+ <Route index element={<div>index</div>} />
132
+ <Route path="about" element={<div>about</div>} />
133
+ </Routes>
134
+ </Router>
135
+ );
136
+ };
118
137
  ```
119
138
 
120
- 在 `modern.config.js` 中这样设置后,`/foo` 路由也会开启 SSG 功能:
139
+ 在 `modern.config.js` 中这样设置后,`/about` 路由也会开启 SSG 功能:
121
140
 
122
141
  ```js
123
- module.exports = {
142
+ export default defineConfig({
124
143
  output: {
125
144
  ssg: {
126
- contacts: {
127
- routes: ['/', '/foo'],
128
- },
145
+ routes: ['/', '/about'],
129
146
  },
130
147
  },
131
- };
148
+ });
132
149
  ```
133
150
 
134
151
  Modern.js 将会自动根据入口拼接完整的 URL 并交给 SSG 插件完成渲染。
@@ -136,22 +153,20 @@ Modern.js 将会自动根据入口拼接完整的 URL 并交给 SSG 插件完成
136
153
  也可以为具体入口或路由配置请求头,例如:
137
154
 
138
155
  ```js
139
- module.exports = {
156
+ export default defineConfig({
140
157
  output: {
141
158
  ssg: {
142
- contacts: {
143
- headers: {},
144
- routes: [
145
- '/',
146
- {
147
- url: '/foo',
148
- headers: {},
149
- },
150
- ],
151
- },
159
+ headers: {},
160
+ routes: [
161
+ '/',
162
+ {
163
+ url: '/about',
164
+ headers: {},
165
+ },
166
+ ],
152
167
  },
153
168
  },
154
- };
169
+ });
155
170
  ```
156
171
 
157
172
  :::info
@@ -160,67 +175,56 @@ module.exports = {
160
175
 
161
176
  ### 阻止默认行为
162
177
 
163
- **约定式路由**也可以通过配置的方式来开启指定路由的 SSG。
164
-
165
- 但因为默认行为的不同,这里为**约定式路由**提供了另一个字段,用来阻止默认的 SSG 行为。
178
+ 默认情况下,**约定式路由**的路由会全部开启 SSG。Modern.js 提供了另一个字段,用来阻止默认的 SSG 行为。
166
179
 
167
- 例如以下目录结构,除了 `/docs4` 外的所有 landing-page 入口中的路由都开启 SSG:
180
+ 例如以下目录结构,`/`、`/user`、`/user/profle` 三条路由都开启 SSG:
168
181
 
169
182
  ```bash
170
183
  .
171
- ├── src/
172
-    ├── contacts/
173
-    │   └── App.tsx
174
-    ├── landing-page/
175
-    │   └── pages/
176
-    │   ├── [user].tsx
177
-    │   ├── docs.tsx
178
-    │   ├── docs1.tsx
179
-    │   ├── docs2.tsx
180
- │   │   ├── docs3.tsx
181
- │   │   ├── docs4.tsx
182
- │   │   └── index.tsx
184
+ ├── src
185
+ └── routes
186
+ ├── layout.tsx
187
+ ├── page.tsx
188
+ └── user
189
+ ├── layout.tsx
190
+ ├── page.tsx
191
+ └── profile
192
+ └── page.tsx
183
193
  ```
184
194
 
185
195
  可以这样设置,禁用某一条客户端路由的默认行为:
186
196
 
187
- :::info 注
188
- 该配置仅在渲染动态路径的约定式路由时使用。
189
- :::
190
-
191
197
  ```js
192
- module.exports = {
198
+ export default defineConfig({
193
199
  output: {
194
- 'landing-page': {
195
- preventDefault: ['/docs4'],
196
- },
200
+ preventDefault: ['/user'],
197
201
  },
198
- };
202
+ });
199
203
  ```
200
204
 
201
205
  ### 添加动态路由参数
202
206
 
203
- 部分路由可能是动态的,例如自控式路由中的 `/user/:id` 或是约定式路由中 `user/[id].ts` 文件生成的路由。
207
+ 部分路由可能是动态的,例如自控式路由中的 `/user/:id` 或是约定式路由中 `user/[id]/page.tsx` 文件生成的路由。
204
208
 
205
209
  可以在 `output.ssg` 中配置具体的参数,渲染指定参数的路由,例如:
206
210
 
207
211
  ```js
208
- module.exports = {
212
+ export default defineConfig({
209
213
  output: {
210
214
  ssg: {
211
- 'landing-page': {
212
- routes: [
213
- {
214
- url: '/user/:id',
215
- params: [
216
- {
217
- id: 'modernjs',
218
- },
219
- ],
220
- },
221
- ],
222
- },
215
+ routes: [
216
+ {
217
+ url: '/user/:id',
218
+ params: [
219
+ {
220
+ id: 'modernjs',
221
+ },
222
+ ],
223
+ },
224
+ ],
223
225
  },
224
226
  },
225
- };
227
+ });
226
228
  ```
229
+
230
+ 动态路由和 SSG 的组合,在根据 CMS 系统数据变更,实时生成静态页面时非常有用。
@@ -4,7 +4,7 @@ sidebar_label: svgDefaultExport
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [output.svgDefaultExport](https://modernjs.dev/builder/zh/api/config-output.html#output-svgdefaultexport)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [output.svgDefaultExport](https://modernjs.dev/builder/zh/api/config-output.html#output-svgdefaultexport)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/output/svgDefaultExport.md'
@@ -0,0 +1,4 @@
1
+ {
2
+ "label": "performance (性能)",
3
+ "position": 13
4
+ }
@@ -4,7 +4,7 @@ sidebar_label: buildCache
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.buildCache](https://modernjs.dev/builder/zh/api/config-performance.html#performance-buildcache)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.buildCache](https://modernjs.dev/builder/zh/api/config-performance.html#performance-buildcache)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/buildCache.md'
@@ -4,7 +4,7 @@ sidebar_label: bundleAnalyze
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.bundleAnalyze](https://modernjs.dev/builder/zh/api/config-performance.html#performance-bundleanalyze)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.bundleAnalyze](https://modernjs.dev/builder/zh/api/config-performance.html#performance-bundleanalyze)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/bundleAnalyze.md'
@@ -4,7 +4,7 @@ sidebar_label: chunkSplit
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.chunkSplit](https://modernjs.dev/builder/zh/api/config-performance.html#performance-chunksplit)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.chunkSplit](https://modernjs.dev/builder/zh/api/config-performance.html#performance-chunksplit)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/chunkSplit.md'
@@ -4,7 +4,7 @@ sidebar_label: printFileSize
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.printFileSize](https://modernjs.dev/builder/zh/api/config-performance.html#performance-printfilesize)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.printFileSize](https://modernjs.dev/builder/zh/api/config-performance.html#performance-printfilesize)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/printFileSize.md'
@@ -4,7 +4,7 @@ sidebar_label: profile
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.profile](https://modernjs.dev/builder/zh/api/config-performance.html#performance-profile)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.profile](https://modernjs.dev/builder/zh/api/config-performance.html#performance-profile)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/profile.md'
@@ -4,7 +4,7 @@ sidebar_label: removeConsole
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.removeConsole](https://modernjs.dev/builder/zh/api/config-performance.html#performance-removeconsole)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.removeConsole](https://modernjs.dev/builder/zh/api/config-performance.html#performance-removeconsole)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/removeConsole.md'
@@ -4,7 +4,7 @@ sidebar_label: removeMomentLocale
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [performance.removeMomentLocale](https://modernjs.dev/builder/zh/api/config-performance.html#performance-removemomentlocale)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [performance.removeMomentLocale](https://modernjs.dev/builder/zh/api/config-performance.html#performance-removemomentlocale)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/performance/removeMomentLocale.md'
@@ -3,7 +3,7 @@ title: plugins (插件)
3
3
  sidebar_position: 9
4
4
  ---
5
5
 
6
- - 类型: `CliPlugin[] | { cli: CliPlugin[] }`
6
+ - 类型: `CliPlugin[]`
7
7
  - 默认值:`[]`
8
8
 
9
9
  用于配置自定义的 Modern.js 插件。
@@ -12,6 +12,19 @@ sidebar_label: state
12
12
 
13
13
  具体配置项如下:
14
14
 
15
+ ## `models`
16
+
17
+ * 类型:`Array<Model>`
18
+ * 默认值:`[]`
19
+
20
+ 注册提前挂载的 model 对象,这些 model 会在 Reduck store 创建完成后立即执行挂载。一般使用无需提前挂载。
21
+
22
+ ## `initialState`
23
+ * 类型: `Object`
24
+ * * 默认值:`{}`
25
+
26
+ 用于设置全局 store 的初始状态。一般用于 SSR 在 hydration 阶段初始化数据。
27
+
15
28
  ## `immer`
16
29
 
17
30
  * 类型:`boolean`
@@ -0,0 +1,4 @@
1
+ {
2
+ "label": "security (安全)",
3
+ "position": 14
4
+ }
@@ -4,7 +4,7 @@ sidebar_label: sri
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [security.sri](https://modernjs.dev/builder/zh/api/config-security.html#security-sri)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [security.sri](https://modernjs.dev/builder/zh/api/config-security.html#security-sri)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/security/sri.md'
@@ -4,8 +4,6 @@ sidebar_label: ssr
4
4
 
5
5
  # server.ssr
6
6
 
7
-
8
-
9
7
  * 类型: `boolean`
10
8
  * 默认值: `false`
11
9
 
@@ -4,7 +4,7 @@ sidebar_label: alias
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.alias](https://modernjs.dev/builder/zh/api/config-source.html#source-alias)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.alias](https://modernjs.dev/builder/zh/api/config-source.html#source-alias)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/alias.md'
@@ -4,7 +4,7 @@ sidebar_label: compileJsDataURI
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.compileJsDataURI](https://modernjs.dev/builder/zh/api/config-source.html#source-compilejsdatauri)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.compileJsDataURI](https://modernjs.dev/builder/zh/api/config-source.html#source-compilejsdatauri)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/compileJsDataURI.md'
@@ -4,7 +4,7 @@ sidebar_label: define
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.define](https://modernjs.dev/builder/zh/api/config-source.html#source-define)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.define](https://modernjs.dev/builder/zh/api/config-source.html#source-define)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/define.md'
@@ -4,7 +4,7 @@ sidebar_label: exclude
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.exclude](https://modernjs.dev/builder/zh/api/config-source.html#source-exclude)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.exclude](https://modernjs.dev/builder/zh/api/config-source.html#source-exclude)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/exclude.md'
@@ -4,7 +4,7 @@ sidebar_label: globalVars
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.globalVars](https://modernjs.dev/builder/zh/api/config-source.html#source-globalvars)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.globalVars](https://modernjs.dev/builder/zh/api/config-source.html#source-globalvars)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/globalVars.md'
@@ -4,7 +4,7 @@ sidebar_label: include
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.include](https://modernjs.dev/builder/zh/api/config-source.html#source-include)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.include](https://modernjs.dev/builder/zh/api/config-source.html#source-include)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/include.md'
@@ -4,7 +4,7 @@ sidebar_label: moduleScopes
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.moduleScopes](https://modernjs.dev/builder/zh/api/config-source.html#source-modulescopes)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.moduleScopes](https://modernjs.dev/builder/zh/api/config-source.html#source-modulescopes)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/moduleScopes.md'
@@ -4,7 +4,7 @@ sidebar_label: preEntry
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.preEntry](https://modernjs.dev/builder/zh/api/config-source.html#source-preentry)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.preEntry](https://modernjs.dev/builder/zh/api/config-source.html#source-preentry)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/preEntry.md'
@@ -4,7 +4,7 @@ sidebar_label: resolveExtensionPrefix
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.resolveExtensionPrefix](https://modernjs.dev/builder/zh/api/config-source.html#source-resolveextensionprefix)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.resolveExtensionPrefix](https://modernjs.dev/builder/zh/api/config-source.html#source-resolveextensionprefix)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/resolveExtensionPrefix.md'
@@ -4,7 +4,7 @@ sidebar_label: resolveMainFields
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [source.resolveMainFields](https://modernjs.dev/builder/zh/api/config-source.html#source-resolvemainfields)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [source.resolveMainFields](https://modernjs.dev/builder/zh/api/config-source.html#source-resolvemainfields)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/source/resolveMainFields.md'
@@ -4,7 +4,7 @@ sidebar_label: autoprefixer
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [tools.autoprefixer](https://modernjs.dev/builder/zh/api/config-tools.html#tools-autoprefixer)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [tools.autoprefixer](https://modernjs.dev/builder/zh/api/config-tools.html#tools-autoprefixer)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/tools/autoprefixer.md'
@@ -4,7 +4,7 @@ sidebar_label: babel
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [tools.babel](https://modernjs.dev/builder/zh/api/config-tools.html#tools-babel)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [tools.babel](https://modernjs.dev/builder/zh/api/config-tools.html#tools-babel)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/tools/babel.md'
@@ -4,7 +4,7 @@ sidebar_label: cssExtract
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [tools.cssExtract](https://modernjs.dev/builder/zh/api/config-tools.html#tools-cssextract)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [tools.cssExtract](https://modernjs.dev/builder/zh/api/config-tools.html#tools-cssextract)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/tools/cssExtract.md'
@@ -4,7 +4,7 @@ sidebar_label: cssLoader
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [tools.cssLoader](https://modernjs.dev/builder/zh/api/config-tools.html#tools-cssloader)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [tools.cssLoader](https://modernjs.dev/builder/zh/api/config-tools.html#tools-cssloader)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/tools/cssLoader.md'
@@ -4,7 +4,7 @@ sidebar_label: devServer
4
4
  ---
5
5
 
6
6
  :::info BUILDER
7
- 该配置为 Modern.js Builder 配置,可能存在无法跳转的链接。详细信息可参考 [tools.devServer](https://modernjs.dev/builder/zh/api/config-tools.html#tools-devserver)。
7
+ 该配置为 Modern.js Builder 配置,详细信息可参考 [tools.devServer](https://modernjs.dev/builder/zh/api/config-tools.html#tools-devserver)。
8
8
  :::
9
9
 
10
10
  import Main from '@modern-js/builder-doc/zh/config/tools/devServer.md'