לא כל מסמך מתחיל ב-Word. Typst הפך לדרך מהירה לכתוב מאמרים, מכתבים, קורות חיים וסיכומי הרצאות בלי להיאבק ב-LaTeX, וצוותים רבים מחזיקים את המדריכים, האפיונים ונוהלי התפעול שלהם ב-AsciiDoc. ואז מישהו מבקש עותק חתום וסרוק, ובמחשב שמולכם יש רק את קובץ המקור.

Look Scanned פותח עכשיו את שניהם. השתמשו בהמרת Typst (.typ) ל-PDF במראה סרוק לקובצי .typ, ובהמרת AsciiDoc (.adoc) ל-PDF במראה סרוק לקובצי .adoc ו-.asciidoc. המסמך הופך לעמודים בתוך הדפדפן שלכם. אתם בודקים אותם בתצוגה המקדימה, מוסיפים את אפקט הסריקה ומורידים PDF שנראה כאילו עבר בסורק אמיתי. אין צורך להתקין Typst CLI, Ruby או Asciidoctor PDF, ואין חשבון שצריך להתחבר אליו.

Typst: המהדר האמיתי, בדפדפן שלכם

Look Scanned מריץ את המהדר הרשמי של Typst (Typst 0.14) בגרסה שנבנתה לדפדפן. זה אותו מהדר שעומד מאחורי typst compile, ולכן העמודים, שבירות השורה, המשוואות והטבלאות יוצאים כמו במחשב שלכם, כולל גודל העמוד והשוליים שהמסמך מגדיר.

  • בפעם הראשונה צריך לחכות רגע. המהדר והגופנים של Typst, כ-20 MB יחד, יורדים מ-Look Scanned בפעם הראשונה. אחר כך הם נטענים מהמטמון של הדפדפן, וקובצי Typst נפתחים גם בלי חיבור לאינטרנט.
  • קובץ אחד, בלי חבילות. רק מסמכים עצמאיים עוברים הידור. שורת #import "@preview/…" נכשלת, כי אין מאגר חבילות להוריד ממנו. כך גם כל דבר שקורא קובץ אחר: תמונה שמוכנסת עם #image, פרק שמשולב עם #include או נתונים שנקראים מקובץ CSV או JSON.
  • רק גופני ברירת המחדל של Typst. הטקסט נסדר בגופנים שמגיעים עם Typst: ‏Libertinus Serif, ‏New Computer Modern עם הגופן המתמטי שלו, ו-DejaVu Sans Mono לקוד. גופנים שמותקנים במחשב שלכם אינם זמינים, ולכן גופן אחר שהמסמך מציין מוחלף באחד מאלה. הם מכסים כתב לטיני (כולל וייטנאמית), יווני, קירילי ועברי. לטקסט בסינית, ביפנית ובקוריאנית אין שום גופן חלופי, וגם כתבים כמו ערבית, תאית או דוונאגרי אינם נתמכים כראוי, ולכן כדאי לבדוק את התצוגה המקדימה אם המסמך שלכם משתמש בהם.
  • המקור חייב לעבור הידור. אם Typst מדווח על שגיאה, תקבלו הודעת שגיאה במקום עמודים.

מכיוון ש-Typst מפיק PDF אמיתי לפני שאפקט הסריקה מתווסף, אפשר לשמור גם את הטקסט שלו. כששומרים כ-PDF, הפעילו את "שמירת הטקסט המקורי (בדומה ל-OCR)" בהגדרות הפלט, והטקסט ב-PDF הסרוק יישאר ניתן לחיפוש ולהעתקה.

AsciiDoc: ‏Asciidoctor בלי Ruby

קובצי AsciiDoc מומרים על ידי Asciidoctor, המעבד המוביל של AsciiDoc, בגרסת ה-JavaScript שלו שרצה בדפדפן. התוצאה נפרסת על עמודי A4 עם שוליים של אינץ' אחד, וזה מה שעובר:

  • כותרת המסמך: שם, מחבר ושורת הגרסה, וגם תוכן העניינים כשהמסמך מגדיר :toc:.
  • סעיפים, רשימות, טבלאות, הערות שוליים, ציטוטים וסימוני הסבר בקוד (callouts). בלוקי התראה (admonitions) מציגים את התווית שלהם, כמו Note או Warning, כטקסט ולא כסמל.
  • נוסחאות STEM, שנסדרות בגופן מתמטי של ממש כשהמסמך מגדיר :stem:. גם כתיב AsciiMath וגם כתיב LaTeX עובדים, בתוך השורה ובבלוקים נפרדים.
  • רשימות קוד שנצבעות לפי התחביר כשהמסמך מגדיר :source-highlighter:, לא משנה איזה כלי הדגשה הוא מציין. בלי המאפיין הזה, רשימות הקוד נשארות בלי צבע, כמו בכל מקום אחר.
  • טבלאות ורשימות קוד ארוכות ממשיכות לעמוד הבא, ושורת טבלה אף פעם לא נחתכת באמצע.

