博客搭建

GitHub Page 静态网页托管

创建仓库，请使用<username>.github.io命名你的仓库

博客部署后，如果部署分支与仓库page的分支不同，需要配置仓库page指定分支

博客编写规范

一、文章标题规范

标题较少，较清晰的文章，可以不使用标题编号来梳理

标题较多，标题层级较复杂的文章，需要使用标题编号来梳理

标题编号：
一级标题 1.
二级标题 1.1
三级标题 1.1.1
...

mkdocs 博客框架

Mkdocs部署

mkdocs部署指令：$ mkdocs gh-deploy

该命令生成静态文件site，并且以默认分支gh-pages（添加参数修改 -remote-branch main）

推送到默认远程仓库origin（添加参数修改 --remote-name github.io）

使用 "mkdocs gh-deploy" 指令不加参数时，需要将git pages的Branch选择为gh-pages分支即可显示页面

一、mkdocs环境搭建

Material for MkDocs 可以使用pip来完成安装:

pip install mkdocs-material

二、mkdocs新建博客

该指令帮助生成最简单的博客文件夹
mkdocs new <filename>

<filename>
├─ docs/
│  └─ index.md
└─ mkdocs.yml

Hexo 博客框架

一、Hexo环境配置搭建

• 1.安装Git

  验证cmd：git --version

• 2.安装Nodjs

  Nodjs

  验证cmd：npm version

二、Hexo新建博客

• npm安装hexo

  安装cmd：npm install hexo-cli -g

  验证cmd：hexo -version

• hexo初始化：

  方法1.创建一个文件夹，例如../blog，命令行(git)在该路经下使用 hexo init

  方法2.hexo init blog，这会在在当前命令行(git)路径下创建一个blog文件夹

• 安装组件：

  在blog路径，命令行(git) npm install

三、生成、预览、部署

• 预览页面(hexo server)：$ hexo s

  将生成本地连接http://localhost:4000来预览 这是本地的实时预览，也就是本地的任何修改，都可以马上在这里看见预览效果

• 生成页面(hexo generate)：$ hexo g

  生成部署页面 .deploy.git 再通过部署推送到github托管

• 部署页面(hexo deploy):$ hexo d

  需要配置好_config.yml下的deploy，来部署博客，例如

  deploy:
      type: git
      repo: git@github.com:Xuser7/Xuser7.github.io.git
      branch: main
  

  需要确保git ssh可以连通哦，才能部署成功