لقد تمت أرشفة هذا المقال ولم تعد Apple تحدثه.

إنشاء أدوات HTML5 لتطبيق iBooks Author

تعلّم كيفية إعداد أدوات HTML5 يمكنك استخدامها في الكتب التي تقوم بإنشائها في iBooks Author.

يدعم iBooks Author أدوات HTML5، ويحمل امتداد اسم الملف ".wdgt". لإعداد أداة HTML5، استخدم محرر نصوص أو تطبيق إعداد محتوى لإنشاء الملفات الثلاثة التالية:

  • ملف HTML رئيسي: هذا الملف هو الجزء الرئيسي للأداة. يمكن أن يحمل أي اسم تريده، لكن امتداده يجب أن يكون ".html". كما يمكنك وضع ملف CSS وJavaScript داخل ملف HTML الرئيسي. أو، إضافة ملفات ".css" و".js" إلى حزمة الأدوات وتحميلها من ملف HTML الرئيسي. يمكنك استخدام أي تقنية استخدمتها مسبقًا لتصميم صفحة ويب. حيث يمكنك استخدام HTML لتحديد هيكل الأداة وCSS لتوفير النمط البصري وJavaScript لإضفاء التفاعلية.

  • ملف "Default.png": تعتبر أسهل طريقة لإعداد ملف Default.png هي أخذ لقطة شاشة لملف HTML الرئيسي في أحد تطبيقات إعداد محتوي ويب أو متصفح ويب. هذه هي الصور التي يراها القراء على الصفحة وينقرون عليها لفتح الأداة. في متصفح ويب أو تطبيق إعداد محتوى ويب، قم بأخذ لقطة شاشة من ملف HTML رئيسي. قم بتسميته باسم "Default.png"، وتأكد من استخدام الأحرف الكبيرة في كتابة الحرف "D" وعند تنشيط الأداة ستعرف حجم ملف Default.png. والذي يمكنك تغيير حجمه في الملف Info.plist.

  • الملف Info.plist: يوفر هذا الملف المعلومات اللازمة لكل من iBooks Author وApple Books لتشغيل الأداة. يجب أن يكون اسم الملف "Info.plist."

بعد إنشاء هذه الملفات المطلوبة، قم بإنشاء أية ملفات اختيارية تريدها، مثل ملفات CSS أو JavaScript. ثم، قم بإضافتها جميعًا إلى حزمة الأداة:

  1. في فايندر، قم بإنشاء مجلد.

  2. قم بإضافة الملفات إلى مجلدك الجديد.

  3. قم بإعادة تسمية المجلد وإضافة امتداد ".wdgt" إلى اسم المجلد لإنشاء حزمة الأداة. وستتغير أيقونة المجلد إلى شكل أيقونة الأداة.

  4. قم بإضافة أداتك إلى iBooks Author.

خطوات إنشاء أدوات

قبل إنشاء حزمة الأدوات، تأكد من عدم احتواء أي ملف من ملفات الحزمة على أحرف تحكم في اسم الملف. وفي حالة احتواء أحد الملفات على هذه الأحرف، فلن تتمكن من نشر الكتاب على Book Store في Apple Books.

في حالة ضبط الأداة على وضع التشغيل التلقائي، فلن تتمكن من الوصول إلى الإنترنت.

لا تستخدم أيقونات مخصصة للمجلد، وتجنب أسماء المجلدات التالية في أداتك:

  • الموارد/

  • ملفات الدعم/الموارد/

  • المحتويات/الموارد/

لتحسين أداتك لشاشة ريتنا:

  • في ملفات HTML وCSS وJavaScript، استخدم بروتوكول معياري لمواقع الويب باستخدام رسومات ريتنا‏ (2x).

  • قم بتضمين ملف "Default@2x.png" في الأداة. مع ضبط دقة الملف بنحو ضعف دقة الملف "Default.png" مرتين. لا يمكنك رؤية هذا الملف في iBooks Author، ولكن يمكنك رؤيته في Apple Books على أحد شاشات ريتنا.

تعرّف على المزيد حول كيفية تحسين الكتب التي تقوم بإعدادها باستخدام iBooks Author‏.

