hexo+github博客搭建

hexo+github博客搭建

需求

• 将本地博客存放在DropBox云中,实现多设备读取本地博客
• 使用hexo构建博客系统
• 使用github作为远程仓库
• 使用gitee作为备用仓库
• 绑定域名,实现域名访问
• 本地使用ssh git方式推送,避免每一次推送输入用户名和密码

搭建步骤

安装必要环境

git
windows10 (非必须)
Hexo: 4.2 ~ 5.x
hexo-cli: 3.1 ~ 4.x
node.js: 12.16 ~ latest # 推荐使用 LTS 版
npm: 6.13 ~ latest

安装node,js:

https://nodejs.org/en/

安装git:

https://git-scm.com/

安装node.js 和git后进行测试:

$ npm -v
$ git --version

安装hexo:

因为我将blog文件存放在Dropbox云中,

而Dropbox本地文件在.Dropbox\XXX 若之间使用npm命令则会出现找不到包的问题

我这里的解决方法是:

1. 先在控制台使用npm 命令安装npm install hexo-cli -g

2. 将目录C:\Users\XXX\AppData\Roaming\npm 下的 node_modules和 hexo*相关的文件复制一份到.Dropbox\XXX\Blog\下

3. 在.Dropbox\XXX\Blog\下打开控制台继续执行安装hexo的命令

   # 安装 npm install hexo-cli -g
   # 测试版本
   $ hexo -v
   # 安装
   $ hexo init blog & cd blog & npm install
   # 浏览器访问 localhost:4000 测试 
   $ hexo server
   # 此时本地安装hexo已完成
   

   hexo文件树:

   .
   ├── _config.yml # 网站的配置信息，您可以在此配置大部分的参数。 
   ├── package.json
   ├── scaffolds # 模版文件夹
   ├── source  # 资源文件夹，除 _posts 文件，其他以下划线_开头的文件或者文件夹不会被编译打包到public文件夹
   |   ├── _drafts # 草稿文件
   |   └── _posts # 文章Markdowm文件 
   └── themes  # 主题文件夹
   

   如果遇到npm 安装 报错问题, 尝试删除 package-lock.json 再试

   hexo常用命令:

   hexo
   npm install hexo -g #安装  
   npm update hexo -g #升级  
   hexo init #初始化
   简写
   hexo n "我的博客" == hexo new "我的博客" #新建文章
   hexo p == hexo publish
   hexo g == hexo generate#生成
   hexo s == hexo server #启动服务预览
   hexo d == hexo deploy#部署
   
   服务器
   hexo server #Hexo 会监视文件变动并自动更新，您无须重启服务器。
   hexo server -s #静态模式
   hexo server -p 5000 #更改端口
   hexo server -i 192.168.1.1 #自定义 IP
   
   hexo clean #清除缓存 网页正常情况下可以忽略此条命令
   hexo g #生成静态网页
   hexo d #开始部署
   
   监视文件变动
   hexo generate #使用 Hexo 生成静态文件快速而且简单
   hexo generate --watch #监视文件变动
   
   完成后部署
   两个命令的作用是相同的
   hexo generate --deploy
   hexo deploy --generate
   
   hexo deploy -g
   hexo server -g
   
   草稿
   hexo publish [layout] <title>
   

安装hexo主题:

安装适合自己口味的主题

设置github

github 新建仓库,仓库名称为 XXX.github.io; XXX为你的用户名!

注意项:

1. ==仓库名称中XXX必须与用户名对应!!!!==
2. 方式为`public`

设置使用ssh方式推送

1. 查看本地C:\Users\XXX\.ssh 下有无id_rsa样式文件

2. 若无,创建新的ssh 密钥,

   $ ssh-keygen -T rsa -C 'github邮箱地址'
   # 回车继续, passphrase 密码可输入可不输
   

3. 复制.ssh目录下的id_rsa.pub中文件内容到github ssh keys管理中

   

4. 测试ssh

   $ ssh git@github.com
   

   若出现: ssh: connect to host github.com port 22: Connection refused 错误

   解决方法:

   1. XXX\.ssh目录下创建config文件

   2. config文件中写入下面的信息：

      Host github.com  User xxxxx@xx.com(github用户邮箱)  Hostname ssh.github.com  PreferredAuthentications publickey  IdentityFile ~/.ssh/id_rsa  Port 443
      

   3. 再使用ssh git@github.com测试

      

选择配置自己的hexo 主题(可选)

选择适合自己口味的blog主题即可

域名绑定github

1. 域名解析商解析方式选择CNAME; 站点为: XXX.github.io

2. xxx.github.io仓库中,setting选项Page中配置 Custom domain

   内容为你的域名,save保存

3. blog 根目录下的source文件中创建CNAME文件 (必须选项)

   内容为你的域名

   作用: 防止每次hexo推送博客后,域名解析失效,重新配置Custom domain