Differences

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

--- preferences:hidden_preferences [2017/08/21 06:27] – [Hidden Preferences] dstillman
+++ preferences:hidden_preferences [2025/01/13 01:39] (current) – dstillman
@@ Line 1: / Line 1: @@
 ====== Hidden Preferences ======
-You can edit most Zotero preferences through the [[/support/preferences|Preferences]] window. However, the preferences window does not include all of the different ways you can customize your copy of Zotero. To view the the full list of Zotero's preferences, including many hidden preferences, go to the Advanced pane of the Zotero preferences and click "Config Editor". Enter "zotero" into the Filter field at the top of the list that comes up. Preferences that can be safely changed by users are described below.
+You can edit most Zotero preferences through the [[/support/preferences|Preferences]] window in Zotero or the Preferences pane in the Zotero Connector in your browser. However, both Zotero and the Zotero Connector support additional hidden preferences. These settings may have received less testing and/or are intended for more advanced use.
-All Zotero hidden preferences are preceded by "extensions.zotero."
+===== Zotero =====
-===== General Preferences =====
+To view the the full list of Zotero's preferences, including many hidden preferences, go to the Advanced pane of the Zotero preferences and click "Config Editor". Enter "zotero" into the Filter field at the top of the list that comes up. Preferences that can be safely changed by users are described below.
+Most Zotero hidden preferences are preceded by "extensions.zotero."
+==== General Preferences ====
 These general hidden preferences allow you to refine your Zotero configuration.
 ^Preference Name^Default Value^Description^
-|attachmentRenameFormatString|'{%c - }{%y - }{%t{50}}'|Zotero automatically renames attached files saved from translators. This string controls how those names are formatted. %c is creator, %y is year, %t is the title, the curly braces around each part mean "only include this part if the field specified inside is non-empty"and {50} means "truncate at 50 characters." You can rearrange these to suit your needs.|
 |backup.interval|1440|Determines, at most, how often (in minutes) Zotero makes an automatic backup of the database. The default is every 24 hours (1440 minutes)|
-|backup.numBackups|2|Determines how many automatic database backups Zotero should keep. Excess backups are deleted oldest first. This does not include backups made during database upgrades. //Note that setting this too high could cause database upgrade backups to be overwritten.//|
+|backup.numBackups|2|Determines how many automatic database backups Zotero should keep. Excess backups are deleted oldest first. This does not include backups made during database upgrades.|
-|browserContentContextMenu|true|By default, Zotero will include various options to your Firefox context menu. If you set this to false, those context-dependent right-click options will no longer be available.|
+|capitalizeTitles|true|By default, Zotero will recase titles of items you capture (e.g., to remove all caps). Switch this preference to false and you will preserve case information for titles.|
-|capitalizeTitles|true|By default, Zotero will recase titles of items you capture. Switch this preference to false and you will preserve case information for titles.|
 |debug.level|5|When debug.log is enabled, determines the lowest of the debug levels (1-5, with 5 being the lowest) that is displayed|
 |debug.log|false| Used for debugging Zotero. See [[/support/debug_output|debug output]].|
 |debug.time|false|When debug.log is enabled, shows the milliseconds from the previous debug call|
 |fontSize|“1.0”|This preference allows you to increase or decrease the size of text in the Zotero interface.|
-|httpServer.enabled|false|If set to true, Zotero in Firefox will be able to receive citations from Safari or Chrome with the Zotero Connector installed. See the [[kb/httpserver_enabled|knowledge base article]] on this feature.|
+|httpServer.enabled|true|If set to true, Zotero will listen for requests from the Zotero Connector (e.g., to allow saving items to Zotero from the Connector).|
-|launchNonNativeFiles|false|By default, Zotero will open any file stored inside Zotero through whatever means Firefox uses to launch that type of file. So, for example, if you click on a PDF in Firefox, the PDF might launch inside the browser using a PDF viewer plugin. If you switch this preference to true, Zotero will use your operating system to launch non-native files like PDFs instead of Firefox.|
+|httpServer.port|23119|If ''httpServer.enabled'' is enabled, this is the port on which Zotero will listen for connections from the Zotero Connector.|
-|recursiveCollections|false|By default, each of your collections displays only the items you have placed there. When you place a collection inside another collection, the contents of the second collection are not added to the first. If you enable recursive collections, items from subcollections will appear in all higher-level collections.|
 |sortAttachmentsChronologically|false|If set to true, your attachments will be sorted by the order you added them instead of alphabetically.|
 |sortNotesChronologically|false|If set to true, your notes will be sorted by the order you added them instead of alphabetically.|
-===== Translator Preferences =====
-These hidden preferences allow you to control some translator behavior (this does not currently apply to Chrome or Safari). They can be either general preferences that apply to all translators or translator-specific preferences (prefixed by the translator name) that affect only individual websites or bibliographic formats. **All translator hidden preferences are preceded by "extensions.zotero.translators."**
+==== PDF Reader ====
+^Preference Name^Default Value^Description^
+|sortNotesChronologically.reader|true|Sort item notes in reverse chronological order. If ''false'', sort alphabetically.|
+==== Note Editor ====
+^Preference Name^Default Value^Description^
+|note.css||Custom CSS to apply to note content|
+|note.fontSize|14|Note font size — settable from the View menu, but other values (including decimals) can be set manually|
+|note.smartQuotes|true|Automatically convert straight quotes to typographic quotes|
+==== Translator Preferences ====
+These hidden preferences allow you to control behavior for import/export translators for some specific bibliographic formats. **All translator hidden preferences are preceded by "extensions.zotero.translators."**
 ^Preference Name^Default Value^Description^Applies to^
