Skip to content
palmoni5 edited this page Nov 5, 2026 · 3 revisions

הדפסה וייצוא

המערכת תומכת בהדפסת טקסט, בהפקת PDF, בייצוא Word ובהדפסת מסמך PDF קיים. להוראות שימוש ראה הדפסה וייצוא למשתמש.

מסלולי הקלט והפלט

קלט עיבוד פלט אפשרי
טקסט הספר, TOC וקישורים בחירת טווח, פתרון פרופיל טקסט, צירוף מפרשים והערות, בניית בלוקים הדפסה, PDF ו־Word, לפי הרשאות הספר.
prebuiltBlocks בלוקים מוכנים ממקור אחר עימוד והפקה לפי הפורמטים המותרים.
createPdfOverride מסמך PDF שסופק לקריאה, חיתוך טווח והרכבת גיליונות הדפסה ו־PDF; ללא המרה ל־Word.
צילום צורת הדף לכידת אזור הרינדור המוצג, כאשר המדיניות מתירה PDF המבוסס על תמונה והדפסה שלו.

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

בחירת טווח ובניית תוכן

בספר טקסט, טווח ההדפסה נבחר לפי כותרות, תתי־כותרות או שורות. בחירת כותרת כסוף טווח כוללת את תוכן הסעיף שלה לפי headerSectionEndLine; אין להניח שהיא מציינת רק את שורת הכותרת.

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

PrintBlock ו־PreparedPrintDocument מתארים כותרות, טקסט, כותרות קבוצות מפרשים וקטעי פירוש. commentary_print_builder.dart ו־commentary_print_limit.dart מרכזים את שילוב המפרשים והגבלותיהם. הערות אישיות מתווספות לפי בחירת המשתמש.

טקסט עברי ב־PDF

המסלול הנוכחי משתמש ב־ShapedText וב־opentype_shaper לצורך עיצוב גליפים, מיקום ניקוד והתקדמות האותיות. ShapedText משתלב בעימוד של חבילת pdf ותומך בפיצול בין עמודים.

PdfShapedFont כותב את הגליפים כטקסט וקטורי, כולל תת־קבוצה של הגופן ומיפוי ToUnicode לצורך חילוץ טקסט. shaped_text_layout.dart מטפל בפריסת השורות ובנתוני העימוד.

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

תצוגה מקדימה ותיאום עבודה

התצוגה המקדימה מרנדרת את ה־PDF לתמונות. היא אינה קובעת שהפלט הסופי עצמו הוא תמונה.

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

מצב העבודה מדווח בנפרד מהצלחת השמירה או משליחת ההדפסה. אישור שהעבודה נשלחה למערכת אינו אישור שהמדפסת הוציאה דף בפועל.

Word וייצוא ספר שלם

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

Word מעמד מחדש את התוכן. אין להבטיח זהות בין מספר העמודים או שבירת השורות בתצוגת ה־PDF ובמעבד התמלילים של המשתמש.

יש להבדיל בין:

  • שמירת הטווח שנבחר ל־Word מתוך מסך ההדפסה.
  • ייצוא הספר מתוך קורא הטקסט — בחירת Word או טקסט עבור הספר.
  • ייצוא הערות אישיות ממסך ההערות, עם הארגון והאפשרויות שלו.

ייצוא לקובץ טקסט אינו שומר עימוד ועיצוב עשיר.

הדפסת PDF ועמודים בגיליון

createPdfOverride מסמן קלט שהוא PDF קיים. הטווח מתייחס למספרי העמודים בקובץ, החל מ־1. pdf_sheet_composer.dart מסדר עמודים על גיליון, לרבות 1, 2 או 4 עמודים בגיליון.

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

הרשאות ספרים וצורת הדף

BookProtection מגדיר הרשאות ומכסות לפי ספר ומהדורה. הפלט חייב להתחשב גם בספרי המפרשים הכלולים בו.

resolvePageShapePrintPolicy:

  1. קובע אילו מפרשים מוצגים בפועל בתצורת צורת הדף.
  2. פותר את הרשאות ספרי היעד ומשלב אותן עם הרשאות המקור באמצעות המדיניות המחמירה.
  3. מתיר צילום רק כשקיימת תצורה ואין מכסת קטעים שמחייבת ספירה במסלול טקסט.
  4. במקרה האחר משתמש במסלול שמאפשר להחיל את ההגבלות.

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

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

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

דפים קשורים

מקורות בקוד

Clone this wiki locally