手把手教你建github技术博客by hexo

原创 2016年08月29日 17:06:55

适合人群

  • 喜欢写Blog的人
  • 有一定的编程基础
  • 爱折腾的人
  • 熟练使用版本控制Git
  • 了解使用Github
  • 熟悉基本的MarkDown语法

环境准备

安装Git

下载 msysgit 并执行即可完成安装。

安装Node.js

在 Windows 环境下安装 Node.js 非常简单,仅须下载安装文件并执行即可完成安装。

安装hexo

利用 npm 命令即可安装。(在任意位置点击鼠标右键,选择Git bash)

npm install -g hexo

问题
* npm ERR! registry error parsing json 错误

可能需要设置npm代理,执行命令

npm config set registry http://registry.cnpmjs.org
  • hexo:command not found
    删除刚刚安装的npm目录,重新执行命令npm install -g hexo安装hexo,

创建hexo文件夹

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

hexo init

安装依赖包

npm install

本地查看

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

hexo generate
hexo server

好了,至此,本地博客已经搭建起来了,只是本地哦,别人看不到的。下面,我们要部署到Github。

问题
* 执行hexo server提示找不到该指令
解决办法:
在Hexo 3.0 后server被单独出来了,需要安装server,安装的命令如下:

npm install hexo -server --save 

安装此server后再试,问题解决

github 创建博客

注册账号

地址:https://github.com/
输入账号、邮箱、密码,然后点击注册按钮.
1

创建页面仓库

这个仓库的名字需要和你的账号对应,格式: yourname.github.io
输入基本信息,然后点击创建仓库.
2
3
注意
命名规则:你的github账号.github.io,我这里被坑了,之前是jekell写的,现在换成hexo,所以我是另建创库了。

生成SSH密钥

ssh-keygen -t rsa -C “你的邮箱地址”,按3个回车,密码为空。

在C:\Users\Administrator.ssh下,得到两个文件id_rsa和id_rsa.pub。

在GitHub上添加SSH密钥

打开id_rsa.pub,复制全文。https://github.com/settings/ssh ,Add SSH key,粘贴进去。

hexo使用

目录结构

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

全局配置 _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
2: 开启分页
1: 禁用分页
0: 全部禁用
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 #部署,将 lmintlcx 改成用户名
deploy:
  type: git
  repo: 刚刚github创库地址.git
  branch: master

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

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

编辑文章

新建文章

hexo new "标题"

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

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

编辑完后保存,hexo server 预览

hexo部署

执行下列指令即可完成部署。

hexo generate
hexo deploy

hexo deploy问题:Deployer not found: git
执行

npm install hexo-deployer-git --save

重新deploy即可

以下提示说明部署成功

[info] Deploy done: git

点击 Github 上项目的 Settings,GitHub Pages,提示Your site is published at http://wuxiaolong.me (这是我买的域名)

图床

1.墙裂推荐七牛云储存,注册地址

2.七牛云储存提供10G的免费空间,以及每月10G的流量.存放个人博客图片最好不过了

3.七牛云储存还有各种图形处理功能、缩略图、视频存放速度也给力(非打广告)。

具体使用见使用七牛作为github博客的图床

域名

将独立域名与GitHub Pages的空间绑定

方法一:在站点source目录下面,新建一个名为CNAME的文本文件,里面写入你要绑定的域名,比如wuxiaolong.me
方法二:在Repository的根目录下面,新建一个名为CNAME的文本文件,里面写入你要绑定的域名,比如wuxiaolong.me

DNS设置

DNSpod,快,免费,稳定。
注册DNSpod,添加域名,如下图设置。

其中A的两条记录指向的ip地址是github Pages的提供的ip
如何知道你的github上项目的IP,如下:

去Godaddy修改DNS地址

更改godaddy的Nameservers为DNSpod的NameServers。

微信公众号


欢迎微信扫一扫关注我的公众号。

插件

2016.08.20更新

安装插件

安装插件:npm install 插件名 –save
卸载插件:npm uninstall 插件名
更新插件和博客框架:npm update

执行以下命令安装 RSS 插件

npm install hexo-generator-feed --save

生成站点地图

npm install hexo-generator-sitemap --save

生成百度站点地图

npm install hexo-generator-baidu-sitemap --save

SEO优化

npm install hexo-generator-seo-friendly-sitemap --save

HTML压缩

