当使用 Hexo 进行博客开发时,所用到的语法主要有两部分:Markdown 和 Hexo。下面将分别介绍它们的语法。
# Markdown 语法
Markdown 是一种轻量级的标记语言,适用于写博客、笔记等文本类内容。其语法简单易懂,可以快速学习和掌握。下面是 Markdown 的常用语法:
# 标题
使用 # 来表示标题,# 的数量表示标题的级别,例如 # 表示一级标题,## 表示二级标题,以此类推。
# 一级标题 | |
## 二级标题 | |
### 三级标题 |
# 列表
使用 - 或 * 来创建无序列表,或使用数字和。来创建有序列表。
- 无序列表项1 | |
- 无序列表项2 | |
1. 有序列表项1 | |
2. 有序列表项2 |
# 引用
使用 > 来创建引用。
> 这是一段引用。 |
# 图片
使用 语法来插入图片,其中 [] 中填写图片的描述,() 中填写图片的链接。
![图片描述](图片链接) |
# 链接
使用 语法来插入链接,其中 [] 中填写链接的描述,() 中填写链接的地址。
[链接描述](链接地址) | |
[点我跳转](https://onlyzyx.com/posts/39295.html#结语) | |
显示的内容 跳转的连接 #跳转的标题 |
# 代码块
使用 ```来标记代码块,也可以使用单个` 来标记内嵌代码。
```python | |
print('hello, world') | |
print('hello, world') | |
Copy Code | |
### 分割线 | |
使用 --- 来插入分割线。 | |
```markdown | |
--- |
# 其他
Markdown 还支持粗体、斜体、删除线、表格等语法,具体用法可以参考 Mardown 教程。
# Hexo 语法
除了 Markdown,Hexo 还提供了许多自身的语法和功能,用于对博客进行更加细致的管理和展示。
# Front-matter
Front-matter 是指位于文章开头的 YAML 格式头部信息,用来定义文章的元数据。例如:
--- | |
title: 示例文章 | |
date: 2023-10-15 | |
tags: | |
- 技术 | |
- 编程 | |
--- |
Hexo 会解析 Front-matter,将元数据存储到数据库中。
# 标签和分类
标签(Tags)用于对文章进行分类和标记,分类(Categories)用于对文章进行更精细的归类。你可以在文章的 Front-matter 中添加 tags 和 categories 字段,将文章与特定的标签或分类相关联。例如:
--- | |
title: 示例文章 | |
date: 2023-10-15 | |
tags: | |
- 技术 | |
- 编程 | |
categories: 技术 | |
--- |
# 摘要
摘要(Excerpt)是文章的简短描述,通常用于在首页或文章列表中展示。你可以在文章正文中添加 <!-- more -->
标签来分隔摘要和完整内容。例如:
--- | |
title: 示例文章 | |
date: 2023-10-15 | |
--- | |
这是文章的摘要部分。 | |
<!-- more --> | |
这是文章的完整内容。 |
# 扩展名
扩展名(Permalink)用于自定义文章的 URL 地址。默认情况下,Hexo 会根据文章的创建时间和文件名生成 URL。但你也可以自定义 URL,比如使用文章的标题作为扩展名。在配置文件 _config.yml
中可以设置 permalink 的格式。例如:
yamlCopy Codepermalink: :title/ |
这样,文章的 URL 会根据标题生成。
# 标签和分类页面
除了给文章打标签和分类外,还可以将标签和分类显示到相应的页面中。你可以在主题中相关位置插入标签和分类的链接,或使用 Hexo 提供的 tag 和 category 页面生成器,自动生成标签页和分类页。
# 链接页语法
|
效果:
https://gitee.com/flechazo5201314/qtfactory
# Sakura 主题
Sakura 是一款基于 Bootstrap 4 的响应式 Hexo 主题,具有清新优美的设计风格和强大的自定义功能。以下是一些常用的 Sakura 特性:
# 自定义头图
Sakura 支持自定义头图,即在文章中添加 cover
字段,来指定当前文章的头图。例如:
--- | |
title: 示例文章 | |
date: 2023-10-15 | |
cover: /images/cover.jpg | |
--- |
# 自定义页面
Sakura 支持自定义页面,你可以在 source
目录下创建 .md
文件,设置 layout: page
,并添加自己的内容,就可以在站点上添加一个新的页面了。
--- | |
title: 关于我 | |
layout: page | |
--- | |
这是关于我的内容。 |
# 归档页面
Sakura 内置了归档页面,可以根据文章发布时间自动生成各年份、各月份的文章列表。
# 侧边栏小部件
Sakura 还提供了多个侧边栏小部件,用于展示标签、分类、最近更新的文章等信息。
以上是关于 Hexo、Markdown 和 Sakura 主题的语法和特性,希望对你有所帮助!
# 文章锁
password: chai | |
abstract: 柴大大的私密文件哦! | |
message: 请输入正确的密码访问哦! | |
wrong_pass_message: 抱歉,这个密码看着不太对,请再试试。 | |
wrong_hash_message: 抱歉,这个文章不能被纠正,不过您还是能看看解密后的内容。 |