כמה דברים לא עוברים:

  • ‏include:: לא מבוצע. כל הנחיית include מוצגת כקישור לנתיב שלה במקום התוכן שהייתה אמורה לשלב. אחדו קודם את החלקים לקובץ אחד.
  • תמונות צריכות כתובת אינטרנט מלאה. תמונה שמופנית בנתיב יחסי כמו images/diagram.png לא תימצא, כי הקובץ נפתח לבד, בלי התיקייה שלו. תמונה עם כתובת https:// מלאה נטענת מהאתר שמארח אותה, ולשם כך דרוש חיבור לאינטרנט.
  • תרשימים נשארים קוד מקור. ‏Asciidoctor Diagram אינו זמין, ולכן בלוק PlantUML או Mermaid מוצג כטקסט שהקלדתם.
  • הגופנים מגיעים מהמכשיר שלכם. הטקסט נסדר בגופנים שמותקנים במחשב או בטלפון שלכם, ולכן אותו קובץ עשוי לעבור עמוד במקומות אחרים במכשיר אחר.
  • קבצים ארוכים מאוד עלולים לחרוג מהזמן. הפריסה צריכה להסתיים בתוך כ-30 שניות, ולכן כדאי לפצל מסמך באורך של ספר לקבצים קטנים יותר.
  • קובצי .asc אינם נתמכים. הסיומת הזאת שייכת בדרך כלל למפתחות ולחתימות PGP. שנו את שם קובץ ה-AsciiDoc לסיומת .adoc לפני שאתם פותחים אותו.

איך הופכים קובץ .typ או .adoc ל-PDF סרוק?

  1. פתחו את המרת Typst (.typ) ל-PDF במראה סרוק או את המרת AsciiDoc (.adoc) ל-PDF במראה סרוק ובחרו את הקובץ שלכם.
  2. המתינו רגע בזמן שהעמודים מוכנים, ואז עברו על התצוגה המקדימה עמוד אחר עמוד. בדקו את הכותרות, המשוואות, הטבלאות והקוד.
  3. כוונו את אפקט הסריקה. אם יש במסמך אותיות קטנות או נוסחאות צפופות, השאירו את הטשטוש והרעש נמוכים.
  4. לחצו על "צור PDF סרוק", ואחר כך על "הורד PDF סרוק".

אם אתם מעדיפים תמונות, אפשר לייצא כל עמוד כ-JPG או כ-PNG במקום. המדריך ל-PDF, JPG ו-PNG מסביר מתי כל אחד מהם מתאים. עם Pro, סריקה בכמות גדולה מטפלת בכמה קובצי .typ או .adoc בבת אחת.

הקובץ שלכם נשאר במכשיר שלכם

שני הפורמטים מומרים ונסרקים בתוך הדפדפן, וקובץ המקור אף פעם לא מועלה לשרת. ב-Typst, ההורדות היחידות הן המהדר והגופנים שלו, מהאתר של Look Scanned עצמו; חבילות וקבצים אחרים אף פעם לא נשלפים. ב-AsciiDoc, החריג היחיד הוא תמונה עם כתובת https:// מלאה, שנשלפת מהאתר שמארח אותה, בדיוק כמו כשפותחים את הדף בדפדפן.

כדאי לדעת

  • התוצר עשוי מתמונות. כמו בסריקה אמיתית, אי אפשר לסמן את הטקסט ב-PDF או לחפש בו, אלא אם השתמשתם באפשרות הטקסט שתוארה למעלה עבור קובץ Typst. שמרו את קובץ המקור .typ או .adoc לעריכה.
  • אפקט הסריקה מוחל תמיד. ‏Look Scanned נועד לגרום למסמכים להיראות סרוקים. אם אתם צריכים רק PDF נקי, ייצאו אותו עם Typst או עם Asciidoctor PDF.
  • צריכים חבילות, include או תרשימים? הפיקו את ה-PDF במחשב שמותקנים בו Typst או Asciidoctor PDF, ואז הוסיפו ל-PDF הזה את אפקט הסריקה ב-Look Scanned. זה עובד עם כל מסמך, כי הכלי המקורי כבר עשה את החלק הקשה.

כותבים בפורמט אחר? ראו איך Look Scanned מטפל בקובצי LaTeX ובקובצי Markdown, HTML ו-TXT.

יש לכם קובץ .typ או .adoc שצריך להיראות סרוק? נסו עם Typst או עם AsciiDoc.