# github 私有库创建pages的最简单的保姆级教程

本站使用的mdbook ，其他 hexo 或者gitbook 都一样一样

2022-10-22 最终放弃简单易用的mdbook 换到 golang开发的 hugo上，

关于 hugo私有库存部署脚本请查看在github上快速部署一个基于hugo的个人博客

首先第一步是创建一个私有库，用来存放md文件 dev.leiyanhui.com-src 分支也只需要一个main

再创建一个公开库 dev.leiyanhui.com-page 用来存放生成后的html

这两个库可以在不同的帐号下，后面你自己替换这两个库名称，还有邮箱和用户名

# 原理

在 dev.leiyanhui.com-page 打开github page 服务

在 dev.leiyanhui.com-src 用 github actions 自动生成html并推送到 dev.leiyanhui.com-src

# 首先你可能需要先搞定自动生产

先搞定 md到html的静态生成，无论是mdbook 还是 hexo，文章末尾有提供 mdbook的自动脚本 mdbook-公开库自己部署到自己.yml

放到 dev.leiyanhui.com-src/.github/workflows/ 文件后缀为yml 文件名无所谓

本文默认你已经会弄这个，如果不明白查看这个文章

# 然后准备自动推送相关的

经过我测试https 推送目前是存在问题的，还是建议使用ssh推送

# 在本机先弄一套密钥

    ssh-keygen -t rsa -C "joyanhui@qq.com"
    cd ~/.ssh 
    cat id_rsa  #这是私钥 记好
    cat id_rsa.pub #这是公钥 记好

win环境下自己搞定

# 再公开库添加公钥

打开公开库 dev.leiyanhui.com-page setting Deploy keys

链接： https://github.com/joyanhui/dev.leiyanhui.com-page/settings/keys

添加一个 Add new ，把前面公钥 id_rsa.pub 的内容粘贴进来名称随意

# 在私有库添加一个环境变量存私钥

打开私有库 dev.leiyanhui.com-page setting secrets actions

链接： https://github.com/joyanhui/dev.leiyanhui.com-src/settings/secrets/actions

添加一个 New repository secret 大概意思就是加密变量

名称随意，我这里使用名称 FOR_PAGE_SSHKEY 内容填写私钥id_rsa的内容

# 修改私有库的自动部署actions workflows文件

编辑私有库 mdbook-共有库自己部署到自己.yml 文件在 env:添加一个环境变量

    FOR_PAGE_SSHKEY: ${{ secrets.FOR_PAGE_SSHKEY }}

在 git commit 后面添加几行命令自动部署私钥

    mkdir -p ~/.ssh/
    echo "$FOR_PAGE_SSHKEY" > ~/.ssh/id_rsa
    chmod 600 ~/.ssh/id_rsa
    ssh-keyscan github.com >> ~/.ssh/known_hosts

在 git push origin 前面添加一个远程git

    git remote rm origin
    git remote add origin git@github.com:joyanhui/dev.leiyanhui.com-page.git

这就可以了

在合适的位置还要添加一个删除 rm -rf .github 不然公开库也自动执行这个yml了，然后肯定会失败

完整的配置文件参考文末 mdbook-私有库自动部署到公开库pages.yml

# 进阶

提升国内网访问
- 网站访问
  我用的dnspods 境外解析到 xxx.github.com 境内解析到国内cdn cdn再指向xxx.github.com
- src文件在线编辑和上传
  - gitcode 也有 DevOps 可以用
  - gitee 自动推送到 github gitee默认提供同步功能，目前还是免费的，但是gitee的md编辑器有点难用！
  - coding 自动推送到 github coding 有集成服务Jenkins 并且有香港和美国服务器让你运行集成服务代码，每个提供免费300分钟的执行时间，出发你一天24小时都在写都在提交不然其实也够用。

# hugo的自动部署

查看这里

# 我在用的 github/workflows actions 脚本

dev.leiyanhui.com-src/.github/workflows/mdbook-公开库自己部署到自己.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
name: mdbook
on:
  push:
    branches:
      - main

jobs:
  mdbook_build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
      with:
        fetch-depth: 0
    - name: 安装 mdbook
      run: |
        mkdir mdbook
        curl -sSL https://github.com/rust-lang/mdBook/releases/download/v0.4.14/mdbook-v0.4.14-x86_64-unknown-linux-gnu.tar.gz | tar -xz --directory=./mdbook
        echo `pwd`/mdbook >> $GITHUB_PATH
    - name: 编译 mdbook
      run: |
        echo "编译"
        mdbook build
        echo "分支到 gh-pages"
        git worktree add gh-pages
        #mkdir  gh-pages
        cd  gh-pages
        echo "删除 ref 以避免保留历史记录"
        git update-ref -d refs/heads/gh-pages
        rm -rf *
        mv ../book/* .
        echo "处理独立域名的绑定 CNAME文件"
        echo "dev.leiyanhui.com" >> CNAME
        
        echo  "推送到分支"
        git config user.name "joyanhui"
        git config user.email "joyanhui@qq.com"
        git init
        #git checkout -b main
        git add -A
        git commit -m "自动生成  $GITHUB_SHA to gh-pages"
        echo "推送 "
        git push origin gh-pages -f -q

dev.leiyanhui.com-src/.github/workflows/mdbook-私有库自动部署到公开库pages.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
name: mdbook
on:
  push:
    branches:
      - main

jobs:
  mdbook_build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
      with:
        fetch-depth: 0
    - name: 安装 mdbook
      run: |
        mkdir mdbook
        curl -sSL https://github.com/rust-lang/mdBook/releases/download/v0.4.14/mdbook-v0.4.14-x86_64-unknown-linux-gnu.tar.gz | tar -xz --directory=./mdbook
        echo `pwd`/mdbook >> $GITHUB_PATH
    - name: 编译 mdbook
      env:
        FOR_PAGE_SSHKEY: ${{ secrets.FOR_PAGE_SSHKEY }}
      run: |
        echo "编译"
        mdbook build
        echo "分支到 gh-pages"
        git worktree add gh-pages
        #mkdir  gh-pages
        cd  gh-pages
        echo "删除 ref 以避免保留历史记录"
        git update-ref -d refs/heads/gh-pages
        rm -rf *
        mv ../book/* .
        echo "处理独立域名的绑定 CNAME文件"
        echo "dev.leiyanhui.com" >> CNAME
        echo  "推送到分支"
        git config user.name "joyanhui"
        git config user.email "joyanhui@qq.com"
        git init
        #git checkout -b main
        git add -A
        git commit -m "自动生成  $GITHUB_SHA to gh-pages"
        echo "远程"
        
        mkdir -p ~/.ssh/
        echo "$FOR_PAGE_SSHKEY" > ~/.ssh/id_rsa
        chmod 600 ~/.ssh/id_rsa
        ssh-keyscan github.com >> ~/.ssh/known_hosts
        
        git remote rm origin
        git remote add origin git@github.com:joyanhui/dev.leiyanhui.com-page.git
       
        #推送
        git push origin gh-pages:main -f -q