ملف Info.plist

يحتوي ملف Info.plist للأداة الرئيسية على بعض المفاتيح المطلوبة وبعض المفاتيح الاختيارية. ويتناول الجدول التالي هذه المفاتيح، بجانب تعريفاتها وبعض قيم الأمثلة لأداة تسمى "Hello World".

المفتاح

قيمة مثال

مطلوب

التعريف

CFBundleDevelopmentRegion

الإنجليزية

اختياري

سلسلة تحدد المنطقة الأصلية للحزمة. وهي تتوافق عادة مع اللغة الأصلية للشخص الذي قام بإنشاء الحزمة.

CFBundleDisplayName

Hello World

مطلوب

سلسلة تحتوي على الاسم الفعلي للأداة. وستظهر في iBooks Author وApple Books.

CFBundleIdentifier

com.apple.widget.HelloWorld

مطلوب

سلسلة تحدد الأداة بصورة فريدة، في صيغة مجال عكسي.

CFBundleName

Hello World

اختياري

سلسلة تحتوي على اسم الأداة. والذي يجب أن يتطابق مع اسم حزمة الأداة في فايندر، محذوفًا منه امتداد الملف ".wdgt".

CFBundleShortVersionString

1.0

اختياري

سلسلة تعطي رقم الإصدار المختصر للأداة. ويكون غالبًا مماثلاً إلى CFBundleVersion.

CFBundleVersion

1.0

اختياري

سلسلة تعطي رقم الإصدار الخاص بالأداة.

الطول

768

اختياري

عدد يعرّفك طول الأداة بوحدة البكسل. إذا لم يحدد، فسيتم استخدام طول Default.png.

MainHTML

HelloWorld.html

مطلوب

سلسلة تعطي اسم ملف HTML الذي يقوم بتنفيذ أداتك.

العرض

1024

اختياري

عدد يعرّفك عرض الأداة بوحدة البكسل. إذا لم يحدد، فسيتم استخدام عرض Default.png.

IBNotifiesOnReady

اختياري

عند الضبط على true (صواب)، فستخبر الأداة Apple Books بموعد التبديل من عرض Default.png إلى عرض أداة HTML الجارية.

ملف Info.plist الكامل للأداة يبدو بالصورة التالية:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>CFBundleDevelopmentRegion</key> <string>English</string> <key>CFBundleDisplayName</key> <string>Hello World</string> <key>CFBundleIdentifier</key> <string>com.apple.widget.HelloWorld</string> <key>CFBundleName</key> <string>Hello World</string> <key>CFBundleShortVersionString</key> <string>1.0</string> <key>CFBundleVersion</key> <string>1.0</string> <key>Height</key> <integer>768</integer> <key>MainHTML</key> <string>HelloWorld.html</string> <key>Width</key> <integer>1024</integer> <key>IBNotifiesOnReady</key> <true/> </dict> </plist>

حدود المفاتيح وقيودها

لا تستخدم المفاتيح التالية؛ فالميزات غير متوافقة:

المفتاح

الوصف

AllowFileAccessOutsideOfWidget

الأدوات الموجودة في الكتب التي تم إنشاؤها باستخدام iBooks Author لا يمكنها الوصول إلى الملفات الموجودة في نظام الملف العام.

AllowFullAccess

اختزال لقائمة تحتوي على مفاتيح الوصول الأخرى، بعضها غير متوافق.

AllowInternetPlugins

مكونات الإنترنت الإضافية مثل Flash، غير متوفرة في الكتب التي تم إنشاؤها بواسطة iBooks Author. يمكنك تضمين الأفلام والصوت باستخدام HTML5

مع العلم بأن الأفلام ومقاطع الصوت الموجودة داخل أدوات HTML لن تكون محمية بموجب إدارة الحقوق الرقمية (DRM).

AllowJava

الأدوات الموجودة في الكتب التي تم إنشاؤها بواسطة iBooks Author لا يمكن أن تتضمن محتوى Java.

AllowSystem

أدوات موجودة في الكتب التي تم إنشاؤها بواسطة iBooks Author لا يمكنها الوصول إلى أوامر النظام.

