一、整体思路

yuque_diagram.jpg

  • 【1】利用npm插件yuque-hexo-lyrics将语雀云端的文章同步到博客源码source/_posts文件夹下。
  • 【2】再利用GitHub Actions自动化部署将GitHub私有仓库（website）的博客源文件编译成静态博客文件并部署push到静态博客仓库（wztlink1013.github.io）下。

:::danger 但是以上【1】【2】两种方式并不能解决语雀一发布文章就触发GitHub源码仓库的GitHub Actions :::

  • 【3】所以需要中间TencentCloud云函数/Aliyun云函数，云函数的作用就是，语雀文章一经正式发布就触发云函数，从而云函数再触发GitHub私有的源码仓库下的GitHub Actions达到编译静态博客的效果。

    二、网站源文件配置

    插件npm地址【暂未GitHub开源】：https://www.npmjs.com/package/yuque-hexo-lyrics

yuque-hexo-lyrics插件使用

:::info 本人基于yuque-hexo项目修改的进阶插件 :::

【1】在开发环境当中下载插件（全局安装）

  1. npm i -g yuque-hexo-lyrics

【2】相关hexo命令

  1. yuque-hexo-lyrics clean # 清缓存删除yuque文件夹 删除yuque.json文件(更新之后的插件不删除yuque.json)
  2. yuque-hexo-lyrics sync # 从云端拉取到本地

【3】特别需要注意的是：开发环境语雀Token变量的传入

语雀为了防止用户恶意多次拉取数据，出于对知识库安全性的调整，使用第三方 API 访问知识库，需要传入环境变量 YUQUE_TOKEN，如果是本地使用建议使用环境变量，也可以是终端的方式输入。
image.png
如果是在GitHub Actions里面的环境执行yuque-hexo-lyrics sync命令的时候，通过如下命令传入语雀的token

  1. YUQUE_TOKEN=${{ secrets.YUQUE_TOKEN }} yuque-hexo sync

【4】最后的配置样式（本插件可以同时下载多个知识库）

  2.   "yuqueConfig_blog": {
  3.     "baseUrl": "https://www.yuque.com/api/v2",
  4.     "login": "wztlink1013",
  5.     "repo": "blog",
  6.     "postPath": "source/_posts/blog",
  7.     "cachePath": "yuque_blog.json",
  8.     "mdNameFormat": "slug",
  9.     "onlyPublished": false,
  10.     "onlyPublic": false,
  11.     "adapter": "hexo",
  12.     "timeout": "150s"
  13.   },
  14.   "yuqueConfig_essay": {
  15.     "baseUrl": "https://www.yuque.com/api/v2",
  16.     "login": "wztlink1013",
  17.     "repo": "essay",
  18.     "postPath": "source/_posts/essay",
  19.     "cachePath": "yuque_essay.json",
  20.     "mdNameFormat": "slug",
  21.     "onlyPublished": false,
  22.     "onlyPublic": false,
  23.     "adapter": "hexo",
  24.     "timeout": "150s"
  25.   },
  26.   "yuqueConfig_dsal": {
  27.     "baseUrl": "https://www.yuque.com/api/v2",
  28.     "login": "wztlink1013",
  29.     "repo": "dsal",
  30.     "postPath": "source/_posts/blog",
  31.     "cachePath": "yuque_dsal.json",
  32.     "mdNameFormat": "slug",
  33.     "onlyPublished": false,
  34.     "onlyPublic": false,
  35.     "adapter": "hexo",
  36.     "timeout": "150s"
  37.   },
  38.   "yuqueConfig_javascript": {
  39.     "baseUrl": "https://www.yuque.com/api/v2",
  40.     "login": "wztlink1013",
  41.     "repo": "javascript",
  42.     "postPath": "source/_posts/blog",
  43.     "cachePath": "yuqueConfig_javascript.json",
  44.     "mdNameFormat": "slug",
  45.     "onlyPublished": false,
  46.     "onlyPublic": false,
  47.     "adapter": "hexo",
  48.     "timeout": "150s"
  49.   },
  50.   "scripts": {
  51.     "build": "hexo generate",
  52.     "clean": "hexo clean",
  53.     "deploy": "hexo deploy",
  54.     "server": "hexo server"
  55.   }

更详细使用参考官方官方仓库。

GitHub Actions文件的配置

在博客源文件夹下新建如下GitHub Actions文件
.github/workflows/main.yml

