כיצד לתרגם EPUB עם Calibre: התקנת תוסף, מצבי פלט ובדיקת קבצים

Calibre אינו מתרגם ספרים בעצמו. אתם מתרגמים קובץ EPUB ב-Calibre באמצעות Ebook Translator, תוסף של צד שלישי מבית bookfere המופיע במדד התוספים של Calibre. התקינו אותו דרך העדפות → תוספים → קבלת תוספים חדשים, בחרו מנוע תרגום, החליטו אם ברצונכם בתרגום בלבד או לצד המקור, והריצו אותו על קובץ EPUB נטול DRM. תקבלו קובץ EPUB חדש בספריית Calibre שלכם.

ההתקנה היא החלק המהיר. מה שרוב המדריכים מדלגים עליו הוא מה התוסף עושה לספר בדרך. קראנו את קוד המקור של הגרסה הנוכחית (2.4.2) כדי לגלות, ושלוש ברירות מחדל חשובות יותר מהמנוע שתבחרו:

1. פלט ברירת המחדל הוא דו-לשוני. כל פסקה מתורגמת מוצבת מתחת למקור, אלא אם תשנו את הגדרת המיקום.
2. העיצוב המוטבע שטוח בטקסט המתורגם. נטיות, הדגשות וקישורים בתוך פסקה אינם עוברים לתרגום. רק רשימה קבועה של תגים, כגון תמונות, מעברי שורה וכתב עילי, מוגנת ומוחזרת למקומה.
3. כל הרצה היא המרה של Calibre. אפילו מ-EPUB ל-EPUB, התוסף מעביר את הספר לצינור ההמרה של Calibre, הבונה מחדש את קובץ הפלט.

שום דבר מזה לא הופך את התוסף לבחירה גרועה. הוא חינמי, בקוד פתוח (GPL-3.0), וניתן להגדרה רבה. אבל כדאי לדעת מה לבדוק לפני שאתם קוראים את התוצאה, או משתפים אותה.

הערה על השיטה: מדריך זה מבוסס על קוד המקור של גרסה 2.4.2 של התוסף, התיעוד הרשמי שלו, והמדריך של Calibre. לא הרצנו תרגום מתוזמן עבור מאמר זה, ולכן אין בו טענות לגבי מהירות, איכות תרגום, או איזה מנוע מניב את התוצאה הטובה ביותר.

מה דרוש לכם לפני שמתחילים

התוסף מקבל גם פורמטים אחרים ש-Calibre יודע לקרוא, כגון MOBI או AZW3. מכיוון שהספר עובר בכל מקרה דרך ההמרה של Calibre, התחלה מקובץ EPUB נקי מעניקה לכם את הפלט הצפוי ביותר.

התקינו את תוסף Ebook Translator

התיעוד של התוסף מציע שתי דרכים להתקין אותו:

1. מתוך Calibre (מומלץ): פתחו העדפות → תוספים → קבלת תוספים חדשים, חפשו Ebook Translator, לחצו על התקן, ואז הפעילו מחדש את Calibre.
2. מקובץ: הורידו את קובץ ה-ZIP מדף הבית של התוסף, ואז השתמשו בהעדפות → תוספים → טעינת תוסף מקובץ והפעילו מחדש.

אם התוסף לא מופיע בסרגל הכלים, הוסיפו אותו תחת העדפות → סרגלי כלים ותפריטים → סרגל הכלים הראשי.

Calibre מציין את bookfere.com כיוצר התוסף. הצוות של Calibre אינו מתחזק אותו. דווחו על בעיות במאגר GitHub של התוסף, ולא ל-Calibre.

מצב אצווה או מצב מתקדם

לתוסף יש שתי דרכים להריץ תרגום:

