博客插件详解¶

Zensical 内置的强大博客系统

功能尚未实现

博客功能目前在 Zensical 的 Tier 2 规划列表中，尚未实现。本文档中的配置暂时无效，请等待官方发布。

什么是博客插件？¶

博客插件计划提供的功能：

📦 开箱即用 - 无需额外安装
📑 自动索引 - 自动生成博客列表
🏷️ 分类标签 - 支持分类和标签
⏱️ 阅读时间 - 自动计算阅读时间
📝 草稿功能 - 支持草稿管理
👤 作者信息 - 显示作者和日期

计划配置（待功能发布）¶

在 zensical.toml 中启用博客插件：

[project.plugins.blog]
post_date_format = "full"                    # 日期格式
draft = true                                  # 启用草稿
post_readtime = true                          # 显示阅读时间
post_readtime_words_per_minute = 265          # 每分钟阅读字数（中文适配）
post_url_format = "{date}/{slug}"             # 文章 URL 格式
pagination_per_page = 10                      # 每页显示文章数
pagination_url_format = "page/{page}"         # 分页 URL 格式

创建博客文章¶

在 docs/blog/posts/ 目录下创建 Markdown 文件：

---
title: 我的第一篇博客
date: 2025-01-22
authors:
  - name: 你的名字
    email: your@email.com
categories:
  - 技术
  - Python
tags:
  - Zensical
  - 教程
---

# 我的第一篇博客

这是文章内容...

配置选项详解¶

postdateformat¶

日期显示格式：

full - 完整日期（如：2025年1月22日）
short - 简短格式（如：2025-01-22）
medium - 中等格式

post_readtime¶

自动计算阅读时间：

post_readtime = true
post_readtime_words_per_minute = 265  # 中文适配

draft¶

草稿功能：

draft = true                    # 启用草稿
draft_if_future_date = true     # 未来日期自动标记为草稿

更多详细内容请参考博客系统完全指南。