重定向与 404
静态托管环境缺少服务端逻辑(如 Nginx 规则)来处理动态路由。docmd 生成原生 HTML 保障机制以自动处理重定向和错误状态。
无服务器重定向
通过在 redirects 对象中定义映射,将旧 URL 的流量转发到新目标。
{
"redirects": {
"/setup": "/getting-started/installation",
"/v1/api": "/api-reference"
}
}
技术实现
当你定义重定向时,引擎在旧路径创建一个包含 <meta http-equiv="refresh"> 标签的 index.html 文件。此策略确保:
- 无缝重定向:用户立即转发到新目标。
- SEO 保留:搜索引擎识别重定向以保持链接权重。
- 分析追踪:在重定向发生前记录页面浏览。
品牌化 404 页面
当用户请求缺失的 URL 时,静态主机自动加载根 404.html 文件。docmd 默认生成此文件。它完美继承你网站的主题、侧边栏和 SPA 功能。
自定义错误内容
在配置中个性化 404 错误消息:
{
"notFound": {
"title": "404:页面未找到",
"content": "我们找不到您要查找的页面。使用侧边栏找到返回的路。"
}
}
本地开发
开发服务器自动为缺失的文件提供你的自定义 404 页面。在本地测试错误体验。