Common Issues

[windingwind]

Chinese Documentations/中文文档

如果你能够阅读中文，遇到问题请先查看中文文档。文档中包括几乎所有你可能遇到的问题，提问重复内容不再回复。
中文文档

Translate doesn't work

Select text in the built-in reader and view the result in the popup/right sidebar.

Auto-Translate doesn't work

Check if the current item's language is in the plugin settings' ignore list. See https://github.com/windingwind/zotero-pdf-translate#advanced

Translate Error

Type	Detail	Reason	Solution
Request Error	Slow or no result/Error: Request timed out	server unavailable	change translate engine
Request Error	Error: ... failed with status code 4xx	invalid secret	check secret
Request Error	TypeError: xhr.response.trans_result is undefined #30	invalid secret	check secret
Request Error	Error: ... failed with status code 425	request too fast	change translate engine
Request Error	Error: ... IP/User Disabled #57	request too fast	change translate engine
Others	-	-	post an issue

Sidebar/Popup doesn't show

See #29 #17

Translate Engine & Secret

See https://github.com/windingwind/zotero-pdf-translate#translate-engine
Here are the documents for applying API keys:
#20 (in Chinese)

Poor quality/Why we recommend using services that require secret

See #56

Character Limitation

It's from the translation service. For a workaround for CNKI, see #762 (comment)

UI Issues

Show/Hide Popup

Edit->Preferences->PDF Translate->UI->Enable Popup

Font Size

Edit->Preferences->PDF Translate->UI->Font Size

[windingwind]

Debug Steps

• Start Zotero but don't do anything.
• Go to Help->Debug Output Logging->View Output.
• Reproduce the bug after the debug window is opened.
• Copy the logs and paste them into your issue.