v2.2.3latest

This release brings literature note actions to the PDF reader, adds guided lessons to the documentation, and fixes bugs across reader links, citations, and popovers. ZotLit Companion 2.2.3, the Zotero add-on, ships with it and has no changes of its own, so Companion versions 2.2.0 to 2.2.2 keep working.

Breaking ChangesCopy anchor link

Obsidian 1.15.1 or laterCopy anchor link

ZotLit 2.2.3 needs Obsidian 1.15.1 or later (before: 1.14.5). The installer minimum stays 1.13.4. On Obsidian 1.14.5 to 1.15.0, ZotLit stays at 2.2.2 and does not update until you update Obsidian. See Which Zotero and Obsidian versions ZotLit works with.

What's NewCopy anchor link

Write or open the literature note from the PDFCopy anchor link

When a Zotero PDF that belongs to a paper is open in Obsidian, a button appears at the top right of the PDF tab, with the tooltip Write literature note (or Open literature note when the note exists). The tooltip updates when you write or delete the note. The same entry is in the tab's More options menu, and there is a new command, ZotLit: Open or write literature note for this PDF.

The note opens in a split beside the PDF, and a tab that already shows the note comes forward. A PDF that is not part of a Zotero paper gets no button. See Connect Zotero to Obsidian: your first literature note.

New guided lessonsCopy anchor link

The documentation now starts with six short lessons at /learn: connect Zotero and write a first literature note, annotate PDFs, cite as you write, export to Word with citations, make a literature review table, and track what you have read. The Getting started tile in ZotLit's Welcome view now opens these lessons, and help links in ZotLit point at the new pages. Some help labels were renamed to match the new pages: in Citations settings, "Pandoc citation tutorial" is now Pandoc citation workflow and its button "Open tutorial" is now Open guide; the Template Workbench "Annotation tutorial" link is now Annotation guide.

Other improvementsCopy anchor link

• In a large Zotero library, the Library View now responds faster when you resize the window or collapse a sidebar, because it skips the rows you cannot see.

Bug FixesCopy anchor link

• With Open PDF file links in Obsidian or Open annotation links in ZotLit reader turned off, the page link on an annotation still opened the PDF in Obsidian across the annotation view, query blocks, the Reading Card, and the Query View. It now opens the annotation in Zotero, as the setting says. See Open an item's PDF in Obsidian.
• On Obsidian 1.15.1, menus and popovers in a separate Obsidian window opened empty or closed at once (for example the query view menu, the filter popover, and the highlight popup). They work again.
• In Live Preview, a citation next to another one, such as [@a] [@b], sometimes disappeared. It now stays visible. See Insert citations.
• An export to Word started right after Zotero opened, with Better BibTeX installed, could wait forever. ZotLit now stops after 30 seconds and asks you to wait until Zotero is ready and try again. See Export a note with citations.
• While the setup steps showed at the top of a narrow Library View, the Reading Card's Open PDF and Write literature note buttons could sit below the end of the tab, out of reach. The tab now scrolls to show them. See Browse your library in the Library View.
• Saving the Recent list with Save as query file… named the file Recent. It is now named Untitled.
• The highlight popup stayed on top when you opened another tab. It now hides with the PDF and comes back with it, keeping the comment you typed. See How to edit PDF annotations in Obsidian.
• After you selected Uninstall for the Pandoc engine while a draft with citations was open, the setting could offer Try again instead of Install. It now shows Install. The same fix applies to Chinese segmenter.
• If you selected Uninstall for the Pandoc engine while an export to Word was running, the export could fail. Now the export finishes first, then the engine is removed.