使用hexo+github搭建免费个人博客详细教程

2017-07-06

一、博客搭建过程

1.创建github博客仓库，yzzplus.github.io

2.配置SSH key

1	$ cd ~/. ssh #检查本机已存在的ssh密钥

1	ssh-keygen -t rsa -C "邮件地址"

然后连续3次回车，最终会生成一个文件在用户目录下，打开用户目录，找到.ssh\id_rsa.pub文件，记事本打开并复制里面的内容，打开你的github主页，进入个人设置 -> SSH and GPG keys -> New SSH key,将刚复制的内容粘贴到key那里，title随便填，保存。

3.安装Node.js

4.安装hexo
利用 npm 命令即可安装。（在任意位置点击鼠标右键，选择Git bash）

1	npm install -g hexo

5.创建hexo文件夹
安装完成后，在你喜爱的文件夹下（如F:\hexo），执行以下指令(在F:\hexo内点击鼠标右键，选择Git bash)，Hexo 即会自动在目标文件夹建立网站所需要的所有文件。

hexo init

6.本地查看
现在我们已经搭建起本地的hexo博客了，执行以下命令(在F:\hexo)，然后到浏览器输入localhost:4000看看。http://localhost:4000

7.hexo目录结构

deploy #需要部署的文件
node_modules #Hexo插件
public #生成的静态网页文件
scaffolds #模板
source #博客正文和其他源文件，404、favicon、CNAME 都应该放在这里
  _drafts #草稿
  _drafts #草稿
themes #主题
  _config.yml #全局配置文件
package.json

8.全局配置 _config.yml

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site #站点信息
title:  #标题
subtitle:  #副标题
description:  #站点描述，给搜索引擎看的
author:  #作者
email:  #电子邮箱
language: zh-CN #语言    
# URL #链接格式
url:  #网址
root: / #根目录
permalink: :year/:month/:day/:title/ #文章的链接格式
tag_dir: tags #标签目录
archive_dir: archives #存档目录
category_dir: categories #分类目录
code_dir: downloads/code
permalink_defaults: 
# Directory #目录
source_dir: source #源文件目录
public_dir: public #生成的网页文件目录 
# Writing #写作
new_post_name: :title.md #新文章标题
default_layout: post #默认的模板，包括 post、page、photo、draft（文章、页面、照片、草稿）
titlecase: false #标题转换成大写
external_link: true #在新选项卡中打开连接
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
highlight: #语法高亮
  enable: true #是否启用
  line_number: true #显示行号
  tab_replace:
# Category & Tag #分类和标签
default_category: uncategorized #默认分类
category_map:
tag_map:
# Archives
0: 全部禁用
1: 禁用分页
2: 开启分页
archive: 2
category: 2
tag: 2
# Server #本地服务器
port: 4000 #端口号
server_ip: localhost #IP 地址
logger: false
logger_format: dev
# Date / Time format #日期时间格式
date_format: YYYY-MM-DD #参考http://momentjs.com/docs/#/displaying/format/
time_format: H:mm:ss
# Pagination #分页
per_page: 10 #每页文章数，设置成 0 禁用分页
pagination_dir: page
# Disqus #Disqus评论，替换为多说
disqus_shortname:
# Extensions #拓展插件
theme: landscape-plus #主题
exclude_generator:
plugins: #插件，例如生成 RSS 和站点地图的
- hexo-generator-feed
- hexo-generator-sitemap
# Deployment #部署
deploy:
  type: git
  repo: github仓库地址.git
  branch: master

注意:
配置文件的冒号“:”后面有一个空格
repo: 刚刚github创库地址.git

9.hexo命令

hexo help #查看帮助
hexo init #初始化一个目录
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成网页，可以在 public 目录查看整个网站的文件
hexo server #本地预览，'Ctrl+C'关闭
hexo deploy #部署.deploy目录
hexo clean #清除缓存，**强烈建议每次执行命令前先清理缓存，每次部署前先删除 .deploy 文件夹
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

10.编辑文章

1	hexo new "标题"

在 _posts 目录下会生成文件标题.md

title: Hello World
date: 2015-07-06 18:56:29 #发表日期，一般不改动
categories: hexo #文章文类
tags: [hexo,github] #文章标签，多于一项时用这种格式
---
正文，使用Markdown语法书写

编辑完后保存，hexo server 预览

二、总结

1.搭建过程中碰到很多问题，主要是自己对服务器环境不太熟悉，一旦配置错误很难找到原因。
2.搭建博客时也找到很多前端开发者的教程，在这里分享给大家。
-手把手教你建github技术博客——作者吴小龙同學
-使用hexo+github搭建免费个人博客详细教程——作者柳夏南
-Markdown 语法说明 (简体中文版)