v2.2.1

This is a maintenance release after 2.2.0. ZotLit Companion 2.2.1 ships with it and has no changes of its own, so Companion 2.2.0 keeps working.

What's NewCopy anchor link

Update notesCopy anchor link

• The new ZotLit: 更新笔记 command opens a dialog. 更新全部笔记 updates every existing note. 更新当前笔记 shows when a literature note is open.
• The dialog creates no notes unless you ask. The checkbox 更新全部笔记时，也为没有笔记的条目创建笔记 is off by default.
• After you save a template in the web Template Workbench, the notice action now reads 更新现有笔记. It changes only the notes you already have. It used to read "Update all notes".
• When you update a whole library or collection, ZotLit now shows the confirmation even if it holds one item.
• The older update commands stay available for keyboard shortcuts.
• "Update imported note from Zotero" is now ZotLit: 覆盖导入的笔记, so the name says what it does. Your hotkeys keep working.

See Start with Update notes and Apply a template change to some notes.

Every field in the FilterCopy anchor link

The Query View Filter used to list 8 fields, so a journal or DOI condition needed an expression. It now lists every Zotero field, with the common ones first. Whole date fields sit beside their parts.

• Everyday words find a field, in English or Chinese. For example, journal or 期刊 finds the Publication field.
• These words also work in the Properties, Sort, and Group lists and in the completion list of filter expressions.
• A saved expression on such a field now opens as a visual row.
• Profile Match shares the same list.

See Filter the rows and Profile Match.

Other improvementsCopy anchor link

• Text filter rows now ignore letter case: 包含 and 不包含. To keep case, use the new rows 包含，区分大小写 and 不包含，区分大小写. Saved filters keep their results and open as match case rows. This applies to the Query View Filter and Profile Match.
• The filter expression field is easier to use in Query View filters, Formulas, and Profile Match:
  • (, [, and quotes now close themselves. Typing one wraps selected text.
  • An empty field shows the hint 输入筛选表达式.
  • 可视化编辑 turns a blank expression into an empty condition row.
  • When an expression has no visual form, the button's tooltip says 此表达式只能以文本编辑.
• The Query View is faster in large libraries. On a 100,000-item test library, the first page, sorting, and common title searches came back about 3 to 4 times faster. Filters on Tags or Collections are faster too. Very broad searches take as long as before.
• The Workbench's 标注 tab now says that edits apply to each annotation you insert from now on. Its help names the 标注示例 pane.

Bug FixesCopy anchor link

• In a large library, item search could pause after you edited items in Zotero. This is the search in the Library View, the quick switcher, the citation suggester, and the Template Workbench. Now it stays responsive, also while you update the notes of a whole library.
• When you converted 2.1 templates, a frontmatter field that failed the conversion check stopped the conversion. The Profile editor stayed locked, so the only repair was editing the settings file. Now the conversion finishes, keeps the field as you wrote it, and a notice names it. ZotLit refuses to create notes until you fix the field, and the refusal names it. See Properties that need a fix.
• Other conversion failures did nothing visible when you selected 转换模板. Now a notice says what went wrong. For a problem in a template file, it also offers moving the file out of the template folder to use the built-in templates.
• A Template Workbench preview with citations and no Pandoc engine showed as broken, with the heading Citation style "undefined". Now the preview stays valid and shows a hint. 打开设置 takes you to the Pandoc 引擎 setting.
• Some disks ignore letter case, the usual setup on macOS and Windows. There, a template folder set to templates beside a vault folder Templates broke template customizing. It failed with "Could not create the template document". Now ZotLit finds the existing folder. Notes also move into such folders correctly.
• Tooltips on controls inside popups, such as the Query View Filter and Properties popups, appeared behind the popup. Now they show above it.
• The function argument hint in filter expressions flashed and jumped as the cursor moved. Now it stays in place.