Mac下搭建GitHubPages和Hexo教程

这是用Mac下搭建Hexo并部署GitHubPages的教程以及我的步骤与遇到的问题。

简易更新版本请参考: Mac下搭建Hexo并部署GitHubPages的步骤(直接重点)/

参考文档

hexo官方文档:文档

一些需要了解的命令

使用 npm 完成 Hexo 的安装

$ npm install -g hexo-cli

建站

$ hexo init folder
$ cd folder
$ npm install

开始

安装需要的程序

  • Xcode
  • Git,此处使用图形化客户端安装。

安装程序

  • Node.js,此处使用图形化客户端安装。

安装程序

完成截图(这里推荐LTS版本,不推荐下方新版本,当前时间2018年4月8日)

安装hexo

此步骤详细请看安装过程中遇到的问题

输入sudo npm install -g hexo-cli

建站

在自己想安装的位置创建文件夹,我这里为用户下。

输入hexo init folder(folder为自己重新创建的文件夹)

输入cd (folder为自己重新创建的文件夹)

输入npm install

生成静态文件

输入$ hexo generate

启动服务器

输入$ hexo server

预览

安装过程中遇到的问题

安装hexo

1和3为权限问题,应该加undo

1:npm install -g hexo-cli

Error: EACCES: permission denied, access ‘/usr/local/lib/node_modules’ npm ERR! at Error (native)

使用命令行保持类似以下错误: Error: EACCES: permission denied, access ‘/usr/local/lib/node_modules’ npm ERR! at Error (native)

原因: 执行命令行命令时没有获得管理员权限

解决办法: 在命令前面加上sudo即可.然后输入电脑的管理员密码操作即可完成.

2:sudo npm install -g hexo-cli

Error on npm install after update to Node 8 #30

try running npm install -g node-gyp, fixed it for me!

3:npm install -g node-gyp

重新安装LTS版本,出现之前的问题。
解决方法:添加“sudo”

4:sudo npm install -g node-gyp(完成)

5:sudo npm install -g hexo-cli(完成)

建站

报错:syntax error near unexpected token newline

bash-syntax-error-near-unexpected-token-newline

输入hexo init folder

输入cd folder出现问题

报错:No such file or directory

原因:folder是任意文件夹名称

之后由于不是很懂,所以再次init,之后这里我发现有两个folder文件夹,故删除了一个。

其次,我重新创建了一个新文件夹,这个文件夹的路径位置为自己想安装的目录。

如果直接创建文件夹时,直接输入hexo init会出现如下报错:

所以指令应为:

hexo init folder(folder为自己重新创建的文件夹)

之后:

发现是从废纸篓里克隆的(之前删掉的那个),于是将它删除。

了解了之后,此处创建的文件夹不能有空格

在这个时候输入

folder(有空格)

folder(没有空格)

sudo hexo init

sudo hexo init(folder)

cd/folder

都会出现这个错误。

这个问题我目前还未明确,方法是重新安装GIT和nodejs之后再次安装hexo。

 wechat
产品北里,讲述产品和人性、涉及设计、技术和运营的公众号。
你们的赞赏是我更新的动力~