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 
  5. 22811726113558\_.pic.jpg

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 发布 publish 1

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

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

配置

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

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

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

参考