Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
preferences:hidden_preferences [2017/11/12 19:53]
127.0.0.1 external edit
preferences:hidden_preferences [2017/12/04 11:02] (current)
bwiernik [Zotero Connector]
Line 1: Line 1:
-<​html><​p id="​zotero-5-update-warning"​ style="​color:​ red; font-weight:​ bold">​We’re 
-in the process of updating the documentation for 
-<a href="​https://​www.zotero.org/​blog/​zotero-5-0">​Zotero 5.0</​a>​. Some documentation 
-may be outdated in the meantime. Thanks for your understanding.</​p></​html>​ 
- 
- 
 ====== Hidden Preferences ====== ====== Hidden Preferences ======
  
-You can edit most Zotero preferences through the [[/​support/​preferences|Preferences]] window in Zotero or the Preferences pane in the Zotero Connector. 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.+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.
  
 ===== Zotero =====  ===== Zotero ===== 
Line 22: Line 16:
 |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.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. //Note that setting this too high could cause database upgrade backups to be overwritten.//​|
-|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.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.log|false| Used for debugging Zotero. See [[/​support/​debug_output|debug output]].|
Line 30: Line 23:
 |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).| |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).|
 |httpServer.port|23119|If ''​httpServer.enabled''​ is enabled, this is the port on which Zotero will listen for connections from the Zotero Connector.| |httpServer.port|23119|If ''​httpServer.enabled''​ is enabled, this is the port on which Zotero will listen for connections from the Zotero 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.| 
 |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.| |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.| |sortAttachmentsChronologically|false|If set to true, your attachments will be sorted by the order you added them instead of alphabetically.|
Line 36: Line 28:
  
 ==== Translator Preferences ==== ==== 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."​**+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^ ^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.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| |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| |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 ==== ==== Full-Text Indexing ====
 These preferences deal with Zotero'​s ability to create full-text indexes from imported files. These preferences deal with Zotero'​s ability to create full-text indexes from imported files.
Line 60: Line 50:
  
  
-==== Export and Citation Settings ====+==== Citation ​QuickCopy ​Settings ====
  
 ^Preference Name^Default Value^Description^ ^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.plainText|true|Add quotes around blockquote paragraphs in plain-text output|
 |quickCopy.quoteBlockquotes.richText|true|Add quotes around blockquote paragraphs in rich-text output| |quickCopy.quoteBlockquotes.richText|true|Add quotes around blockquote paragraphs in rich-text output|
- 
-==== Annotation Settings ==== 
- 
-^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.| 
  
 ==== Word processor plugin ==== ==== Word processor plugin ====
Line 81: Line 65:
 ===== Zotero Connector ===== ===== Zotero Connector =====
  
-To view Zotero Connector ​preferences in Chrome and Firefox, open the preferences for the connector ​— by right-clicking on the save button and choosing Preferences/​Options,​ or via the Extensions/Add-ons pane — and change ​the last part of the URL from "​preferences.html" ​to "config.html".+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]].
  
-Hidden preferences in Safari are not currently easily accessible. 
preferences/hidden_preferences.1510534409.txt.gz · Last modified: 2017/12/01 19:55 (external edit)