v2.2.1latest

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: Update notes command opens a dialog. Update all notes updates every existing note. Update active note shows when a literature note is open.
• The dialog creates no notes unless you ask. The checkbox When you update all notes, also create notes for items that have none is off by default.
• After you save a template in the web Template Workbench, the notice action now reads Update existing notes. 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: Overwrite imported note, 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: contains and does not contain. To keep case, use the new rows contains, match case and does not contain, match case. 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 Type a filter expression.
  • Edit visually turns a blank expression into an empty condition row.
  • When an expression has no visual form, the button's tooltip says This expression can only be edited as text.
• 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 Annotation tab now says that edits apply to each annotation you insert from now on. Its help names the Annotation example 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 Convert templates. 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. Open settings takes you to the Pandoc engine 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.