美文网首页Web前端之路iOS精英班Android开发
使用Hexo+GitHub+个人域名搭建个人博客

使用Hexo+GitHub+个人域名搭建个人博客

作者: 僵尸粉YJ | 来源:发表于2017-08-23 15:06 被阅读1557次

    一、前言

    之前一直都是使用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_maptag_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:你注册域名了?如果注册域名了,将域名解析到你github pages的域名里,记录类型是CNAME。
      • 嘿_黑羊:和3楼的情况一样,在装有Node.js和Git的情况下,安装hexo会出现[Error: Cannot find module './build/Release/DTraceProviderBindings']的错误(Mac环境),解决方法是通过以下命令安装hexo:‘$ npm install -g hexo-cli’
      • hatboy911:不错,正考虑搭建一个个人博客的
      • 总是在你背后守护:按照你的方法搭建出错了 装hexo出错了
        总是在你背后守护:@僵尸粉YJ 先指出你的指导中的错误,在下载你的主题,在配置文件中写的不是maupassant,而是maupassant-hexo ,并且创建一个项目不是 用new 而是用init . 我装hexo的错我解决了
        僵尸粉YJ:要先安装Git和NodeJS的环境
        僵尸粉YJ:@总是在你背后守护 请问报什么错啊?或者我可以帮你解决
      • 梦想照旧实现:还有github pages,这个功能不错:+1:

      本文标题:使用Hexo+GitHub+个人域名搭建个人博客

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