Hexo搭建静态博客网站简要教程

Hexo 是一个快速的、简单的和强大的博客框架,它使用markdown或者其他渲染引擎来解析你的博文,然后用漂亮的主题生成静态文件。这一切所花的时间也就几秒钟而已!

##依赖包

  1. 安装 Node.js
  2. 安装 Git ,默认桌面上生成Git BASH,Git BASH为windows提供一个模仿BASHi方法,所以支持的命令是Linux或者UNIX下的命令。

##安装Hexo框架
打开Git BASH,进入命令行界面。输入如下命令:

>>>npm install hexo -g

一般情况下很快就能完成安装,如果出现安装卡住的现象,可以到 https://www.npmjs.org/ 下载相应的包,再重新运行上面的命令。

##初始化目录
这里以D盘下的blog目录为例,输入如下命令:

>>>cd d:
>>>hexo init blog
>>>cd blog
>>>npm install

这样子就初始化一个hexo目录。然后就能看到如下的目录:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|  ├── _drafts
|  └── _posts
└── themes

##本地查看
在命令行中输入如下命令:

>>>hexo generate
>>>hexo server

第一个命令表示生成静态博客网站,第二个命令表示启动服务器。以上两个命令可以简写成如下:

>>>hexo g
>>>hexo s

在浏览器中输入http://localhost:4000 ,就可以查看网站的样子。

更多命令信息,可查看 hexo官网

##部署到Github上
这里假设你已经有了 Github 账号,并且已经将本地电脑添加到Github上的信任名单中了。如未,请查看 廖雪峰的官网

  • 在Github上创建资源库,建议命名为[你的用户名].github.io。
  • 打开blog目录下的 _config.yml ,按照如下修改:

    deploy:
      type: github
      repository: https://github.com/wonsikin/wonsikin.github.io.git
      branch: master
    
  • 保存完毕后运行如下命令:

    >>>hexo g
    

    每次修改本地配置文件时都运行以上命令

  • 发布到Github上面,运行如下命令:

    >>>hexo deploy //可以简写成>>>hexo d
    
  • 按照提示输入Github的用户名和账号。
  • 部署成功后,在地址栏中输入[你的用户名].github.io,就可以查看到部署到Github上面的网站。

##发布文章

运行如下命令,可以发布一条博客:

>>>hexo new "Article title"

然后在 source/_posts 文件夹中打开这个文件,配置开头,填写文章内容,重新运行生成和部署命令,就能够在网站中看到发布的博库。

PS :hexo中博客内容的书写语法是 markdown

##绑定个人域名

  • 首先你得有自己的域名。
  • www.dnspod.cn 上注册,使用该网站的域名解析服务。
  • 如下图配置 CNAMEA记录


记住NS记录的两个值,待会儿要用。

  • 进入域名提供商的管理页面,在DNS管理一项,选择自定义DNS,填写刚才的两个NS记录:

  • 在hexo博客目录下的 source 文件夹里面,创建 文件,里面填写个人域名。

##更新-141025
Hexo升级到2.8之后,运行会HexoError错误。

解决方法为:找到报错的文件(上图红框内文字所示),查看是否存在如下内容

archive_b: Archives: %s

然后修改为

archive_b: “Archives: %s“

即用引号包裹带有%的设置。

PS: 更多优化信息,稍后添加!