依赖
nodejs Node.js 12.0 及以上版本,14.0以下版本(推荐12.16.2)
安装
全局安装
1 | npm install -g hexo-cli |
在要创建站点的文件夹下执行
1 | hexo init myblog |
新建完成后,指定文件夹的目录如下:
1 | . |
_config.yml 网站的 配置 信息,您可以在此配置大部分的参数
scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。
source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
themes
主题 文件夹。Hexo 会根据主题来生成静态页面。
创建文章
1 | hexo new 我的第一篇文章 |
默认在source/_posts文件夹中创建 我的第一篇文章.md
文章默认信息如下
1 |
|
然后编写自己的blog
运行
启动命令
1 | hexo server |
默认 http://localhost:4000 查看自己些的博客
启动命令也可简写
1 | hexo s |
打包
打包文件
1 | hexo generate |
打包之后生成的静态文件在public 文件夹
然后将public文件夹内的静态文件,放到自己网站的根目录就可以了
启动命令也可简写
1 | hexo g |
也可用dabug 方式监控生成情况
1 | hexo g --debug |
官网地址
更加详细的说明,请参考官网:
安装问题处理
关于hexo搭建博客——生成index.html页面为空
第一种:nodejs版本不兼容
主要原因是 nodejs版本不兼容,14+的版本都不行。
导致生成的index.html文件是空白的。
解决办法
重新安装nodejs 推荐12.16.2
安装完毕之后,
执行hexo g 会在本地Blog文件夹下,生成启动文件,打开里面的index.html如果有,内容说明问题解决了。
第一种:缺少相应包文件
问题情况: hexo g 命令后无相应静态文件index.html生成。
结局办法
hexo g 无法生成 index
但是一些文件没有生成,如 index.html 文件。
查看 npm 安装各 hexo 插件的情况
npm ls –depth 0
hexo 的一些插件未安装插件
npm ERR! missing npm ERR! missing hexo-generator-archive…
解决
逐一安装缺失的包
npm install hexo-generator-archive –save
…
安装完后重新构建即可解决。
第二种:缺失相应配置文件
问题情况:生成了index.html,但是此文件大小为0kb,博客首页文章预览正常显示,点开跳转为空白页面。
解决方案:git bush后运行hexo g –debug,即可在出现的结果中找到相应错误。例如会出现”can’t find xxxxxx”。即说明某个配置文件被引用,但你的文件里并没有这个文件,进行添加即可。
第三种:缺少.md文件
问题情况: hexo g 命令后无相应静态文件index.html生成。
解决方案:查找_post文件夹是否有相应的.md文件
一辈子很短,努力的做好两件事就好:
第一件事是热爱生活,好好的去爱身边的人;
第二件事是努力学习,在工作中取得不一样的成绩,实现自己的价值,而不是仅仅为了赚钱。