通过Hexo在Github上搭建博客教程

作者: Andrew_liu | 来源:发表于2014-11-23 14:06 被阅读23742次

Hexo简介


hexo是一个基于Node.js的静态博客程序,可以方便的生成静态网页托管在github和Heroku上。作者是来自台湾的@tommy351

A fast, simple & powerful blog framework, powered by Node.js.

为什么我要使用Hexo:

  1. 之前使用过CSDN,博客园和jekyll博客,其中前两个不能算是这个博客吧,主要是使用别的提供的平台发博文,第三个jekyll,我记得是Ruby语言写的,是Github Page着力推荐的, 但其中有繁琐的git操作, 而且有一些资源加载的问题(主要是我不太懂Ruby)
  2. 最近在学习JS后端Node.js, 现在火的不行, 异步IO的机制, 所以在学习过程中发现了Hexo
  3. Hexo更加简单优雅, 而且风格多变, 适合程序员搭建个人博客,而且支持多平台的搭建

使用的软硬件

Mac Pro    #软件的安装基本都是基于brew
Node.js    #v0.10.33
npm        #2.1.6 包管理,类似于Python中的pip

下面正式讲述如何部署:

1. Git安装和Github设置


使用Mac电脑可以直brew安装,

brew install git         #Mac电脑使用brew安装
sudo apt-get install git #Ubuntu系统使用这条命令安装

git操作和github上SSH设置请看这篇博文

使用Github Page搭建博客, 需要遵循一定的规则, 需要在github建立仓库,仓库名为Github用户.github.io, 更多详情请参考官方文档

2. Node.js安装


mac电脑可以直接通过brew安装

#安装命令
brew install node  #如果我没记错的话,最新版的node.js的包中已经集成了npm包管理工具

使用以下命令验证是否安装成功
node -v
npm -v

Node.js的详细内容请参考Node.js学习笔记

3. Hexo安装与设置


Node, npm和Git都安装成功, 开始安装hexo,

npm install hexo -g  #-g表示全局安装, npm默认为当前项目安装

Hexo使用命令:

hexo init <folder>  #执行init命令初始化hexo到你指定的目录
hexo generate       #自动根据当前目录下文件,生成静态网页
hexo server         #运行本地服务, 

浏览器输入http://localhost:4000就可以看到效果。

4. 添加博文


hexo new "postName"  #新建博文,其中postName是博文题目

博文会自动生成在博客目录下source/_posts\postName.md

#文件自动生成格式:
title: "It Starts with iGaze: Visual Attention Driven Networkingwith Smart Glasses"  #博文题目
date: 2014-11-21 11:25:38      #生成时间
tags: Paper                    #标签, 多个标签使用格式[Paper1, Paper2, Paper3,...]
---

如果不想博文在首页全部显示, 并能出现阅读全文按钮效果, 需要在你想在首页显示的部分下添加``

此处及以上的内容会在首页显示
<!--more-->
一下是在首页隐藏的部分

5. 主题更改


Hexo提供了官网的主题, 初始化hexo时也会自动生成一个主题, Hexo还支持个性定制主题, 可以根据自己的喜好对主题进行修改, 更多主题可以在官网中找到

  • 个性化博客的设置
    博客的根目录下对喜爱的主题进行主题进行克隆
git clone git@github.com:yunlzheng/hexo-themes.git themes/writing

#在./_config.yml,修改主题为writing
theme: writing

#查看本地效果
hexo g       #hexo generate简写
hexo s       #hexo server简写

6. 部署到Github


以上内容都是在本地进行查看, 现在将博客部署到github上
打开./_config.yml

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: Snow Memory    #博客名
subtitle: 雪忆, 如雪般单纯, 冷静思考.  #博客副标题
description:          #网站描述, 用于爬虫抓取的关键词
author: Andrew Liu    #作者名称
email: Liu.bin.coder@gmail.com  #作者邮箱
language: zh-CN       #网页编码,中文

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://andrewliu.tk   #用于绑定域名, 其他的不需要配置
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 # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
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
#Archives 默认值为2,修改为1,Archives页面就只会列出标题,而非全文
## 2: Enable pagination
## 1: Disable pagination
## 0: Fully Disable
archive: 1
category: 1
tag: 1

