一、前言
之前一直都是使用Jekyll+GitHub搭建个人博客,但由于Jekyll是基于Ruby实现,搭建本地服务比较麻烦,我个人又对Ruby不熟悉,因此就转用Hexo搭建博客了。Hexo是基于NodeJS实现的,相对于Jekyll,实现Hexo的调试�环境就简单许多。
二、配置环境和创建项目
注:使用Hexo搭建博客前,电脑必须搭建好Git和NodeJS的环境;关于Git和NodeJS的安装方法,本文章不做介绍
1.安装Hexo
$ sudo npm install -g hexo
安装完后就可以初始化一个�项目
�2.初始化项目
$ sudo hexo init projectname
目录结构:
.
├── node_modules // 依赖
├── scaffolds // 脚手架、骨架
├── source // 资源文件夹
│ └── _posts // 新建的文章保存在这里
├── themes // 主题文件夹
│ └── landscape // 默认主题
├── _config.yml // 全局配置文件
├── package.json // 项目的参数和所依赖插件
_config.yml
全局配置文件;网站的名称、副标题、描述、作者、语言、主题、时间格式、URL、端口、代码高亮、部署等等参数
3.生成HTML静态页
$ hexo generate
或者
$ hexo g
4.启动服务预览
$ hexo server
或者
$ hexo s
启动服务后,在浏览器输入 http://localhost:4000/
即可访问。默认情况下,Hexo�服务启动的端口为4000,若端口被占用或想使用其他端口启动,则�运行命令:
$ hexo server -p 端口
如果不想每次启动时都输入端口,可以全局配置文件 _config.yml
中配置默认端口
修改
_config.yml
配置文件时,冒号:
和右边的直之间要有一个空格
server:
port: 8800 # 配置默认端口
上图为浏览结果,我个人觉得默认主题不好看;因此,我找了另一个主题。
三、修改主题
我的个人博客使用了 maupassant
主题,因此,我们也做这个主题做案例吧。
主题地址:https://github.com/tufu9441/maupassant-hexo
使用命令行进入 themes
文件夹,把主题克隆到�该目录下,执行命令:
$ git clone https://github.com/tufu9441/maupassant-hexo
接下来�就需要安装渲染器(强烈建议使用cnpm或其他国内镜像安装)
$ npm install hexo-renderer-jade@0.3.0 --save
$ npm install hexo-renderer-sass --save
然后我们打开项目根目录下的 _config.yml
全局配置文件,找到 theme
配置项,把 theme: landscape
设置为 theme: maupassant
克隆下来的主题文件夹为
maupassant-hexo
我已将它重命名maupassant
theme: maupassant
修改完主题配置,需要执行 hexo g
命令重新生成静态HTML,然后再执行 hexo s
启动服务
666666
这个主题好看多了
四、修改配置
修改语言
�细心的同学会发现,页面显示是英文;但我们需要的是中文。
首先,我们来看看主题 maupassant
目录下的 languages
都�有哪些语言
我们看到 zh-CN.yml
文件,所以该主题是支持简体中文的
我们再打开项目根目录下的 _config.yml
全局配置文件,找到 language
配置项,把 language:
设置为 language: zh-CN
language: zh-CN
接着,再�编译启动服务。
666666,居然变成了中文
修改分类、标签的访问链接
当我们给�文章添加一个分类或标签时,我们访问这个分类下的所有文章,会发现访问的URL是 http://domain/categories/分类名/
(如下图���),有时候我们可能不太想在URL里看到有中文字符,我们需要的路径为 http://domain/categories/classname/
,此时,我们需要给 分类名
设置一个别名。
在全局配置文件,找到 category_map
和 tag_map
配置项:
category_map:
分类一: class1
分类二: class2
tag_map:
标签一: tag1
标签二: tag2
修改HTML目标文件夹
我们执行 hexo g
命令�后,生成的HTML文件默认情况下是保存在 public
目录下的;如果我们想修改HTML文件保存的目录,�我们可修改全局位置文件下的:
public_dir: dir-name
关于修改配置,我们就说到这里;如果大家想设置网站标题、简介、开启评论等功能,可以看一下全局配置文件和主题目录下的配置文件。配置文件都有很详细的注释说明。
五、创建代码仓
�首先,我们需要有一个GitHub账户;然后创建一个名为 yourname.github.io
的�代码仓;yourname
为你的GitHub账号名。把 hexo g
命令后,把 public
文件夹的所有文件上传到该仓库中。
进入代码仓的 Settings
页面,开启 GitHub Pages
�配置好 GitHub Pages
后
yourname.github.io
为GitHub分配给您的域名(yourname
为你的账号);�此时,访问该域名即可访问你的博客了。
六、设置自定义域名
注册一个自己喜欢的域名,然后将域名解析到 yourname.github.io
解析完后,再回到 GitHub Pages
�设置域名
到此,我们已经成功使用Hexo+GitHub+个人域名搭建个人博客了。