# project-timeline

**Repository Path**: s1jeai/project-timeline

## Basic Information

- **Project Name**: project-timeline
- **Description**: 这是一个以 Markdown + properties 为底层数据，以纵向项目线视图显示的 Obsidian 插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目时间线 Obsidian 插件

这是一个以 Markdown + properties 为底层数据的 Obsidian 插件。插件不使用私有数据库，只读取和创建普通 Markdown 项目线笔记，便于版本管理、迁移和手动编辑。

## 功能

- 纵向项目线视图，最新时间在上方。
- 只显示项目线，界面保持单一时间线。
- 多条项目线重叠时会围绕界面中心均匀平铺。
- 项目线左侧只显示起始日期和结束日期。
- 项目信息以三行小卡片显示：项目名称、日期范围、标签。
- 拖动项目线顶部或底部手柄，可按天修改开始和结束日期。

## 安装到 Obsidian

运行：

```powershell
npm run build
```

然后将 `output` 文件夹中的三个文件复制到你的库：

```text
<你的库>/.obsidian/plugins/project-timeline/
```

在 Obsidian 设置中启用“项目时间线”。

## Markdown properties 约定

```yaml
---
timeline-title: 项目名称
timeline-start: 2026-05-01
timeline-end: 2026-06-30
tags:
  - 工作
  - 重要
---
```

插件只扫描设置里的记录保存文件夹，默认是 `project-timeline/`。文件必须包含 `timeline-start` 才会显示为项目线，`timeline-end` 留空时，插件会临时按当前时间显示。普通 `start` / `end` 属性不会被识别。