IguanaTex

إجوانا تكس

(ج) جوناثان لو رو وزفيكا بن حاييم (ويندوز)، تسونغ جو شيانغ وجوناثان لو رو (ماك)

موقع الكتروني: https://www.jonathanleroux.org/software/iguanatex/

IguanaTex عبارة عن وظيفة إضافية لبرنامج PowerPoint تسمح لك بإدراج معادلات LaTeX في عرض PowerPoint التقديمي الخاص بك على نظامي التشغيل Windows وMac. ويتم توزيعه بالكامل مجانًا، بالإضافة إلى كود المصدر الخاص به.

يستضيف هذا المستودع التعليمات البرمجية المصدر في نموذج يمكن تتبعه ومشاركته ومناقشته بسهولة (يتم تصدير تعليمات برمجية VBA باستخدام ماكرو ExportVBA).

متطلبات النظام

ويندوز

• نظام التشغيل: Windows 2000 أو الأحدث (32 أو 64 بت).
• عرض تقديمي:
  • تم اختبار IguanaTex مع PowerPoint 2010، و2013، و2016، و2019 (32 و64 بت)، وOffice 365، وPowerPoint 2003. ومن المرجح أن يعمل أيضًا في PowerPoint 2000 و2007.
  • يتوفر دعم SVG لـ Office 365 والإصدارات الحديثة من PowerPoint. تم تأكيد الدعم لـ PowerPoint 2021 على الأقل للإصدارات 2108 وما فوق، ومن المحتمل (على الرغم من عدم تأكيده) لـ PowerPoint 2019 وربما حتى PowerPoint 2016 لنفس الإصدارات. لاحظ أن الإصدارات ذات الترخيص المجمع، الموجودة في الإصدار 1808 اعتبارًا من أغسطس 2023، لا تدعم تحويل SVG إلى الشكل، وهو ما يتطلبه IguanaTex.
• لاتكس: TeXLive أو MiKTeX
• GhostScript (إذا كان الإصدار الأخير يثير مشكلات، فجرّب gs9.26)
• ImageMagick
• (اختياري) TeX2img، يُستخدم لإخراج الرسومات المتجهة عبر EMF (تنزيل).

ماك

• إنتل أو أبل سيليكون ماك
  • في أجهزة Mac المستندة إلى Apple Silicon، يجب تشغيل PowerPoint باستخدام الإعداد "فتح باستخدام Rosetta".
• باور بوينت لنظام التشغيل Mac:
  • باور بوينت 2019 أو أوفيس 365
  • PowerPoint 2016 (الإصدار 16.16.7 190210 أو أحدث) (سيتم تأكيده؛ قد لا تعمل بعض الميزات، مثل SVG)
• MacTeX: تأكد من تثبيت libgs لدعم SVG، عن طريق تحديد "تخصيص" في خطوة "نوع التثبيت" في برنامج تثبيت MacTex. (لم أجد طريقة لتثبيت libgs عبر TexLive بعد التثبيت الأولي، إذا كنت تعرف واحدة فيرجى إبلاغي بذلك)

تحميل وتثبيت

ويندوز

