上一篇文章主要介绍了如何通过Github和Hexo来搭建自己的博客,接下来,我们要开始写博客了,在我的第一篇博客的书写过程中还是踩了很多的坑,本篇博客将结合我之前踩的一些坑来介绍一下运用Hexo写博客的主要流程。
一、写博客的简要流程
1.1 新建一篇博文
在Hexo根目录下执行如下命令:
1 | $ hexo new "postName" #博文名称自行修改 |
随后,在“source_posts\”路径下会自动生成对应的.md文件,如下图所示,博客的内容就写在这个文件中。
打开对应生成的.md文件,如下所示:
1 | title: Github+Hexo搭建个人博客的流程 #博文的题目 |
至此,一篇博文新建完毕,接下来的工作就是正文的书写。
1.2 博文的正文部分
(1)书写工具:
a.用markdown语法直接在先前生成的.md文件中进行书写。这样做无法实现实时预览,不提倡;
b.运用插件“hexo-admin”进行书写。官方插件,可以实时预览;
c.印象笔记。这是我在用的一款软件,不仅能够实现实时预览,而且对于插入图片、代码、公式等内容操作更加便捷。
应该还有很多其他的书写工具,找到适合自己的就可以了。
(2)一些基本的markdown语法:
a. 标题的分级:使用“#”可以表示1~6级标题,一级标题对应一个“#”,二级标题对应两个“#”,以此类推。
1 | # 一级标题 |
b. 插入图片:
1 |  #ImgPath为指定路径下的图片文件;中括号中为替代图片的文字,可空 |
c. 插入外部链接:
1 | [链接](https://xxxx.xxx) #中括号内为链接的文字,小括号内为链接到的网址 |
d. 插入表格、图表:印象笔记中可以直接进行表格和图表的插入,自动生成对应的markdown语句,这里不再详细说明。
二、部署前的一些设置
下图是yilia主题中“_config.yml”文件里的一些基础配置,根据注释很容易对相关的内容进行修改:
这里主要对“截断按钮文字”进行说明,如果自己的博文较长,此时直接部署到博客上会使博文全部显示,而比较合理的方式是只显示文章的一部分,“截断按钮文字”即实现这个功能,具体用法是在自己的博文中要截断的地方输入<!-- more -->(“more”关键字可以进行修改),即可实现前后的截断,示意图如下所示:
最终部署到博客上实际效果如下:
踩坑:我的第一篇博文按上述内容书写完成后,进行了部署,但是发现博客上的图片消失了,找了半天原因,最终发现是“截断文字”的锅,如果不进行截断,文中的图片能够正常显示,但是截断后则不能。最后发现原因是添加截断后,生成了新的.html文件,导致原先的图片路径对应不上,所以读不到图片。
填坑:知道问题后解决起来就相对简单了,找到调用的图片的.html文件,然后将图片放到其同一目录下,“E:\Hexo\public\2020\03\26\Github-Hexo搭建个人博客的流程”这是我的.html文件路径,接下来我将存有图片的文件夹放到了该目录下,重新生成部署,问题解决。
最后,一篇博文就书写完成,接下来就根据我的第一篇博客中的内容重新进行生成和上传部署,即可更新自己的博客。