在win10下安装
需要的服务:
node.js
github账号
git

查询node.js

node -v

npm -v

出现版本号则安装成功

npm默认安装位置

默认路径C:\Users\Administrator\AppData\Roaming下的npm和npm-cache

修改方式:找到node安装路径,依次进入node_modules->npm,找到npmrc文件修改prefix,不知道是由于版本问题还是什么,网上很多教程里的npmrc文件里都有prefix和cache两个,而我npmrc文件却只有一个prefix。

prefix=D:\NodeJS\node_global

github配置key

在git中输入ssh-keygen -t rsa -C "youremail@example.com"

默认回车,然后输入俩次密码

找到你的id_rsa.pub打开复制,或者clip < ~/.ssh/id_rsa.pub

登录github,添加ssh keys

将复制的粘贴进去

在你的git输入 ssh -T git@github.com

输入你的密码

得到Hi name! You’ve successfully authenticated, but GitHub does not provide shell access.

详细教程

安装hexo

npm install -g hexo

可能下载会很慢

切换下载源

#获得原来的镜像地址
npm get registry
#设置为淘宝镜像
npm config set registry http://registry.npm.taobao.org/
#换成原来的
npm config set registry https://registry.npmjs.org/

初始化

cd D:/Hexo  #这里的路径是代码存放路径,重要!
hexo init
hexo g    #生成
hexo s    #启动

访问http://127.0.0.1:4000

安装主题

set-executionpolicy remotesigned

在你的hexo文件下

例子git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

在_config.yml中的theme:landscape修改成theme: yilia

然后执行hexo g生成,再次访问主题就发生改变

如果出现一些莫名其妙的问题,可以先执行hexo clean来清理一下public的内容,然后再来重新生成和发布。

上传到github中

配置_config.yml

deploy:
  type: git
  repository: git@github.com:liuxianan/liuxianan.github.io.git
  branch: master

安装插件

npm install hexo-deployer-git

提交到github中

hexo d  #提交

写博客

在source/_posts目录下使用hexo new命令,或者手动新建.md文件,写好后使用hexo d -g生成并上传,这样就可以通过yourname.github.io
访问博客

相关命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

#缩写
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

#组合命令
hexo s -g #生成并本地预览
hexo d -g #生成并上传

修改网站icon

准备
自己的图片:favicon.png

将图片放在Hexo/themes/yilia/source/img/中

找到Hexo/themes/yilia/layout/_partial/head.js,找到以下内容并修改为:

1
2
3
<% if (theme.favicon){ %>
<link rel="icon" href="/img/favicon.png">
<% } %>

删除默认READMAE文件

解决办法

我们在本地的source文件里新建一个README.md文件

修改Hexo根目录下的_config.yml文件,将skip_render参数的值设置为README.md

1
2
3
4
5
6
skip_render: README.md

// 为什么需要设置这一步呢?
// 因为你执行hexo g命令时,hexo会默认将source文件里的所有md文件渲染为html文件放到public中,
// 同时README.md会被渲染为README.html文件放到public文件里
// 加上这段设置,就是告诉hexo的解析器,你在渲染source文件里的md文件时,跳过README.md文件

新文章模板

1
2
3
4
5
6
7
8
9
10
11
12
---
title: My awesome title
date: 2016-10-12 18:38:45
categories:
- 分类1
- 分类2
tags:
- 标签1
- 标签2
mp3: http://domain.com/awesome.mp3
cover: http://domain.com/awesome.jpg
---