1. قم بتنزيل ملف الوظيفة الإضافية ‎.ppam من صفحة الإصدارات الخاصة بهذا المستودع، أو من صفحة تنزيل IguanaTex، واحفظه في موقع موثوق به (راجع مقالة Microsoft هذه)، مثل %appdata%MicrosoftAddins (على سبيل المثال، C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
2. قم بتحميل الوظيفة الإضافية : في "ملف" > "خيارات" > "الوظائف الإضافية" > "إدارة:" (الجزء السفلي من النافذة)، اختر "وظائف PowerPoint الإضافية" في مربع التحديد. ثم اضغط على "انتقال..."، ثم انقر فوق "إضافة جديد"، وحدد ملف .ppam في المجلد الذي قمت بتنزيله فيه، ثم "إغلاق" (إذا قمت بتنزيل مصدر .pptm وحفظته بتنسيق .ppam ، فسيتم ذلك يكون في مجلد الوظيفة الإضافية الافتراضي).
3. إنشاء مجلد ملفات مؤقت وتعيينه : يحتاج IguanaTex إلى الوصول إلى مجلد يتمتع بأذونات القراءة/الكتابة لتخزين الملفات المؤقتة.
   • الافتراضي هو "C:Temp". إذا كان لديك أذونات الكتابة ضمن "C:"، فقم بإنشاء المجلد "C:Temp". أنت جاهز تمامًا.
   • إذا لم تتمكن من إنشاء هذا المجلد، فاختر أو أنشئ مجلدًا يتمتع بإذن الكتابة في أي مكان آخر. في علامة التبويب IguanaTex، اختر "الإعدادات الرئيسية" ثم ضع المسار إلى المجلد الذي تختاره. يمكنك أيضًا استخدام مسار نسبي ضمن مجلد العرض التقديمي (على سبيل المثال، "." لمجلد العرض التقديمي نفسه).
4. تثبيت وتعيين المسار إلى GhostScript وImageMagick (مطلوب لمخرجات الصورة، إلا في حالة استخدام محرك "Latex (DVI)":
   • مطلوب لتحويل ملفات PDF المتوسطة إلى PNG قبل إدراجها في PowerPoint ككائن صورة. في عملية إنشاء الصور، تقوم جميع محركات LaTeX باستثناء "Latex (DVI)" بإخراج ملفات PDF. حتى عند إنشاء شكل، غالبًا ما يكون من الأفضل إنشاء صورة أولاً ثم التحويل إلى شكل: يعد إنشاء الصورة أسرع وأكثر قوة، لذلك يمكن أن يكون من السهل العمل على شاشة العرض في وضع الصورة ثم إجراء تحويل نهائي إلى الشكل، مع الحفاظ على الشكل. الحجم.
   • قم بتعيين المسار الكامل إلى gswin32c.exe أو gswin64c.exe (لاحظ " c "!) وإلى Magick.exe الخاص بـ ImageMagick في نافذة "الإعدادات الرئيسية".
   • أفضل طريقة للتأكد من صحة المسار هي استخدام الزر "..." بجوار كل مسار والانتقال إلى الملف الصحيح.
   • تتضمن بعض المسارات الافتراضية %USERPROFILE% . يوصى بالنقر فوق "..." للتأكد من تحويل المسار بشكل صحيح إلى المسار الفعلي لملف تعريف المستخدم.
5. (اختياري) تثبيت وتعيين المسار إلى TeX2img :
   • مطلوب فقط لدعم الرسومات المتجهة عبر EMF (مقارنة بـ SVG، إيجابيات EMF هي: متوفرة في جميع إصدارات PowerPoint، وأشكال قابلة للتعديل بالكامل؛ السلبيات: بعض شاشات العرض تعاني بشكل عشوائي من التشوهات)
   • قم بالتنزيل من هذا الرابط (مزيد من التفاصيل حول TeX2img في Github repo الخاص بهم)
   • بعد تفريغ TeX2img في مكان ما على جهازك، قم بتشغيل TeX2img.exe مرة واحدة للسماح له بتعيين المسارات المختلفة تلقائيًا إلى latex/ghostscript، ثم قم بتعيين المسار الكامل إلى TeX2imgc.exe (لاحظ " c "!) في نافذة "الإعدادات الرئيسية" .
6. (اختياري) تثبيت بيانات تعريف LaTeXiT :
   • مطلوب لتحويل شاشات العرض التي تم إنشاؤها باستخدام LaTeXiT على نظام Mac إلى شاشات IguanaTex
   • قم بتنزيل LaTeXiT-metadata-Win.zip من صفحة الإصدارات، وقم بفك الضغط، ثم قم بتعيين المسار إلى LaTeXiT-metadata.exe في نافذة "الإعدادات الرئيسية".
   • تم إعداد البيانات الوصفية لـ LaTeXiT بواسطة بيير شاتيلير، مؤلف LaTeXiT، بناءً على طلبي. شكرا جزيلا له!
   • كود المصدر أصبح الآن عامًا.

إعدادات أخرى :

• إذا كان لديك تثبيت LaTeX غير قياسي، فيمكنك تحديد المجلد الذي يتم تضمين الملفات التنفيذية فيه في الإعدادات الرئيسية.
• إذا كنت ترغب في الحصول على خيار استخدام محرر خارجي، على سبيل المثال، عند تصحيح أخطاء كود مصدر LaTeX، فيمكنك تحديد المسار إلى هذا المحرر في الإعدادات الرئيسية. إذا كنت ترغب في استخدام هذا المحرر بشكل افتراضي عبر نافذة تحرير IguanaTex، حدد مربع الاختيار "الاستخدام كإعداد افتراضي".

ماك

التثبيت التلقائي مع Homebrew

إذا كنت تستخدم Homebrew، يكون التثبيت بسيطًا مثل:

brew tap tsung-ju/iguanatexmac
brew install --cask --no-quarantine iguanatexmac latexit-metadata

ثم اتبع 5. تأكد من تعيين المسارات بشكل صحيح في تعليمات التثبيت اليدوي أدناه.

لمزيد من التفاصيل (على سبيل المثال، كيفية الترقية أو إلغاء التثبيت )، يرجى الاطلاع على تعليمات Tsung-Ju's Homebrew.

التثبيت اليدوي

1. قم بتنزيل الملف المضغوط "الملفات المعدة مسبقًا لنظام التشغيل Mac" من صفحة الإصدارات الخاصة بهذا المستودع
   هناك 3 ملفات للتثبيت:

   • IguanaTex.scpt : ملف AppleScript للتعامل مع الوصول إلى الملفات والمجلدات
   • libIguanaTexHelper.dylib : مكتبة لإنشاء طرق عرض النص الأصلي؛ تم تضمين كود المصدر في git repo، ضمن "IguanaTexHelper/"
   • IguanaTex_v1_XX_Y.ppam : ملف الوظيفة الإضافية الرئيسي

2. قم بتثبيت IguanaTex.scpt

mkdir -p ~ /Library/Application  Scripts/com.microsoft.Powerpoint
cp ./IguanaTex.scpt ~ /Library/Application  Scripts/com.microsoft.Powerpoint/IguanaTex.scpt

3. قم بتثبيت libIguanaTexHelper.dylib

sudo mkdir -p ' /Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized '
sudo cp ./libIguanaTexHelper.dylib ' /Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/libIguanaTexHelper.dylib '

4. قم بتحميل الوظيفة الإضافية : ابدأ تشغيل PowerPoint (أعد تشغيله إذا كان قيد التشغيل عند تثبيت dylib). من شريط القائمة، حدد الأدوات > وظائف PowerPoint الإضافية... > '+'، ثم اختر IguanaTex_v1_XX_Y.ppam

   • في المرة الأولى التي تنقر فيها على أحد أزرار الوظيفة الإضافية، قد يتم إعلامك بأنه تم حظر libIguanaTexHelper.dylib . انتقل إلى إعدادات جهاز Mac، ثم الأمان والخصوصية، وانقر على "السماح على أي حال".

5. التحقق من تعيين المسارات بشكل صحيح :

   • انقر فوق "الإعدادات الرئيسية" في علامة تبويب شريط IguanaTex، وتأكد من تعيين المسارات إلى GhostScript وLaTeX الثنائيات وlibs.9.dylib (المستخدمة في تحويلات SVG) بشكل صحيح عن طريق النقر فوق كل زر "..." بجوار لهم: إذا كان الطريق صحيحاً، فيجب أن يأخذك إلى موقعه؛ وإلا فستحتاج إلى الانتقال إلى المسار ذي الصلة. يجب أن تتطابق الإعدادات الافتراضية مع مواقع تثبيت MacTex، ولكن قد يختلف التثبيت لديك.
   • إذا لم تتمكن من العثور عليها أو إذا اشتكت IguanaTex من عدم إرجاع الأمر، فافتح محطة طرفية واستخدم locate gs ، و locate pdflatex ، و locate libgs .

6. (اختياري) تثبيت بيانات تعريف LaTeXiT :

   • مطلوب لتحويل شاشات العرض التي تم إنشاؤها باستخدام LaTeXiT على نظام Mac إلى شاشات IguanaTex
   • قم بتنزيل LaTeXiT-metadata-macos من صفحة الإصدارات، وأضف إذنًا قابلاً للتنفيذ، ثم قم بتعيين المسار إلى موقعه في نافذة "الإعدادات الرئيسية" أو انسخه إلى مجلد الوظيفة الإضافية الآمن:
     chmod 755 ./LaTeXiT-metadata-macos
sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
   • في المرة الأولى التي يتم فيها استدعاء LaTeXiT-metadata-macos بواسطة IguanaTex، قد يقوم نظام التشغيل Mac OS بحظره. انتقل إلى إعدادات جهاز Mac، ثم الأمان والخصوصية، وانقر على "السماح على أي حال".
   • تم تجميع الملف القابل للتنفيذ على نظام التشغيل Mac OS 10.13 ولكن يجب أن يعمل على جميع الإصدارات. يرجى إعلامي إذا كان لديك أي مشكلة.
   • تم إعداد البيانات الوصفية لـ LaTeXiT بواسطة بيير شاتيلير، مؤلف LaTeXiT، بناءً على طلبي. شكرا جزيلا له!
   • كود المصدر أصبح الآن عامًا.

حيل غير واضحة

يجب أن يكون استخدام IguanaTex واضحًا في الغالب، ولكن هناك بعض النصائح والحيل التي قد لا تكون كذلك.

• مفاتيح التسريع (أي اختصارات لوحة المفاتيح): يمكن الوصول إلى العديد من أوامر IguanaTex ("إنشاء"، "إلغاء"، إلخ) باستخدام مجموعة من مفاتيح التعديل وحرف واحد. ابحث عن الحرف الذي تحته خط في النص/التسمية الخاصة بالزر المقابل.
• ويندوز: Alt + حرف. على سبيل المثال، بدلاً من النقر على " ز "إنشاء"، يمكنك استخدام Alt + g . (هذا هو سلوك Office القياسي على نظام التشغيل Windows)
• ماك: Ctrl + Cmd + حرف. على سبيل المثال، بدلاً من النقر على " ز "Enerate"، يمكنك استخدام Ctrl + Cmd + g . (لا تتوفر مفاتيح التسريع في Office القياسي لنظام التشغيل Mac، وقد تم ترميز هذا خصيصًا بواسطة Tsung-Ju لـ IguanaTex)

القضايا المعروفة

• تحتوي شاشات "الصور" التي تم إنشاؤها على نظام Mac (والتي هي عبارة عن ملفات PDF مُدرجة) على هامش إضافي صغير حولها حتى لا تظهر مقطوعة على نظام Windows. في الإصدارات السابقة، لم يكن هناك هامش ولكن الشاشة كانت تبدو مقصوصة. يبدو أن هذا خطأ في الطريقة التي يتعامل بها PowerPoint مع بعض ملفات PDF على نظام Mac، حيث يقوم بتخزينها داخليًا كملفات EMF. ومع ذلك، لا تحتوي ملفات PDF التي أنشأها LaTeXiT على هذه المشكلة، لذلك قد تكون هناك طريقة للتحايل على هذا الخطأ في إصدار مستقبلي من IguanaTex.
• لا يمكن إضافة وحدات ماكرو IguanaTex إلى شريط أدوات الوصول السريع على نظام Mac: وهذا خطأ معروف يُزعم أن Microsoft تعمل عليه.
• قد تكون هناك بعض مشكلات القياس عند تغيير تنسيق الملف (صورة <-> الشكل، أو حتى ضمن تنسيقات أشكال SVG وEMF المتنوعة). أفضل طريقة للتعامل مع ذلك هي استخدام وظائف "التحويل إلى الشكل"/"التحويل إلى الصورة"، والتي تعمل على إعادة إنشاء العرض بالتنسيق المطلوب مع الحفاظ على الحجم ثابتًا. يمكن للمرء بعد ذلك تعديل المحتوى إذا لزم الأمر، وسيكون القياس صحيحًا.
• بالنسبة لشاشات الشكل (أي الرسومات المتجهة)، يوصى بالإعداد الافتراضي "SVG via DVI w/ dvisvgm" بسبب المشكلات التي يتم ملاحظتها أحيانًا في الأوضاع الأخرى:
  • تظهر بعض شاشات العرض التي تم الحصول عليها عبر "EMF w/TeX2img" أو "EMF w/ pdfiumdraw" مشوهة. هذا هو خطأ PowerPoint الذي يحدث أحيانًا عند فك تجميع ملف EMF في كائن شكل.
  • تحتوي بعض شاشات العرض التي تم الحصول عليها باستخدام "SVG via PDF w/ dvisvgm" على رموز أو أجزاء من الرمز مفقودة. وذلك لأن بعض الخطوط يتم تمثيلها في PDF بواسطة مسارات مفتوحة بعرض خط معين، بدلاً من المسارات المغلقة، وبالتالي يتم التعامل معها بشكل مختلف بواسطة PowerPoint عند التحويل إلى كائن شكل. انظر هذه المناقشة لمزيد من التفاصيل.

رخصة

تم ترخيص هذا العمل بموجب ترخيص Creative Commons Attribution 3.0 Unported.