• מצב אצווה: בחרו ספר אחד או יותר, הגדירו את שפת היעד ופורמט הפלט, ולחצו על תרגם. המשימה רצה בתור המשימות של Calibre. השתמשו בזה לטיוטה ראשונה של ספר שלם שאתם מתכננים לקרוא פעם אחת.
• מצב מתקדם: חלצו את הפסקאות של ספר אחד לטבלה, תרגמו את כולן או רק את הנבחרות, ערכו כל תרגום ביד, ואז לחצו על פלט. השתמשו בזה כשהספר חשוב, למשל כשכמה פרקים צריכים תרגום מחדש או שמות צריכים תיקון, כי תוכלו לתקן פסקאות לפני שה-EPUB נכתב.

אם בכל מקרה תבדקו את התרגום, המצב המתקדם מאפשר לכם לבצע תיקונים בתוסף. במצב אצווה, תבצעו אותם מאוחר יותר בעורך של Calibre.

בחירת מנוע תרגום

מנוע Google חינמי הוא ברירת המחדל. גרסה 2.4.2 מציעה את המנועים האלה (השמות כפי שהם מופיעים בתוסף):

ברירות מחדל שמשפיעות על ספר ארוך:

• ההפוגה בין בקשות תלויה במנוע. בקוד המקור של גרסה 2.4.2 היא 20 שניות עבור ChatGPT (OpenAI ו-Azure), 12 שניות עבור Claude, שנייה אחת עבור Gemini ו-DeepL (חינמי), ו-0 עבור רוב האחרים. התיעוד מציע להעלות אותה אם השירות מתחיל לסרב לבקשות.
• מספר הניסיונות הוא 3, וההרצה מתבטלת לאחר 10 שגיאות רצופות. יש להגדיר את מספר הביטולים ל-0 כדי שלעולם לא תעצור אוטומטית.
• פסק הזמן תלוי גם הוא במנוע: 60 שניות עבור ChatGPT ו-DeepSeek, 30 שניות עבור Claude ו-Gemini, ו-10 שניות עבור השאר.
• מיזוג לתרגום כבוי. כשהוא פועל, התוסף שולח פסקאות בקבוצות של עד 1,800 תווים. קבוצות נותנות ל-LLM יותר הקשר סביב כל בקשה, אבל תגובה אחת גרועה משפיעה אז על כמה פסקאות בבת אחת.
• מילון מונחים כבוי. כשהוא פועל, הוא קורא קובץ טקסט פשוט. מונח והתרגום שלו מופיעים בשתי שורות, מונח שיש להשאיר ללא תרגום מופיע בשורה אחת, והערכים מופרדים בשורות ריקות.

התוסף בחינם, אבל התרגום לא תמיד בחינם. רומן בן 300 עמודים שנשלח ל-API בתשלום מחויב כמו כל שימוש אחר ב-API. המדריכים שלנו ל-ChatGPT, Claude, ו-DeepSeek לתרגום מסבירים במה כל מודל נוטה לטעות בטקסטים ארוכים.

בחרו פלט של שפת היעד בלבד או דו-לשוני

ההגדרה מיקום התרגום קובעת את צורת הספר:

אם אתם רוצים ספר שאפשר פשוט לקרוא, שנו את המיקום לללא מקור לפני שתתחילו, כי ברירת המחדל מייצרת ספר דו-לשוני.

היזהרו עם אפשרויות השמאל והימין. במקור, כל זוג נבנה מחדש כשורת טבלה עם שלושה תאים: מקור, רווח, ותרגום. עם רווח ברירת המחדל של 10%, עמודות הטקסט הן ברוחב 45% כל אחת. בטלפון או בקורא ספרים אלקטרוני בגודל 6 אינץ', זה הופך לשתי רצועות טקסט צרות. מדריך ה-EPUB הדו-לשוני שלנו משווה את הפריסות הדו-לשוניות שמחזיקות מעמד במסכים קטנים.

מה התוסף משנה בתוך ה-EPUB שלכם

זה החלק שמדריכים כלליים משמיטים. הטבלה מסכמת מה v2.4.2 עושה לכל סוג תוכן, בהתבסס על קוד המקור (lib/element.py ו-lib/conversion.py בתג v2.4.2).

