（一）需要

我想搭一个本人的博客网站。

（二）计划

1、思路

  • 先实现手动打包后，能后公布到GitHub Pages；
  • Github Actions 实现提交代码CICD 自动化部署；

2、用的技术

  • Docusaurus
  • Markdown
  • GitHub Pages
  • Github Token
  • Github Actions

3、手动装置实现步骤

装置步骤Docusaurus官网有

https://www.docusaurus.cn/doc...

（1）装置脚手架
npx create-docusaurus@latest my-website classic

装置后，我的项目目录如下：

my-website├── blog│   ├── 2019-05-28-hola.md│   ├── 2019-05-29-hello-world.md│   └── 2020-05-30-welcome.md├── docs│   ├── doc1.md│   ├── doc2.md│   ├── doc3.md│   └── mdx.md├── src│   ├── css│   │   └── custom.css│   └── pages│       ├── styles.module.css│       └── index.js├── static│   └── img├── docusaurus.config.js├── package.json├── README.md├── sidebars.js└── yarn.lock
目录阐明：
/blog/ - 蕴含博客的 Markdown 文件。如果你敞开了博客性能，则能够将此目录删除。你还能够通过设置 path 参数来扭转此目录的名称。在 博客性能指南 文档中能够找到更多详细信息/docs/ - 蕴含文档的 Markdown 文件。可在 sidebars.js 中自定义文档在侧边栏中的程序。如果你敞开了文档性能，则能够删除该目录。你还能够通过设置 path 参数来扭转此目录的名称。在 文档性能指南 中能够找到更多详细信息/src/ - 非文档文件，例如独立页面（pages）或自定义的 React 组件。你不用严格地恪守将非文档文件放到这里，然而将它们集中在此目录下能够更轻松地进行治理，以便您须要进行某些格局校验或解决/src/pages - 此目录中的任何扩大名为 JSX/TSX/MDX 文件都将被转换为网站的独立页面(page)。 能够在 独立页面（pages）指南 中找到更多详细信息/static/ - 寄存动态文件的目录。此处的所有内容都将被复制到最终的 build 目录的根目录下/docusaurus.config.js - 蕴含站点配置的配置文件。与 Docusaurus 1 中的 siteConfig.js 文件等价/package.json - Docusaurus 网站也是一个 React 应用程序。你能够在其中装置和应用所需的任何 npm 软件包/sidebars.js - 生成文档时应用此文件来指定侧边栏中的文档程序
（2）本地启动命令
cd my-websitenpm run start
（3）配置文件
这四个文件不能错。
url: 'https://iguoxing.github.io',baseUrl: '/iguoxing/',organizationName: 'iguoxing', // Usually your GitHub org/user name.projectName: 'iguoxing.github.io', // Usually your repo name.
（4）本地打包

npm run build

（5）手动发布命令
GIT_USER=iguoxing USE_SSH=true yarn deploy

4、主动部署实现步骤

（1）新建gh-pages分支
（2）根目录建设.github/workflows/documentation.yml文件

文件配置如下

# Copyright 2022 zhaoguoxing# # Licensed under the Apache License, Version 2.0 (the "License");# you may not use this file except in compliance with the License.# You may obtain a copy of the License at# #     http://www.apache.org/licenses/LICENSE-2.0# # Unless required by applicable law or agreed to in writing, software# distributed under the License is distributed on an "AS IS" BASIS,# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.# See the License for the specific language governing permissions and# limitations under the License.name: Deploy Arden Github pageson:  push:    branches:      - mainjobs:  build-and-deploy:    runs-on: ubuntu-latest    steps:    - name: Checkout      uses: actions/checkout@main      with:        persist-credentials: false    - name: Install and Build      run: |        npm install        npm run-script build     - name: Deploy      uses: JamesIves/github-pages-deploy-action@releases/v3      with:        ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN }}        BRANCH: gh-pages        FOLDER: build        BUILD_SCRIPT: npm install && npm run build
（3）配置GitHub AccessToken

https://docs.github.com/cn/au...

（4）提交代码后，就能实现了

这是我实现的成果；
https://iguoxing.github.io/ig...

5、记录卡住我的几个问题

（1）[Docusaurus Error] Running git push command failed. Does the GitHub user account you are using have push access to the repository?
organizationName 名称用 GitHub用户名；
（2）This workflow has no runs yet.
批改分支名为main

参考链接

https://juejin.cn/post/693684...

写在最初的话

学习路上，经常会懈怠

《有想学技术须要监督的同学嘛~》
https://mp.weixin.qq.com/s/Fy...