MLi's Blog

Hexo学习5-Hexo撰写博客教程

说明

这篇文章的内容是利用Hexo撰写博客的相关内容,关于Hexo的配置和发布过程可以参见 Hexo学习1-用hexo创建博客并发布到github pages

创建新文章

在命令行工具下进入到hexoBlog目录,运行:

hexo new "arc1"

这样在source/_posts目录下就新建了一个arc1.md博客文件,打开以后有固定的格式:

1
2
3
4
5
---
title: myarc
date: 2017-01-23 10:24:47
tags:
---

其中title为博客的标题,tags为博客的标签,对于多个标签可以采用tags:[tag1,tag2]来实现。博客的撰写需要采用markdown语法,可以参见Markdown语法总结. 写完以后运行hexo s -p 3600 进行预览,没问题了再运行hexo generate hexo deploy发布到github pages

如果要添加私密文章或者草稿,则需要运行hexo new **draft** "arc1", 这样在source/_drafts目录下新建了arc1.md,然后在本地可以强行预览草稿:hexo server --drafts

引用自己博客的文章

A引用Bfg.md,则在A的md文件里输入:

1
{% post_link Bfg %}

插入图片

有两种典型的方式可以插入图片: -

  • hexo的官方方式:这种方式需要将站点的配置文件_config.yml里设置:’post_asset_folder: true’, 然后在cmd输入: hexo new "post-test", 这样 source\_posts 下建立post-test.md和post-test的文件夹。再把图片(比如:example.jpg)放到post-test这个文件夹里。post-test.md里进行调用的时候输入:

    1
    2
    {% asset_img example.jpg aaa %}
    `

    但是,这种方法我没有试验成功。不知道怎么回事

  • 基于Markdown语法的调用方式: ![](example.jpg的相对路径)。但是如果’post_asset_folder: true’情况下,如果把exaple.jpg放在上一级目录中是无法显示的。参考下面的测试结果(首页能不能显示还和具体模板有关系)

总结下有两种比较靠谱的方式:

  • _config_yml中设置’post_asset_folder: false’,然后将所有的图片放到_post的同级目录images下,然后进行调用![](/images/example.jpg)
  • _config_yml中设置’post_asset_folder: true’, 这样建立aa.md的时候就同时新建了aa的文件夹,将图片放aa文件夹下,aa.md里调用的时候为![](aa/compare_markdown_img.png)

测试的时候犯了一个很低级的错误,就是我将图片命名为example.jpg.jpg, 导致一直预览不到。另外基于Markdown语法的图片可能会在首页和归档页看不到,不过对于我而言不是很重要。

跳过渲染文件

skip_render后面得文件夹名字第一个不能是下划线,比如_book

Markdown 语法

参见Markdown语法总结