لا تبدأ كل المستندات في 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 ميغابايت، من 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، ثم أضف تأثير المسح إلى ذلك الملف في Look Scanned. تنجح هذه الطريقة مع أي مستند، لأن الأداة الأصلية أنجزت الجزء الصعب بالفعل.

تكتب بصيغة أخرى؟ اطّلع على طريقة تعامل Look Scanned مع ملفات LaTeX وملفات Markdown وHTML وTXT.

هل لديك ملف .typ أو .adoc يحتاج إلى أن يبدو ممسوحًا ضوئيًا؟ جرّبه مع Typst أو مع AsciiDoc.