Hexo教程(1)——搭建本地服务

  本网站使用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的相关配置。

坚持原创技术分享,您的支持将鼓励我继续创作!
0%