שניים מהפרטים הללו גורמים לנזק הנראה לעין ביותר.

מדוע נטיות וקישורים נעלמים. עבור כל פסקה, התוסף בונה את הטקסט לתרגום מהטקסט הפשוט של הפסקה. רק תגים ברשימה המוגנת שלו מוחלפים במצייני מקום. <em> או <a> אינו מוגן ואינו מתעלמים ממנו, ולכן המילים שלו מתורגמות והסימון שלו הולך לאיבוד. במצב דו-לשוני הפסקה המקורית שומרת על העיצוב שלה, כך שהבעיה מופיעה רק בשורה המתורגמת. במצב יעד בלבד העיצוב נעלם. ניתן להוסיף סלקטורים תחת Reserve Element, אך שמירת אלמנט משאירה אותו לא מתורגם. זה שימושי לביטויים זרים או שמות ספרים שברצונך לשמור, וטעות להדגשה שברצונך לתרגם.

מדוע הערות שוליים עלולות להישבר. מו"לים מסמנים הפניות להערות שוליים בדרכים שונות. לתוסף יש מקרה מיוחד לקישור שעוטף רק כתב עילי (<a href="#n1"><sup>1</sup></a>) ושומר על הקישור הזה intact. הפניה שנכתבת כ-<a href="#n1" class="noteref">1</a> אין לה כתב עילי, כך שהמספר שורד אך ייתכן שהקישור לא. בדוק הערות לפני שאתה סומך על תרגום יעד בלבד של ספרי עיון. עבור ספרים יפניים וסיניים, ראה כיצד לתרגם הערות רובי ב-EPUB לפני שתחליט אם אובדן הפוריגנה מקובל.

האלמנט המתורגם מקבל גם מאפיין lang עבור שפת היעד ומאפיין dir, מה שעוזר לקוראי ספרים אלקטרוניים לבחור גופנים ופריסה מימין לשמאל. במצב דו-לשוני, התרגום אינו מעתיק את ה-id של האלמנט המקורי, כך שעוגנים קיימים עדיין מצביעים על הפסקה המקורית.

לבסוף, מדריך ההמרה של Calibre מתאר כיצד ההמרה פועלת: הקלט הופך ל-XHTML, עובר טרנספורמציה ואז נכתב על ידי תוסף פלט. בדרך, הטרנספורמציות של Calibre יכולות ליצור מחדש את המטא-נתונים ואת תוכן העניינים. התוסף מתרגם לאחר הטרנספורמציות הללו, ממש לפני שתוסף הפלט כותב את הקובץ. לכן ה-EPUB המתורגם שלך הוא ספר שנבנה מחדש, לא הקובץ המקורי שלך עם טקסט חדש. המדריך של Calibre מציין שמערכת ההמרה שלו "אינה תחליף לעורך ספרים אלקטרוניים מלא".

בדוק את ה-EPUB המתורגם בחמש דקות

אל תשפוט את התוצאה לפי הפרק הראשון. בצע השוואה מבנית בין הקובץ המקורי לקובץ המתורגם. EPUB הוא ארכיון ZIP, כך שכלי שורת פקודה סטנדרטיים יכולים לספור את הסימון בכל צד:

mkdir src out
unzip -q original.epub -d src
unzip -q translated.epub -d out
for tag in '<em' '<i[ >]' '<strong' '<a ' '<sup' '<img' '<rt'; do
  s=$(grep -rhoE "$tag" src --include='*htm*' | wc -l)
  o=$(grep -rhoE "$tag" out --include='*htm*' | wc -l)
  printf '%-10s source=%-6s output=%s\n' "$tag" "$s" "$o"
done
grep -rho '{{id_[0-9]*}}' out | head

כיצד לקרוא את התוצאה:

