Joplin Publisher

简介

发布 Joplin 笔记到 GitHub，并通过 GitHub Actions 来自动化构建部署。

使用

GitHub

1. 如果你还没有的话，注册一个 GitHub 账户。
2. 使用模版项目 joplin-blog-template 作为模版创建一个新的仓库，名字是 <github username>.github.io
3. 修改 Settings > Pages > Build and deployment，选择 GitHub Actions
4. 创建一个 github token，至少选择 content 和 <github username>.github.io 仓库的权限，创建完成之后复制得到的 token

Joplin

1. 安装插件 https://joplinapp.org/plugins/plugin/rxliuli.joplin-publisher/
2. 打开 Joplin > Settings > Plugins > Publisher，分别设置 GitHub token/username/repo
3. 选择一个笔记，添加标签 blog
4. 点击 Tools > Publish to GitHub 发布

稍等两分钟，就可以前往 <github username>.github.io 查看你发布的笔记了。

你可以继续为希望发布的笔记添加标签 blog，然后重新运行 Publish to GitHub，这会将笔记更新到网站上。

配置

由于使用 Hexo 进行渲染，所以可以在创建的 GitHub 仓库中配置。目前使用的主题是 Fluid，也可以修改对应的主题配置。

例如，想要修改站点的标题，可以修改 _config.yml 中的 title

如果想要更新首页的背景图，可以修改 _config.fluid.yml 中的 index.banner_img

参考

• hexo 文档：https://hexo.io/
• fluid 主题的文档：https://hexo.fluid-dev.com/docs/en/guide/