Hexo常用命令

Hexo常用命令

一、写作

1. 新建空白文档

   hexo n [layout] <title>

   layout分为：post、page、draft，默认为post

   参数	描述
   -p, --path	自定义新文章的路径
   -r, --replace	如果存在同名文章，将其替换
   -s, --slug	文章的 Slug，作为新文章的文件名和发布后的 URL

   用法实例：

   hexo new post --path 前端开发/前端开发——Web开发基础 "前端开发——Web开发概述"
   如果没有最后""里面的标题，只会创建文件名为“前端开发——Web开发基础”的文件，title为模板默认值。如果指定的文件目录不存在，则会新建文件目录

   hexo n p -p 目录/文件名 "标题"

2. Front-matter

   参数	描述	用法
   title	文章标题、文件名
   tags	标签	tags: - PS3 - Games
   categories	分类	categories: - Diary
   index_img	首页的缩略图	index_img: /img/yangtai/p1.jpg
   banner_img	详细页的顶部背景大图	banner_img: /img/yangtai/p2.jpg
   comments	开关文章的评论功能	comments: true（默认） / false

二、发布

1. 生成静态文件

   hexo g

2. 本地预览

   hexo s  启动服务器。默认情况下，访问网址为： http://localhost:4000/

3. 部署网站

   hexo d

4. 一键生成并部署

   hexo d -g

三、自定义

自定义模板

在hexo的scaffolds目录下有三个md文档，按需修改模板即可

自定义默认背景图片

修改主题配置_config.fluid中的post.banner_img

四、资源文件夹

资源，指除了文章文本之外的所有文件，诸如：图片（包括文章里的配图）、CSS、JS文件等。

如果这些资源存放在本地，那么只能在本地服务器上正常浏览使用它们，通过网站浏览时将无法加载。

针对图片的一种做法是，设置Toypra等markdown编辑器的 图片上传功能，接着类似于github提供的图床服务，使网站上的在线文档能够正常加载图片。

另外一种，也就是这里推荐的做法是，使用Hexo的 相对路径引用的标签插件。介绍如下：

通过常规的 markdown 语法和相对路径来引用图片和其它资源可能会导致它们在存档页或者主页上显示不正确。在Hexo 2时代，社区创建了很多插件来解决这个问题。但是，随着Hexo 3 的发布，许多新的标签插件被加入到了核心代码中。这使得你可以更简单地在文章中引用你的资源。

{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}

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

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

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

使用这个便签插件，首先要调整config.yml的设置，将post_asset_folder设置为true，

post_asset_folder: true

之后，Hexo将会在你每一次通过 hexo new [layout] <title> 命令创建新文章时自动创建一个文件夹。这个资源文件夹将会有与这个文章文件一样的名字。将所有与你的文章有关的资源放在这个关联文件夹中之后，你可以通过相对路径来引用它们

重点！！实际尝试发现，这种方式体验很差，因为使用标签插件的时候Typora就无法预览到图片

所以还是放弃这种方式，改为使用github图床吧，这样虽然加载慢一点，但是起码三个地方都可以访问到

五、使用草稿功能

• 创建草稿

hexo new draft "your title"

• 发布草稿

hexo publish [layout] <filename>

可以试试能否加上–path参数