• פלט יעד בלבד עם הרבה פחות תגי <em>, <i> או <a מאשר המקור פירושו הדגשה או קישורים שטוחים. זה צפוי מההתנהגות לעיל. החלט אם הספר יכול לחיות בלעדיהם.
• פחות תגי <img בפלט יעד בלבד פירושו שמציין מקום של תמונה אבד. בפלט דו-לשוני, תמונות יכולות להופיע פעמיים, לכן הסתמך על חיפוש מצייני המקום במקום. מצא את הפרק ותקן אותו במצב מתקדם או בעורך של Calibre.
• כל טקסט {{id_…}} פירושו שמנוע שינה מציין מקום, כך שהאלמנט המוגן לא שוחזר.
• בפלט דו-לשוני אמורים להיות לפחות כמה תגיות כמו במקור, מכיוון שהפסקאות המקוריות נשמרות.

התבנית <em תואמת גם ל-<embed, דבר נדיר בספרים אך שווה לדעת אם ספירה נראית מוזרה.

לאחר מכן הרץ את EPUBCheck של W3C על הקובץ המתורגם. פתח אותו בקורא שבו תשתמש בפועל, ובדוק את רשימת הבדיקה לתרגום EPUB: ניווט, הערות, תמונות והפסקה האחרונה של כל פרק. אם הספר מיועד לאחרים, בדוק אותו ב-Kindle, Kobo ו-Apple Books.

אם התרגום נעצר באמצע

התוסף שומר פסקאות מתורגמות במטמון כברירת מחדל. אם הרשת נופלת או שהמנוע מתחיל לסרב לבקשות, הרץ שוב את אותו ספר עם אותן הגדרות. פסקאות שכבר נמצאות במטמון לא מתורגמות שוב. בפועל:

1. פתח את יומן המשימה תחת Jobs וחפש שגיאות חוזרות, שלרוב מצביעות על הגבלת קצב או מפתח API שפג תוקפו.
2. העלה את Interval או הנמך את Concurrency limit עבור אותו מנוע.
3. הרץ שוב את הספר. המטמון ממשיך מהמקום שבו הוא נעצר.
4. השתמש בCache Manager כדי לנקות את המטמון של ספר רק כאשר אתה רוצה תרגום חדש, למשל לאחר עריכת המילון שלך. החלפת מנוע או שפת יעד כבר מתחילה מטמון נפרד.

מתי Calibre הוא הכלי המתאים, ומתי לא

השתמש בתוסף Calibre כאשר:

• הספר נטול DRM וכבר נמצא בספריית Calibre שלך;
• אתה רוצה לבחור ולשלם עבור המנוע בעצמך;
• אתה מוכן לסקור פסקאות במצב מתקדם; ו-
• הספר הוא בעיקר פרוזה פשוטה, כך שאובדן עיצוב בתוך השורה עולה מעט.

חפש זרימת עבודה אחרת כאשר:

• הספר תלוי בעיצוב בתוך השורה, בהפניות צולבות או בהערות מקושרות, כפי שעושים ספרי לימוד וספרים אקדמיים רבים;
• שמות ומונחים חייבים להישאר עקביים לאורך מאות עמודים ואתה לא רוצה לתחזק קובץ מילון בעצמך;
• אתה מעדיף לא להריץ בדיקות ותיקוני סימון בעצמך; או
• אתה לא מרגיש בנוח עם מפתחות API, הגבלות קצב ויומני משימות.

אם הרשימה השנייה מתארת את הספר שלך, אפשרות אחת היא להעלות את ה-EPUB ל-BookTranslator ולראות את המחיר לפני שאתה משלם. משימות שהושלמו מציעות גם הורדה של שפת היעד בלבד וגם הורדה דו-לשונית, ושמות ומונחי מפתח נשמרים עקביים עם מילון מובנה במקום קובץ שאתה כותב. זהו שירות בתשלום. בכל כלי שתשתמש, הרץ את בדיקת הסימון שלמעלה על הפלט, וסקור כל תרגום ארוך לפני שאתה מסתמך עליו. השוואת כלי תרגום EPUB מציגה זה לצד זה את תוסף Calibre, כלי הדפדפן ושירותי הקבצים, אם אתה רוצה להשוות לפני שתבחר.