npm install hexo-html-minifier --save

CSS压缩

npm install hexo-clean-css --save

JS压缩

npm install hexo-uglify --save

imagages压缩

npm install hexo-imagemin --save

插件开启配置

根目录下的 _config.yml,添加以下代码:

# RSS
feed:
type: atom
path: atom.xml
limit: 20

# sitemap
# 提交给谷歌搜素引擎,SEO优化开启配置是一样的
sitemap:
    path: sitemap.xml
# 提交百度搜索引擎   
baidusitemap:
    path: baidusitemap.xml 

# HTML压缩
html_minifier:
  exclude:     
# css压缩
clean_css:
  exclude: 
    - '*.min.css'
# js压缩   
uglify:
  mangle: true
  output:
  compress:
  exclude: 
    - '*.min.js'
# image压缩    
imagemin:
  enable     : true
  interlaced : false
  multipass  : false
  optimizationLevel: 2
  pngquant   : false
  progressive: false     

package.json可以看安装了哪些插件。

Hexo Seo优化让你的博客在google搜索排名第一

总结

之前用的jekell写的,手把手教你建github技术博客by jekyll,也是折腾了几天才做成自己满意的,昨天决定换成hexo,也是花了一天半时间,为了追求更好,必须折腾!

关于作者

点击查看

参考文献

版权声明:本文为博主原创文章,未经博主允许不得转载。

手把手教你使用Hexo + Github Pages搭建个人独立博客

本文原始链接:手把手教你使用Hexo + Github Pages搭建个人独立博客 作者:令狐葱 本文基于 知识共享署名-相同方式共享 4.0 国际许可协议发布,欢迎转载,演绎或用于商业目的,但是必...

手把手教你使用Travis CI自动部署你的Hexo博客到Github上

这年头要是没有个博客都不好意思给别人说你是程序员,我用XX笔记呀,不行吗?不行,这玩意儿要么不能公开分享,要么公开分享要会员,现在到处都是开源,自己学到了东西都不能分享给需要帮助的人,真是伤心呀。那么...

手把手教你用Hexo+Github 搭建属于自己的博客

大概可以分为以下几个步骤 搭建环境准备(包括node.js和git环境,gitHub账户的配置) 安装Hexo 配置Hexo 怎样将Hexo与github page 联系起来 怎样发布文章 主题 推...

手把手教你用Hexo+Github 搭建属于自己的博客

手把手教你用Hexo+Github 搭建属于自己的博客
  • lile777
  • lile777
  • 2017年05月27日 14:44
  • 889

手把手教用 Hexo + Github pages搭建属于自己的博客

对于每一个自己写过博客的同学来说,拥有自己的个人博客站点是一件很让人值得兴奋的事情,接下来就让我们一起来利用“Hexo + Github pages“搭建属于自己的个人博客吧……^^...

GitHub hexo搭建个人博客

  • 2017年06月10日 23:53
  • 1.37MB
  • 下载

Hexo+Github从零搭建技术博客

作为一名技术开发人员,搭建一个属于自己的博客,记录自己,沉淀自己,还是很重要的。年前给自己定一个目标:搭建博客,记录成长。之后,你懂的,就有下面的内容。附上博客地址:http://awenzeng.m...

免费搭建个人技术博客 Github and Hexo

个人技术博客地址:http://songmingyao.com/ 免费搭建个人技术博客 Github and Hexo

手把手教从零开始在GitHub上使用Hexo搭建博客教程(四)-使用Travis自动部署Hexo(2)

前言 前面一篇文章介绍了Travis自动部署Hexo的常规使用教程,也是个人比较推荐的方法。 前文最后也提到了在Windows系统中可能会有一些小问题,为了在Windows系统中也可以实现使用Trav...
  • SeayXu
  • SeayXu
  • 2016年06月03日 17:33
  • 432

手把手教从零开始在GitHub上使用Hexo搭建博客教程(三)-使用Travis自动部署Hexo(1)

前言 前面两篇文章介绍了在github上使用hexo搭建博客的基本环境和hexo相关参数设置等。 基于目前,博客基本上是可以完美运行了。 但是,有一点是不太好,就是源码同步问题,如果在不同的电脑上写文...
  • SeayXu
  • SeayXu
  • 2016年06月03日 17:33
  • 432
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:手把手教你建github技术博客by hexo
举报原因:
原因补充:

(最多只允许输入30个字)