Tolaria 如何从 Portent 模板知识库起步并完成类型与关系初始化【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria如果你的知识库是空文件夹第一件事往往不是记笔记而是决定一条笔记是什么。Tolaria 提供了一个现成的起步方案Portent 模板。它给 Tolaria vault 一组开箱默认的约定——八种类型、两种关系字段和捕获 → 整理 → 归档的生命周期——你不需要先设计一套私有分类法就能开始使用。这篇文章讲清楚三件事如何拿到并打开 Portent 模板 vault、如何完成类型Type初始化、以及如何把belongs_to/related_to两个关系字段用起来并验证生效。前提只有一个一个 Tolaria vault 就是磁盘上的一个文件夹包含 Markdown 笔记、附件、类型定义和保存的视图文件系统是唯一事实来源vault 概念说明。Git 是推荐项而非必需项普通 Markdown 文件夹就能直接打开需要历史、diff、远端同步时再初始化 Git。Portent 模板给了什么Portent 是一个开放规范加模板核心是三个问题这是什么用来做什么是捕获、整理还是归档这三个问题直接对应 Tolaria 的类型文档、关系字段、Inbox 和归档行为。模板默认提供八种类型分两组PORT可执行Project、Operation、Responsibility、TaskENTP非可执行的知识记录Event、Note、Topic、Person两个默认关系字段belongs_to主归属、组成或上下文related_to较松的语义连接一个生命周期快速捕获 → 赋予类型和关系完成整理 → 不再需要时归档模板的使用方式文档给出了三种原样使用、按自己的语言重命名各部分、或者当作自己 Tolaria 配置的参考模型。本文章按原样起步来写。模板仓库的入口链接在 site/templates/portent.md 中指向 refactoringhq/portent-vault-template用git clone把该模板克隆到本地得到一个含类型文档和示例笔记的文件夹作为下一步要打开的 vault。打开模板 vault 并确认类型加载在 Tolaria 中打开克隆好的模板文件夹。选择已有文件夹时Tolaria 会扫描其中的.md文件并在存在 frontmatter 时使用它打开或创建 vault。打开后先检查侧边栏的 Types 区域八种默认类型应当已经按类型文档加载各自带有图标、颜色、侧边栏顺序和标签。模板的八份类型文档就是 vault 根目录下type: Type的 Markdown 文件可以在本仓库的演示 vault 中对照查看实际形态type/note.md、type/project.md、type/person.md、type/topic.md、type/event.md、type/area.md、type/measure.md、type/responsibility.md。类型由type:字段决定Tolaria 不会根据文件所在的文件夹推断类型——把文件移动到别的文件夹不会改变它的类型。类型文档控制的是侧边栏分组、类型图标与颜色、侧边栏顺序与标签、置顶属性、新建笔记模板类型概念。初始化类型确认或新增一个 Type 文档模板自带类型文档时这一步主要是核对如果你想新增类型比如模板没有的Procedure操作路径是从命令面板运行New Type或点击侧边栏 Types 标题处的创建类型指南。给类型起一个明确的名称。按需添加图标、颜色、侧边栏顺序、侧边栏标签、置顶属性、建议字段、默认值或新建笔记模板。类型文档的标准形态如下来自文档示例--- type: Type _icon: folder _color: blue _sidebar_label: Projects _order: 10 --- # Project其中_icon使用 kebab-case 的 Phosphor 图标名例如folder或briefcase。两个容易忽略的初始化细节模板内容类型文档可以在templatefrontmatter 字段里放新笔记模板手写编辑类型文档正文时# TypeName标题之后的模板化结构字段标签、二级标题、清单起点也会被用作新笔记模板纯描述性文字则只作为文档保留。默认值 vs 占位符类型文档中定义为空的属性和关系会在该类型的新笔记里显示为占位符从 Properties 面板填写即可如果某个属性带了值例如 Project 类型写了status: Active这个值就变成该类型所有新笔记的默认值。初始化关系字段belongs_to 与 related_toPortent 把知识建成一张图关系可以写在 YAML frontmatter 里、用 wikilink 指向其他笔记这样图在应用外依然可读、可搜索、可移植。关系字段的写法frontmatter 示例来自 relationships 概念文档belongs_to: - [[product-work]] related_to: - [[documentation]] - [[editor-research]]Tolaria 开箱支持三个默认关系字段belongs_to、has、related_tofrontmatter 里任何包含 wikilink 的字段都会被动态识别为关系字段所以blocked_by这类自定义字段同样生效。关系字段可以指向一条笔记也可以指向一组笔记数组。两个不必手写的行为自动逆关系belongs_to有自动计算的逆关系has。一条笔记声明自己属于某个 project 后该 project 会在has关系下显示这条笔记不需要手写反向链接。related_to是横向关系双向生效。展示位置出向关系和逆关系会出现在 Properties 面板和 Neighborhood 模式中——Neighborhood 模式下笔记列表会变成围绕所选笔记的图视图。正文链接与关系字段的分工如果关系在行文中自然出现用正文链接即可如果这个连接重要到需要在导航、过滤、Neighborhood 模式或 Properties 面板中显示就写进 frontmatter 关系字段。验证初始化是否生效按 Inbox 整理流程 走一遍完整闭环来验证新建一条捕获笔记或直接把 Inbox 中的笔记整理出来给它一个清晰的 H1。设置它的type字段为某个已初始化类型例如Projecttype: Project在 Properties 面板确认类型文档定义的空属性以占位符出现、带值的属性已经填好默认值——这是类型初始化的直接证据。在 frontmatter 中给这条笔记加一条belongs_towikilink 指向某条项目笔记然后打开该项目的 Properties 面板确认它出现在对方的has逆关系里。切换到 Neighborhood 模式确认两条笔记之间的边出现在图视图中。另外两个可用的核对点类型在侧边栏按_sidebar_label和_order分组排序Inbox 工作流本身是可选的如果你希望每条笔记默认就是整理好的状态可以在 Settings Workflow 中关掉它。边界与限制Portent 模板是起步词汇表不是强制规范文档明确建议先用默认词汇表之后再按需添加自定义类型。类型与文件夹解耦移动文件不改变类型也不要依赖文件夹位置做语义分组。模板仓库地址、图标名和字段名请以 site/templates/portent.md 和 site/concepts/types.md 中的原文为准模板内容可整体重命名以匹配你的语言。多 vault 场景下Settings - Vaults -Use multiple vaults at the same time搜索、快速打开、backlink 和 wikilink 导航可以跨 vault但 Git 操作始终绑定各自 vault 的仓库——模板 vault 与正式 vault 并存试用时这一点对提交行为有影响。完成以上步骤后vault 里应当是八份类型文档在根目录加载、新笔记按类型带默认值和占位符、belongs_to/related_to在 Properties 面板与 Neighborhood 模式中可见。这就是 Portent 起步的完整终态后续再按需扩展自定义类型或视图。【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考