Obsidian DB Folder 数据库视图技术解析

Obsidian DB Folder 数据库视图技术解析

【免费下载链接】obsidian-db-folder Obsidian Plugin to Allow Notion like database based on folders 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-db-folder

什么是数据库视图

Obsidian DB Folder 插件通过解析 Markdown 文件中的 YAML 配置，动态渲染出一个功能完善的数据库视图界面。这个视图基于 React 技术构建，提供了直观的数据管理和操作体验。

核心功能解析

1. 数据库基本信息配置

每个数据库视图都包含两个基础信息字段：

• name：数据库名称，用于标识这个数据集
• description：数据库描述，详细说明这个数据库的用途和内容，会在预览模式下显示

2. 列配置详解

数据库的核心是列(columns)配置，它定义了数据结构、显示方式和交互行为。每个列配置都支持完整的 React-Table 列配置参数。

必填参数

• input：列的数据类型，支持 text(文本)、markdown(Markdown格式)、number(数字)、select(下拉选择)、checkbox(复选框)、calendar(日期)等
• key：对应笔记中的元数据字段名（当前版本暂不支持行内编辑）
• accessor：数据访问键，必须是唯一标识符
• label：列标题，显示在表格顶部

可选参数

• position：列在表格中的显示顺序
• options：当列类型为 select 时，定义可选值列表及其显示样式

高级配置

• isInline：设为 true 可启用行内编辑模式
• enable_media_view：对于文本类型列，设为 true 可启用媒体视图
  • media_width：媒体视图宽度
  • media_height：媒体视图高度

本地配置示例

以下是一个完整的数据库配置示例，展示了多种列类型的配置方式：

database-plugin: basic

name: 娱乐媒体库
description: 记录我消费的所有媒体内容
columns:
  评分:
    input: select
    accessor: 评分
    label: 评分
    key: 评分
    position: 5
    enable_media_view: true
    media_width: 100
    media_height: 100
    isInline: false
    options:
      - { label: "⭐️⭐️⭐️⭐️⭐️", backgroundColor: "hsl(0,62.66650406270436%,57.196614999999994%)"}
      - { label: "⭐️⭐️⭐️⭐️", backgroundColor: "hsl(305, 95%, 90%)"}
      - { label: "⭐️⭐️⭐️", backgroundColor: "hsl(116, 95%, 90%)"}
      - { label: "⭐️⭐️", backgroundColor: "hsl(185, 95%, 90%)"}
      - { label: "⭐️", backgroundColor: "hsl(78, 95%, 90%)"}
  导演:
    input: text
    accessor: 导演
    label: 导演
    key: 导演
    position: 4
    enable_media_view: true
  年份:
    input: number
    accessor: 年份
    label: 年份
    key: 年份
    position: 7
  文件:
    key: __file__
    input: markdown
    label: 文件
    accessor: __file__
    isMetadata: true
    position: 1
  标题:
    input: text
    accessor: 标题
    label: 标题
    key: 标题
    position: 6
  观看日期:
    input: calendar
    accessor: 观看日期
    key: 观看日期
    label: 观看日期
    position: 3
    isSorted: true
    isSortedDesc: true
  已观看:
    input: checkbox
    accessor: 已观看
    key: 已观看
    label: 已观看
    position: 2
config:
  cell_size: normal
  sticky_first_column: false
  remove_field_when_delete_column: true
  media_settings:
    enable_media_view: true
    width: 100
    height: 100

使用技巧与最佳实践

1. 列类型选择：根据数据类型选择合适的 input 类型，如日期选择 calendar，评分选择 select 等

2. 排序配置：通过 isSorted 和 isSortedDesc 控制列的默认排序方式

3. 媒体视图：对于包含图片或视频链接的文本列，启用 enable_media_view 可提供更好的预览体验

4. 元数据列：file 是特殊列，用于显示关联的文件信息

5. 配置复用：相似的数据库可以通过复制和修改 YAML 配置快速创建

Obsidian DB Folder 的数据库视图功能强大而灵活，通过合理的配置可以构建出满足各种需求的数据管理系统，从简单的媒体库到复杂的研究资料库都能轻松应对。

【免费下载链接】obsidian-db-folder Obsidian Plugin to Allow Notion like database based on folders 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-db-folder