ידע עברי על ספרים דיגיטליים

עברית וימין־לשמאל

EPUB בעברית: כיוון ימין־לשמאל (RTL) בשלוש שכבות

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

עודכן לאחרונה ·6 דקות קריאה

בקצרה

ספר EPUB עברי תקין מגדיר RTL בשלוש שכבות: page-progression-direction="rtl" ב־spine, ‏dir="rtl" ותגי שפה במסמכי התוכן, ו־CSS תומך. CSS לבדו אינו תחליף לכיוון ולשפה במבנה המסמך.

EPUB עברי צריך להצהיר על עברית ועל כיוון ימין־לשמאל במבנה הקובץ, לא רק להיראות מיושר לימין. שלוש שכבות משלימות זו את זו: כיוון המעבר הכללי בחבילה, כיוון ושפה במסמך XHTML, ו־CSS שמסדר את העיצוב.

שכבה ראשונה: כיוון ההתקדמות ב־spine

ה־spine במסמך OPF קובע את סדר הקריאה של מסמכי התוכן. ב־EPUB 3.3 המאפיין page-progression-direction יכול לקבל ltr, ‏rtl או default. לספר עברי זורם הגדירו rtl:

<spine page-progression-direction="rtl">
  <itemref idref="title"/>
  <itemref idref="chapter-01"/>
</spine>

ההצהרה אומרת למערכת הקריאה מהו כיוון הזרימה הכללי; היא רלוונטית למחוות מעבר, דפדוף ולפריסות כפולות. אם הערך הוא default, מערכת הקריאה רשאית לבחור את הכיוון. מפרט Reading Systems 3.3 אומר שמערכת קריאה מניחה default כשלא הוגדר ערך. לכן היעדר מאפיין אינו דרך בטוחה לקבל RTL.

זה אינו משנה את סדר הפרקים: סדר ה-itemref נשאר סדר הקריאה. גם אל תחליפו את הסדר כדי לגרום לדפדוף להיראות נכון. אם פרקים מופיעים הפוך, תקנו את סדר ה־spine; אם הדפדוף הפוך, תקנו את page-progression-direction.

שכבה שנייה: HTML והשפה

על שורש כל מסמך XHTML עברי הגדירו dir="rtl", ‏lang="he" ו-xml:lang="he". dir נותן בסיס נכון לאלגוריתם הדו־כיווני; תגי השפה מתארים את שפת התוכן לכלי קריאה, חיפוש ונגישות.

<html xmlns="http://www.w3.org/1999/xhtml"
      xml:lang="he" lang="he" dir="rtl">
<head>
  <title>פרק ראשון</title>
  <link rel="stylesheet" type="text/css" href="../styles/book.css"/>
</head>
<body>
  <h1>פרק ראשון</h1>
  <p>זהו משפט עברי עם 2026 ו-EPUB.</p>
</body>
</html>

אם יש ציטוט ארוך באנגלית, הגדירו עליו במפורש lang="en" dir="ltr". כך לא מכריחים את כל העמוד לכיוון אחד, אך גם לא משאירים מקטע לטיני לניחוש. אותו עיקרון מתאים לרשימת קוד, כתובת URL או נוסחה.

במסמך החבילה הוסיפו גם את שפת הפרסום הראשית:

<metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
  <dc:language>he</dc:language>
</metadata>

dc:language הוא מטא־דאטה של הפרסום כולו, לא תחליף ל-lang במסמך. ספר דו־לשוני עשוי להזדקק לעוד תגי שפה במקטעים המתאימים.

שכבה שלישית: CSS, אך לא במקומו של HTML

