【问题标题】:Building Bookdown to HTML loses styled formatting将 Bookdown 构建为 HTML 会丢失样式格式
【发布时间】:2021-01-03 17:31:01
【问题描述】:

我有一个大型 Bookdown 文档,我想将它作为 HTML 文件托管在网站上。我使用bookdown::gitbook 构建网站,本地预览看起来不错。但是,当我在网站中托管 html 文件时,它们似乎失去了 HTML 样式并且看起来很糟糕。有什么解决方法吗?

已编辑:在我的 Index.Rmd 文件开头添加 yaml:

   --- 
    title: "Team Documentation"
    author: "Maxx"
    date: "Updated on `r Sys.Date()`"
    knit: "bookdown::render_book"
    site: bookdown::bookdown_site
    bibliography: [book.bib]
    biblio-style: apalike
    link-citations: yes
    colorlinks: yes
    lot: yes
    lof: yes
    fontsize: 13pt
    monofontoptions: "Scale=0.7"
    description: "This is a collection of commonly used information and how-to documents"
    output:
      bookdown::gitbook:
        self_contained: true
        css: css/style.css
        split_by: section+number
        config:
          toc:
            collapse: section
            before: |
              <li><a href="./index.html">Documentation</a></li>
            after: null
          toolbar:
            position: fixed
          edit: null
          download: null
          search: yes
          sharing: false
          info: yes
      bookdown::html_book:
        css: css/toc.css
    ---

【问题讨论】:

  • 服务器无法找到(自定义?)CSS 文件。你能提供一个MWE吗?
  • @M. A. 好点 - 我从上面的 .Rmd 文件中添加了 yaml。该问题可能与self_contained: true 有关 - 我试图创建一个独立的 HTML 文件输出可能存在问题。感谢您的回复,我将创建一个 MWE。

标签: html bookdown gitbook


【解决方案1】:

得出一个解决方案: 将 Bookdown Gitbook 粉碎成一个独立的 html 文件以托管在静态站点上会导致错误 + 额外的维护步骤,因此我最终放弃了静态站点并托管为 Azure 应用程序服务站点。我的步骤:

  1. 设置 Azure 应用服务站点
  2. 创建 Bitbucket 存储库
  3. 像往常一样从 R 构建 Bookdown Gitbook(即根据预期用途作为单独的 html 页面,而不是独立的)
  4. 将 Bookdown html 文件 + css 文件推送到 Bitbucket repo
  5. 将 Bitbucket 存储库连接到 Azure 应用服务并部署
  6. 部署存在一个问题,该问题中的命令帮助解决了该问题:https://stackoverflow.com/a/62016237/314763

此解决方案具有以下优势:

  • 将 Bookdown 文件推送到 Bitbucket 很简单,因为它可以 使用 Git 实现自动化
  • Azure 应用服务可以进行身份​​验证 添加到其中,这对我的团队来说是一项福利

我希望这对其他人也有帮助。

【讨论】:

    猜你喜欢
    • 2020-07-05
    • 2019-11-11
    • 1970-01-01
    • 1970-01-01
    • 2019-10-25
    • 1970-01-01
    • 2019-12-29
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多