# 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
server_ip: localhost
logger: false
logger_format: dev

# 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: MMM D YYYY
time_format: H:mm:ss

# Pagination 分页, 设置每页显示多少篇博文
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Disqus  disqus评论,  与多说类似, 国内一般使用多说
disqus_shortname: 

# Extensions
## Plugins: https://github.com/hexojs/hexo/wiki/Plugins
## Themes: https://github.com/hexojs/hexo/wiki/Themes
theme: yilia    #主题设置
exclude_generator:

# Deployment  站点部署到github要配置这里, 非常重要
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: github    #部署类型, 本文使用Github
  repository: git@github.com:Andrew-liu/Andrew-liu.github.io.git  #部署的仓库的SSH
  branch: master   #部署分支,一般使用master主分支
plugins: 
- hexo-generator-feed   #此插件用于RSS订阅, 以后有时间再介绍

在配置文件中设置号部署设置后,

hexo deploy  #进行部署

Initialized empty Git repository in /Users/andrew_liu/Andrew-liu.github.io/.deploy/.git/
[master (root-commit) bb3079b] First commit
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 placeholder
[info] Clearing .deploy folder...
[info] Copying files from public folder...
[master 6e24e8d] Site updated: 2014-11-21 11:16:23
 172 files changed, 34969 insertions(+)
 create mode 100644 2014/09/08/Hello-World/index.html
 ...
 create mode 100644 "tags/\345\277\203\350\267\257\346\234\255\350\256\260/index.html"
To git@github.com:Andrew-liu/Andrew-liu.github.io.git
 + 11237d0...6e24e8d master -> master (forced update)
Branch master set up to track remote branch master from git@github.com:Andrew-liu/Andrew-liu.github.io.git.
[info] Deploy done: github


#表示部署成功

可以使用Github用户名.github.io进行访问, 或者设置个性域名

相关文章

