本网站使用Hexo博客框架,如果你也想搭建属于自己的博客站点,写写文章,发发照片什么的,也可以使用Hexo。极易上手,老少皆宜。网上有关Hexo的教程很多,官网教程也很详细,甚至嗨哟B站教学视频。这篇文章只是一个梳理,基于Mac,Windows大概也差不多。可能会有细节上的遗漏,我会随时更新的~
简介
Hexo是什么
Hexo是一个基于Node.js的博客框架,快速简洁。支持Markdown,且拥有丰富的主题和插件。Linux,Mac,Windows均可使用。
和其他的博客框架比如Jekyll、Octopress、Wordpress类似,我们可以使用Hexo生成静态网页,并托管到GitHub上。
感谢来自台湾的作者tommy351。
Hexo适合我嘛
如果你不是程序员,不要担心,搭建和部署Hexo超级简单(除非遇到比较奇葩的环境问题)。Hexo拥有丰富的主题和插件,不管是写文章,还是图片展示,基本可以满足你的所有需求。
你是程序员的话,选择就比较多了,但是如果你不是前端开发者,完全可以把重心放在自己的领域,Hexo可以省去许多麻烦。
安装
安装准备
安装Hexo前需要确定你的电脑里已经有:
官网都告诉你了,安装超级简单,就不多说了。
Hexo安装
Node.js和Git安装好后,安装Hexo只需下面一句命令:
$ npm install -g hexo-cli
Mac用户有时可能出现以下报错:
➜ ~ npm install -g hexo-cli</br>
npm WARN checkPermissions Missing write access to /usr/local/lib/node_modules
npm ERR! path /usr/local/lib/node_modules</br>
npm ERR! code EACCES</br>
npm ERR! errno -13</br>
npm ERR! syscall access</br>
npm ERR! Error: EACCES: permission denied, access '/usr/local/lib/node_modules'</br>
npm ERR! { [Error: EACCES: permission denied, access '/usr/local/lib/node_modules']</br>
npm ERR! stack:</br>
npm ERR! 'Error: EACCES: permission denied, access \'/usr/local/lib/node_modules\'',</br>
npm ERR! errno: -13,</br>
npm ERR! code: 'EACCES',</br>
npm ERR! syscall: 'access',</br>
npm ERR! path: '/usr/local/lib/node_modules' }</br>
npm ERR! </br>
npm ERR! The operation was rejected by your operating system.</br>
npm ERR! It is likely you do not have the permissions to access this file as the current user</br>
npm ERR! </br>
npm ERR! If you believe this might be a permissions issue, please double-check the</br>
npm ERR! permissions of the file and its containing directories, or try running</br>
npm ERR! the command again as root/Administrator (though this is not recommended).</br>
</br>
npm ERR! A complete log of this run can be found in:</br>
npm ERR! /Users/pluto/.npm/_logs/2018-12-29T21_05_36_404Z-debug.log</br>
一个简单的解决方法是直接使用sudo运行上面的命令:
$ sudo npm install -g hexo-cli
或者换到root用户操作。
但是npm不建议这样,并提供了官方的解决办法。
安装好之后,使用下面的命令就可以看到Hexo版本:
$ hexo version
建站
安装好Hexo,我们就可以在本地建站了。
在终端找到想要存放Hexo文件的目录,运行:
$ hexo init [folder]
OK,这个时候我们就可以在目录下看到新建的Hexo文件夹了。以下是其中一些必要的文件,你的目录中可能还有别的。
├── _config.yml
├── scaffolds
├── source
| └── _posts
└── themes
我们后面再详细分析每个文件的用途,我们先生成一下静态文件。进到Hexo的文件目录中,运行
$ hexo generate
该命令也可以简写为
$ hexo g
运行之后,我们可以看到多了一个public
文件夹,这玩意儿就是生成的静态网页。然后我们启动本地服务:
$ hexo server
同样,可以简写为
$ hexo s
现在,打开浏览器,地址栏输入http://localhost:4000
,就是本地的服务啦~ 默认的主题是landscape
,就长下面这个样子。
在终端Ctrl
+c
可以终止本地服务。
小结
好哒~本节内容就到这里,我们已经可以在本地运行Hexo服务了。下一节我们了解Hexo的相关配置。