文件内容配置如下

  1. # workflow name
  2. name: website to wztlink1013.github.io CI/CD
  4. on: [repository_dispatch, watch]
  6. jobs:
  7.   Deploy-Pages: 
  8.     name: website to wztlink1013.github.io
  9.     runs-on: ubuntu-latest
  11.     steps:
  12.     # check it to your workflow can access it
  13.     # from: https://github.com/actions/checkout
  14.     - name: Checkout Repository master branch
  15.       uses: actions/checkout@main 
  16.     # from: https://github.com/actions/setup-node  
  17.     - name: Setup Node.js 10.x 
  18.       uses: actions/setup-node@main
  19.       with:
  20.         node-version: "10.x"
  22.     - name: add Git infomations
  23.       run: | 
  24.         git config --global user.name '${{secrets.GIT_NAME}}' 
  25.         git config --global user.email '${{secrets.GIT_EMAIL}}'
  27.     - name: submit commit infomations
  28.       run: |
  29.         git log --pretty=format:"%s from Github Actions at `date +"%Y-%m-%d %H:%M:%S"`" --date=short -n 1  > commit-message.log
  31.     - name: npm istall hexo-cli、yuque-hexo、*
  32.       env:
  33.         YUQUE_TOKEN: ${{ secrets.YUQUE_TOKEN }}
  34.       run: |
  35.         npm install hexo-cli -g
  36.         npm install yuque-hexo-lyrics -g
  37.         npm install
  39.     - name: generate articles
  40.       run: |
  41.         hexo clean
  42.         yuque-hexo-lyrics clean
  43.         YUQUE_TOKEN=${{ secrets.YUQUE_TOKEN }} yuque-hexo-lyrics sync
  44.         hexo generate 
  46.     - name: push wztlink1013.github.io repository
  47.       env:
  48.         Github_Pages: github.com/wztlink1013/wztlink1013.github.io
  49.         Github_Token: ${{ secrets.token_GithubAPI }}
  50.       run: |  
  51.         git clone https://${Github_Token}@${Github_Pages} .github_pages
  52.         mv .github_pages/.git/ ./public/
  53.         cd ./public/
  54.         git add .
  55.         git commit -F ../commit-message.log
  56.         git push --force --quiet "https://${Github_Token}@${Github_Pages}" master:master

三、Serverless云函数配置

腾讯云serverless

:::info python2.7的配置 :::

  1. # -*- coding: utf8 -*-
  2. import requests
  4. def main_handler(event, context):
  5.     r = requests.post("https://api.github.com/repos/wztlink1013/website/dispatches",
  6.     json={'event_type': "run-it"},
  7.     headers = {"User-Agent":'curl/7.52.1',
  8.               'Content-Type': 'application/json',
  9.               'Accept': 'application/vnd.github.everest-preview+json',
  10.               'Authorization': 'token ***********'})
  12.     if r.status_code == 204:
  13.         return "This's OK!" 
  14.     else:
  15.         return r.status_code

:::info 触发器的设置 ::: image.png

阿里云serverless

记录一下Hexo自动化部署过程中阿里云平台的原函数配置的python代码 :::info python2.7 :::

  1. # -*- coding: utf-8 -*-
  2. import logging
  3. import requests
  5. # To enable the initializer feature (https://help.aliyun.com/document_detail/158208.html)
  6. # please implement the initializer function as below：
  7. # def initializer(context):
  8. #   logger = logging.getLogger()
  9. #   logger.info('initializing')
  11. def handler(event, context):
  12. #   logger = logging.getLogger()
  13. #   logger.info('hello world')
  14. #   return 'hello world'
  15.     r = requests.post("https://api.github.com/repos/wztlink1013/blog-source/dispatches",
  16.     json={'event_type': "run-it"},
  17.     headers = {"User-Agent":'curl/7.52.1',
  18.               'Content-Type': 'application/json',
  19.               'Accept': 'application/vnd.github.everest-preview+json',
  20.               'Authorization': 'token f43964836a33dce244385bc303c8c20adc1bd52194'})
  22.     if r.status_code == 204:
  23.         return "This's OK!" 
  24.     else:
  25.         return r.status_code
  26. # # -*- coding: utf8 -*-
  27. # import requests
  29. # def main_handler(event, context):
  30. #     r = requests.post("https://api.github.com/repos/wztlink1013/blog-source/dispatches",
  31. #     json={'event_type': "run-it"},
  32. #     headers = {"User-Agent":'curl/7.52.1',
  33. #               'Content-Type': 'application/json',
  34. #               'Accept': 'application/vnd.github.everest-preview+json',
  35. #               'Authorization': 'token 144a87bd45e62ff1cf30dc18880787917bc7865417'})
  37. #     if r.status_code == 204:
  38. #         return "This's OK!" 
  39. #     else:
  40. #         return r.status_code

:::info python3版本 :::

  1. # -*- coding: utf-8 -*-
  3. import logging
  4. import requests
  5. OK = b'ok\n'
  7. def handler(environ, start_response):
  8.     status = '200 OK'
  9.     response_headers = [('Content-type', 'text/plain')]
  10.     sync_yuque()
  11.     start_response(status, response_headers)
  12.     return [OK]
  14. def sync_yuque():
  15.     requests.post("https://api.github.com/repos/wztlink1013/Blog3.0/dispatches",
  16.     json={'event_type': "run-it"},
  17.     headers={"User-Agent":'curl/7.52.1',
  18.               'Content-Type': 'application/json',
  19.               'Accept': 'application/vnd.github.everest-preview+json',
  20.               'Authorization': 'token f43964836a33dce415385bc303c8c20adc1bd52194'})

:::info