静态托管环境缺少服务端逻辑(如 Nginx 规则)来处理动态路由。docmd 生成原生 HTML 保障机制以自动处理重定向和错误状态。

无服务器重定向

通过在 redirects 对象中定义映射,将旧 URL 的流量转发到新目标。

{
  "redirects": {
    "/setup": "/getting-started/installation", 
    "/v1/api": "/api-reference"                  
  }
}

技术实现

当你定义重定向时,引擎在旧路径创建一个包含 <meta http-equiv="refresh"> 标签的 index.html 文件。此策略确保:

  1. 无缝重定向:用户立即转发到新目标。
  2. SEO 保留:搜索引擎识别重定向以保持链接权重。
  3. 分析追踪:在重定向发生前记录页面浏览。

品牌化 404 页面

当用户请求缺失的 URL 时,静态主机自动加载根 404.html 文件。docmd 默认生成此文件。它完美继承你网站的主题、侧边栏和 SPA 功能。

自定义错误内容

在配置中个性化 404 错误消息:

{
  "notFound": {
    "title": "404:页面未找到",
    "content": "我们找不到您要查找的页面。使用侧边栏找到返回的路。"
  }
}
本地开发

开发服务器自动为缺失的文件提供你的自定义 404 页面。在本地测试错误体验。