从朋友这边了解到了hexo是个快捷的博客搭建平台,很是向往,的确也想记录些日常,放假在家,突然想起来,那就说建就建吧。记录一下过程,以便以后新的入门者可参考。具体步骤包含以下三步:
- 安装Hexo
- 本地及git上的博客部署
- Hexo博客主题及其他修改
1. 安装Hexo
在安装Hexo之前,电脑需要安装好以下两个软件:
(1) Git
Git就是官网下的安装包,直接安装的。
(2) Node.js$ git clone git://github.com/creationix/nvm.git ~/.nvm
$ cd ~/.nvm
$ git checkout v0.33.2
#选择版本号为0.33.2$ nvm install stable
安装Hexo$ npm install -g hexo-cli
2. 本地及git上的博客部署
(1)将hexo的博客部署数据存放在自己指定的目录下:$ hexo init /Users/nilin/Documents/myblog
当看到”INFO Start blogging with Hexo!”,说明在指定的文件目录下面,已经成功建好了Hexo。$ cd /Users/nilin/Documents/myblog
$ npm install
$ hexo generate
# 做任何修改时,都需要hexo generate
(2)本地部署:
想要本地部署查看自己的博客,只需下面这行命令:$ hexo server
“INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.”
直接在自己的浏览器中,输入以上localhost的地址,则可以在本地查看自己的博客。当然,写博客的大家也会想要和其他人一同分享自己的收获,那么,我们则可以进行到下面的部分,即在git上面进行自己博客的部署,让大家可以看到我们的博客。
(3)Git上的部署:
- 首先,你需要一个github上的账户。请自行注册去咯,https://github.com。
- 其次,假设你的github上的账户名叫做yourgitname。请进入github的账户,建立一个new repository,名字为yourgitname.github.io
- 然后,在之前指定的本地存放hexo相关数据的文件夹下面,有一个有趣的文件,叫做_config.yml。
用任意文本编辑器打开该文件,会看到该文件内容是我们博客的设置参数,比如:title, author,以及其他具体设置。在该文件内容的最后一部分,就是Deployment,即部署部分。我们将deployment部分的内容改为以下,并且保存。
deploy:
type: git
repository:http://github.com/yourgitname/yourgitname.github.io.git
branch: master
- 再进入terminal进行deploy操作。
$ npm install hexo-deployer-git --save
# 设置deploy的参数$ hexo generate
$ hexo deploy
在deploy过程中,你需要输入自己的github账户名和密码。然后,不出意外地,你将在http://yourgitname.github.io
上面就正常看到自己的博客啦!
3. Hexo博客主题及其他修改
当你看到自己搭建的Hexo博客平台时,心情或许和我一样。一方面,很是欣慰,终于是看到自己的博客了,另一方面,觉得哪里不对劲,这个博客的默认风格有点过时。那么,就让我们继续前行,更改一下风格,并且开始我们第一篇的博客写作吧。
- 博客主题
(1)Hexo主题板块:https://hexo.io/themes/
有的也很好看,比如:https://sharvaridesai.github.io/hexo-theme-edinburgh-demo/
可惜,不知道具体要怎么把这个现有的为我所用。
(2)在知乎上面,有关于hexo的讨论,可以在其中找寻有意思的hexo的主题。
https://www.zhihu.com/topic/19851557/top-answers
以其中一个主题为例,https://github.com/hexojs/hexo-theme-phase- 进入该url的第一行,可以预览该博客的风格:http://hexo.io/hexo-theme-phase
- 在README.md中,作者一般都会写明如何install,并修改本地的_config.yml文件中的theme的参数。
-
$ hexo generate
$ hexo deploy
- 新建博客
(1)hexo命令:$ hexo new [layout] <title>
Layout | Path
— | —
post
|source/_posts
page
|source
draft
|source/_drafts
我暂时就尝试了一下 post:$ hexo new post "How to build up a hexo blog"
看到以下信息:
“INFO Created: ~/Documents/myblog/source/_posts/How-to-build-up-a-hexo-blog.md”
然后,照例:$ hexo generate
$ hexo deploy
就可以在网页上面看到自己多了一篇新文章,标题为”How to build up a hexo blog”。
(2)Markdown工具
通过之前的尝试,发现其实hexo new … 命令是在指定的文件夹内,新建了一个markdown的文件。因而,我们也可以将写完的markdown文件保存到该目录下。此篇文章就是这种方法的一个尝试。
当然,寻找合适长期的markdown写作的工具也是我下一步要做的事情咯。 - 管理博客
管理博客是个长期的过程,其中涉及的内容很广泛,比如:内容分档、标签,以及友情链接等等。不过,到现在看来,还是比较容易上手的。
Hexo, I am coming ~
4. Hexo常见问题
(后记)记录在使用Hexo过程中,遇见的一些问题:
(1) 运行任何hexo命令,然后没有任何反应。
在Mac系统上面的,可以考虑运行以下命令$ npm uninstall hexo-cli -g
# 卸载之前安装的hexo$ npm install -g hexo-cli --registry=https://registry.npm.taobao.org
# 配置国内Taobao npm数据源重装$ npm install
# 在blog的根目录下面$ hexo server
# 运行hexo命令
(2) On branch master, nothing to commit, working tree clean
明明写了新的博客,在blog的根目录下面使用$ hexo deploy
却被告知“On branch master, nothing to commit, working tree clean”,此时,可以配套运行以下代码$ hexo clean
$ hexo deploy
(3) Error: Cannot find module ‘./build/Debug/DTraceProviderBindings’
官网和网上普遍的解决方案为以下:$ npm install hexo --no-optional
可惜对我还是无解,这个问题还木有解决。
参考: