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/

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

【Hexo博客搭建】将其部署到GitHub Pages（三）：怎么写作以及更新？
简介: 本系列文章属于半笔记半教程的零基础小白入门文,教你将 Hexo 部署到 GitHub Pages 应该怎么做,跟着此系列文章最终可以获得自己的静态博客网站.流程很长,分成不同的篇幅,此为本系列 ...
【Hexo博客搭建】将其部署到GitHub Pages（二）：如何初始化并部署？
简介: 本系列文章属于半笔记半教程的零基础小白入门文,教你将 Hexo 部署到 GitHub Pages 应该怎么做,跟着此系列文章最终可以获得自己的静态博客网站.流程很长,分成不同的篇幅,此为本系列 ...
【Hexo博客搭建】将其部署到GitHub Pages（四）：更换博客主题并进行个性化配置
前几篇文章教了大家如何在GitHub上部署hexo博客以及怎么写文章,这次我们一起换掉其默认的主题,并进行一些简单配置,让咱们的博客更充满特色. 一.挑选心仪的hexo主题这是我们未更换前,默认主题 ...
Hexo 博客添加看板娘
Hexo 博客添加看板娘相信看到这里的小伙伴都有属于自己的hexo博客了吧,废话不多说,我们直接进入主题我的博客:传送门 1.安装模块在hexo根目录下用Git执行命令 npm install ...
为 hexo 博客添加本地搜索功能
点击上方好好学java ,选择星标公众号重磅资讯.干货,第一时间送达今日推荐:我的大学到研究生自学 Java 之路,过程艰辛,不放弃,保持热情,最终发现我是这样拿到大厂 offer 的!个人 ...
hexo博客添加暗色模式_我如何向网站添加暗模式
hexo博客添加暗色模式同一个网站,两种不同的配色方案 (Same website, two different color schemes) Last year I made it a point ...
hexo博客添加暗色模式_我如何将暗模式添加到我的网站
hexo博客添加暗色模式 I recently redesigned my website. Here are 2 pictures of how it looked, for reference: ...
Hexo博客添加评论功能
Hexo博客添加评论功能实现了Hexo的评论功能先附上官网链接valine官网我使用的是Material-X主题,大多主题都支持,基本在官方主题文档都可以找到使用方法 1.进入官网,注册账号需 ...
新浪博客发博文老是提示系统繁忙、请稍后再试解决方法
新浪博客发博文老是提示系统繁忙.请稍后再试解决方法: 微信关注新浪客服公众号点击在线客服.选人工,博客其他问题然后客服会让你提供博客登陆名密码前三位博客绑定的手机联系邮箱手机会受 ...

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

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

最新文章

热门文章