【亲测免费】 Heatmap Calendar 插件使用手册 for Obsidian

---

1. 目录结构及介绍

该开源项目 heatmap-calendar-obsidian 是一个专门为 Obsidian 知识管理软件设计的插件，用于在日历视图中以热图形式展示数据，类似于 GitHub 活动日历。下面简要介绍其核心目录结构：

• main.css：存放样式定义，控制热图显示的视觉效果。
• main.ts：主程序文件，实现插件的核心逻辑和功能。
• manifest.json：插件的元数据文件，包括名称、版本、作者等信息以及必要的配置项。
• package.json 和 package-lock.json：定义了项目依赖及版本，用于npm包管理。
• settings.ts：包含了插件设置的代码，允许用户自定义颜色方案等。
• .gitignore, .editorconfig, eslintignore, eslintrc 等文件则是开发过程中的配置文件，帮助保持代码质量和忽略不必要的文件。
• LICENSE: 使用的开源协议，本项目遵循 Apache-2.0 许可证。
• README.md: 项目介绍和快速入门指南，虽然在此提供详细文档，但初始阅读此文件对于理解项目至关重要。

---

2. 项目启动文件介绍

主启动文件：main.ts

这是插件运行的核心文件，它初始化插件功能并与Obsidian环境集成。主要职责包括：

• 注册插件到Obsidian环境中。
• 实现DataviewJS接口来收集并处理数据。
• 调用渲染函数（如renderHeatmapCalendar）来在用户界面中显示热图日历。

开发者需关注如何接收来自用户daily notes的数据，如何处理这些数据，并最终通过JavaScript调用来展现热图。

---

3. 配置文件介绍

manifest.json 文件

这是一个关键的配置文件，提供了插件的基本信息和一些元数据。示例字段包括：

• "name": 插件的名字，如 "Heatmap Calendar".
• "version": 当前插件版本号。
• "description": 描述插件的功能。
• "author": 开发者的姓名或团队名。
• 还有其他配置项如图标路径、兼容的Obsidian版本等。

用户配置：settings.ts

虽然不是传统意义上的项目配置文件，但在用户端，settings.ts 允许用户通过Obsidian的设置界面自定义热图的颜色方案。用户可以通过这个文件添加新的颜色模式，影响到插件的显示效果，无需直接编辑代码。

实践配置：DataviewJS块

在实际使用过程中，用户会在笔记中编写DataviewJS块来配置和调用插件，尽管这不是项目内文件，但它构成了用户如何与插件互动的“配置”部分。例如，定义数据集、选择颜色方案等都是在这个上下文中完成的。

---

综上所述，heatmap-calendar-obsidian项目的结构清晰，注重于用户友好性和高度定制性，使用户能够灵活地将日常追踪数据可视化，增强知识管理体验。