دليل المستخدم
إعدادات الإنترنت
تعيين إعدادات الإنترنت ليس مهمة تافهة ولكنها تسمح بالبحث في التطبيق عن المحتوى من الإنترنت إذا تم تكوينها بشكل صحيح. لا يمكن لـ OnSong توفير هذه الإعدادات لك لأنه يتطلب منك الموافقة على استخدام محتوى موقع الويب وفقاً لشروط الاستخدام الخاصة به. إذا تركت هذه الإعدادات فارغة، فسيتم تعطيل ميزة البحث عن الإنترنت في التطبيق وستحتاج إلى استخدام امتداد إضافة إلى OnSong Safari بدلاً من ذلك.
ملاحظة: يستخدم OnSong لغة برمجة موجهة نحو الأنماط تسمى التعبيرات العادية لتحديد المحتوى المراد استيراده. عند كتابتها بشكل صحيح، فإن هذه السلاسل من الأحرف تشكل أنماطاً يمكنها استخراج النصوص من محتوى صفحة الويب. يتم استخدام التعبيرات العادية في خصائص الأنماط أدناه.
يمكنك تكوين OnSong للبحث في مواقع ويب مختلفة باستخدام الحقول التالية:
معاملات البحث
يستخدم OnSong محرك البحث Microsoft Bing للبحث عن المحتوى على الإنترنت. بينما يتم نقل استعلام البحث مباشرة إلى محرك البحث، يمكن نقل معاملات إضافية للبحث هنا مثل المجال الذي سيتم البحث فيه. يقيد المثال التالي البحث إلى دليل الحروف في موقع ويب معين:
site:http://www.domain.com/chords
تعرف على المزيد حول معاملات البحث المتقدمة في Bing
نمط العنوان
يتم تنفيذ نمط العنوان مقابل سمة العنوان من محتوى الصفحة المكتشفة ويُستخدم لاستخراج عنوان الأغنية. يستخرج المثال التالي Brown Eyed Girl من العنوان الكامل لصفحة الويب، Brown Eyed Girl By Van Morrison.
(.+?)(?=(( +Chords)|( +By)))
نمط السطر الثانوي
يتم تنفيذ نمط السطر الثانوي مقابل سمة العنوان من محتوى الصفحة المكتشفة ويُستخدم لاستخراج السطر الثانوي أو فنان الأغنية. يستخرج المثال التالي Van Morrision من العنوان الكامل لصفحة الويب، Brown Eyed Girl - Van Morrison.
(?<=[\-])(.+?)(?=\|+\s*)
نمط المحتوى
يُستخدم نمط المحتوى لاستخراج محتوى الأغنية من محتوى HTML الكامل لصفحة الويب. عادة يتم وضع هذا المحتوى في علامات HTML <pre></pre>. يستخرج المثال التالي المحتوى من عناصر pre في محتوى HTML لصفحة الويب المكتشفة.
(?<=<pre>)(.+?)(?=</pre>)
نمط الحروف
في بعض الحالات، يتم وضع الحروف باستخدام HTML. يمكن لـ OnSong تحديد الحروف باستخدام نمط تعبير عادي أيضاً. في هذا المثال، يتم استخدام علامات HTML <u></u> للإشارة إلى الحروف في HTML. سيستخرج النمط التالي تلك القيم وتحويلها إلى حروف موضوعة بين قوسين.
<u>(.+?)</u>
نمط الحروف
عند مواجهة محتوى، قد يتم وضعه بين قوسين، أو قد يكون نصاً عادياً باستخدام حروف فوق الكلمات. يمكنك تكوين الصيغة المتوقعة من موقع الويب هنا. على سبيل المثال، إذا اخترنا وضع قوسين واستخدمنا نمط الحروف السابق، فسيتم محاطة الحروف المكتشفة بأقواس مربعة.
إزالة علامات HTML
بينما يتم إنشاء معظم مخططات الحروف في صفحات الويب كنص عادي ضمن علامات <pre></pre>، إلا أنها تحتوي أحياناً على علامات HTML غير ضرورية. قم بتفعيل هذا الخيار لإزالة علامات HTML غير ضرورية. الوضع الافتراضي معطّل.