一、环境准备
- nodejs
- npm
1. npm
首先配置npm的淘宝源,安装完成后可通过npm info hexo查看是否配置淘宝源成功:
1 | npm config set registry https://registry.npm.taobao.org |
2. node
安装
先用普通的apt工具安装低版本的node,然后再升级最新。sudo apt-get install node
删除nodejs
apt-get remove nodejs
Ubuntu安装更新版本的工具N,执行:sudo npm install n -g
更新新node版本,执行:sudo n stable
可能出现node错误 /usr/bin/env: node: No such file or directory
解决
执行一个npm命令怎么提示/usr/bin/env这个错误…
创建一个软连接,如下:
1 | ln -s /usr/bin/nodejs /usr/bin/node |
- 因为npm执行的时候默认是使用/usr/bin/node去执行的,但我本地是没有/usr/bin/node的,所以需要创建一个
所以需要创建一个软连接将自己的node的执行文件指到/usr/bin/node上,于是修改如下:
1 | ln -s /usr/local/NODEJS_HOME/bin/node /usr/bin/node |
参考原文链接:https://blog.csdn.net/Qevery678/article/details/104803433
二、Hexo
1. 安装hexo
1 | $ npm install -g hexo |
新建完成后,指定文件夹的目录如下:
1 | . |
2. 发布文章
新建一篇文章
1 | hexo new "博客文章文件名" |
或新建和复制md文件放到/source/_posts
文件夹或其子文件夹中
文章要按照规定格式书写
开头部分 可以按标准写入标签、分类、以便归档
这里写的标签会自动汇集到tags
页面上
举个例子🌰
1 | --- |
发布运行
1 | hexo clean #清除页面缓存 |
完成后,打开浏览器,在地址栏输入你的放置个人网站的仓库路径,即 http://xxxx.github.io (知乎排版可能会出现”http://“字样,参考下图) 比如我的xxxx就是我的GitHub用户名:
https://robinwang825.github.io
你就会发现你的博客已经上线了,可以在网络上被访问了。
文件目录解释
_config.yml
网站的配置信息,您可以在此配置大部分的参数。package.json
应用程序的信息。
EJS、Stylus和 Markdown renderer 已默认安装,您可以自由移除。scaffolds
模版文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的markdown文件中默认填充的内容。
例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。source
资源文件夹是存放用户资源的地方。
除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。
Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
也就是你写的markdown存在这里面就会自动被包含到博客页面。themes
主题文件夹。Hexo的博客主题存在这里面,你可以去网上下载好看的主题或者自己写。
三、hexo常见问题
1. hexo init卡顿问题
解决 hexo init 卡顿问题 https://www.jianshu.com/p/a409601734f1
2. Hexo部署出现错误err: Error: Spawn failed解决方式
部署过程中可能会出现错误
1 | fatal: unable to access 'https://github.com/a956551943/a956551943.github.io/': Encountered end of file |
解决方式一:(已经尝试,有效)
1 | ##进入站点根目录,这个是自己博客所在文件夹 |
解决方式二:有可能是你的git repo配置地址不正确,可以将http方式变更为ssh方式
1 | ##进入站点根目录 |
Reference
安装 node_Mac下的Node.js安装教程
命令行安装node.js
gitee+hexo: https://blog.csdn.net/weixin_43960457/article/details/108887889
hexo+git/gitee: https://blog.csdn.net/L19iii/article/details/113077513
hexo+服务器搭建个人博客:https://www.jianshu.com/p/6ae883f9291c