Hexo 博客添加 README.md 以及部署到 GitHub 丢失/显示不正常解决方法


GitHub 项目的README.md为自述文件,可对该项目进行介绍,解释等。

使用 Github Pages 和 Hexo 搭建的博客,如果在最开始建立仓库的时候没有创建README.md文件,那么在后期如何添加呢?

添加方法:在根目录 source 文件夹下新建README.md即可,该文件使用 Markdown 语法。

然而当我们执行 hexo g -d 部署博客的时候会发现README.md变成了 README.html,如下所示:
在这里插入图片描述
原因就在于当我们在执行 hexo g -d 命令时,.md 文件会被转化成 HTML 文件,并将这些文件放到 public 目录里,最后再提交到远程 GitHub 仓库,而 Hexo 也提供了一个方法,让md文件不被转换成HTML,在根目录的 _config.yml 配置文件里,找到 skip_render 关键字,添加 README.md,让解释器跳过渲染就行了:

skip_render: README.md

官方文档:https://hexo.io/docs/configuration
拓展阅读:《Hexo + Github Pages 自定义一个不使用主题模板渲染的独立页面》
我的博客:https://www.itrhx.com/

TRHX • 鲍勃 CSDN认证博客专家 CSDN博客专家 网络爬虫工程师 高校俱乐部主席
个人博客:www.itrhx.com,Python 网络爬虫工程师,专攻数据挖掘、数据分析,数据可视化领域,Golang、前端以及开源技术爱好者,一入 IT 深似海,从此学习无绝期!求知若饥,虚心若愚,只谈技术,莫问前程!注重细节,用心写好文!
已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 数字20 设计师:CSDN官方博客 返回首页