553 lines
12 KiB
Markdown
553 lines
12 KiB
Markdown
---
|
||
title: 生成地点笔记文件完整流程总结
|
||
created: 2026-04-13
|
||
tags:
|
||
- wiki
|
||
- tools/obsidian
|
||
- tools/bases
|
||
- tools/map
|
||
- type/指南
|
||
- places/笔记规范
|
||
description: Obsidian中生成地点笔记文件的完整流程、规范和最佳实践
|
||
para:
|
||
- places
|
||
- resources
|
||
categories:
|
||
- '[[LLM Wiki]]'
|
||
- '[[Places]]'
|
||
source: '[[地点笔记文件生成流程总结]]'
|
||
type: place
|
||
loc: []
|
||
rating: null
|
||
last: 2026-04-13
|
||
---
|
||
|
||
# 生成地点笔记文件完整流程总结
|
||
|
||
## 一、前期准备
|
||
|
||
### 1.1 参考现有模板
|
||
|
||
**必读参考文件：**
|
||
|
||
```
|
||
References/Kyoto.md # 地点笔记结构示例
|
||
Templates/Place Template.md # 基础frontmatter模板
|
||
Templates/Bases/Places.base # Places的Base视图配置
|
||
Templates/Bases/Map.base # 地图视图配置参考
|
||
```
|
||
|
||
**参考Kyoto.md的关键模式：**
|
||
|
||
```yaml
|
||
# Frontmatter格式
|
||
categories:
|
||
- "[[LLM Wiki]]"
|
||
- "[[Places]]" # 字符串格式，不是Wikilink
|
||
type: place
|
||
- landmark # 列表格式，每项一行
|
||
loc:
|
||
- "[[Wuhan]]" # Wikilink格式
|
||
coordinates:
|
||
- "30.5438" # 分两行的字符串格式
|
||
- "114.3055"
|
||
rating: 5
|
||
```
|
||
|
||
**参考Kyoto.md的内容结构：**
|
||
|
||
```markdown
|
||
## Trips
|
||
![[Templates/Bases/Trips.base#Location]]
|
||
|
||
## Places
|
||
![[Templates/Bases/Map.base#Location]]
|
||
![[Templates/Bases/Places.base#Location]]
|
||
```
|
||
|
||
### 1.2 检查必要条件
|
||
|
||
| 检查项 | 要求 | 状态 |
|
||
|
|
||
----
|
||
----|------|------|
|
||
| Places分类存在 | `Categories/Places.md` | ✅ |
|
||
| Map.base模板 | `Templates/Bases/Map.base` | ✅ |
|
||
| Places.base模板 | `Templates/Bases/Places.base` | ✅ |
|
||
| Trips.base模板 | `Templates/Bases/Trips.base` | ✅ |
|
||
| 瓦片代理启动 | 端口18090运行 | ⚠️ 地图加载前提 |
|
||
|
||
---
|
||
|
||
## 二、文件创建流程
|
||
|
||
### 2.1 创建地点笔记
|
||
|
||
**文件路径：** `References/[地点名称].md`
|
||
|
||
**Frontmatter配置：**
|
||
|
||
```yaml
|
||
---
|
||
categories:
|
||
- "[[LLM Wiki]]"
|
||
- "[[Places]]" # 字符串格式Wikilink
|
||
type: place
|
||
- landmark # 类型1
|
||
- tower # 类型2（可选）
|
||
loc:
|
||
- "[[Wuhan]]" # 地区Wikilink
|
||
coordinates:
|
||
- "30.5438" # 纬度（字符串）
|
||
- "114.3055" # 经度（字符串）
|
||
rating: 5
|
||
address: 湖北省武汉市武昌区蛇山西端
|
||
icon: 🏯
|
||
color: #d4a574
|
||
created: 2026-04-10
|
||
---
|
||
```
|
||
|
||
**Frontmatter字段说明：**
|
||
|
||
| 字段 | 格式 | 用途 | 示例 |
|
||
|------|------|------|------|
|
||
| **categories** | 字符串列表 | 主分类 | `"[[Places]]"` |
|
||
| **type** | 列表 | 地点类型 | `landmark`, `tower` |
|
||
| **loc** | Wikilink列表 | 地理位置 | `"[[Wuhan]]"` |
|
||
| **coordinates** | 分两行字符串 | 地图坐标 | `"30.5438"` |
|
||
| **rating** | 数字 | 评分 | `5` |
|
||
| **address** | 字符串 | 详细地址 | 汉字地址 |
|
||
| **icon** | Emoji | 标记图标 | `🏯` |
|
||
| **color** | 十六进制 | 标记颜色 | `#d4a574` |
|
||
| **created** | YYYY-MM-DD | 创建日期 | `2026-04-10` |
|
||
|
||
### 2.2 内容结构
|
||
|
||
```markdown
|
||
# [地点名称]
|
||
|
||
简介描述...
|
||
|
||
## 历史背景
|
||
|
||
## 建筑特色
|
||
|
||
## 文化价值
|
||
|
||
## 地理位置与交通
|
||
|
||
## 游览建议
|
||
|
||
## Trips
|
||
|
||
![[Templates/Bases/Trips.base#Location]]
|
||
|
||
## Places
|
||
|
||
![[Templates/Bases/Map.base#Location]]
|
||
|
||
![[Templates/Bases/Places.base#Location]]
|
||
|
||
## 参考资料
|
||
```
|
||
|
||
---
|
||
|
||
## 三、Base视图配置
|
||
|
||
### 3.1 Places.base Location地图视图
|
||
|
||
**文件：** `Templates/Bases/Places.base`
|
||
|
||
**添加Location地图视图：**
|
||
|
||
```yaml
|
||
- type: map
|
||
name: Location
|
||
filters:
|
||
and:
|
||
- list(loc).contains(this)
|
||
order:
|
||
- file.name
|
||
- type
|
||
- rating
|
||
- last
|
||
sort:
|
||
- property: rating
|
||
direction: DESC
|
||
- property: last
|
||
direction: DESC
|
||
- property: loc
|
||
direction: ASC
|
||
coordinates: note.coordinates # ⚠️ 关键配置
|
||
markerIcon: note.icon
|
||
markerColor: note.color
|
||
defaultZoom: 12
|
||
```
|
||
|
||
**关键配置点：**
|
||
|
||
- ✅ `coordinates: note.coordinates` - 读取笔记的coordinates属性
|
||
- ✅ `markerIcon: note.icon` - 使用笔记的icon属性作为标记图标
|
||
- ✅ `markerColor: note.color` - 使用笔记的color属性作为标记颜色
|
||
- ✅ `defaultZoom: 12` - 默认缩放级别
|
||
- ✅ `filters: list(loc).contains(this)` - 只显示loc包含当前地点的笔记
|
||
|
||
### 3.2 为什么需要修改Places.base
|
||
|
||
**问题：** 原Places.base只有表格视图，没有地图视图
|
||
|
||
**解决：** 添加Location地图视图，使`![[Templates/Bases/Places.base#Location]]`能显示为地图
|
||
|
||
**影响范围：**
|
||
- ✅ 不影响现有的Places、Type、Related等表格视图
|
||
- ✅ 只新增一个Location地图视图
|
||
- ✅ 所有使用Places.base的地点笔记都会受益
|
||
|
||
---
|
||
|
||
## 四、常见问题与解决方案
|
||
|
||
### 4.1 Categories显示错误
|
||
|
||
**问题：** categories显示为 `[[Places]]` 或 `\[[Places]]\`
|
||
|
||
**原因：** 格式混淆
|
||
|
||
| 格式 | 正确性 | 说明 |
|
||
|------|--------|------|
|
||
| `[[Places]]` | ⚠️ Wikilink格式 | 适用于内联链接 |
|
||
| `"[[Places]]"` | ✅ 字符串格式 | Places.base期望的格式 |
|
||
| `\[[Places]]\` | ❌ 错误 | 反斜杠转义 |
|
||
|
||
**解决：**
|
||
|
||
```yaml
|
||
categories:
|
||
- "[[LLM Wiki]]"
|
||
- "[[Places]]" # 正确
|
||
```
|
||
|
||
### 4.2 Coordinates格式不兼容
|
||
|
||
**问题：** 地图无法显示标记点
|
||
|
||
**常见格式：**
|
||
|
||
| 格式 | 兼容性 | 说明 |
|
||
|------|--------|------|
|
||
| `location: [30.5438, 114.3055]` | ❌ | 数组格式，Maps插件不支持 |
|
||
| `coordinates: [30.5438, 114.3055]` | ⚠️ | 数组格式，需Places.base配置 |
|
||
| `coordinates: "30.5438, 114.3055"` | ⚠️ | 单行字符串，需拆分 |
|
||
| `coordinates:\n - "30.5438"\n - "114.3055"` | ✅ | 分两行的字符串格式 |
|
||
|
||
**解决（Kyoto模式）：**
|
||
|
||
```yaml
|
||
coordinates:
|
||
- "30.5438"
|
||
- "114.3055"
|
||
```
|
||
|
||
### 4.3 Base文件解析错误
|
||
|
||
**问题：** Obsidian报错"无法解析数据库文件"
|
||
|
||
**常见原因：**
|
||
|
||
1. **YAML缩进错误**
|
||
|
||
```yaml
|
||
# ❌ 错误
|
||
views:
|
||
- type: map
|
||
name: 地图 # 缩进不一致
|
||
|
||
# ✅ 正确
|
||
views:
|
||
- type: map
|
||
name: 地图 # 统一缩进
|
||
```
|
||
|
||
2. **特殊字符未转义**
|
||
|
||
```yaml
|
||
# ❌ 错误
|
||
description: "This is a "quote" test"
|
||
|
||
# ✅ 正确
|
||
description: 'This is a "quote" test'
|
||
```
|
||
|
||
3. **坐标配置缺失**
|
||
|
||
```yaml
|
||
# ❌ 缺少coordinates配置
|
||
- type: map
|
||
name: Location
|
||
|
||
# ✅ 添加coordinates
|
||
- type: map
|
||
name: Location
|
||
coordinates: note.coordinates
|
||
```
|
||
|
||
**解决方法：**
|
||
1. 参考Obsidian Bases文档
|
||
2. 使用在线YAML验证器
|
||
4. 从简单配置开始，逐步添加功能
|
||
|
||
### 4.4 地址编码乱码
|
||
|
||
**问题：** address字段显示为乱码
|
||
|
||
**原因：** 文件保存时使用了错误的编码
|
||
|
||
**解决：**
|
||
|
||
```powershell
|
||
# 使用UTF-8编码重写文件
|
||
$content = Get-Content "文件路径" -Encoding UTF8
|
||
Set-Content -Path "文件路径" -Value $content -Encoding UTF8 -NoNewline
|
||
```
|
||
|
||
### 4.5 地图空白无法加载
|
||
|
||
**问题：** Base地图视图显示空白
|
||
|
||
**检查清单：**
|
||
|
||
| 检查项 | 操作 | 预期结果 |
|
||
|--------|------|---------|
|
||
| 瓦片代理运行 | 浏览器访问 <http://127.0.0.1:18090/status> | "ok" |
|
||
| Maps插件启用 | 设置 → 社区插件 → Maps | ✅ 开启 |
|
||
| 地图背景配置 | Maps设置 → Background | 有5+选项 |
|
||
| coordinates属性存在 | 检查笔记frontmatter | 有coordinates字段 |
|
||
| 坐标格式正确 | `coordinates:\n - "lat"\n - "lng"` | 分两行字符串 |
|
||
|
||
---
|
||
|
||
## 五、最佳实践建议
|
||
|
||
### 5.1 文件组织
|
||
|
||
```
|
||
MyNotes/
|
||
├── 黄鹤楼.md # 地点笔记
|
||
├── 故宫.md
|
||
└── 长城.md
|
||
|
||
Categories/
|
||
└── Places.md # Places分类索引
|
||
|
||
Templates/Bases/
|
||
├── Places.base # Places的Base配置（含Location地图视图）
|
||
├── Map.base # 全局地图视图
|
||
└── Trips.base # 旅行记录
|
||
```
|
||
|
||
### 5.2 Frontmatter规范
|
||
|
||
**推荐顺序：**
|
||
|
||
1. categories（主分类）
|
||
2. type（类型）
|
||
3. loc（地区）
|
||
4. coordinates（坐标）
|
||
5. rating（评分）
|
||
6. address（地址）
|
||
7. icon/color（外观）
|
||
8. created（日期）
|
||
|
||
**推荐格式：**
|
||
|
||
```yaml
|
||
categories:
|
||
- "[[LLM Wiki]]"
|
||
- "[[Places]]" # 字符串格式Wikilink
|
||
type: place
|
||
- landmark # 小写，用连字符
|
||
loc:
|
||
- "[[Wuhan]]" # Wikilink到分类
|
||
coordinates:
|
||
- "30.5438" # 纬度字符串
|
||
- "114.3055" # 经度字符串
|
||
rating: 5
|
||
address: 湖北省武汉市武昌区蛇山西端
|
||
icon: 🏯
|
||
color: #d4a574
|
||
created: 2026-04-10
|
||
```
|
||
|
||
### 5.3 Base视图命名规范
|
||
|
||
| 视图类型 | 推荐命名 | 说明 |
|
||
|---------|---------|------|
|
||
| **map** | Location | 显示地点位置的地图 |
|
||
| **table** | Details | 详细信息表格 |
|
||
| **table** | Location Details | 按地区过滤的表格 |
|
||
| **table** | Related | 相关链接的笔记 |
|
||
|
||
### 5.4 嵌入模式
|
||
|
||
**Kyoto模式（推荐）：**
|
||
|
||
```markdown
|
||
## Places
|
||
![[Templates/Bases/Map.base#Location]] # 主地图
|
||
![[Templates/Bases/Places.base#Location]] # 同地区地点
|
||
```
|
||
|
||
**独立Base模式（不推荐）：**
|
||
|
||
```markdown
|
||
## Places
|
||
![[黄鹤楼.base]] # 独立的base文件
|
||
```
|
||
|
||
**原因：** 独立base文件难以维护，Kyoto模式使用共享的Places.base
|
||
|
||
### 5.5 坐标获取
|
||
|
||
| 方法 | 精度 | 坐标系 | 推荐度 |
|
||
|------|--------|--------|--------|
|
||
| Maps右键Copy coordinates | 高 | 自动 | ⭐⭐⭐ |
|
||
| 腾讯地图网页 | 高 | GCJ-02 | ⭐⭐ |
|
||
| 高德地图网页 | 高 | GCJ-02 | ⭐⭐ |
|
||
| 手机GPS | 最高 | WGS-84 | ⭐⭐⭐ |
|
||
|
||
**注意事项：**
|
||
- 国内使用GCJ-02（腾讯/高德）减少偏移
|
||
- Obsidian Maps不做坐标转换，保持一致
|
||
|
||
---
|
||
|
||
## 六、完整检查清单
|
||
|
||
### 6.1 创建前检查
|
||
|
||
- [ ] Places分类文件存在
|
||
- [ ] Places.base模板存在
|
||
- [ ] Map.base模板存在
|
||
- [ ] 瓦片代理已启动
|
||
|
||
### 6.2 创建后验证
|
||
|
||
- [ ] categories格式正确（`"[[Places]]"`）
|
||
- [ ] coordinates格式正确（分两行字符串）
|
||
- [ ] loc使用Wikilink（`"[[Wuhan]]"`）
|
||
- [ ] icon和color已设置
|
||
- [ ] 中文地址无乱码
|
||
- [ ] Trips嵌入正确
|
||
- [ ] Places.base#Location嵌入正确
|
||
- [ ] Map.base#Location嵌入正确
|
||
|
||
### 6.3 功能验证
|
||
|
||
- [ ] Places.base#Location显示地图
|
||
- [ ] 地图上能看到标记点
|
||
- [ ] 标记点位置正确
|
||
- [ ] 点击标记能跳转到笔记
|
||
- [ ] 地图能缩放和拖动
|
||
|
||
---
|
||
|
||
## 七、快速参考
|
||
|
||
### Frontmatter完整示例
|
||
|
||
```yaml
|
||
---
|
||
categories:
|
||
- "[[LLM Wiki]]"
|
||
- "[[Places]]"
|
||
type: place
|
||
- landmark
|
||
- tower
|
||
loc:
|
||
- "[[Wuhan]]"
|
||
coordinates:
|
||
- "30.5438"
|
||
- "114.3055"
|
||
rating: 5
|
||
address: 湖北省武汉市武昌区蛇山西端
|
||
icon: 🏯
|
||
color: #d4a574
|
||
created: 2026-04-10
|
||
---
|
||
|
||
# 黄鹤楼
|
||
|
||
[内容...]
|
||
|
||
## Trips
|
||
|
||
![[Templates/Bases/Trips.base#Location]]
|
||
|
||
## Places
|
||
|
||
![[Templates/Bases/Map.base#Location]]
|
||
|
||
![[Templates/Bases/Places.base#Location]]
|
||
```
|
||
|
||
### Places.base Location视图配置
|
||
|
||
```yaml
|
||
- type: map
|
||
name: Location
|
||
filters:
|
||
and:
|
||
- list(loc).contains(this)
|
||
order:
|
||
- file.name
|
||
- type
|
||
- rating
|
||
- last
|
||
sort:
|
||
- property: rating
|
||
direction: DESC
|
||
coordinates: note.coordinates
|
||
markerIcon: note.icon
|
||
markerColor: note.color
|
||
defaultZoom: 12
|
||
```
|
||
|
||
---
|
||
|
||
## 八、关键要点回顾
|
||
|
||
1. **categories使用字符串格式** `"[[Places]]"`
|
||
2. **coordinates分两行字符串** `"lat"` 和 `"lng"`
|
||
3. **loc使用Wikilink格式** `"[[Wuhan]]"`
|
||
4. **Places.base需要Location地图视图**，配置`coordinates: note.coordinates`
|
||
5. **使用共享Base而非独立Base**，便于维护
|
||
6. **遵循Kyoto.md的结构模式**，保持一致性
|
||
7. **确保UTF-8编码**，避免中文乱码
|
||
8. **瓦片代理必须运行**，地图才能加载
|
||
|
||
## 相关资源
|
||
|
||
---
|
||
|
||
## 规范文档
|
||
|
||
详见 [[地点笔记文件生成流程总结]]
|
||
|
||
- [[Obsidian Maps选点建笔记操作指南]]
|
||
- [[Templates/Bases/Places.base]]
|
||
- [[Templates/Bases/Map.base]]
|
||
- [[References/Kyoto.md]]
|
||
- [[Categories/Places.md]]
|
||
|
||
---
|
||
|
||
创建于：2026-04-10
|
||
|
||
## 来源
|
||
|
||
> **溯源规则**：所有数字/百分比/具体结论必须标注 `[raw:{文件名}:{行号}]` 格式。
|
||
|
||
- [[地点笔记文件生成流程总结]]
|