Frequently Asked Questions

[windingwind]

Chinese Documentations/中文文档

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

中文社区文档
语雀文档（旧）

Doesn't work

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

Or, if you are using free services (services that do not require a secret key), performance or availability is usually not guaranteed.

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

Check if the auto-detect language is enabled.

ChatGPT-like APIs

Use custom endpoint/secret/etc. for the custom GPT services.

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

Translate Engine & Secret

See https://github.com/windingwind/zotero-pdf-translate#translate-engine
Here are the documents for applying API keys:
#20 / CN community (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->Settings->PDF Translate->UI->Enable Popup

Font Size

Edit->Settings->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.