hexo使用
hexo主题
hexo主题下载地址:https://hexo.io/themes/
每个主题中都有相关的下载及配置说明,不过有些主题很坑,各种下载报错,建议使用常用的一些主题。
创建新文章
根目录命令行输入hexo new [模板] <文章名>新建文章
其中<模板>在scaffolds中,默认情况下有三个模板post、draft、page
参数
|
功能
|
路径
|
post
|
新建文章(默认)
|
/source/_posts/
|
draft
|
新建草稿
|
/source/_drafts/
|
page
|
新建页面(标签页,分类页等)
|
/source/
|
通常使用hexo new <title>即可,默认post,注意这里的title不是文章名,具体文章中显示的文章标题可以在文章文件中修改,例如:hexo new post article
此时在source/_posts/文件夹中多了一个article.md文件
删除文章:直接删除_posts文件夹下article.md即可
article.md中两条---之间的内容为文章的配置内容,可以在其中设置标签、分类等。其中的title为文章发布后文章页面显示的标题,例如我们修改一下tittle为:Hexo博客文章发布
而.md文件的名字,也就是我们新建文章时输入的名字,是作为文章页面链接中显示的名字,例如,本篇文章的文件名为:article.md,文章内设置的文章标题为Hexo博客新建文章并发布,那么本篇文章的链接就是https://www.lixint.me/article.html
创建草稿
草稿文件的创建命令如下:
hexo new draft <title>
创建的文件会被保存到source/_drafts文件夹,如果有文章没写完或不想发布的,可以放到drafts文件夹下。
预览草稿
草稿默认不会显示在页面中,有两种方式可以预览草稿。
- 在执行 hexo g 命令时加上 --draft 参数。
hexo s --draft
- 在 _config.yml 文件中把 render_drafts 参数设为 true 。
render_drafts: true
草稿文章 转 发布文章
使用 publish 命令将草稿移动到 source/_posts 文件夹,该命令的使用方式与 new 十分类似,您也可在命令中指定 layout 来指定布局,草稿发布后_drafts目录下的草稿会同时删除。
hexo publish [layout] <title>
Hexo没有提供将草稿全部发布到_post目录,可以使用hexo publish .来发布,不过偶尔报错。
文章模板
在新建文章中使用的post参数,就是模板的名称,在使用hexo new post <文件名>命令进行新建文章时,系统会自动在scaffolds文件夹中搜寻名为post的文件,根据其中的内容生成新的.md文章文件。后续随着配置项的增多,可以自行设置不同类型的模板。如:hexo new photo "My Gallery" 执行时Hexo 会尝试在 scaffolds 文件夹中寻找 photo.md,并根据其内容建立文章
给文章添加分类和模板
通过对文件头部配置信息中tags 与categories项的修改可以设置文章的标签及分类。
其中标签可以按格式贴现设置多个:
title: Hexo博客新建文章并发布 date: 2018-12-06 12:16:12 tags: - Hexo - Markdown categories: 搭建博客
添加“阅读全文”按钮
方法一:在文章任意你想添加的位置添加:<!--more-->
此标签以下内容不展示在列表中,收起为阅读全文效果
方法二:设置首页文章以摘要形式显示,打开主题配置文件,找到auto_excerpt进行修改:
auto_excerpt:
enable: true
length: 150
在博文中添加图片
目前有三种方法像博文中添加图片:
方法一
(1)在hexo目录下,安装插件:
npm install hexo-asset-image --save
(2)在source 目录下新建一个img文件夹,把图片放置在里面;
(3)在xxx.md文件中引用图片:![header]( img/header.jpg)
方法二:
(1)在全局配置文件(hexo/_config.yml)中将post_asset_folder设置为true;
(2)创建文章(在创建的时候,会在hexo/source/_post目录下,生成一个XXX.md文件和一个XXX的文件夹):
(3)把XXX这个博文需要展示的图片放在XXX文件夹目录下;
(4)在XXX.md文件中引入图片的方式:{% asset_img example.jpg This is an example image %}
方法三
前两种方法尽管在上传时很方便,但是在插入图片时并不是很方便,现在很多Markdown编辑器在插入图片是非常方便,截图直接粘贴、现有的图片文件直接拖入都可以实现插入图片,而不是使用代码进行插入。
但是这样插入的图片在上传时并不会被上传,这样就导致了博客中文章图片的连接还是本地路径的格式。
于是博主自己写了一个Python脚本,在文章完成后上传前,通过脚本自动将文章中的图片上传至腾讯云对象存储(腾讯云每个月都有一定的免费额度)或者SMMS图床,文章中图片链接替换。这样既不会占用Github Pages空间,又能方便地插入图片。
对于脚本的使用,可以到==>Hexo博文图片自动上传腾讯云、SMMS图床并替换博文内图片链接<==查看
2人点赞
发布到Github上
(1) _config.yml配置文件中配置:
deploy:
type: git
repo: https://gitee.com/liershuang/liershuang.git //git地址
branch: master //仓库分支
message: 文章发布 //自动部署默认提交目录
(2)发表的文章在本地预览无误后,在 Git Bash 命令窗口执行以下命令:
hexo clean && hexo g && hexo d
(3)git pages中点击更新