簡體   English   中英

將 Bookdown 構建為 HTML 會丟失樣式格式

[英]Building Bookdown to HTML loses styled formatting

我有一個很大的 Bookdown 文檔,我想將它作為 HTML 文件托管在網站上。 我使用bookdown::gitbook構建到一個網站,本地預覽看起來不錯。 但是,當我在網站中托管 html 文件時,它們似乎丟失了 HTML 樣式並且看起來很糟糕。 有什么解決方法嗎?

當我使用 Gitbook 構建 Bookdown 站點托管 HTML 時,漂亮的 Bookdown 樣式似乎消失了

編輯:在我的 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
    ---

找到了一個解決方案:將 Bookdown Gitbook 粉碎成一個獨立的 html 文件以托管在靜態站點上會導致糟糕的情況 + 額外的維護步驟,所以我最終放棄了靜態站點,轉而托管為 Azure 應用程序服務站點。 我的步驟:

  1. 設置 Azure 應用服務站點
  2. 創建一個 Bitbucket 存儲庫
  3. 像往常一樣從 R 構建 Bookdown Gitbook(即根據預期用途作為單獨的 html 頁面,而不是獨立的)
  4. 將 Bookdown html 文件 + css 文件推送到 Bitbucket 倉庫
  5. 將 Bitbucket 存儲庫連接到 Azure 應用服務並進行部署
  6. 部署存在一個問題,該問題中的命令幫助解決了該問題: https : //stackoverflow.com/a/62016237/314763

該解決方案具有以下優勢:

  • 將 Bookdown 文件推送到 Bitbucket 很簡單,因為它可以使用 Git 自動化
  • Azure 應用服務可以添加身份驗證,這對我的團隊來說是一種福利

我希望這對其他人也有幫助。

暫無
暫無

聲明:本站的技術帖子網頁,遵循CC BY-SA 4.0協議,如果您需要轉載,請注明本站網址或者原文地址。任何問題請咨詢:yoyou2525@163.com.

 
粵ICP備18138465號  © 2020-2024 STACKOOM.COM