一、前言
之前一直都是使用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 主题,因此,我们也做这个主题做案例吧。
使用命令行进入 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 我已将它重命名 maupassanttheme: maupassant
修改完主题配置,需要执行 hexo g 命令重新生成静态HTML,然后再执行 hexo s 启动服务
666666
这个主题好看多了
四、修改配置
修改语言
�细心的同学会发现,页面显示是英文;但我们需要的是中文。
首先,我们来看看主题 maupassant 目录下的 languages 都�有哪些语言
我们看到 zh-CN.yml 文件,所以该主题是支持简体中文的
我们再打开项目根目录下的 _config.yml 全局配置文件,找到 language 配置项,把 language: 设置为 language: zh-CNlanguage: 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+个人域名搭建个人博客了。
作者:僵尸粉YJ
链接:https://www.jianshu.com/p/e1bead7da6ca