-|attachSupplementary|false|Translators should attempt to attach supplementary data when importing items.|[[https://forums.zotero.org/discussion/21880/supplementary-information/#Comment_153889|All web translators implementing this behavior]]|
-|supplementaryAsLink|false|Supplementary data attachments should be attached as links instead of being downloaded. This option has no effect if attachSupplementary is disabled. Setting this oprtion to "true" maintains the convenience of quick access to supplementary data, but speeds up saving items from the web.|[[https://forums.zotero.org/discussion/21880/supplementary-information/#Comment_153889|All web translators implementing this behavior]]|
-|ACS.highResPDF|0|Determines which version of the Full Text PDF is attached: 0 - PDF w/ links; 1 - high res PDF; 2 - both|ACS Publications|
 |RIS.import.ignoreUnknown|true|Do not store values that cannot be mapped to Zotero fields in notes.|RIS import translator|
 |RIS.import.keepID|false|Do not drop value from "ID -" tag. Can be used to find items in EndNote.|RIS import translator|
 |BibTeX.export.dontProtectInitialCase|false|Do not surround words with braces if only the first letter is capitalized. Useful if you enter titles in Zotero in title case (not recommended).\\ ''false'': ''%%{Tame {The} {BeaST}}%%''\\ ''true'': ''%%{Tame The {BeaST}}%%''\\ //Note that the first word is never surrounded if it does not contain internal upper-case letters//|BibTeX export translator|
-===== Full-Text Indexing =====
+|BibTeX.export.simpleCitekey|null|By default only for newly added entries the new simple format (disallowing any special character except dash and underscore) for the citekey are used. Setting this hidden key to true, such simple citekeys will be used always.|BibTeX export translator|
+==== Full-Text Indexing ====
 These preferences deal with Zotero's ability to create full-text indexes from imported files.
@@ Line 41: / Line 52: @@
-===== Reports =====
+==== Reports ====
 These options allow you to customize your reports.
@@ Line 49: / Line 60: @@
-===== Export and Citation Settings =====
+==== Citation QuickCopy Settings ====
 ^Preference Name^Default Value^Description^
-|export.bibliographyLocale| |By default, Zotero creates bibliographies in the language of the installed version of Firefox. Entering a locale code here causes Zotero to use the specified language instead. For example, to cite items in English in a non-English version of Firefox, enter 'en-US' (without quotes) into this preference. For a full list of available locale codes, see [[https://github.com/zotero/zotero/blob/master/chrome.manifest|Zotero's chrome manifest]].|
+|export.quickCopy.compatibility.indentBlockquotes|true|Word and TextEdit don't indent blockquotes on their own and need this enabled. Results in an extra indent in LibreOffice, which handles blockquotes correctly.|
-|export.quickCopy.compatibility.indentBlockquotes|true|Word and TextEdit don't indent blockquotes on their own and need this enabled. Results in an extra indent in OpenOffice, which handles blockquotes correctly.|
+|export.quickCopy.compatibility.word|false|Add Word Normal style to paragraphs and enable double-spacing. LibreOffice inserts the conditional style code as a document comment.|
-|export.quickCopy.compatibility.word|false|Add Word Normal style to paragraphs and enable double-spacing. OpenOffice inserts the conditional style code as a document comment.|
 |quickCopy.quoteBlockquotes.plainText|true|Add quotes around blockquote paragraphs in plain-text output|
 |quickCopy.quoteBlockquotes.richText|true|Add quotes around blockquote paragraphs in rich-text output|
-===== Annotation Settings =====
+==== Word Processor Plugin ====
 ^Preference Name^Default Value^Description^
-|annotations.warnOnClose|true|By default, Zotero will warn you before you close a sticky note annotation. If you switch this to false you will not receive that warning.|
+|integration.keepAddCitationDialogRaised |false|If you switch this to true, you can keep the Zotero word plugin interface for adding citations always at the front. and prevent it from going hidden behind the Word window you're working with.|
-===== Word processor plugin =====
+===== Zotero Connector =====
+To view hidden preferences for the Zotero Connector, open the preferences for the connector (by right-clicking on the save button and choosing Preferences/Options in Chrome and Firefox, or by long-pressing the save button in Safari). Then, click "Advanced", then "Config Editor".
+==== Translator Preferences ====
+Zotero Connectors support some translator preferences that apply to all translators generally or to specific websites. To use these preferences, in the Zotero Connector Config Editor, click "Add Preference". Type or paste the preference's name and click "OK". Enter the appropriate preference value from the table below (e.g., **true** or **1**) and click "OK" again.
+^Preference Name^Default Value^Description^Applies to^
+|translators.attachSupplementary|false|Translators should attempt to attach supplementary data when importing items.|[[https://forums.zotero.org/discussion/21880/supplementary-information/#Comment_153889|All web translators implementing this behavior]]|
+|translators.supplementaryAsLink|false|Supplementary data attachments should be attached as links instead of being downloaded. This option has no effect if attachSupplementary is disabled. Setting this oprtion to "true" maintains the convenience of quick access to supplementary data, but speeds up saving items from the web.|[[https://forums.zotero.org/discussion/21880/supplementary-information/#Comment_153889|All web translators implementing this behavior]]|
+|translators.ACS.highResPDF|0|Determines which version of the Full Text PDF is attached: 0 - PDF w/ links; 1 - high res PDF; 2 - both|ACS Publications|
+**Note:** The supplementary data preferences will only work for sites whose translator supports this behavior. If you encounter sites with supplementary data that are not imported, please report it on the [[/forum|Zotero forums]].
-^Preference Name^Default Value^Description^
-|integration.keepAddCitationDialogRaised |false|If you switch this to true, you can keep the Zotero word plugin interface for adding citations always at the front. and prevent it from going hidden behind the Word window you're working with.|