CSS מועיל להשלמת העיצוב, למשל ליישור התחלתי ולמאפיינים לוגיים. אבל EPUB 3.3, סעיף 6.3.1.2, קובע שגיליון סגנון אסור שיכלול את direction או את unicode-bidi. הסיבה מעשית: מערכת קריאה עשויה שלא לממש CSS או לכבות אותו. את הכיוון והשפה קובעים אפוא במסמך; CSS אינו נתיב חלופי לכך.

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="he" lang="he" dir="rtl">
  <body>
    <p>זהו משפט עברי ובו <bdi dir="auto">ISBN 978-1-4028-9462-6</bdi>.</p>
    <blockquote dir="ltr" lang="en">A quotation in English.</blockquote>
    <p><bdo dir="ltr">ABC-123</bdo> הוא רצף שהכיוון שלו מוכתב במפורש.</p>
  </body>
</html>

bdi הוא רכיב HTML. מסמך תוכן EPUB הוא XHTML המבוסס על HTML, ולכן אפשר להשתמש בו כדי לבודד תוכן שכיוונו אינו ידוע מראש. dir="auto" קובע את כיוון הבסיס לפי התו החזק הראשון; bdo מיועד למקרה החריג שבו כופים כיוון. אין צורך לעטוף בו מספרים רגילים.

לספר עברי רגיל אין צורך ב-writing-mode. כיוון עברית הוא אופקי, עם שורות מימין לשמאל. writing-mode מתאים, למשל, לפריסה אנכית; הוא אינו תיקון ל־RTL, ועלול להוסיף הבדלי תמיכה מיותרים. לפרטים על בחירת CSS ראו CSS ב־EPUB.

מספרים, אנגלית וסימנים

עברית ומקטעים לטיניים באותה פסקה מפעילים את Unicode Bidirectional Algorithm. בדרך כלל אין צורך לעטוף כל מספר, אבל יש לבדוק דוגמאות אמיתיות: עמוד 12, ‏version 3.3, כתובת דוא״ל, מחיר עם מטבע, טווח תאריכים וסוגריים. סימני פיסוק ליד אנגלית הם נקודת תורפה שכיחה.

השתמשו ב-dir="ltr" וב-lang="en" למקטע לטיני שלם כאשר הכיוון שלו מהותי, וב־bdi dir="auto" כשכיוון המקטע אינו ידוע. אל תנסו לפתור בעיה באמצעות תווי כיוון בלתי נראים בלי לדעת מדוע; הם מקשים על עריכה ומציאת תקלות. הרחבה ודוגמאות נמצאות ב־מספרים ולטינית בטקסט עברי.

מה מערכות קריאה רשאיות לעשות

מפרט Reading Systems 3.3 מחייב מערכת קריאה לעבד dir במסמכי XML, ומסביר שכאשר dir הוא rtl יש להגדיר את רמת ההטמעה הבסיסית של bidi לימין־לשמאל. המפרט גם מכיר בכך שמערכות קריאה עשויות להציע למשתמש מנגנון לעקיפת כיוון ברירת המחדל. לכן ההצהרות בקובץ נותנות כוונה תקנית וברורה, אבל אינן מבטיחות שכל הגדרה אישית של קורא תבוטל.

בדקו לפחות שני קוראים שונים, עם גודל גופן קטן וגדול. בדקו את תחילת הספר ואת סופו, מעבר קדימה ואחורה, תוכן עניינים, הערות שוליים, תמונות עם כיתוב ומקטע אנגלי. אם הבדיקות נועדו ל־Kindle, ראו גם שליחה ל־Kindle והגבלות RTL ש־Amazon מפרסמת לקוראים מסוימים.

שגיאות נפוצות

הראשונה היא CSS בלבד: text-align:right נראה תקין בפסקה קצרה, אך אינו מגדיר את כיוון המסמך או את כיוון הדפדוף. השנייה היא dir רק על body או על כמה פסקאות; עדיף בסיס עקבי בשורש המסמך ואז חריגים מקומיים. השלישית היא שכחת dc:language, שפוגעת בתיאור הפרסום אף שהעמודים עצמם נראים בסדר.

