6.4 HTML 发布功能

6.4.1 HTML 404 页面

如果读者试图访问书籍中无法找到的页面，浏览器将因为找不到请求的网页而显示 404 错误。这个 404 错误显示在一个 404 页面上。每个 web 服务器都有一个默认的 404 页面。但是大多数 web 服务平台，如 Netlify、Github Pages 和 Gitlab Pages 都会将网站根目录中名为 404.html 的文件用作自定义的错误提示网页（如果你能提供该文件）。

对于全部 HTML 书记格式，bookdown 会在你的输出目录中使用简单的内容（一个标题和 2 段正文）创建一个自定义的 404.html；请见图 6.2。

展示一本在线 bs4_book 的屏幕截图，其中有侧边栏、页脚和 CSS 样式。文本为：未找到页面。找不到您请求的页面（可能已被移动或重命名）。您可能希望尝试搜索以查找页面的新位置，或使用目录查找您要查找的页面。

图 6.2: 示例 404 页面的屏幕截图。

如您所见，这个 404 页面嵌入在书中，以便读者能够快速返回正在阅读的书籍内容。网页书籍站点的整体结构（包括导航栏、页脚、侧边栏等）和 CSS 样式仍然保留在 404 页面上。

要自定义 404 页面而不是使用 bookdown 提供的页面，你可以向项目根目录中添加 _404.Rmd 或 _404.md 文件。如果在编译书籍时找到前述任何一个文件，则该文件内容将被编译并作为嵌入书籍结构中的 404 页面的主体内容。

如果一个 404.html 文件已经存在于根目录级别的书籍源文档仓库中（与书籍的 .Rmd 文件放在一起），那么 bookdown 将保持该文件不变，并且不会将它覆盖。这是因为我们假设你的发布工作流中已经有了使用这个自定义的 404.html 的机制。

6.4 HTML 发布功能

6.4.1 HTML 404 页面

6.4.2 用于共享的元数据