Hexo博客日常操作总结

目录:

  • 创建博客文章
  • 发布文章
  • 更新博客内容
  • 摘要
  • 资源文件夹
  • 服务器

hexo官方地址:hexo.io

创建博客文章

1
$ hexo new [layout] <title>

文章的布局(layout),默认为 post,可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。

创建发布文章

在source/_posts目录下生成一个new-article.md文件

1
$ hexo new "new article"

结果

1
INFO  Created: ~/test/Blog/source/_posts/new-article.md

而且文章的表头会根据你的设置自动初始化,类似:

1
2
3
4
5
6
---
title: new article
date: 2019-07-19 10:37:44
categories:
tags:
---

创建草稿文章

在source/_drafts目录下生成一个new-article.md文件

1
hexo new draft 'new draft'

结果

1
INFO  Created: ~/test/Blog/source/_drafts/new-draft.md

文章的表头也会根据你的配置自动初始化。草稿默认不会显示在页面中,链接也访问不到。因此可以把一些未完成的文章暂时放在_drafts目录下。
可在执行时加上 –draft 参数,或是把 render_drafts 参数设为 true 来预览草稿

1
2
3
4
5
//如果你希望强行预览草稿,更改配置文件:
render_drafts: true

//或者,如下方式启动server:
$ hexo server --drafts

发布文章

可通过 publish 命令将草稿移动到 source/_posts 文件夹

1
$ hexo publish [layout] <title>

注意:我使用了该命令后,并没有达到预期的效果。

  • 如果Markdown文件表头文件,出现如title填写不规范等语法错误,会报错
  • 提示转义文件的目录成功,但是文件名发生了改变,如下,现在还不知道原因。
    1
    INFO  Published: ~/test/Blog/source/_posts/undefined-world.md

更新博客内容

您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。

1
2
$ hexo generate --deploy
$ hexo deploy --generate

简写
上面两个命令可以简写为
$ hexo g -d
$ hexo d -g

其他

摘要

手动设置或者添加摘要
<!--more-->之上的内容为摘要。
如果没有设置,会自动截取文本前N字为博客首页显示内容。

资源文件夹

详细介绍
如果你的Hexo项目中只有少量图片,那最简单的方法就是将它们放在 source/images 文件夹中。然后通过类似于

1
![](/images/image.jpg)

的方法访问它们。
想要更有规律地提供图片和其他资源以及想要将他们的资源分布在各个文章上,config.yml 文件中的 post_asset_folder 选项设为 true 来打开。

1
2
_config.yml
post_asset_folder: true

当资源文件管理功能打开后,Hexo将会在你每一次通过 hexo new [layout] <title> 命令创建新文章时自动创建一个文件夹。
这个资源文件夹将会有与这个 markdown 文件一样的名字。将所有与你的文章有关的资源放在这个关联文件夹中之后,你可以通过相对路径来引用它们,这样你就得到了一个更简单而且方便得多的工作流。

资源相对路径引用的标签插件

1
2
3
{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}

比如说:当你打开文章资源文件夹功能后,你把一个 example.jpg 图片放在了你的资源文件夹中,如果通过使用相对路径的常规 markdown 语法 ![](/example.jpg) ,它将 不会 出现在首页上。(但是它会在文章中按你期待的方式工作)

正确的引用图片方式是使用下列的标签插件而不是 markdown :

1
{% asset_img example.jpg This is an example image %}

通过这种方式,图片将会同时出现在文章和主页以及归档页中。

服务器

输入以下命令以启动服务器,您的网站会在 http://localhost:4000 下启动。在服务器启动期间,Hexo 会监视文件变动并自动更新,您无须重启服务器。
即新建、删除或修改文章后,不需要重启hexo server,刷新一下即可预览。

1
$ hexo server

如果您想要更改端口,或是在执行时遇到了 EADDRINUSE 错误,可以在执行时使用 -p 选项指定其他端口,如下:

1
$ hexo server -p 5000

使用 Hexo 生成静态文件快速而且简单。

1
$ hexo generate

Hexo 能够监视文件变动并立即重新生成静态文件,在生成时会比对文件的 SHA1 checksum,只有变动的文件才会写入。

1
$ hexo generate --watch

您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。

1
2
$ hexo generate --deploy
$ hexo deploy --generate

简写
上面两个命令可以简写为
$ hexo g -d
$ hexo d -g

-------------本文结束感谢您的阅读-------------

我的传送门:博客简书GitHub