Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
kb:annotations_in_database [2022/06/25 17:30] – [Using an External PDF Reader] dstillmankb:annotations_in_database [2023/01/31 07:41] (current) – [Interacting with Embedded Annotations] dstillman
Line 10: Line 10:
 With annotations stored in the database, Zotero is able to quickly sync just the details of each new or updated annotation. By contrast, with standard PDF annotations, the entire PDF file needs to be transferred after every change, so if two people in a group added an annotation at the same time, or even if a PDF was just left open on one computer, it would create an unresolvable file conflict, forcing the user to choose one side or the other. This happened regularly in earlier versions of Zotero, both in personal and group libraries, and we expect PDF annotation to get far more usage as part of the app. With annotations stored in the database, Zotero is able to quickly sync just the details of each new or updated annotation. By contrast, with standard PDF annotations, the entire PDF file needs to be transferred after every change, so if two people in a group added an annotation at the same time, or even if a PDF was just left open on one computer, it would create an unresolvable file conflict, forcing the user to choose one side or the other. This happened regularly in earlier versions of Zotero, both in personal and group libraries, and we expect PDF annotation to get far more usage as part of the app.
  
-Storing annotations in the database also enables advanced functionality, such as being able to tag annotations and filter for them throughout the Zotero interface. (Currently annotation tags are limited to filtering in the PDF reader sidebar, which makes it possible to add all of a PDF's annotations with a given tag to a note, but they'll be accessible in other parts of Zotero in upcoming versions.) We plan to add other extended features like this going forward.+Storing annotations in the database also enables advanced functionality, such as being able to tag annotations and filter for them throughout the Zotero interface. We plan to add other extended features like this going forward.
  
-There are major performance benefits as well. For syncing, as discussed above, saving annotations back to the file requires Zotero to transfer the entire file — which could be many megabytes — after every change, whereas transferring just an individual annotation is instantaneous. It's also harder for Zotero to track changes to external files, so if you annotate something externally, there may be a delay before you can search for those annotations in Zotero — you might need to wait for Zotero to notice the file modification or manually trigger reprocessing.+There are major performance benefits as well. For syncing, as discussed above, saving annotations back to the file requires Zotero to transfer the entire file — which could be many megabytes — after every change, whereas transferring just an individual annotation is instantaneous. It's also harder for Zotero to track changes to external files, so if you annotate something externally, there may be a delay before you can search for those annotations in Zotero or before the updated file syncs — you might need to wait for Zotero to notice the file modification or manually trigger reprocessing and syncing.
  
 We'll always try to support external workflows as efficiently as possible, but it will never match the seamless experience we're able to provide when everything is done within the app. We'll always try to support external workflows as efficiently as possible, but it will never match the seamless experience we're able to provide when everything is done within the app.
Line 24: Line 24:
 You can export a copy of the PDF with annotations embedded by using File → "Export PDF…" from the library view or "Save As…" from the PDF reader. (To export the original file, drag the attachment item from the items list to your filesystem or use right-click → Show File and copy the file from there.) You can export a copy of the PDF with annotations embedded by using File → "Export PDF…" from the library view or "Save As…" from the PDF reader. (To export the original file, drag the attachment item from the items list to your filesystem or use right-click → Show File and copy the file from there.)
  
-When exporting metadata (e.g., BibTeX or RIS) from your library, there's a new “Include Annotations” option under “Export Files” that will embed annotations in all exported PDFs. We plan to support other ways to export annotations in future updates.+When exporting metadata (e.g., BibTeX or RIS) from your library, there's an “Include Annotations” option under “Export Files” that will embed annotations in all exported PDFs. We plan to support other ways to export annotations in future updates.
  
 ===== Using an External PDF Reader ===== ===== Using an External PDF Reader =====
Line 37: Line 37:
 If you choose to stop using Zotero in the future, you can trivially export your entire library with annotations embedded in your PDFs. If you choose to stop using Zotero in the future, you can trivially export your entire library with annotations embedded in your PDFs.
  
-In addition to the methods detailed above for exporting annotations, annotations are stored locally in Zotero's open SQLite database and are extractable using standard open-source tools, and they are also available via the Zotero web API.+In addition to the methods detailed above for exporting annotations, annotations are stored locally in Zotero's open SQLite database and are extractable using standard open-source tools. They are also accessible to plugins within Zotero and to external tools via the Zotero web API.
  
 {{tag>kb}} {{tag>kb}}
kb/annotations_in_database.1656192635.txt.gz · Last modified: 2022/06/25 17:30 by dstillman