windingwind/zotero-pdf-translate

Frequently Asked Questions

windingwind opened this issue · 2 comments

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

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.

IP被限制了怎么办?