美文网首页
使用Hexo+Github搭建属于自己的博客

使用Hexo+Github搭建属于自己的博客

作者: iamzhaozekai | 来源:发表于2017-11-08 06:52 被阅读0次

    因为图片占用 Github 太多空间,现在已经放弃 GithubPage 了,但是还是把以前的搭建过程记录一下,说不定哪天又要用到了。

    一、环境和工具


    1.1 安装 Git:

    1.2 安装 Node.js

    • 下载地址:Nodejs官网
    • 安装教程: 一路 Next 即可,默认会安装 nodejs 和 npm 于 /usr/local/bin/ 目录下,由于该目录默认已经添加到 PATH 环境变量,所以安装完成之后可以直接使用node -v命令查看是否安装成功
      nodejs_install_result

    1.3 安装Hexo

    • 什么是Hexo: Hexo官方文档。Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

    • 安装教程:使用下面的命令来下载和安装 Hexo

      npm install hexo-cli -g
      //或者
      npm install hexo -g --no-optional
      

      这里 -g 代表全局安装,这样 hexo 包将放在 /usr/local/lib/node_modules (Windows 位于 ~/AppData/Roaming/npm/node_modules),不带的话是本地安装,将放在当前目录的 node_modules 下

      我在 Mac OS X 上使用不带 --no-optional 方式安装会出现 DTraceProviderBindings MODULE_NOT_FOUND 的错误,加上可以解决,应该是缺少某些 module,具体不是很清楚。

      CLI = Command Line Interface 命令行界面。我的理解是:hexo-cli 是 hexo 的命令行模式,类似于 Git Bash 和 Git 的关系

    1.4 注册github账号

    这里我们就不多讲了,请进入 官网 进行注册

    1.5 创建github pages

    • 什么是github pages: 官方教程
    • 创建 github pages 对应仓库:在github上创建一个名字为 your_github_name.github.io 的 repository

    二、在本地创建博客


    1. 初始化博客环境

    第一次创建博客目录,首先创建一个文件夹作为博客根目录,然后进入该目录在这里执行

    // 初始化hexo环境
    hexo init
    // 使用npm安装所需的组件
    npm install
    

    这样我们以后就可以在该目录里进行博客创作

    2. 发表一篇新文章

    我们可以使用下面命令来创建一篇新的文章,或者直接将文章放到 <blog_root>/source/_posts 目录里

    hexo new "文章标题"
    

    3. 生成博客静态网页

    使用下面命令将 source 文件生成静态网页,生成的文件放在<blog_root>/public 目录下

    hexo generate
    

    4. 将网页发布到server端

    hexo server
    

    最后我们就可以通过浏览器访问服务器网页。这里我们还没配置server信息,所以server其实还是本机(http://localhost:4000

    三、部署到github pages


    接下来我们开始 commit to github,这样才可以在github.io上看到我们的博客。这个很简单,首先在全局配置文件 _config.yml 里的 deploy 部分进行配置,其中 repo为你的github pages对应的仓库地址(yourname.github.io ):

    deploy:
      type: git
      repo: git@github.com:i-am-zhaozekai/i-am-zhaozekai.github.io.git
      branch: master
    

    配置完成之后执行

    hexo deploy
    

    这样 hexo 就会把 public 目录上传到你的 github.io,大家就可以通过你的github pages 看到你的博客了

    • 执行deploy命令的时候可能会出现 deployer not found:git 的错误信息,此时可以先执行 npm install hexo-deployer-git --save
    • 貌似从hexo提交代码时会把你以前的代码删掉,所以上传之前最好先备份一下

    四、配置主题


    Hexo 默认使用的主题是 landscape ,我们可以到官网 Hexo themes 上查看各种主题效果,或者看这里的一些介绍 知乎:有哪些好看的 Hexo 主题。挑选一个自己喜欢的然后配置使用。我个人比较喜欢 BlueLake 这个主题。

    1. 下载主题

    您可以直接到 BlueLake发布页 下载,然后解压拷贝到 themes 目录下,修改配置即可。不过推荐使用 git 来 checkout 代码,之后也可以通过 git pull 来快速更新。
    在博客根目录下执行

    git clone https://github.com/chaooo/hexo-theme-BlueLake.git themes/BlueLake
    

    2. 启用主题

    在_config.yml 下修改 themes 节点值为 BlueLake 即可


    3. 其他配置

    关于该主题的其他配置项,有一些是属于 BlueLake 特有的,例如该主题需要安装 jade和stylus 主题渲染包,详细的请参考 BlueLake 作者博客

    相关文章

      网友评论

          本文标题:使用Hexo+Github搭建属于自己的博客

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