路由
Methanol 依托 pages/ 目录结构构建文件路由体系。
MDX / Markdown 页面
pages/about.mdx→/aboutpages/guide/index.mdx→/guide/(目录索引)
HTML 页面
你也可以在 pages/ 中放置纯 HTML 文件。构建过程中,Vite 将对其进行处理并输出至 dist/:
pages/custom.html→dist/custom.html(访问路径为/custom.html)
示例:
404 页面
创建 pages/404.mdx 即可自定义 404 Not Found 页面。该页面默认不会在导航中显示。
离线页面
创建 pages/offline.mdx 即可自定义内置 PWA 的离线回退页面。该页面默认不会在导航中显示。
hidden 与 exclude
hidden: true: 仅在导航菜单中隐藏,路由依然有效,用户仍可通过直接访问 URL 进入。exclude: true: 将在开发(dev)及构建(build)阶段被完全排除。若在目录的index.mdx中设置,则整个目录都会被排除。- 以
_或.开头的文件或目录将被系统自动忽略。