@modern-js/main-doc 2.9.0 → 2.11.0

package/docs/zh/tutorials/first-app/c06-model.mdx

@@ -195,18 +195,10 @@ const Item = ({
 export default Item;
 ```
 
-接下来，我们修改 `src/routes/page.tsx`，为 `<Item>` 组件传递更多参数：
+接下来，我们修改 `src/routes/page.tsx` 和 `src/routes/page.loader.ts`，为 `<Item>` 组件传递更多参数：
 
-```tsx
-import { Helmet } from '@modern-js/runtime/head';
-import { useModel } from '@modern-js/runtime/model';
-import { useLoaderData } from '@modern-js/runtime/router';
-import { List } from 'antd';
-import { name, internet } from 'faker';
-import Item from '../components/Item';
-import contacts from '../models/contacts';
-
-type LoaderData = {
+```ts title="src/routes/page.loader.ts"
+export type LoaderData = {
   code: number;
   data: {
     name: string;
@@ -215,7 +207,7 @@ type LoaderData = {
   }[];
 };
 
-export const loader = async (): Promise<LoaderData> => {
+export default async (): Promise<LoaderData> => {
   const data = new Array(20).fill(0).map(() => {
     const firstName = name.firstName();
     return {
@@ -231,6 +223,16 @@ export const loader = async (): Promise<LoaderData> => {
     data,
   };
 };
+```
+
+```tsx title="src/routes/page.tsx"
+import { Helmet } from '@modern-js/runtime/head';
+import { useModel } from '@modern-js/runtime/model';
+import { useLoaderData } from '@modern-js/runtime/router';
+import { List } from 'antd';
+import { name, internet } from 'faker';
+import Item from '../components/Item';
+import contacts from '../models/contacts';
 
 function Index() {
   const { data } = useLoaderData() as LoaderData;

package/docs/zh/tutorials/first-app/c07-container.mdx

@@ -15,24 +15,8 @@ import { Tabs, Tab as TabItem } from "@theme";
 
 Modern.js 支持在 `layout.tsx` 通过 Data Loader 获取数据，我们先数据获取这部分代码移动到 `src/routes/layout.tsx` 中：
 
-```tsx
-import { name, internet } from 'faker';
-import {
-  Outlet,
-  useLoaderData,
-  useLocation,
-  useNavigate,
-} from '@modern-js/runtime/router';
-import { useState } from 'react';
-import { Radio, RadioChangeEvent } from 'antd';
-import { useModel } from '@modern-js/runtime/model';
-import contacts from '../models/contacts';
-import 'tailwindcss/base.css';
-import 'tailwindcss/components.css';
-import 'tailwindcss/utilities.css';
-import '../styles/utils.css';
-
-type LoaderData = {
+```ts title="src/routes/layout.loader.ts"
+export type LoaderData = {
   code: number;
   data: {
     name: string;
@@ -41,7 +25,7 @@ type LoaderData = {
   }[];
 };
 
-export const loader = async (): Promise<LoaderData> => {
+export default async (): Promise<LoaderData> => {
   const data = new Array(20).fill(0).map(() => {
     const firstName = name.firstName();
     return {
@@ -56,6 +40,25 @@ export const loader = async (): Promise<LoaderData> => {
     data,
   };
 };
+```
+
+```tsx title="src/routes/layout.tsx"
+import { name, internet } from 'faker';
+import {
+  Outlet,
+  useLoaderData,
+  useLocation,
+  useNavigate,
+} from '@modern-js/runtime/router';
+import { useState } from 'react';
+import { Radio, RadioChangeEvent } from 'antd';
+import { useModel } from '@modern-js/runtime/model';
+import contacts from '../models/contacts';
+import 'tailwindcss/base.css';
+import 'tailwindcss/components.css';
+import 'tailwindcss/utilities.css';
+import '../styles/utils.css';
+import type { LoaderData } from './layout.loader';
 
 export default function Layout() {
   const { data } = useLoaderData() as LoaderData;

package/modern.config.ts

@@ -40,12 +40,11 @@ const getNavbar = (lang: string): NavItem[] => {
       link: getLink('/apis/app/commands'),
       activeMatch: '/apis/',
     },
-    // TODO enabled after we write the v2 release blog
-    // {
-    //   text: getText('博客', 'Blog'),
-    //   link: getLink('/blog/index'),
-    //   activeMatch: '/blog/',
-    // },
+    {
+      text: getText('博客', 'Blog'),
+      link: getLink('/blog/index'),
+      activeMatch: '/blog/',
+    },
     {
       text: `v${version}`,
       items: [
@@ -153,5 +152,5 @@ export default defineConfig({
       }),
     ],
   },
-  plugins: [docTools()],
+  plugins: [docTools({})],
 });

package/package.json

@@ -11,13 +11,13 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.9.0",
+  "version": "2.11.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "^2.9.0"
+    "@modern-js/builder-doc": "^2.11.0"
   },
   "devDependencies": {
     "classnames": "^2",
@@ -29,9 +29,9 @@
     "fs-extra": "^10",
     "@types/node": "^16",
     "@types/fs-extra": "^9",
-    "@modern-js/builder-doc": "2.9.0",
-    "@modern-js/doc-tools": "2.9.0",
-    "@modern-js/doc-plugin-auto-sidebar": "2.9.0"
+    "@modern-js/builder-doc": "2.11.0",
+    "@modern-js/doc-tools": "2.11.0",
+    "@modern-js/doc-plugin-auto-sidebar": "2.11.0"
   },
   "scripts": {
     "dev": "modern dev",

package/src/pages/index.tsx

@@ -1,5 +1,6 @@
 import clsx from 'clsx';
-import { useLang, Helmet } from '@modern-js/doc-tools/runtime';
+import { useLang, Helmet, useLocation } from '@modern-js/doc-tools/runtime';
+import { useEffect } from 'react';
 import ContentCard from '../components/ContentCard';
 import SecondaryTitle from '../components/SecondaryTitle';
 import { FeatureLayout } from '../components/FeatureLayout';
@@ -44,6 +45,13 @@ const HomepageHeader = () => {
 
 export default function Home() {
   const t = useI18n();
+  const { pathname } = useLocation();
+  useEffect(() => {
+    window.MODERN_THEME = 'dark';
+    return () => {
+      window.MODERN_THEME = undefined;
+    };
+  }, [pathname]);
 
   const features = [
     {
@@ -106,10 +114,7 @@ export default function Home() {
     <div>
       <Helmet>
         <html className="dark"></html>
-        <script>
-          localStorage && localStorage.setItem('modern-theme-appearance',
-          'dark');
-        </script>
+        <script>window.MODERN_THEME = 'dark';</script>
         <style type="text/css">{`
           .modern-doc-appearance {
             display: none!important;

package/en/configure/app/dev/asset-prefix.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: assetPrefix
----
-
-# dev.assetPrefix
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.assetPrefix](https://modernjs.dev/builder/en/api/config-dev.html#devassetprefix).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/assetPrefix.md';
-
-<Main />

package/en/configure/app/dev/before-start-url.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: beforeStartUrl
----
-
-# dev.beforeStartUrl
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.beforeStartUrl](https://modernjs.dev/builder/en/api/config-dev.html#devbeforestarturl).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/beforeStartUrl.md';
-
-<Main />

package/en/configure/app/dev/hmr.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: hmr
----
-
-# dev.hmr
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.hmr](https://modernjs.dev/builder/en/api/config-dev.html#devhmr).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/hmr.md';
-
-<Main />

package/en/configure/app/dev/host.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: host
----
-
-# dev.host
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.host](https://modernjs.dev/builder/en/api/config-dev.html#devhost).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/host.md';
-
-<Main />

package/en/configure/app/dev/https.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: https
----
-
-# dev.https
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.https](https://modernjs.dev/builder/en/api/config-dev.html#devhttps).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/https.md';
-
-<Main />

package/en/configure/app/dev/port.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: port
----
-
-# dev.port
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.port](https://modernjs.dev/builder/en/api/config-dev.html#devport).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/port.md';
-
-<Main />

package/en/configure/app/dev/progress-bar.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: progressBar
----
-
-# dev.progressBar
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.progressBar](https://modernjs.dev/builder/en/api/config-dev.html#devprogressbar).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/progressBar.md';
-
-<Main />

package/en/configure/app/dev/start-url.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: startUrl
----
-
-# dev.startUrl
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [dev.startUrl](https://modernjs.dev/builder/en/api/config-dev.html#devstarturl).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/dev/startUrl.md';
-
-<Main />

package/en/configure/app/experiments/lazy-compilation.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: lazyCompilation
----
-
-# experiments.lazyCompilation
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [experiments.lazyCompilation](https://modernjs.dev/builder/en/api/config-experiments.html#experimentslazycompilation).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/experiments/lazyCompilation.md';
-
-<Main />

package/en/configure/app/html/app-icon.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: appIcon
----
-
-# html.appIcon
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.appIcon](https://modernjs.dev/builder/en/api/config-html.html#htmlappicon).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/appIcon.md';
-
-<Main />

package/en/configure/app/html/crossorigin.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: crossorigin
----
-
-# html.crossorigin
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.crossorigin](https://modernjs.dev/builder/en/api/config-html.html#htmlcrossorigin).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/crossorigin.md';
-
-<Main />

package/en/configure/app/html/disable-html-folder.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: disableHtmlFolder
----
-
-# html.disableHtmlFolder
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.disableHtmlFolder](https://modernjs.dev/builder/en/api/config-html.html#htmldisablehtmlfolder).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/disableHtmlFolder.md';
-
-<Main />

package/en/configure/app/html/favicon-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: faviconByEntries
----
-
-# html.faviconByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.faviconByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmlfaviconbyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/faviconByEntries.md';
-
-<Main />

package/en/configure/app/html/favicon.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: favicon
----
-
-# html.favicon
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.favicon](https://modernjs.dev/builder/en/api/config-html.html#htmlfavicon).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/favicon.md';
-
-<Main />

package/en/configure/app/html/inject-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: injectByEntries
----
-
-# html.injectByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.injectByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmlinjectbyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/injectByEntries.md';
-
-<Main />

package/en/configure/app/html/inject.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: inject
----
-
-# html.inject
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.inject](https://modernjs.dev/builder/en/api/config-html.html#htmlinject).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/inject.md';
-
-<Main />

package/en/configure/app/html/meta-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: metaByEntries
----
-
-# html.metaByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.metaByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmlmetabyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/metaByEntries.md';
-
-<Main />

package/en/configure/app/html/meta.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: meta
----
-
-# html.meta
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.meta](https://modernjs.dev/builder/en/api/config-html.html#htmlmeta).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/meta.md';
-
-<Main />

package/en/configure/app/html/mount-id.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: mountId
----
-
-# html.mountId
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.mountId](https://modernjs.dev/builder/en/api/config-html.html#htmlmountid).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/mountId.md';
-
-<Main />

package/en/configure/app/html/tags-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: tagsByEntries
----
-
-# html.tagsByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.tagsByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmltagsbyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/tagsByEntries.md';
-
-<Main />

package/en/configure/app/html/tags.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: tags
----
-
-# html.tags
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.tags](https://modernjs.dev/builder/en/api/config-html.html#htmltags).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/tags.md';
-
-<Main />

package/en/configure/app/html/template-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: templateByEntries
----
-
-# html.templateByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.templateByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmltemplatebyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/templateByEntries.md';
-
-<Main />

package/en/configure/app/html/template-parameters-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: templateParametersByEntries
----
-
-# html.templateParametersByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.templateParametersByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmltemplateparametersbyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/templateParametersByEntries.md';
-
-<Main />

package/en/configure/app/html/template-parameters.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: templateParameters
----
-
-# html.templateParameters
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.templateParameters](https://modernjs.dev/builder/en/api/config-html.html#htmltemplateparameters).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/templateParameters.md';
-
-<Main />

package/en/configure/app/html/template.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: template
----
-
-# html.template
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.template](https://modernjs.dev/builder/en/api/config-html.html#htmltemplate).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/template.md';
-
-<Main />

package/en/configure/app/html/title-by-entries.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: titleByEntries
----
-
-# html.titleByEntries
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.titleByEntries](https://modernjs.dev/builder/en/api/config-html.html#htmltitlebyentries).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/titleByEntries.md';
-
-<Main />

package/en/configure/app/html/title.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: title
----
-
-# html.title
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [html.title](https://modernjs.dev/builder/en/api/config-html.html#htmltitle).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/html/title.md';
-
-<Main />

package/en/configure/app/output/asset-prefix.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: assetPrefix
----
-
-# output.assetPrefix
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [output.assetPrefix](https://modernjs.dev/builder/en/api/config-output.html#outputassetprefix).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/output/assetPrefix.md';
-
-<Main />

package/en/configure/app/output/assets-retry.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: assetsRetry
----
-
-# output.assetsRetry
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [output.assetsRetry](https://modernjs.dev/builder/en/api/config-output.html#outputassetsretry).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/output/assetsRetry.md';
-
-<Main />

package/en/configure/app/output/charset.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: charset
----
-
-# output.charset
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [output.charset](https://modernjs.dev/builder/en/api/config-output.html#outputcharset).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/output/charset.md';
-
-<Main />

package/en/configure/app/output/clean-dist-path.mdx

@@ -1,13 +0,0 @@
----
-sidebar_label: cleanDistPath
----
-
-# output.cleanDistPath
-
-:::tip
-This config is provided by Modern.js Builder, more detail can see [output.cleanDistPath](https://modernjs.dev/builder/en/api/config-output.html#outputcleandistpath).
-:::
-
-import Main from '@modern-js/builder-doc/docs/en/config/output/cleanDistPath.md';
-
-<Main />