网友评论

  • thinkhejie:如何升级hexo的版本?
  • 香脆的大鸡排:真棒,学习了
  • 巴图鲁:不错
  • stormxue:部署成功,但是无法通过使用Github用户名.github.io进行访问,这是什么原因?
  • Raybon_lee:亲,换电脑了,hexo 该如何操作呢, :smile: ,之前环境搭建在本地了,有没有托管平台
  • 我叫小灿灿:部署这块太复杂了,没看明白.
  • 我叫小灿灿:你的这个主页很好看,能告诉我是那个主题么?
  • Bianfei:正好需要
  • 606fd5f5448c:楼主,我也遇到了这个问题-bash: syntax error near unexpected token `newline'
  • Rancho1110:ranho@A56CM:~/MyBlog$ sudo hexo server
    Native thread-sleep not available.
    This will result in much slower performance, but it will still work.
    You should re-install spawn-sync or upgrade to the lastest version of node if possible.
    Check /usr/lib/node_modules/hexo/node_modules/hexo-util/node_modules/cross-spawn/node_modules/spawn-sync/error.log for more details
  • Hanwen1001:http://zhonghanwen.github.io/ 部署后访问404,请问是什么原因
  • 2f2ccef765c8:请问部署好了,为什么还是打不开呢,又没有报错。
  • Gutierrez:初始化了之后需要npm install
  • iHTCboy:安装hexo报错,改下面命令:

    sudo npm install --unsafe-perm --verbose -g hexo
  • 886955d2f2ad:博主你好,有一个问题,就是不管我使用的是哪一个主题,使用:http://localhost:4000都会显示和原本的不同,好像有很多css没有加载进来,试了很多主题都是这样子,hexo是3.1.1的版本,十分感谢。
  • 886955d2f2ad:博主你好,有一个问题,就是不管我使用的是哪一个主题,使用:http://localhost:4000都会显示和原本的不同,好像有很多css没有加载进来,试了很多主题都是这样子,hexo是3.1.1的版本,十分感谢。
  • aceebf116ba8:你好,请问hexo deploy之后,在github上相应的仓库中只有public文件夹中的内容,这样是对的么?我在本地localhost:4000显示正常的博客首页,而在github.io上,只有在public加个index.html才能显示html中的内容,不然就404。这是为什么呢……
  • 骨骨:执行 npm install hexo -g 这个命令后,等待了几分钟后出错了,不知道该怎么操作了,求助:

    ![](http://ww2.sinaimg.cn/large/674d24fegw1es87ctjie6j215011gwuu.jpg)
  • Andrew_liu: @原力烹小鲜 你试试放在source文件夹下
  • 加乘:@Andrew_liu 但现在问题又来了,不知为何每次deploy 后CNAME 文件就自动不见了好不开心😢请帮助我~~
  • 加乘: @Andrew_liu 现已正式入门yeah谢谢大大
  • 加乘: @Andrew_liu 现已正式入门yeah谢谢大大
  • Andrew_liu:@原力烹小鲜 启动hexo的内置调试server
  • 加乘:求问安装完毕后为何localhost没有反应??😢
  • Andrew_liu: @豆子糖 你加了$符号?
  • 豆子糖:$ hexo init <folder>这一步显示-bash: syntax error near unexpected token `newline'
    求解?
  • 杨少侠:@悟道问心 已解决 没有执行 npm install
  • 杨少侠: 你好,为什么我hexo s 后 出现的页面总是代码,诸如此类:
    <%- partial('_partial/head') %>
    <%- partial('_partial/header') %>
    <%- body %>
    <%- partial('_partial/footer') %>
    <%- partial('_partial/after-footer') %>
  • Andrew_liu:@fishwood 可以管理两个博客, git不需要账号, 你说的是github吧, 设置根据上面的来就行了
  • 3e354400518e:您好,感谢分享。初学者请教,我想同时管理两个博客,请问是否可行,是否复杂?需要两个git帐号?本机设置上需要注意哪些?谢谢
  • sH2nxy:@Andrew_liu 我再去看看吧,我这里一堆bug,完全不知道肿么回事
  • Andrew_liu:@Linyiem 是的, 你可以查看hexo官方部署文档
  • sH2nxy:repository: git@github.com:Andrew-liu/Andrew-liu.github.io.git #部署的仓库的SSH
    这句话的意思是说会把这些代码上传到git上你的Andrew-liu.github.io仓库里吗?
  • Andrew_liu: @Linyiem 代码在本地呀,命令会用git上床的
  • sH2nxy:@Andrew_liu 谢谢,deploy语句我看到了。其实我的问题是我一开始简历hexo文件夹的时候就没上传到git上面,然后用github客户端上传,多次提示failed。
    我想问你的代码是一早就放在github上的对吧?
    (git初学者)
  • Andrew_liu:@Linyiem deploy:
    type: github #部署类型, 本文使用Github
    repository: git@github.com:Andrew-liu/Andrew-liu.github.io.git #部署的仓库的SSH
    branch: master #部署分支,一般使用master主分支

    然后使用 hexo deploy部署, 查看文章最后
  • sH2nxy:我现在博客还在本地,还是通过localhost访问的。请问要怎么才能用域名访问呢
  • sH2nxy:刚才那个错误没有了,现在的错误是 hexo :command not found 已经安装了呀,也到了hexo文件夹目录下了,怎么显示找不到命令呢
    jnunp:@iHTCboy 不行啊 加上sudo就变成了 sudo :command not found
    iHTCboy:@Linyiem 出现以上错误是因为权限问题,在执行hexo命令前,加上sudo即可。
  • sH2nxy:安装hexo报错,错误代码贴不过来……
  • Andrew_liu:@机智的阿卡林酱 我在Mac下使用node -v正常打印版本好, 阿卡林酱有关注你的微博, 希望能交流一下
  • 帅灰:Mark
  • Andrew_liu:@侯爷 我一般使用多说, 感觉还不错
  • 侯爷:@Andrew_liu ok,我博客上用的评论模块就是disqus :grin:
  • Andrew_liu:@侯爷 已经修改了 感谢提醒
  • Andrew_liu:@侯爷 说错了, 这是一个外国的, 和多说类似
  • 侯爷:disqus不是多说

本文标题:通过Hexo在Github上搭建博客教程

本文链接:https://www.haomeiwen.com/subject/usrwtttx.html