Github搭建个人博客全攻略
- 一、Github
- 二、配置博客仓库
- 三、配置Git用户SSH密钥
- [四、Deploy Key or Token](#四、Deploy Key or Token)
-
- [方法一: Deploy Key](#方法一: Deploy Key)
- [方法二: Token](#方法二: Token)
- 五、Hexo
- [六、 主题](#六、 主题)
- [七、 发布博文](#七、 发布博文)
- 八、参考链接
一、Github
Github是开发者的代码仓库,一个开源和分享社区。
本文前提是已注册github账号。
二、配置博客仓库
假设用户名为MyName
- 进入个人主页(https://github.com/用户名),选择Repositories,点击New
- Repository name填入MyName.github.io,即MyName/
MyName.github.io
,点击Create Repository
三、配置Git用户SSH密钥
- 安装Git或TortoiseGit(后者添加环境变量)
- 打开git bash或命令行,执行
ssh-keygen -t ed25519 -C "your_email@example.com"
- 默认在C:/Users用户名/.ssh里找到id_ed25519.pub(如步骤2使用rsa则是 id_rsa.pub),记事本打开复制里面的内容
- 右上角头像进入Settings,选择SSH and GPG Keys,点New SSH Key,随意填入Title,Key粘贴步骤3的密钥,点击Add SSH Key
四、Deploy Key or Token
博客Hexo部署用到Deploy Key或者Token的方式,选其一即可
方法一: Deploy Key
- 进入仓库页面的Setting,选择Deploy Key,点击Add Deploy Key
- 密钥生成步骤同步骤三,生成的时候选择保存其他的文件名,复制密钥内容到Key栏
方法二: Token
- 点个人头像,选择Setting,再选Developer Settings,Person access tokens,点tokens (classic),Generate new Token(classic),填写信息,Expiration默认30天,Select scopes勾选repo栏即可
- 点击Generate token,复制生成的Token下一步使用
五、Hexo
- 下载安装node,添加环境变量,配置依赖下载路径
- 安装hexo
shell
npm install -g hexo-cli
npm install -g hexo-renderer-pug
npm install -g hexo-renderer-stylus
npm install -g hexo-deployer-git
- 建立博客,预览效果
shell
# 新建博客目录
mkdir blog
# 初始化hexo项目
hexo init blog
# 安装依赖
cd blog
npm install
# 生成静态文件
hexo generate
# 启动本地服务器 http://localhost:4000
hexo server
- Github部署
shell
# blog/_config.yml, token或ssh key选一个repo配置,每个:号后面必须带一个空格
url: https://MyName.github.io/MyName.github.io
deploy:
type: git
repo: https://上一步得到的token值@github.com/MyName/MyName.github.io
# repo: git@github.com:MyName/MyName.github.io.git
branch: master
message:
#执行部署
hexo deploy
六、 主题
shell
git clone https://github.com/主题仓库地址.git themes/主题名
# 编辑_config.yml
theme: 主题名
七、 发布博文
shell
hexo new post "How to build a bolg with Hexo on Github"
hexo clean
hexo generate
hexo deploy
登录https://MyName.github.io/即可查看发布的博文,更多知识点请上Hexo官网查阅。