问题描述
我有一个很大的Bookdown文档,我想将它作为HTML文件托管在网站上。我使用bookdown::gitbook
构建了网站,本地预览效果很好。但是,当我将html文件托管在网站中时,它们似乎失去了HTML样式,看起来非常糟糕。有什么解决方法吗?
编辑:将yaml添加到我的Index.Rmd文件的开头:
---
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应用服务站点。我的步骤:
- 设置Azure应用服务网站
- 创建Bitbucket存储库
- 从R正常构建Bookdown Gitbook(即按预期用途作为独立的html页面,而不是自包含的)
- 将Bookdown html文件和CSS文件推送到Bitbucket存储库
- 将Bitbucket存储库连接到Azure应用服务并部署
- 部署存在一个问题,该问题中的命令帮助解决了这个问题:https://stackoverflow.com/a/62016237/314763
此解决方案具有以下优点:
- 将Bookdown文件推送到Bitbucket很简单,因为它可以 使用Git自动化
- Azure应用程序服务可以具有身份验证 添加到它,这对我的团队来说是一种振作
我希望这对其他人也有帮助。