本博客书写教程:关于书写格式

本博客是发布在github上的,而github上提供挂载的是静态网站和静态资源,是一种低成本的公共展示手段。我们利用hexo这个工具把本地的MarkDown文件自动生成为静态页面,然后再上传到github上。所以,各位老师要为本博客提供的原文件必须是一篇能被hexo正确解析的MarkDown文件。接下来,我们就来介绍一下这种格式。

文件开头

在文件的开头部分,请按照下图的方式进行书写:

1、首先用三根短横线开头,再用三根短横线结束;
2、中间内容分别是标题(title)、日期(date)和分类(categories);
3、注意冒号后面一定要有一个空格。

文件内容

在完成文件开头后,你可以在下一行开始书写内容了。在书写内容时,请先在第一段用简短的文字书写一个内容概要,然后换行使用more标记进行分割。这样,这篇文章在首页就只会显示第一段内容,只有点击《阅读全文》才能看到后面的内容了。书写方式和效果如下:


文章内容在书写过程中,只需要在每段的结束时换行,不需要(也不能)在每段开始的时候使用TAB或空格进行缩进。其余效果语法请参见MarkDown语法即可。

如何插入图片

在文中插入图片是我们书写时的重要的说明手段,在HEXO中有两种语法可以插入图片,这里我们推荐使用:

图片路径可以由上传者调整,但是需要各位作者老师把图片一同交与上传者。请注意:图片最好使用jpg或png格式;另外为节约空间,图片大小最好保持在几百k就够了;图片的名称请按照在文章中出现的顺序数字进行命名。

如何插入代码

技术文章当然少不了代码的出现,HEXO中采用的支持语法是:

用codelock和endcodelock把你的代码括起来,其中lang属性后面跟上代码的所属语言即可。HEXO可以自动找出该语言的关键字、变量、注释等进行变颜色操作。效果如下:

1
2
3
4
5
6
7
try {
... //需要异常处理的代码
} catch() {
...//捕获到异常后执行的代码
} finally {
//有没有捕获到异常都要执行的代码
}