hexo+github搭博客

hexo+github搭建博客网站

官方教程

  详细教程查看文档 | Hexo

安装git

1、设置用户信息

1
2

git config --global user.name "xxx" # 用户名
git config --global user.email  "xxx@xxx.com" # 邮箱

2、生成新的SSH key

1

ssh-keygen -t rsa -C "邮箱地址"

3、添加SSH key到GitHub

  登录GitHub，点击右上角的 Account Settings—>SSH Public keys —> add another public keys
  然后把~.ssh\id_rsa.pub中的内容粘贴进去

4、github上建立仓库

  点New Repository，注意Repository名字是特定的，Github Pages Repository名字必须是账号名.github.io

安装nodejs

1、下载

淘宝镜像下载压缩版的二进制文件zip包

2、配置环境

解压zip，在电脑系统环境中修改Path路径，添加在结尾添加;C:\Program Files\node-v10.16.3-win-x64
Path=...;C:\Program Files\node-v10.16.3-win-x64;

3、命令验证

1
2

node -v  
npm -v

4、配置全局模块安装目录

  可以配置全局模块安装目录，文件会保存至 「全局模块的安装目录node_modules」「缓存目录npm-cache」

1
2
3

npm config set prefix "C:\Program Files\node-v10.16.3-win-x64"  
npm config set cache "C:\Program Files\node-v10.16.3-win-x64\npm-cache"
npm install xxx -g #  全局安装xxx，可选参数 -g，g 代表 global，全局安装的意思

5、npm更换淘宝镜像

1

npm config set registry https://registry.npm.taobao.org

安装 Hexo

1、安装

  要在cmd管理员模式下进行安装，命令如下

1
2

npm install -g hexo-cli # 安装hexo
hexo -v # 查看版本

2、建立博客文件夹

  自己建立一个文件夹放博客相关的文件，如mblog，下面命令对博客文件夹进行初始化

1
2
3

cd mblog
hexo init
npm install

3、安装 Git 相关模块

1
2
3

npm install hexo-deployer-git --save # 将文章部署到github上的模块
npm install hexo-generator-feed --save # 安装RSS插件
npm install hexo-generator-sitemap --save # 添加Sitemap,加速网页收录速度

4、配置远端地址

编辑 _config.yml 【：的后面是有一个空格的，不然后面会出错】

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

deploy:  
type: git  
repository: git@github.com:test/test.github.io.git,master

//或者
deploy:
type: git
repo: https://github.com/JiLuanxi/jiluanxi.github.io.git
branch: 
message: 

//参数解释
repo：直接复制 Repo 的URL即可
branch：默认 push 到哪个分支。如果为空，则默认 push 到 master 分支
message：默认提交信息。如果为空，则默认为 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}

5、使用hexo

1

hexo g && hexo s # 在本地生成静态页面并预览

6、hexo主要目录

  _config.yml：整个站点的配置文件
  source/_posts： 发表的博文目录
  source/_drafts：彩稿文件目录
  themes：主题文件目录
  public：执行hexo g命令，输出的静态网页内容目录
  scaffolds：layout模板文件目录，其中的md文件可以添加编辑
  source：文章源码目录，该目录下的markdown和html文件均会被hexo处理。该页面对应repo的根目录，404文件、favicon.ico文件，CNAME文件等都应该放这里，该目录下可新建页面目录。

7、主题

  简洁美观：https://xaoxuu.com/wiki/stellar

8、常用命令

1
2
3
4
5

hexo n  # == hexo new 建立新文章，默认在_posts下，layout="draft"时发布的是草稿
hexo p  # == hexo publish 将_drafts下的文件放到_posts下，也就是发布草稿
hexo g  # == hexo generate 生成静态网页
hexo s  # == hexo server 启动预览服务器，开启-d选项时可以预览草稿
hexo d  # == hexo deploy 发布到远程服务器，开启--generate选项可以在deploy前自动generate