使用说明

1. npm run mim:build：创建依赖文件目录 init_modules（必须先运行一次，不然会出错），依赖文件存在后如果不更新就可以不运行了。
2. 其他用正常命令即可。

|-- assets                   => 静态资源，注意在打包时会修改资源的名称和更新引用，因此 MD 文档中不能使用这里资源
    |-- images               => 图片
    |-- katex                => 数学公式插件 KaTeX 的样式
|-- components
    |-- cipher               => cipher 路由的内容(没有SEO)
    |-- comm                 => 普通组件
    |-- demo                 => demo 路由的内容
    |-- icon                 => 图标组件
    |-- layout               => 布局组件
    |-- mdx                  => MDX 组件
|-- pages
    |-- [nemu1]
        |-- index.jsx        => MDX一级路由页面
        |-- [nemu2]
            |-- index.jsx    => MDX二级路由页面
    |-- cipher
        |-- index.jsx        => cipher页面
    |-- demo
        |-- [slug].jsx       => 示例页面
    |-- mdx
        |-- [slug].jsx       => 文章页面
    |-- media
        |-- index.jsx        => 音视频页面
    |-- search
        |-- index.jsx        => 搜索页面
|-- mdx                      => 所有的文章
    |-- menu.js              => 文章目录
    |-- other.js             => 其他目录
|-- public                   => 静态资源，由 Next 内置，不可修改名称，打包时不会修改资源名称
    |-- bigFiles             => 大资源, 不在 git 中记录
    |-- demo                 => demo页面中无法展示的项目, 项目的 README 应加入/mdx/other.js 中
    |-- images               => 图片
    |-- mdx                  => 文章的资源
|-- scripts                  => node 脚本工具
|-- styles                   => 样式
    |-- article              => 文章样式
    |-- globals              => 全局样式 
|-- utils
    |-- config.js            => 全局配置
    |-- demo.js              => demo页面的函数
    |-- hook.js              => hook
    |-- mdx.js               => mdx页面的函数
    |-- media.js             => media页面的数据
    |-- search.js            => search页面的数据
    |-- utils.js             => 其它通用函数
|-- middleware.js            => 中间件

说明：

1. 增加文档分类，在 mdx/menu.js 中配置分类信息，分类最多支持三级。

2. 权限：

   • 文档权限，在 md 的 frontmatter 中设置 auth 字段，表示该文档需要权限查看。

     有权限的文档更新和初始化时要先运行一次 npm run build:auth，再运行 npm run build 打包。

   • cipher 路由权限，具体看该文件。

   目前仅有以上权限。

3. 文档排序，在 mdx/menu.js 中目标分类下配置 sort 字段，

   • 默认：按时间升序。
   • desc ：按时间降序排列。

4. 新增 md 文档，所有的文档便于统一管理，都在 posts 目录中。

   • 在 mdx/menu.js 文件中配置了的目录中的 md 文件将被自动注入路由。
   • 特殊情况下，不属于 mdx/menu.js 分类中的文档，如果要加入路由，在 mdx/other.js 中配置。

注意：

1. 要加入路由的 md 文件，名称不能包含 - 字符，这个字符在路由解析中被作为关键字使用了。
2. 项目中的大文件没有被 Git 记录，迁移的时候不要忽略这些文件，不然将永久丢失。

插件列表：

1. next-mdx-remote：加载解析 mdx。
2. gray-matter：同步解析 mdx 的 formatter，解析速度比 next-mdx-remote 块，只需要解析 formatter 时使用这个。
3. rehype-urls：修改 mdx 文档中的本地资源链接。
4. remark-gfm：支持 mdx 文档的表格语法。
5. @mapbox/rehype-prism：语法高亮。
6. remark-math：支持数学公式，选择 rehype-katex 插件对公式进行解析渲染。
7. rehype-katex：数学公式解析，是 KaTeX 的封装，样式需要在 KaTeX 中下载，现在是下载后放在本地的 assets/katex 中，并在全局引用。
8. rehype-slug-custom-id：给 <h1>...<h6> 标签增加 id（这里是将这些标签作为导航锚点）。
9. @jsdevtools/rehype-toc：将 <h1>...<h6> 标签解析为TOC，用作导航。

插件升级：

需要注意有些包要配合升级（如 next 14 以上的版本要 node 18 以上），可以隔几年升级一次，频繁升级，处理出现的问题太麻烦。

项目安装包升级后去 这个页面 测试是否正常，这个页面内容如果正常，说明升级成功。

1. 2024-07-01 注入攻击（已解决）：最近一段时间网站偶尔会跳出广告，发现是运行了外部注入的脚本导致的，做了如下处理：
   • 在 next.config.js 中配置了 Content-Security-Policy ，禁止加载不明来源的资源。
   • 在 next.config.js 中配置了 X-Frame-Options ，禁止嵌入非同源站点的 <iframe>。

1. npm run media：创建媒体页面数据。
2. npm run md：批量创建 md 文档。
3. npm run search：创建搜索数据。