Use a different template for different notes
Add a profile, give it a look of its own, set the conditions that select it, and check that ZotLit picks it for an item.
A profile decides a literature note's name, folder, properties, and body. Add one when books, papers, or a single collection need a look of their own.
Add a profile
Open the Profiles page
In Obsidian, open Settings > ZotLit > 文献笔记配置方案. In the header of the 其他配置方案 list, select 添加配置方案.
Name it and choose its folder
Enter the 名称. A name is enough to create the profile. To keep its notes in a folder of their own, also enter the 文献笔记文件夹. Leave the folder empty to use the Default profile's folder. The dialog reads 以当前默认配置方案模板的副本开始。文献笔记文件夹为可选项:留空则使用默认配置方案的文件夹。现有笔记将保留其文件夹。 Select 添加配置方案 to create the profile.
ZotLit writes zotlit-profile.<slug>.md into the folder named by 模板文件夹 and opens the document in the Template Workbench View. The name you typed is the label you see in lists. The profile's actual identity is a separate ID inside the document, so renaming the file changes nothing. See Profiles for what the document carries.
Edit the note source and its properties
Select 笔记 and edit the note source: the text every note from this profile begins with. Select 属性 and set the YAML properties ZotLit writes at the top of each note.
The preview beside the editor renders your edits against a Zotero item. Choose another item at any time to check a different case.
Set the conditions that select it
Select 匹配. The tab reads 选择自动使用此配置方案的条目。
The tab starts with one empty condition row. Pick what it tests: 条目标题, 创建者, 第一作者, 年份, 条目类型, 分类, 文库, or 标签. These are the same conditions as the filter of an items Query View. A row with no value reads 空 and selects nothing until you fill it in. Select 添加条件 to add another condition.
Above the conditions, choose how they combine: 满足以下全部条件, 满足以下任一条件, or 不满足以下任一条件. The last one excludes every item that meets any of its conditions.
The complete condition language, including the expression form, is in Profile Match.
Check the conditions against an item
Select 选择要检查的条目 and choose an item. The tab reports 匹配所选条目 or 不匹配所选条目 for that item.
The profile's row on the settings page then carries 自动选择 while ZotLit can evaluate the conditions.
Create a note from the profile
Run ZotLit: 打开文献笔记快速切换器 and select an item the profile matches. ZotLit creates the note from the profile and reports the match. The note records the profile in its zotlit-profile property.
Existing notes keep the profile that made them. To move one note to this profile, run ZotLit: 切换文献笔记配置方案 from the note.
When two profiles match
Two profiles can match the same item, and ZotLit does not choose for you when they do. The picker opens and reports 多个配置方案匹配:…。请为本次操作选择一个配置方案。. Its search box reads 从匹配的配置方案中选择…, and every candidate that matches the item carries 匹配此条目.
Pick the profile you meant to use, or dismiss the picker to cancel the note. Narrowing the conditions on the 匹配 tab is the durable fix.
When you pick a profile by hand
A profile you choose for the current operation wins over Profile Match, whatever the conditions say. Profiles holds the order ZotLit tries when it selects one.
Your choice covers that one operation. The note records the profile that made it, and later updates read that record instead of the conditions.
Share the profile as one file
A profile is a single document, so you can move it to another vault as one file, with the partials it calls travelling inside it. The Profile document reference describes the document that travels and every key inside it.
Share the profile
On the profile's row, open 更多操作 and select 分享…. The share dialog collects the document and the partials it appears to call.
Choose what the file carries
Under 片段, clear any partial you do not want to send; the ones the profile appears to call are already selected. 包含匹配条件 carries the Profile Match to the receiving vault, and 包含我的文件夹 adds your note folders to the file.
Copy it or save it
Select 复制到剪贴板 to put the file on the clipboard, or 保存 Markdown 文件… to write it into a folder you choose. Both produce the same single document.
Import it in the receiving vault
Run ZotLit: 导入配置方案…, or select the import button in the header of the 其他配置方案 list. ZotLit then asks where the file is: 从剪贴板读取 or 选择文件….
Read what the import dialog reports
The dialog previews the partials it will unpack into the template folder, the citation style, and the incoming Profile Match as its Filter Expression. 导入匹配条件 imports the Match with the profile, so it selects notes in this vault too; turn it off to keep the profile for manual selection only. When the shared profile carries no Match, the dialog reads 不自动选择 and hides the toggle. Select 导入配置方案 to write the profile.
See also
Profiles
What a profile is, how one is chosen, and how a note keeps it.
Profile Match
The condition language that selects a profile automatically.
Profile document
The manifest keys, the note source, and the Annotation Section.
Edit a profile as Markdown
Edit the document directly, in the shape ZotLit enforces.
Literature note profiles
The Default profile, the profile list, and the Partials group.
Last updated on