使用说明

|-- assets                   => 自定义资源文件夹，存放几乎不更改的资源
    |-- 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       => 示例页
    |-- media
        |-- index.jsx        => 音视频页
    |-- mdx
        |-- [slug].jsx       => 文章页
|-- mdx                      => 所有的文章
    |-- menu.js              => 文章目录
    |-- other.js             => 其他目录
|-- public                   => 静态资源，由 Next 内置，不可修改名称
    |-- bigFiles             => 大资源, 不在 git 中记录
    |-- 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             => 其它通用函数

说明：

1. 增加文档分类，在 mdx/menu.js 中配置分类信息，分类最多支持三级。
2. 设置分类权限，在 mdx/menu.js 中目标分类下配置 auth 字段，使用 middleware 校验权限。
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：收集 public/media 的内容，生成 utils/media.js 文件，供媒体页面使用。
2. npm run md：批量创建 md 文档。
3. npm run search：创建搜索数据。