Differences

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

--- preferences:advanced [2017/11/26 17:42] – Update for Zotero 5. bwiernik
+++ preferences:advanced [2024/04/11 06:54] (current) – [Files and Folders] dstillman
@@ Line 5: / Line 5: @@
 {{:preferences_advanced_general.png?nolink&w=600}}
+=== Miscellaneous ===
+  * **Automatically check for updated translators:** Allow Zotero to automatically update its translators (for detecting and saving bibliographic data from different websites) and citation styles. You manually check for updates immediately by clicking the "Update now" button.
+  * **Report broken site translators:** Allow Zotero to notify its developers when a translator fails to save an item. This information is submitted anonymously.
 === Language ===
@@ Line 26: / Line 34: @@
 === Linked Attachment Base Directory ===
 //If you store attached files in Zotero — the default — this setting does not affect you. It only applies to //linked// files.//
-This setting allows you to specify a base directory for linked files, so that links are functional on two computers with different directory structures (e.g., when a folder with linked files is synced through a service like Dropbox). For example, if the folder with your linked files is at ''/home/laptop/sync'' on your laptop and at ''/home/work/sync'' on your work computer, set those paths as the base directory on each respective machine. Zotero then only stores the links relative to that base directory, so the same "relative" links work on both computers.
+This setting allows you to access [[:attaching_files#stored_files_and_linked_files|linked files]] on multiple computers even when they're stored in different locations on each computer. You should set the base directory to the folder on each computer under which you store linked files. For example, if the folder with your linked files is at ''/Users/Sarah/Dropbox/PDFs'' on your laptop and at ''C:\Users\Sarah\Dropbox\PDFs'' on your work computer, set those paths as the base directory on each respective machine. If you add a linked file within the base directory, Zotero stores a relative path to that base directory rather than an absolute path.
-=== Data Directory Location ===
+Note that this setting does not control where files are stored — only whether linked files within the specified folder are referenced by absolute or relative paths. If you're using the [[http://zotfile.com/|ZotFile plugin]] to help with a linked-file workflow, you should configure it to store linked files within the base directory you've configured.
-By default, Zotero stores your [[zotero_data|data directory]] (which contains your library database, attachment files, and several other files) in your user home directory on your computer. This is the best location for most users, but it is possible to change the location. After changing the data directory location, Zotero will store newly created data in the new location.
+Note that linked files are an advanced configuration, and we're not able to help troubleshoot problems with specific setups. We recommend that most people use stored files instead.
+== Automatic Linked-File Relinking ==
+If you previously added linked files on another computer without having set a base directory and your files are now in a different location on your current computer, you can simply set your base directory to the desired containing folder on your current computer (e.g., ''C:\Users\Sarah\Dropbox\PDFs''). When you next open a missing file with an absolute path (e.g., ''/Users/Sarah/Dropbox/PDFs/Smith - 2019 - Foo.pdf''), Zotero will automatically locate the file within your specified base directory and offer to relink all files that have the same base path (''/Users/Sarah/Dropbox/PDFs'').
+=== Data Directory Location ===
-Note, that Zotero will not, however, copy over existing data to the new location. If you want to keep your data, you need to move the files manually. Click the "Show Data Directory" button to open the Zotero directory in your computer's file browser. You will need to move the entire "Zotero" folder (including, 'zotero.sqlite', 'storage', 'styles', and all other files) to the new directory.
+By default, Zotero stores your [[:zotero_data|data directory]] (which contains your library database, attachment files, and several other files) in your user home folder on your computer. This is the best location for most users, but it is possible to change the location. After changing the data directory location, Zotero will store newly created data in the new location.
-If you're using auto-syncing, you may want to disable it temporarily from the Sync pane of the Zotero preferences before changing the data directory. Otherwise, if you accidentally start Zotero with the wrong data directory set or before moving data, Zotero will attempt to pull down your entire library from the server.
+Note that Zotero will not, however, copy over existing data to the new location. If you want to keep your data, you need to move the files manually. Click the "Show Data Directory" button to open the Zotero folder in your computer's file browser. You will need to move everything in the folder (including 'zotero.sqlite', 'storage', 'styles', and all other files) to the new location.
 == Unsafe Data Directory Locations ==
-There are several data directory locations that are potentially unsafe and **likely to lead to database corruption or even data loss**. If you use any of these setups, be sure to [[zotero_data|back up]] your Zotero data frequently.
+There are several data directory locations that are **likely to lead to database corruption or even data loss**.
-  * **Cloud-syncing folders**: Storing your Zotero data directory in a cloud-syncing folder (e.g., Dropbox, Google Drive, or other similar folder synchronization services) is extremely unsafe and will almost certainly lead to database corruption and potentially data loss. The forums contain [[http://forums.zotero.org/discussion/13359/|several]] [[http://forums.zotero.org/discussion/27900/synching-to-dropbox/|threads]] [[http://forums.zotero.org/discussion/6128/dropbox-and-zotero-15-case-conflicts/|about]] [[http://forums.zotero.org/discussion/24593/backing-up-a-large-database-without-corrupting-it/|the problems]] that users have faced with Dropbox- or Google Drive-based setups. See [[https://www.zotero.org/support/sync#alternative_syncing_solutions|Alternative Syncing Solutions]] for potential safe methods of using cloud-syncing services to sync Zotero attachment files.
+  * **Cloud storage folders**: Storing your Zotero data directory in a cloud storage folder (e.g., Dropbox, Google Drive, or other similar folder synchronization services) is [[kb:data_directory_in_cloud_storage_folder|extremely unsafe]] and will almost certainly lead to database corruption and potentially data loss.
-  * **Network drives**: If you store your Zotero data directory on a network drive and then access it from multiple computers at the same time, you are very likely to encounter database corruption. For example, if you leave Zotero open on your laptop, then open the same Zotero database on the network drive from your work computer, you will likely experience corruption. You should never use a network drive to permit multiple users to access the same Zotero database on different machines (use [[Groups]] or [[sync|Zotero syncing]] for that).
+  * **Network drives**: If you store your Zotero data directory on a network drive and then access it from multiple computers at the same time, you are very likely to encounter database corruption. For example, if you leave Zotero open on your laptop, then open the same Zotero database on the network drive from your work computer, you will likely experience corruption. You should never use a network drive to permit multiple users to access the same Zotero database on different machines (use [[:groups]] or [[:sync|Zotero syncing]] for that).
-  * **Virtual machines**: Similar to issues with network drives, it can be unsafe to use the same Zotero database file from both a virtual machine and the computer's host operating system (or another virtual machine). If the same Zotero database is accessed from two locations at the same time (e.g., if Zotero is open on both the virtual machine and the host operating system), corruption is likely. If you want to use Zotero in a virtual machine, it is better to set up a separate Zotero data directory in the virtual machine and to keep it up to date using [[sync|Zotero syncing]].
+  * **Virtual machines**: Similar to issues with network drives, it can be unsafe to use the same Zotero database file from both a virtual machine and the computer's host operating system (or another virtual machine). If the same Zotero database is accessed from two locations at the same time (e.g., if Zotero is open on both the virtual machine and the host operating system), corruption is likely. If you want to use Zotero in a virtual machine, it is better to set up a separate Zotero data directory in the virtual machine and to keep it up to date using [[:sync|Zotero syncing]].
+  * **External disks**: While keeping your data directory on an external disk is usually safe, your database could become corrupted if, say, the disk becomes unmounted while Zotero is open.
 === Database Maintenance ===
-  * **Check Database Integrity:** This function checks your Zotero database for any data corruption. Database corruption is rare. In most cases, it is caused by storing your data directory in an [[#usafe_data_directory_locations|unsafe location]]. Checking database integrity can take a long time if your database is very large. If your database is corrupted, you can use the [[/utils/dbfix/|Database Repair Tools]] to repair the corruption.
+  * **Check Database Integrity:** This function checks your Zotero database for invalid data and database corruption. Database corruption is rare, and in most cases is caused by storing your data directory in an [[#unsafe_data_directory_locations|unsafe location]]. Checking database integrity can take a long time if your database is very large. If your database is corrupted, you can try to use the [[/utils/dbfix/|Database Repair Tool]] to repair the corruption.
-  * **Reset Translators…:** Reset web and import/export translators to the current Zotero defaults using the latest versions from the Zotero server.
+  * **Reset Translators…:** Reset web and import/export translators to the versions bundled with the application or provided as updates from Zotero servers.
-  * **Reset Styles…:** Reset citation styles to the current Zotero defaults using the latest versions from the Zotero server.
+  * **Reset Styles…:** Reset citation styles to the versions bundled with the application or provided as updates from Zotero servers.
@@ Line 99: / Line 115: @@
 {{:preferences_advanced_feeds.png?nolink&w=600}}
-This tab contains preferences for Zotero's [[Feeds]] feature.
+This tab contains preferences for Zotero's [[:Feeds]] feature.
   * **Sorting:** Change between sorting newest or oldest items first.