quarto 创建博客

quarto
Author

Liripo

Published

January 2, 2024

1 使用 quarto 创建自己的博客

1.1 quarto的简单介绍

Quarto® 是在一款建立在pandoc上的开源的科学与技术排版系统，可以进行包含Python、R 、Julia、或 bash 等代码的自动化报告工作。

1.2 安装 quarto

这里推荐两个选择：

  1. 按照官网 介绍下载安装即可。

  2. 选择一个带 quarto 的 docker 镜像，我比较喜欢使用的是 rocker 项目的 tidyverse镜像。tidyverse镜像的基础镜像是rstudio 镜像，而目前新版本的rstudio 都会包含 quarto 软件。

ps: 我选择此镜像是顺便作为 R 方面开发的基础镜像。

# pull 镜像
docker pull rocker/tidyverse:latest
# 运行, 挂载自己本地的路径，我习惯将整个D盘挂载到镜像中。
docker run -d -ti -p 8787:8787 -e ROOT=TRUE -e PASSWORD=《你的密码》 -v 《本地路径，可以整个D盘》:《镜像目录》 rocker/tidyverse

这样，你就可以直接打开浏览器，输入网址 localhost:8787 开启 Rstudio IDE。 默认用户名：rstudio

1.3 quarto 创建 blog的详细步骤

没什么资源比官网的步骤更详细了

https://quarto.org/docs/websites/website-blog.html

1.4 发布博客

1.4.1 使用 github-pages 发布

网址前缀如：https://《用户名》.github.io 所示的网址就是使用的github-pages。

  1. 首先在 github 新建一个名称为 https://《用户名》.github.io 的仓库。

  2. 设置好仓库的pages选项，如下图所示：

  1. 按照上面的步骤，博客项目下会有_quarto.yml 文件，修改下此文件的输出目录。
_quarto.yml
project:
  type: website
  output-dir: docs
  1. 将 .nojekyll 文件添加到存储库的根目录，告诉 GitHub Pages 不要使用 Jekyll（GitHub 默认站点生成工具）对已发布的站点进行其他处理：
terminal
touch .nojekyll
  1. 渲染网站并发布
# quarto 渲染网站
quarto render
# 使用 git 将渲染好的网站发送到刚刚创建好的仓库中
git push