hexo操作与博文编写

938 words

关于hexo操作

hexo是搭建博客所用框架,以下为使用搭建完成后使用操作总结。


更新博客网站流程

三段BASH命令即可进行更新

$ hexo clean
$ hexo g
$ hexo d

在推到github前可先进行本地部署

$ hexo s

关于评论系统的引入

参考教程:在ParticleX上使用Waline作为评论区 | Yuzi’s Blog

思考这项操作在其他方面的应用……


编辑文章的相关操作

创建一个草稿

$ hexo n draft draft_name

创建的草稿 .md 文件在 source\_drafts 文件夹下,可进行编辑。

文章模板

在根目录 scaffolds 文件夹下有文章样式模板,关于 Front-matter 的相关设置参考 官方文档

推送草稿到post

$ hexo publish <file_name>

可以使用 hexo --draft 命令查看已有草稿文件。

使用markdown语法编辑文章

markdown基础写作语法

```代码块
`代码段`
*斜体*
**加粗**
***分割线
>引用
注释[^num]
<u>下划线</u>
 [链接文本](链接地址)
 ~~删除线~~
 $$数学函数$$

部分特殊字符转义

特殊字符转义

插入图片

markdown引用图片的语法:

![alt](path [title])
  • path是必选的,表示图片的路径,可使用绝对或相对路径。
  • alt是可选的,是图片无法加载时的替代描述文本。
  • title是可选的,是图片的标题。

图片的资源文件夹:

为每个文章创建资源文件夹的设置:

在根目录 _config.yml 中找到 post_asset_folder 改为 true 即可。

补充

原版的嵌入图片方法为:

{% asset_img foo.jpg %}

十分难用,故需要安装官方文档推荐的 hexo-renderer-marked 插件以实现用markdown语法嵌入图片。

使用 npm install hexo-renderer-marked 命令直接安装,之后在 config.yaml 中更改设置:

post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true

在Typora偏好设置中图像内设置插入路径可实现联动,部署时要把图片路径中的文章文件名删去。

Comments