基于Hexo构建博客并且部署到Github上
Contents
一个简单的Hexo构建博客的入门资料
环境准备
- 注册一个Github账号
这一步就忽略不说了 - 下载Node安装(如果有需要可以配置path路径)
Node可以下载对应操作系统的安装版本,安装后会自动设置path - 安装hexo
执行命令1
$ npm install -g hexo
- 初始化hexo
创建自定义目录用来存放hexo项目,在这个目录下执行命令:1
$ hexo init
构建博客页面
- 在之前生成的hexo项目的目录下执行命令:
1
$ hexo g # 这个是命令 hexo generate 的简写
- 可以看到在当前目录下生成了一个public的目录,这个目录就是你博客页面
- 启动本地server查看页面 执行命令:
1
$hexo s # 这个命令是hexo server的简写
- 在浏览器输入 localhost:4000查看效果
博客风格设置
拷贝别人已经设计好的风格
1.1 下载别人写好的风格文件夹并且放到项目目录的themes 目录下面
1.2 然后更改项目根目录下的_config.yml的文件中的 theme: thems_name
修改博客的theme
2.1 找到你当前使用的theme的文件夹,在其中有一个_config.yml文件。
2.2 打开这个文件进行编辑即可以修改页面布局和一些其他的内容。
发表或者编辑文章
- 在项目目录的 ./source/_posts 目录下的 *.md文件就是文章内容,可以是用文本编辑器打开编辑
- 文件的格式:(注意所有冒号后面都要有一个空格)
title: postName #文章页面上的显示名称,可以任意修改,不会出现在URL中
date: 2013-12-02 15:30:16 #文章生成时间,一般不改,当然也可以任意修改
categories: example #分类 可选,设置了的会自动归类
tags: [tag1,tag2,tag3] #文章标签,可空,多标签请用格式,注意:后面有个空格
这里是正文
- 摘要显示可以是用<!--more-->放在作为摘要的文字后面
title: Hello
这里是摘要
这里是正文
部署博客到网络上
- 使用github提供的空间可以部署刚刚用hexo构建的博客:
- 在github上创建衣和用户名相关的项目(名字格式是固定的), 例如:luoyuan800.github.io
- 将刚刚构建的hexo项目下的public文件夹中的都push到git项目中(拷贝后push)
- 访问 http://luoyuan800.github.io 即可以查看博客。(将其中的luoyuan800换成你的用户名)
- 如果发现不能访问的话,确认名称的格式,还有git用户中要配置一个已经verify的邮箱。
配置评论系统
默认的静态网页是不提供评论的,而Hexo这个框架搭建的博客默认是可以简单设置使用disqus搭建评论
而国内用户没办法是用disqus,可以选择使用多说(duoshuo)。
- 去多说的网站http://duoshuo.com/ 注册一个账号(可以使用第三方QQ微博之类的登录)然后注册一个shortname
- 我是使用Jacman(Theme)的模块搭建博客的,那么只需要打开这个Theme的文件下面的_config.yml文件,找到其中的#### Comment这一段,然后在对应的duoshuo_shortname后面添加你的shortname就可以加载评论模块了
配置站内搜索
我使用的是jacman主题,这个主题可以简单的配置基于Google,百度, tinysou这个三种站内搜索工具。
因为Google访问比较麻烦,百度检索的收录速度超级慢,我选择了tinysou这个工具。
- 打开tinysou
- 选择立即注册(免费版),用邮箱注册一个账号并且验证
- 进入控制台创建一个Engines
- 进入你创建的Engines的管理页面,点击爬虫选项卡,在其中添加博客的域名(luoyuan800.github.io)
- 打开hexo项目中themes文件夹中的jacman文件夹中的_config.yml文件, 修改一下内容:
tinysou_search: ## http://tinysou.com/
enable: true
id: engine key ## e.g. “4ac092ad8d749fdc6293” for your tiny search id - 在Hexo项目目录下的sources文件夹下面创建一个search文件夹
- 在刚刚创建的文件夹下面创建一个index.md文件,其中填写内容
layout: search title: search ---
添加RSS功能
jacman主题漠然开启RSS模块,不过如果你直接使用点击RSS只会返回404。因为HEXO默认是没有生成RSS文件的
- 安装hexo的rss插件
$ npm install hexo-deployer-git --save
- 编辑项目文件下的_config.yml文件添加如下内容
feed:
type: atom #feed 类型 (atom/rss2)
path: atom.xml #rss 路径
limit: 20 #在 rss 中最多生成的文章数(0显示所有) - 重新构建网站并且上传到你的网站空间
$ hexo g
注:以上所有修改完成后都需要重新构建项目然后发布public文件下的文件才可以看到效果。