前言

Logseq 一直作为我所有知识的仓库,但是 Logseq 是本地的知识服务项目,不方便将自己的部分文章总结分享出去,并分享给特定的人查看,同时又需要保留它的双链接功能,所以在搜索一番后,部署了静态资源的 Logseq 可用于笔记分享,提交后自动化部署,故将这个过程写下。
说明:使用两个仓库而不是一个仓库分支的原因:提交时,git 仓库下载时下载极慢。

Logseq 网站发布流程

本地安装 Logseq 并创建笔记项目

  • Github 官网下载最新桌面版安装包

    • 创建一个文件夹用于笔记项目
    • 添加项目:左侧栏 -> Logseq -> 添加图谱 -> 选中创建的文件夹
    • 如下设置要发布的样式,更加定制化的可以调整显示主题可以 google
    • 图示:
      样式设置
  • 创建 Github 仓库

    • 本地文件夹 git 初始化并上传仓库做为源码仓库 source-repo
    • Github 上另创建一个仓库为发布仓库 public-repo

准备发布环境数据

  • Github token生成:Github 用户级别的 settings -> Developer settings -> Personal access tokens 下生成密钥注意给到仓库下所有的权限
  • ssh 密钥生成:在 PowerShell 下运行后生成一对公私钥
1
ssh-keygen -t rsa -m pem -b 4096 -C "youremailhere@example.com"
  • source-repo 下的项目级别的 setting -> Secrets -> Actions -> New secret 添加数据,Github token 数据填充为 Name: NOTEBOOK_PUBLISH_TOKEN, value: Github token数据 ;私钥数据:Name: NOTEBOOK_SHARE_KEY ,value: 私钥文件内容 注意Name名称在后续需要一致,后续yml文件内使用了到该变量
  • public-repo 下的项目级别的 setting -> Deploy keys -> Add deploy key; 添加公钥数据: Name:NOTEBOOK_SHARE_PUB_KEY ,value: 复制公钥文件内容
  • 选定需要发布的 public-repo 分支 为 main

创建发布 Github Action 的 yml 文件

  • 在source-repo 项目的根目录下创建 .github/workflows/publish.yml 文件
  • 复制文件内容:

验证创建编译是否成功

  • 在本地修改代码后,push 一次即可,查看 source-repo 的 Action 状态是否成功,编译成功则对应的 public-repo 分支内有对应的编译数据

选择对应的静态代码托管商进行静态代码的托管(具体操作不一样)

  • Vercel服务商账号登录状态下直接导入Github上的public-repo 然后部署发布即可展示