[{"data":1,"prerenderedAt":606},["ShallowReactive",2],{"docs-en-/en/docs/capabilities/translating":3},{"id":4,"title":5,"body":6,"description":598,"extension":599,"meta":600,"navigation":601,"path":602,"seo":603,"stem":604,"__hash__":605},"docs/en/docs/capabilities/translating.md","Translating",{"type":7,"value":8,"toc":568},"minimark",[9,13,17,22,25,30,51,55,81,90,94,97,101,104,118,122,125,201,204,208,211,231,240,244,247,251,254,265,269,272,283,287,294,302,306,309,331,335,338,356,363,367,370,385,392,396,399,403,421,425,452,456,467,471,485,491,495,498,526,530,533,547,550],[10,11,5],"h1",{"id":12},"translating",[14,15,16],"p",{},"Doco Translate provides a comprehensive translation workflow for PDF documents. This page covers everything you need to know about configuring and running translations.",[18,19,21],"h2",{"id":20},"opening-a-pdf","Opening a PDF",[14,23,24],{},"Doco Translate supports two methods for importing PDF files:",[26,27,29],"h3",{"id":28},"local-files","Local Files",[31,32,33,41,48],"ul",{},[34,35,36,40],"li",{},[37,38,39],"strong",{},"Drag and drop"," a PDF file into the Doco Translate home screen.",[34,42,43,44,47],{},"Click ",[37,45,46],{},"Open File"," and select a PDF from the file picker.",[34,49,50],{},"Doco Translate copies the file into its own storage so the original remains untouched.",[26,52,54],{"id":53},"online-pdf-links","Online PDF Links",[31,56,57,64,72,78],{},[34,58,59,60,63],{},"Switch to ",[37,61,62],{},"Link"," mode on the home screen.",[34,65,66,67,71],{},"Paste a direct URL to a PDF file (e.g., ",[68,69,70],"code",{},"https://arxiv.org/pdf/2605.06619",").",[34,73,43,74,77],{},[37,75,76],{},"Translate"," to download and open the document.",[34,79,80],{},"The app validates the URL, shows download progress, and handles errors gracefully.",[82,83,84],"blockquote",{},[14,85,86,89],{},[37,87,88],{},"Note:"," The URL must point directly to a PDF file. Web pages that embed PDFs are not supported.",[18,91,93],{"id":92},"translation-settings","Translation Settings",[14,95,96],{},"You can configure translation settings before opening a document, or adjust them at any time from the translator toolbar.",[26,98,100],{"id":99},"source-language","Source Language",[14,102,103],{},"Select the language of the original document. Available options include:",[31,105,106,112],{},[34,107,108,111],{},[37,109,110],{},"Auto Detect"," — The app automatically identifies the source language. This works well for most documents.",[34,113,114,117],{},[37,115,116],{},"Specific language"," — Choose a specific source language for better accuracy, especially for scanned documents or less common languages.",[26,119,121],{"id":120},"target-language","Target Language",[14,123,124],{},"Select the language you want to translate into. Doco Translate supports a wide range of target languages, including:",[126,127,128,141],"table",{},[129,130,131],"thead",{},[132,133,134,138],"tr",{},[135,136,137],"th",{},"Region",[135,139,140],{},"Languages",[142,143,144,153,161,169,177,185,193],"tbody",{},[132,145,146,150],{},[147,148,149],"td",{},"Common",[147,151,152],{},"English, Simplified Chinese, Traditional Chinese, Japanese, Korean, French, German, Spanish, Russian, Italian, Portuguese, Polish, Dutch, Arabic",[132,154,155,158],{},[147,156,157],{},"Southeast Asian",[147,159,160],{},"Indonesian, Vietnamese, Thai, Filipino, Malay, Myanmar, Khmer, Lao",[132,162,163,166],{},[147,164,165],{},"South Asian",[147,167,168],{},"Hindi, Bengali, Telugu, Tamil, Malayalam, Kannada, Marathi, Gujarati, Punjabi, Nepali, Sinhala, Urdu",[132,170,171,174],{},[147,172,173],{},"Eastern European",[147,175,176],{},"Ukrainian, Czech, Hungarian, Romanian, Bulgarian, Croatian, Slovak, Slovenian, Serbian",[132,178,179,182],{},[147,180,181],{},"Nordic",[147,183,184],{},"Swedish, Danish, Finnish, Norwegian, Icelandic, Estonian, Latvian, Lithuanian",[132,186,187,190],{},[147,188,189],{},"Middle Eastern",[147,191,192],{},"Turkish, Hebrew, Persian, Kurdish, Pashto",[132,194,195,198],{},[147,196,197],{},"African",[147,199,200],{},"Swahili, Amharic, Hausa, Igbo, Yoruba, Zulu, Somali",[14,202,203],{},"Right-to-left languages (Arabic, Hebrew, Persian, Pashto, Urdu, Kurdish) are handled with layout direction awareness.",[26,205,207],{"id":206},"translation-service","Translation Service",[14,209,210],{},"Choose which translation provider to use. Doco Translate supports three categories of services:",[31,212,213,219,225],{},[34,214,215,218],{},[37,216,217],{},"Basic services"," — Google Translate, Microsoft Translate, Yandex Translate. No API key required.",[34,220,221,224],{},[37,222,223],{},"AI / LLM services"," — Gemini, OpenAI, Claude, DeepSeek, and more. Requires an API key.",[34,226,227,230],{},[37,228,229],{},"Local services"," — Ollama and LM Studio. Runs entirely on your machine.",[14,232,233,234,239],{},"See ",[235,236,238],"a",{"href":237},"../services/built-in-services","Services"," for a complete list and configuration guide.",[18,241,243],{"id":242},"translating-pages","Translating Pages",[14,245,246],{},"Once you open a PDF, Doco Translate processes it in two phases:",[26,248,250],{"id":249},"_1-parsing","1. Parsing",[14,252,253],{},"The app analyzes the PDF structure page by page, extracting:",[31,255,256,259,262],{},[34,257,258],{},"Text paragraphs with position and formatting metadata",[34,260,261],{},"Images, tables, and formulas",[34,263,264],{},"Page dimensions and layout information",[26,266,268],{"id":267},"_2-translating","2. Translating",[14,270,271],{},"Each page is sent to the selected translation service. You can observe the process in real time:",[31,273,274,277,280],{},[34,275,276],{},"Pages display a loading indicator while translating.",[34,278,279],{},"Translated text appears as soon as the service responds.",[34,281,282],{},"A progress bar in the status bar shows overall completion.",[26,284,286],{"id":285},"concurrent-translation","Concurrent Translation",[14,288,289,290,293],{},"Doco Translate can translate multiple pages simultaneously for faster results. You can configure the maximum number of concurrent pages in ",[37,291,292],{},"Settings → Preferences → Max Concurrent Pages"," (default: 3).",[82,295,296],{},[14,297,298,301],{},[37,299,300],{},"Tip:"," For API-based services, higher concurrency means faster translation but may hit rate limits. For local services, concurrency depends on your hardware.",[18,303,305],{"id":304},"retrying-failed-pages","Retrying Failed Pages",[14,307,308],{},"If a page fails to translate (due to network errors, rate limits, or service issues):",[310,311,312,315,321,324],"ol",{},[34,313,314],{},"A red error banner appears on the failed page with the error message.",[34,316,43,317,320],{},[37,318,319],{},"Retry"," to re-translate the page with the same service.",[34,322,323],{},"Click the service selector next to Retry to switch to a different service for that page.",[34,325,326,327,330],{},"Use the ",[37,328,329],{},"Retry All Failed"," button in the status bar to retry all failed pages at once.",[18,332,334],{"id":333},"image-translation","Image Translation",[14,336,337],{},"Doco Translate can translate text found in images within your PDF:",[310,339,340,347,350,353],{},[34,341,342,343,346],{},"Enable ",[37,344,345],{},"Translate Images"," in the translation settings.",[34,348,349],{},"The app uses OCR to recognize text in images (pictures and tables).",[34,351,352],{},"Recognized text is sent to the translation service.",[34,354,355],{},"The translated image replaces the original in the reading view.",[82,357,358],{},[14,359,360,362],{},[37,361,88],{}," Image translation requires a service that supports multimodal input (most AI/LLM services). Basic translation services do not support image translation.",[18,364,366],{"id":365},"scanned-documents","Scanned Documents",[14,368,369],{},"For scanned PDFs (where text is embedded as images rather than selectable text):",[310,371,372,375,382],{},[34,373,374],{},"Doco Translate automatically detects scanned documents.",[34,376,377,378,381],{},"A prompt appears asking you to ",[37,379,380],{},"specify the source language"," for better OCR accuracy.",[34,383,384],{},"The app uses OCR to extract text from each page before translating.",[82,386,387],{},[14,388,389,391],{},[37,390,300],{}," Always specify the source language for scanned documents. Auto-detection may be less accurate on OCR-extracted text.",[18,393,395],{"id":394},"glossaries","Glossaries",[14,397,398],{},"Glossaries let you define preferred translations for specific terms, ensuring consistent terminology across your documents.",[26,400,402],{"id":401},"creating-a-glossary","Creating a Glossary",[310,404,405,412,418],{},[34,406,407,408,411],{},"Go to ",[37,409,410],{},"Settings → Glossary",".",[34,413,43,414,417],{},[37,415,416],{},"Add Glossary"," to create a new glossary.",[34,419,420],{},"Give it a name and optional description.",[26,422,424],{"id":423},"adding-glossary-items","Adding Glossary Items",[310,426,427,433,440,446],{},[34,428,429,430,411],{},"Open a glossary and click ",[37,431,432],{},"Add Glossary Item",[34,434,435,436,439],{},"Enter the ",[37,437,438],{},"Source Text"," (the term in the original language).",[34,441,435,442,445],{},[37,443,444],{},"Translated Text"," (your preferred translation).",[34,447,448,449,451],{},"Select the ",[37,450,121],{}," for this entry.",[26,453,455],{"id":454},"using-glossaries","Using Glossaries",[31,457,458,461,464],{},[34,459,460],{},"Enable or disable individual glossaries using the toggle switch.",[34,462,463],{},"When a glossary is enabled, Doco Translate automatically replaces matching source terms before sending text to the translation service.",[34,465,466],{},"You can have multiple glossaries active simultaneously.",[26,468,470],{"id":469},"importing-and-exporting","Importing and Exporting",[31,472,473,479],{},[34,474,475,478],{},[37,476,477],{},"Export"," a glossary to a CSV file for backup or sharing.",[34,480,481,484],{},[37,482,483],{},"Import"," a CSV file to bulk-add glossary items.",[14,486,487,488],{},"CSV format: ",[68,489,490],{},"source_text,translated_text,target_language",[18,492,494],{"id":493},"search","Search",[14,496,497],{},"Use the search feature to find specific content within a translated document:",[310,499,500,506,509,520,523],{},[34,501,502,503,505],{},"Click the ",[37,504,494],{}," button (magnifying glass icon) in the toolbar.",[34,507,508],{},"Enter your search term.",[34,510,511,512,515,516,519],{},"Choose to search in ",[37,513,514],{},"Source"," (original text) or ",[37,517,518],{},"Translation"," (translated text).",[34,521,522],{},"Navigate between results using the arrow buttons.",[34,524,525],{},"The view automatically scrolls to the matching page.",[18,527,529],{"id":528},"reloading","Reloading",[14,531,532],{},"If you need to re-parse and re-translate a document (e.g., after changing the source language):",[310,534,535,541,544],{},[34,536,502,537,540],{},[37,538,539],{},"Reload"," button (circular arrow icon) in the toolbar.",[34,542,543],{},"Confirm the action in the dialog.",[34,545,546],{},"The app discards all current translations and re-parses the PDF from scratch.",[548,549],"hr",{},[14,551,552,555,556,560,561,555,564],{},[37,553,554],{},"Previous:"," ",[235,557,559],{"href":558},"../get-started/quickstart","Quickstart"," · ",[37,562,563],{},"Next:",[235,565,567],{"href":566},"./reading","Reading",{"title":569,"searchDepth":570,"depth":570,"links":571},"",2,[572,577,582,587,588,589,590,596,597],{"id":20,"depth":570,"text":21,"children":573},[574,576],{"id":28,"depth":575,"text":29},3,{"id":53,"depth":575,"text":54},{"id":92,"depth":570,"text":93,"children":578},[579,580,581],{"id":99,"depth":575,"text":100},{"id":120,"depth":575,"text":121},{"id":206,"depth":575,"text":207},{"id":242,"depth":570,"text":243,"children":583},[584,585,586],{"id":249,"depth":575,"text":250},{"id":267,"depth":575,"text":268},{"id":285,"depth":575,"text":286},{"id":304,"depth":570,"text":305},{"id":333,"depth":570,"text":334},{"id":365,"depth":570,"text":366},{"id":394,"depth":570,"text":395,"children":591},[592,593,594,595],{"id":401,"depth":575,"text":402},{"id":423,"depth":575,"text":424},{"id":454,"depth":575,"text":455},{"id":469,"depth":575,"text":470},{"id":493,"depth":570,"text":494},{"id":528,"depth":570,"text":529},"Doco Translate provides a comprehensive translation workflow for PDF documents. This page covers everything you need to know about configuring and running trans","md",{},true,"/en/docs/capabilities/translating",{"title":5,"description":598},"en/docs/capabilities/translating","8yEN6JMMfwjct31PZkTITUl8GVkj32Rvv_Sv_aYX9Tk",1780845388797]