Data Cards插件文档链接修复与属性标签使用指南

Data Cards插件文档链接修复与属性标签使用指南

Data Cards是Obsidian生态中一款强大的数据可视化插件，能够将Dataview查询结果转换为美观、可自定义的卡片布局。近期项目维护者针对用户反馈的文档问题和功能使用进行了重要更新。

文档访问问题修复

项目维护者确认并修复了README文件中多个文档链接失效的问题。现在用户可以通过文档按钮正常访问全部技术文档，确保用户能够顺利查阅插件的完整功能说明和配置指南。

属性标签的正确使用方法

在技术实现层面，插件对属性标签的配置方式进行了明确规范。早期文档中建议的JSON格式配置方式：

propertyLabels: {
  "file.link": "Name",
  "test": "Yak"
}

已被证实不可用。正确的实现方式是在Dataview查询语句中直接使用SQL风格的别名定义：

```datacards
TABLE file.link as "Name", test as "Yak"
FROM "Testing"
SORT file.name ASC

// Settings
preset: dense
columns: 3
properties: [Name, Yak]
```

这种语法设计更符合Obsidian生态中Dataview插件的一贯风格，既保持了语法的一致性，又能实现以下技术优势：

1. 直接在查询层面定义显示名称，减少额外配置
2. 与Dataview原生查询语法完美兼容
3. 支持在properties数组中引用已定义的别名

技术建议

对于Obsidian插件开发者，这个案例提供了有价值的经验：

1. 文档链接需要定期验证可用性
2. 功能说明应当与实际代码实现保持严格一致
3. 语法设计应优先考虑与生态中主流插件的一致性

普通用户在使用时应当注意：

• 始终检查插件文档的最新版本
• 复杂查询建议先在Dataview中测试通过
• 属性别名定义要确保前后引用一致

该插件目前已进入Obsidian官方社区插件审核流程，未来版本将会带来更稳定的使用体验和更完善的文档支持。