إنشاء أدوات 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 وiBooks لتشغيل الأداة. يجب أن يكون اسم الملف "Info.plist."

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

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

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

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

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

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

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

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

  • في ملفات HTML وCSS وJavaScript، استخدم بروتوكول معياري لمواقع الويب باستخدام رسومات Retina‏ (2x). 
  • قم بتضمين ملف "Default@2x.png" في الأداة. مع ضبط دقة الملف بنحو ضعف دقة الملف "Default.png" مرتين. لا يمكنك رؤية هذه الملف في iBooks Author، لكنك يمكنك رؤيته في iBooks على شاشة Retina.

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

ملف Info.plist

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

المفتاح قيمة مثال مطلوب التعريف
CFBundleDevelopmentRegion الإنجليزية اختياري سلسلة تحدد المنطقة الأصلية للحزمة. وهي تتوافق عادة مع اللغة الأصلية للشخص الذي قام بإنشاء الحزمة. 
CFBundleDisplayName Hello World مطلوب سلسلة تحتوي على الاسم الفعلي للأداة. وستظهر في iBooks Author وiBooks.
CFBundleIdentifier com.apple.widget.HelloWorld مطلوب سلسلة تحدد الأداة بصورة فريدة، في صيغة مجال عكسي.
CFBundleName Hello World اختياري سلسلة تحتوي على اسم الأداة. والذي يجب أن يتطابق مع اسم حزمة الأداة في Finder، محذوفًا منه امتداد الملف ".wdgt".
CFBundleShortVersionString 1.0 اختياري سلسلة تعطي عدد الإصدار المختصر للأداة. ويكون غالبًا مماثلاً إلى CFBundleVersion.
CFBundleVersion 1.0 اختياري سلسلة تعطي عدد الإصدار الخاص بالأداة.
الطول 768 اختياري عدد يعرّفك طول الأداة بوحدة البكسل. إذا لم يحدد، فسيتم استخدام طول Default.png.
MainHTML HelloWorld.html مطلوب سلسلة تمنحك اسم ملف HTML الذي ينفذ أداتك.
العرض 1024 اختياري عدد يعرّفك عرض الأداة بوحدة البكسل. إذا لم يحدد، فسيتم استخدام عرض Default.png.
IBNotifiesOnReady <true/> اختياري عند الضبط على true (صواب)، فستخبر الأداة iBooks بموعد التبديل من عرض 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 وiBooks لا تعرض ديكورات قريبة.
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 السلاسل والأصول المترجمة. بما في ذلك السلاسل النصية الموجودة في اللغة الهدف التي يمكن للقارئ الاطلاع عليها بصورة مضّمنة.

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

ربما يظهر أحد العناصر، مثل<فيديو>، بصورة متداخلة في اتجاه واحد. وهذا يمكن حدوثه إذا كانت أبعاده أكبر من المساحة المتوفرة. قم بإيجاد ملف CSS الخاص بـ "width:auto" في #محدد الفيديو ثم تغييره ليعكس الأبعاد الحقيقية. على سبيل المثال، ربما تحتوي أداتك على فيديو أبعاده 960 × 540. تحقق من ملف CSS بحثًا عن المحدد المرتبط وقم بضبط العرض والطول إلى القيم الصحيحة:

#video   {
	width: 960;
	height: 540;
}

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

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

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

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

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

<key>IBNotifiesOnReady</key>
 <true/>






2. قم بضبط الأداة لتحميل مكتبة Apple JavaScript في الجزء <الرئيسي> من الملف HTML:

<script type="text/javascript" src="AppleClasses/AppleWidget.js"> </script>

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

3. قم بضبط الأداة لإخطار iBooks بموعد تهيئة HTML. في ملف JavaScript الموجودة في الجزء<الرئيسي> من الملف HTML، اتصل بـ:

widget.notifyContentIsReady()

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

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

تاريخ النشر: