Hexo+GitHub创建个人博客

2017-03-19 本文已影响94人 JSnail321

hoxo出自台湾大学生tommy351之手，是一个基于Node.js的静态博客程序，其编译上百篇文字只需要几秒。hexo生成的静态网页可以直接放到GitHub Pages，BAE，SAE等平台上。

环境搭建

安装Git

Git下载

安装Node

两种方式安装Node.js :

使用Git Bash的方式
$curl https://raw.github.com/creationix/nvm/master/install.sh | sh
$ nvm install stable （安装完成后需要执行该命令来重启终端)
通过下载安装程序
注意安装时，勾选Add to PATH选项

安装Hexo

Node和Git都安装好后，可执行如下命令安装hexo：
npm install -g hexo

GitHub

注册GitHub帐号
建立一个与用户名对应的仓库，格式必须是[usename.github.io]
添加ssh公钥 [Setting -> SSH and GPG keys -> New SSH key]
验证添加成功
ssh -T git@github.com

获取公钥详解

打开git bash
执行生成公钥和私钥的命令：ssh-keygen -t rsa 并按回车3下（为什么按三下，是因为有提示你是否需要设置密码，如果设置了每次使用Git都会用到密码，一般都是直接不写为空，直接回车就好了）。会在一个文件夹里面生成一个私钥 id_rsa和一个公钥id_rsa.pub。
执行查看公钥的命令：cat ~/.ssh/id_rsa.pub

查看博客

初始化
hexo init <folder>
或者cd到目标目录，执行hexo init
生成静态页面
hexo g
本地启动
hexo s
http://localhost:4000可查看效果

.deploy：执行hexo deploy命令部署到GitHub上的内容目录
public：执行hexo generate命令，输出的静态网页内容目录
scaffolds：layout模板文件目录，其中的md文件可以添加编辑
scripts：扩展脚本目录，这里可以自定义一些javascript脚本
-source：文章源码目录，该目录下的markdown和html文件均会被hexo处理。该页面对应repo的根目录，404文件、fav
icon.ico文件，CNAME文件等都应该放这里，该目录下可新建页面目录。
_drafts：草稿文章
_posts：发布文章
themes：主题文件目录
_config.yml：全局配置文件，大多数的设置都在这里
package.json：应用程序数据，指明hexo的版本等信息，类似于一般软件中的关于按钮

_config.yml简介：

# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site
title: Snail琳子 #网站标题
subtitle: stay hungry,stay foolish #网站副标题
description: #描述
author: JZM #作者
email: zm.jin@qq.com #联系邮箱
language: zh-Hans #语言
timezone: #时区

# URL #域名和文件结构
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: https://jzm1994.github.com/  #网址
root: /  #网站根目录
permalink: :year/:month/:day/:title/  #文章的 永久链接 格式
permalink_defaults:  #永久链接中各部分的默认值

# Directory 
source_dir: source        #资源文件夹，这个文件夹用来存放内容
public_dir: public        #公共文件夹，这个文件夹用于存放生成的站点文件
tag_dir: tags             #标签文件夹
archive_dir: archives     #归档文件夹 
category_dir: categories  #分类文件夹

# Writing #写文章选项
new_post_name: :title.md # File name of new posts
default_layout: post
auto_spacing: false
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
max_open_file: 100
multi_thread: true
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight: #代码高亮
  enable: true #是否启用
  line_number: true #是否显示行号
  auto_detect: true
  tab_replace:

# Category & Tag
default_category: uncategorized
category_map:
tag_map:
# Server #本地服务参数
## Hexo uses Connect as a server
## You can customize the logger format as defined in
## http://www.senchalabs.org/connect/logger.html
port: 4000
logger: true
logger_format:

# Date / Time format #日期显示格式
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss

# Pagination #分页设置
## Set per_page to 0 to disable pagination
per_page: 10 #每页10篇文章
pagination_dir: page

# Extensions #插件，暂时未安装插件
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

# Deployment #部署
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo:
      github: git@github.com:jzm1994/jzm1994.github.io.git
      coding: git@git.coding.net:jzm1994/jzm1994.git
  branch: master

hexo\themes\简介：

.
├── languages          #多语言
|   ├── default.yml    #默认语言
|   └── zh-CN.yml      #中文语言
├── layout             #布局，根目录下的*.ejs文件是对主页，分页，存档等的控制
|   ├── _partial       #局部的布局，此目录下的*.ejs是对头尾等局部的控制
|   └── _widget        #小挂件的布局，页面下方小挂件的控制
├── source             #源码
|   ├── css            #css源码 
|   |   ├── _base      #*.styl基础css
|   |   ├── _partial   #*.styl局部css
|   |   ├── fonts      #字体
|   |   ├── images     #图片
|   |   └── style.styl #*.styl引入需要的css源码
|   ├── fancybox       #fancybox效果源码
|   └── js             #javascript源代码
├── _config.yml        #主题配置文件
└── README.md          #用GitHub的都知道

命令

hexo n [layout] "博客标题" = hexo new [layout] "博客标题" #新建文章 layout指布局默认是post
hexo p = hexo public
hexo g = hexo generate #生成静态网页至public目录
hexo s = hexo service #启动服务本地预览
hexo d = hexo deploy #部署到Github/Coding
hexo clean #网页不能正常显示清除缓存
hexo g -d #复合命令
hexo new page "pageName" #新建页面

细节配置

主题

NextT主题
git clone https://github.com/iissnan/hexo-theme-next themes/next
启用NextT主题，打开hexo_config.yml，修改 theme 字段
theme: next
打开hexo\themes\next，编辑主题配置文件_config.yml

图标

在hexo\themes\modernist\layout_partial\head.ejs下，找到这句：
<link rel="icon" type="image/x-icon" href="<%- config.root %>favicon.ico">
将favicon.ico放到工程hexo\source下。可以在Faviconer制作ico图标，国内有比特虫。

摘要

以上是文章摘要以下是余下全文

统计

为hexo博客添加访问次数统计功能

多说第三方评论系统

在主题_config.yml中配置duoshuo_shortname：二级域名中的shortname
复制代码粘贴到 hexo\themes\next\layout_partial\comment.ejs里面：

<% if (config.disqus_shortname && page.comments){ %>
<section id="comment">
    #多说通用代码
</section>
<% } %>

分享服务商：多说,加网,bShare,百度分享。
加网添加方式：

在hexo\themes\modernist\layout_partial\post下新建jiathis.ejs文件
注册加网获得你的分享代码，写入jiathis.ejs
在hexo\themes\modernist\layout_partial\article.ejs中，添加<%-partial(‘post/jiathis’)%>。

404

GitHub Pages自定义404页面直接在根目录下创建404.html。404页面仅对绑定顶级域名的项目才起作用，GitHub默认分配的二级域名和使用hexo s在本机调试都不起作用。
腾讯公益404

图床

七牛云存储图片提供图片外链。

插件

RSS
npm install hexo-generator-feed --save
开启RSS
rss: /atom.xml

更新

更新hexo:
npm update -g hexo
更新主题:

cd themes/next
git pull

更新插件:
npm update

申请域名

搭建过程出现问题

Hexo博客，解析不了标题（#）

markdown标题标准写法需要在"#"和后面字符之间加一个空格
## hello world