Plugin

أدوات موجودة في الكتب التي تم إنشاؤها بواسطة iBooks Author لا يمكن أن تتضمن أحد مكونات Cocoa الإضافية.

يتجاهل iBooks Author المفاتيح التالية:

المفتاح

الوصف

CloseBoxInsetX

لا تعرض الأدوات الموجودة في iBooks Author وApple Books ديكورات قريبة.

CloseBoxInsetY

الخطوط

أدوات iBooks Author لا يمكنها استخدام خطوط مضمنة.

متطلبات الفيديو والصوت

لا يمكنك استخدام الوسائط التي تستخدم امتداد الملفات ‎.m4v أو .m4p. استخدم أحد الصيغ التالية مع امتداد ملف .mp4:

  • فيديو H.264: ما يصل إلى 720 بكسل، 60 إطارًا في الثانية، مستوى ملف تعريف عالٍ 4.2 مع صوت AAC-LC يصل إلى 160 كيلوبت في الثانية، 48 كيلوهرتز، صوت إستريو. وتستخدم مقاطع الفيديو التي تفتح في iMovie 10 بخيار دقة عالية تصل إلى 720 بكسل هذه الإعدادات.

  • فيديو MPEG-4: ما يصل إلى 2.5 ميغابايت في الثانية، 640 × 480 بكسل، 30 إطارًا في الثانية، ملف تعريفي بسيط مع صوت AAC-LC يصل إلى 160 كيلوبت في الثانية، 48 كيلوهرتز، صوت إستريو.

بالنسبة إلى الصوت، استخدم AAC‏ (8 إلى 320 كيلوبت في الثانية، 48 كيلوهرتز إستريو) مع امتداد ملفات ‎.m4a

وسائط الفيديو والصوت في حزم أدوات HTML غير محمية بموجب إدارة الحقوق الرقمية (DRM).

إذا لم يعمل الملف الصوتي أو الفيلم في أداتك الموجودة في iBooks Author، فقم باستعراضه على iPhone أو iPad أو Mac. وهذا سيوضح كيف سيعمل الملف في كتابك المكتمل.

الترجمة

لا يدعم iBooks Author السلاسل والأصول المترجمة. بما في ذلك السلاسل النصية الموجودة في اللغة الهدف التي يمكن للقارئ الاطلاع عليها بصورة مضّمنة.

إصلاح العناصر المتداخلة

قد يظهر عنصر، مثل

#video { العرض: 960؛ الارتفاع: 540؛ }

تطوير نظامي iOS وmacOS

يستخدم نظامي iOS وmacOS أنواع إدخال مختلفة. يمكنك السماح بكل من الإدخال باللمس وبالماوس عند إنشاء أدوات HTML لـ iBooks Author.

تجنب الفلاش عند فتح القراء لأداة HTML

إذا كانت أداة HTML معقدة للغاية، فقد يظهر للقراء فلاش عند فتحها في Apple Books. لتجنب هذا، قم بتحديث أداتك لإخبار Apple Books بموعد التبديل من الملف Default.png إلى أداة HTML:

1. قم بإضافة أحد عناصر "IBNotifiesOnReady" التي تم ضبطها إلى true (صواب) في الملف Info.plist الخاص بالأداة. وهذا يتيح لـ Apple Books معرفة أن الأداة ستخبرها بموعد التبديل إلى أداة HTML.

<key>IBNotifiesOnReady</key>

2. قم بتعيين أداتك لتحميل مكتبة Apple JavaScript

iOS وmacOS لديهما AppleWidget.js بالفعل، لذا لن تضطر إلى تضمينه في حزمة الأداة.

3. قم بضبط أداتك لإشعار Apple Books بموعد تهيئة HTML. في JavaScript الموجود في

widget.notifyContentIsReady()

النشر إلى خدمة ويب خارجية

يمكنك نشر أداة HTML إلى خدمات ويب خارجية فقط في حالة استخدام عناوين صحيحة لمشاركة المصادر مختلفة النطاقات ‏(CORS‏).

تاريخ النشر: