演示系统: macOS:
静态网页框架: Hexo
云主机选择: GitHub
安装
包管理工具安装Homebrew
具体可以参考Homebrew的安装
node.js安装
1 | brew install node |
Hexo的安装
1 | npm install hexo-cli -g |
npm -g表示全局安装
更多信息: Hexo
博客创建
初始化
进入到博客的安放位置,然后输入
1 | hexo init your_blog_name |
该命令会创建一个your_blog_name的文件夹,并在文件夹内下在需要的东西。完成创建后,利用cd命令进入your_blog_name文件夹,然后在本地查看博客效果
1 | cd your_blog_name |
也可以简写为hexo s,然后在浏览器中命令行中出现的地址,即可查看博客的默认效果
1 | http://localhost:4000/ |
按下ctrl+c即可退出
最终能得到下面的效果图,表示成功
更多信息: Hexo
博客上传
密钥创建
具体可以参考免密登陆
GitHub新建repository
登陆GitHub账号,点击右上角头像左边的加号,选择new repository
在Owner处输入GitHub用户名,在Repository name处输入XXX.github.io。XXX与GitHub用户名要一致,也要和Owner里面的名字相同
点击create repository,完成repository创建。
免密上传配置
利用下述命令查看生成的密钥
1 | cat ~/.ssh/id_rsa.pub |
点击头像,选择setting,对GitHub进行配置
在左边的目录框中选择SSH and GPG keys,然后点击new SSH key
将密钥复制到刚才尚未填写key中,Title可任意填写。填写完成后,检查是否通过ssh密钥能否连接到Github。
1 | ssh -T git@github.com |
如果显示输出出现了你的GitHub用户名,那么ssh密钥设置成功。
上传插件安装
为了简化上传步骤,我们需要下载一个Hexo的git插件。在安装插件前,确保在your_blog_name文件夹内,然后再进行插件的安装
1 | npm install hexo-deployer-git --save |
插件安装完成后,对your_blog_name/_config.yml进行相关配置
1 | deploy: |
根据上面的代码提示,可以知道现在需要获取repo的名字,点击头像,选择your profile
在Popular repositories 中点击刚刚创建的XXX.github.io
在code选项卡中,选择SSH选项,点击右边的复制,将git指令填在XXX的位置上
最后得到
1 | deploy: |
注意: type、repo、branch前面均有两个空格。若需要同时上传至多个repo,配置如下
1 | deploy: |
完成配置后,对博客上传功能进行测试
1 | hexo deploy |
等待上传完成,刷新页面,在浏览器的地址栏中输入下面的地址即可查看效果
1 | XXX.github.io |
hexo主题更改
在Hexo主题找到喜欢的主题,下载到themes文件夹内,然后修改_config.yml文件中的主题一栏
1 | # Extensions |
建议查看主题的使用说明,以避免插件不全而导致主体失效。注意: 上传时先清空缓存,再重建上传
1 | hexo clean && hexo g -d |
g表示generate,生成静态文件,然后-d上传
更多信息: 本文部分参考该视频
README.md文件的创建
- 在source下创建README.md
- 在_config.yml的skip_render关键字后加入README.md
注意空格
如果不加入skip_render,执行 hexo g -d 部署博客的时候会发现README.md变成README.html1
skip_render: README.md