运用Hugo创立静态博客，并托管在Github Pages上-天涯论坛

6hz7vif 发表于 2024-10-3 05:24:42

运用Hugo创立静态博客，并托管在Github Pages上

<h1 style="color: black; text-align: left; margin-bottom: 10px;">从netfily迁移到github pages</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">netfily被封</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 其实，早在3年前，我刚创立新博客的时候，便是托管在netfily上的，本博客的第1篇内容《运用Hugo和Netlify创立静态博客，并托管在Github上》 https://www.zhangshengdong.com/post/hugo_and_netlify/ ，便是在写这件事。
 但火速，netfily的登陆因为用到了google的脚本，被大陆封了。只是针对像我这般的老用户，只是不可登录罢了，新文案依然能够自动从github仓库里同步发布，因此亦就没留意。
 可是两天前，我新写了一篇博客，本地hugo编译没问题，可是netfily却始终编译不成功。但即使翻墙，亦没法登录查看原由。只好起始思虑寻找新的托管网站。
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">运用github pages</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 在知乎上对比了一圈托管网站，发掘国内的大多要钱，或设置繁杂。最方便运用的，好似亦便是github pages了。但这般一来，就无了免费cdn，网页加载速度慢了许多。
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">github流水线</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">自动化流程</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 github pages最好是设置一个名为username.github.io的仓库。但很不巧的是，我的博客源码之前便是保留在我的blog仓库中。而github pages生成的二级域名，针对网站好似不太友好。因此只能设计一个自动化流程：在源码blog仓库中，设置github action，自动编译静态网页；将编译出的public文件夹上传至新的BZ-coding组织的BZ-coding.github.io仓库；将BZ-coding.github.io仓库选取master分支自动发布github pages网页。
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">hugo github action</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 在blog仓新增自动编译hugo的github action：
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 # Sample workflow for building and deploying a Hugo site to GitHub Pages 
 name: Deploy Hugo site to Pages 
 on: 
 # Runs on pushes targeting the default branch
 push: 
 branches: ["master"] 
 # Allows you to run this workflow manually from the Actions tab
 workflow_dispatch: 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions: 
 contents: read 
 pages: write 
 id-token: write 
 # Allow one concurrent deployment 
 concurrency: 
 group: "pages"
 cancel-in-progress: true 
 # Default to bash 
 defaults: 
 run: 
 shell: bash 
 jobs: 
 # Build job 
 build: 
 runs-on: ubuntu-latest 
 env: 
 HUGO_VERSION: 0.102.3 
 steps: 
 - name: Install Hugo CLI
 run: | wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_Linux-64bit.deb \ && sudo dp公斤 -i ${{ runner.temp }}/hugo.deb
 - name: Checkout 
 uses: actions/checkout@v3 
 with: 
 submodules: recursive 
 - name: Build with Hugo
 run: | 
 echo "pwd is " 
 pwd 
 ls 
 hugo --minify --verbose 
 - name: Display 
 run: | 
 echo "github.workspace is ${{ github.workspace }}" 
 ls ${{ github.workspace }}
 echo "github.workspace public is ${{ github.workspace }}/public" 
 ls ./public 
 - name: Deploy 
 uses: peaceiris/actions-gh-pages@v3 
 with: 
 deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }} # 这儿的 ACTIONS_DEPLOY_KEY 则是上面设置 Private Key的变量名
 external_repository: BZ-coding/BZ-coding.github.io # Pages 远程仓库 
 publish_dir: "./public"
 keep_files: false # remove existing files 
 publish_branch: master # deploying branch commit_message: ${{ github.event.head_commit.message }}
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">自动上传至网页发布仓</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 在上面脚本的最后，加入了把编译结果文件上传至另一个仓库的代码：
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 - name: Deploy 
 uses: peaceiris/actions-gh-pages@v3 
 with: 
 deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }} # 这儿的 ACTIONS_DEPLOY_KEY 则是上面设置 Private Key的变量名
 external_repository: BZ-coding/BZ-coding.github.io # Pages 远程仓库 
 publish_dir: "./public" 
 keep_files: false # remove existing files
 publish_branch: master # deploying branch commit_message: ${{ github.event.head_commit.message }}
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 其中，需要把目的账号里的ssh公钥，对应的私钥，配置在blog仓库的secrets里。
 并且，这边的上传，此刻好似不可分成两个job，否则好似会public里为空。
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">配置自动发布网站和自定义域名</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 把网页发布仓BZ-coding/BZ-coding.github.io，里的github pages配置成master的根目录。

 而后在BZ-coding账号里验证zhangshengdong.com域名之后，就能够在github pages配置的自定义域名里配上www.zhangshengdong.com了。还能够强制打开https。
</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">处理自定义域名自动消失的问题</h1>
<h1 style="color: black; text-align: left; margin-bottom: 10px;">
 然则随后发掘，每次网页代码更新后，BZ-coding.github.io的自定义域名就会消失。
 经搜索，得知，要在生成的网站根目录里添加CNAME文件，文件内容就写你想自定义的域名就行，例如www.zhangshengdong.com 。
 <img src="https://p3-sign.toutiaoimg.com/tos-cn-i-qvj2lq49k0/75862a46107d43ba8530e313f0f28ee7~noop.image?_iz=58558&from=article.pc_detail&lk3s=953192f4&x-expires=1728086133&x-signature=RxOppCKdq%2B2xb3F4tQXJjTsuAFQ%3D" style="width: 50%; margin-bottom: 20px;">
</h1>

b1gc8v 发表于 2024-10-19 20:46:56

感谢楼主分享，祝愿外链论坛越办越好！

页: [1]

天涯论坛's Archiver

运用Hugo创立静态博客，并托管在Github Pages上