博客写作模版

工欲善其事必先利其器，若想要自己写的博客文章好看，吸引更多的人，那么博客的结构必须合理，格式必须正确，这样才能使得人们更有动力阅读下去

设置文章类型

# tech: 默认技术类文章,
# story: 图文类文章 。图文类文章，文字和段落间增距大。
# 可以在 front-matter/topic/wiki 中覆盖此参数。

article:
  type: tech # tech/story

文章封面

自动生成封面

article:
  auto_cover: true  # 自动生成的封面可能会变掉，如果需要封面图片建议使用自己的图床

引用外部图片

---
# 在具体文章中设置
# 可以直接使用本地路径，/assets/xxx.svg
# 也可以直接引用图片直链 https://xxx.jpg
cover: /assets/xxx.svg
poster: # 海报（可选，全图封面卡片）
  topic: 标题上方的小字 # 可选
  headline: 大标题 # 必选
  caption: 标题下方的小字 # 可选
  color: 标题颜色 # 可选，默认为跟随主题的动态颜色 # white,red...
---

显示效果

内容摘要

自动生成摘要

# 自动从文章内容截取一定字数的文字作为摘要，
article:
  auto_excerpt: 200 # 自动截取 200 个字符作为摘要

手动设置摘要

在
摘要与正文中间使用  隔开，或者在头部使用 description 或者 excerpt 来设置

---
cover: /assets/xaoxuu/blog/2020-0927a@1x.svg
description: # excerpt 也可  文章摘要
---
摘要
<!-- more -->
正文

AI摘要

基于 tianli_gpt 生成AI摘要。在_config.stellar.yml中配置

tianli_gpt: 
  enable: #true
  js: https://jsd.onmicrosoft.cn/gh/qxchuckle/Post-Summary-AI@6.0/chuckle-post-ai.min.js
  field: post # all, post, wiki
  key: 5Q5mpqRK5DkwT1X9Gi5e # tianli_gpt key
  total_length: 1000 # 设置提交的字数限制，默认为1000字，上限为5000，超过5000字符将被截断
  typewriter: true # 打字机动画 
  summary_directly: true # 是否直接显示摘要，否则显示 AI 简介
  rec_method: all # all, web # 文章推荐方式，all：匹配数据库内所有文章进行推荐，web：仅当前站内的文章，默认all
  hide_shuttle: true # 是否隐藏矩阵穿梭
  summary_toggle: false # 是否开启切换简介功能，经过一些处理后，重新生成一份简介，这将消耗key字数
  interface: # AI 信息展示
    name: AI摘要
    introduce: '我是文章辅助AI: QX-AI，点击下方的按钮，让我生成本文简介、推荐相关文章等。'
    version: TianliGPT
    button: ["介绍自己", "推荐文章", "生成摘要", "矩阵穿梭"] # 底部按钮文字

基于白嫖原理，没试过，可以自行尝试购买地址

文章模版

---
# 基本信息
title: {{ title }} # 标题
date: {{ date }} # 创建日期
tags: []  # 标签
categories: []  # 分类
description: # excerpt 也可  文章摘要
# 封面
cover:  # 文章封面
banner:  # 阅读页顶部背景
poster: # 海报（可选，全图封面卡片）
  topic: 标题上方的小字 # 可选
  headline: 大标题 # 必选
  caption: 标题下方的小字 # 可选
  color: 标题颜色 # 可选
# 插件
sticky: # 置顶 数字越大越靠前
mermaid: false # 是否需要渲染图表 boolean
katex:  false # 渲染文章公式
mathjax:  false # 渲染文章公式
# 可选
topic: # 所属话题/专栏 id 
author:  # 该文章的作者
references: # 参考资料
comments: # 设置 false 禁止评论
indexing: # 设置 false 避免被搜索
breadcrumb: # 设置 false 隐藏面包屑导航
leftbar: # 左侧导航
rightbar: # 右侧导航
h1: # 设置为 '' 隐藏标题
type: # tech/story
---

参考资料

用 markdown 格式填写引用的文章，注意要写在引号中：

---
references:
  - '[引用文章1](https://xxx.html)'
  - '[引用文章2](https://xxx.html)'
---

显示效果

许可协议

可以更改协议内容或者自定义其他选项，支持 MarkDown 语法。

article:
  license: '本文采用 [署名-非商业性使用-相同方式共享 4.0 国际](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议，转载请注明出处。'

若你配置了作者数据 _data/authors.yml 和文章作者，可以在 license 中使用 {author.name} 来自动替换为当前文章作者名字。

article:
  license: '本文由{author.name}编写，采用...'

配置分享

分享至微信会生成对应的页面二维码，weibo 和 email 会自动跳转到对应软件或网页，link 会拷贝当前页面链接至剪切板。

article:
  share: # [wechat, weibo, email, link]

独立页面

这个配置也是我比较喜欢的，可以配置自己特定的标签
例如，你有一个更多按钮，有两篇文章都隶属于更多按钮
在主题配置文件中设置更多导航栏：

menubar:
  columns: 4 # 一行多少个
  items: # 可按照自己需求增加，符合以下格式即可
    ...
    - id: more
      theme: ''
      title: 更多
      icon: ''
      url: /more/

然后两篇文章的配置

---
menu_id: more
title: 第一篇文章
---

---
menu_id: more
title: 第二篇文章
---

本文采用署名-非商业性使用-相同方式共享 4.0 国际许可协议，转载请注明出处。

文章大标题