שגיאה נוספת היא שימוש ב-margin-left ו-padding-right במקום מאפיינים לוגיים. הם נקשרים לצד פיזי ולא להתחלה ולסוף של השורה. השתמשו ב-margin-inline-start, ‏padding-inline-end ו-text-align:start; כך אותו stylesheet נשאר מובן גם כשיש חלק LTR. לבסוף, אל תניחו שקובץ שעובר ולידציה נראה נכון: ולידציה בודקת כללים, ובדיקת קורא מגלה התנהגות בפועל.

סדר עבודה שמונע תיקונים מאוחרים

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

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

כאשר קורא מציג תוצאה אחרת, רשמו את שם הקורא, מערכת ההפעלה, גודל הגופן והפעולה שביצעתם. אותו EPUB יכול להיראות תקין בקורא אחד ושונה באחר. תיעוד קצר הופך דיווח מעורפל כמו “העברית נשברה” למקרה שאפשר לשחזר ולתקן.

RTL אינו יישור בלבד

יישור לימין משנה את מיקום הקצה החזותי של שורה, אבל אינו אומר למנוע איך לפרש רצף מעורב. dir נותן לאלגוריתם bidi בסיס כיווני, ושפת he מתארת את לשון התוכן. page-progression-direction מתייחס לדפדוף בין עמודים. שלושת הסימנים עונים על שלוש שאלות שונות, ולכן אין טעם להחליף אחד באחר.

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

לפני מסירה, פתחו גם את קובץ ה־EPUB עצמו מחדש אחרי האריזה. בדקו שה־OPF שאליו מצביע container.xml הוא הקובץ שערך ה־spine שלו rtl, ולא עותק קודם שנשאר בתיקייה. זו תקלה נדירה אך מתסכלת: כל קובצי XHTML נראים נכונים, ובכל זאת הקורא מפעיל הגדרות מחבילה אחרת. בדיקת אריזה וכלי ולידציה עוזרים לאתר נתיבים כאלה.

דף בדיקה לעברית

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

כאשר משהו נראה הפוך, זהו תחילה את השכבה: סדר פרקים שגוי מתוקן ב־spine; כיוון דפדוף מתוקן ב־page-progression-direction; סדר אותיות או סימני פיסוק מתוקן ב־dir, תג השפה והסימון המקומי ב־XHTML. אל תנסו לכסות על תקלה מבנית ביישור או בתווי כיוון בלתי נראים. פתרון כזה עלול להיראות נכון רק בגודל גופן אחד.

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

בכל תיקון חזרו לאותה דוגמת בדיקה. כך לא מתקנים פיסוק אחד ויוצרים בעיה במעבר הבא.

אם מסמך אחד בספר הוא באנגלית, אפשר לתת לו dir="ltr" בשורש שלו בלי לשנות את הגדרת ה־spine של הפרסום כולו. ההפרדה הזו חשובה: כיוון מסמך הוא מידע מקומי, ואילו כיוון ההתקדמות מתאר את הספר. בדקו מעבר בין שני המסמכים בקורא בפועל.

שאלות נפוצות#

האם direction: rtl ב־CSS מספיק?

לא. EPUB 3.3 אוסר את direction ואת unicode-bidi בגיליון סגנון; יש להגדיר כיוון ושפה ב־XHTML ובחבילה.

האם עברית זקוקה ל־writing-mode?

לא בדרך כלל. עברית נכתבת בשורות אופקיות מימין לשמאל; writing-mode מיועד בעיקר למצבי כתיבה אחרים.

מה עושה page-progression-direction?

הוא מבטא את כיוון זרימת התוכן הכללי ב־spine, למשל את כיוון המעבר בין עמודים.

למה מספרים נראים מוזר?

אלגוריתם Unicode bidi תלוי בהקשר. יש לבדוק מספרים, סימנים וקטעים לטיניים בקורא היעד.

מקורות#

  1. EPUB 3.3 — spine page-progression-direction www.w3.org
  2. EPUB 3.3 — CSS requirements www.w3.org
  3. EPUB Reading Systems 3.3 — Internationalization www.w3.org