网站设置
网站模板(template)风格参照了Mike Mahoney
字体风格(font family)参照了YiHui
网站维护
网站的基本架构:
(1)个人网站门户的Quarto项目为site-hhp
。其中“博文|Blog”直接在本项目内开发维护。网站门户有两个同步域名:
域名1:https://kevinhhp.netlify.app 。此域名为
netlify
服务器二级域名。静态站点文件夹(_site/
),直接通过命令上传到netlify
服务器。域名2:https:/www.huhuaping.com 。此域名为服务器域名。静态站点文件夹(
_site/
),将通过文件同步软件resilio
进行服务器的同步上传。为避免无效的反复上传,将进行关键提交点的手动控制上传。同时为保证resilio
同步功能的正常运行,需要使用pre-render:
和post-render:
指令(_quarto.yaml
)进行同步系统文件的来回复制和切换。
(2)独立quarto子项目的建设维护。主要包括:
“教学|Teaching”:
course-em
、course-emii
等。这类项目的输出结果,通过外部资源(resource)的方式,直接同步复制(单向同步)到门户项目的对应文件夹下,我们采用syncToy
软件进行同步管理。“项目|Project”:
books-quarto
、rworld
等。这类项目的输出结果,直接托管到netlify
站点服务平台,因此采用外部链接([text](url-path)
)的方式进行页面跳转。
网站发布
发布网站到netlify简单地有两种方式:
第一,直接使用publish command:
quarto publish netlify
,这将会把_site/
文件夹上传到netlify从而站点发布。第二,通过github进行触发式站点发布。需要管理netlify与R项目的github仓库。一旦R project进行了
git push
,则触发netlify的网站渲染。
测试R运算,显示计算结果。此时使用Quarto Netlify Build Plugin
来调用netlify的server渲染。
测试更新Quarto Netlify Build Plugin
到0.06版本,测试失败。官方说这是netlify的一个bug,目前不知道何时能解决。
更多尝试:
github API调用限制。 access limits。测试是否有限制。
外部资源external resource
需要配置yaml参数resource:
R运算及代码文件
尽量本地运行R代码,并保存结果到freeze。
尽量避免使用github action,这样会在CL远端执行R代码,因为这种运行很难保证未来持续性和可运行。