مدونة حسين

24 أغسطس, 2009

open search XML , ونظرة اقرب

بواسطة: admin في: دروس

منذ اصدار الفايرفوكس , والاكسبلورر 7 … اصبح بالامكان اضافة بحث للموقع في خانة البحث في اعلى الصفحة …
وبعض المواقع تستطيع ان تضيفها الى قائمة المواقع المبحوث فيها

Search

في البداية

انصحكم بقراءة مقالة الاخ صالح المطرفي حول الموضوع , وللاستزادة زوروا الموقع الرسمي للتقنية

تعريف للخدمة

خدمة لمشاركة نتائج بحث الموقع من خلال  المتصفح عدة دون الاضطرار للدخول الى صفحة البحث في الموقع
لغة البرمجة : XML و HTML

انشاء ملف XML

افتح ملف تحرير نصوص وانسخ فيه الكود التالي

 
<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
<ShortName>Hussein's blog</ShortName>
<LongName>Hussein's Search</LongName>
<InputEncoding>UTF-8</InputEncoding>
    <OutputEncoding>UTF-8</OutputEncoding>
<Language>ar</Language>
<Developer>Hussein Makki</Developer>
<Contact>h7umak@gmail.com</Contact>
    <Tags>css html xhtml jquery javascript web design</Tags>
<Image height="16" width="16" type="image/vnd.microsoft.icon">http://h7umak.com/b/wp-content/themes/hussein2/favicon.ico</Image>
<Url type="text/html" template="http://h7umak.com/b/?s={searchTerms}"/>
</OpenSearchDescription>

شرح الكود

الملف سيكون بصيغة xml. والسطر الاول يمثل مقدمة للملف ونضع فيه ترميز الملف والذي انصح ان يكون UTF-8

*عنصر <OpenSearchDescription>

جذر عناصر (او عقدة) للملف المعمول عليه المتطلبات : يجب ان يكتب مرة واحدة ويضم جميع العناصر الاخرى (مثل وسم <HTML> )

*عنصر “short name”

تضع فيه اسم مختصر لملف البحث مقروء من قبل الزوار , وفيه وصف قصير للبحث (ويضهر في المربع بلون رمادي فاتح ) المتطلبات: هذا العنصر يجب ان يضهر مرة واحدة فقط في الملف . اضائة: يجب ان يحتوي على 16 حرف أو اقل , ويجب ان لا يحتوي على لغة HTML او اي لغة مشابهة

*عنصر “long name”

شرح للملف , ويكون اطول من العنصر السابق  ( ويضهر في  قائمة البحوثات الى جانب ايقونة الموقع ) واذا لم يتواجد في الملف , يُعتمد العنصر السابق على انه هذا العنصر المتطلبات: من الممكن ان لا يتواجد هذ العنصر , أو يكتب لمرة واحدة فقط . اضائة :عدد احرف هذا العنصر 48 أو اقل , ولا يحتوي على HTML او لغة مشابهة

*عنصر “inputEncoding”

يحتوي على متغير بصيغة الترميز التي ستكون عليها مدخلات البحث المتطلبات: يمكن ان يتواجد لمرة او اكثر من مرة (متطلب غير اساسي في الملف ) القيمة الافتراضية : “UTF-8″

*عنصر “outputEncoding”

تضع فيه متغير بصيغة ترميز المخرجات أو نتائج البحث … ويفضل ان يكون UTF-8 المتطلبات مطابقة للعنصر السابق

*عنصر “Language”

تضع فيه اسم مختصر للغة المكتوبة (مثلا”ar” أو “en” ) او ان تضع “*” لتبين ان البحث يضم جميع اللغات المتطلبات: عنصر غير اساسي , يمكن ان بُكتب مرة او اكثر

*عنصر “developer”

يحتوي على اسم المبرمج او الشخص الذي كتب الملف المتطلبات : عنصر غير اساسي يمكن ان يتواجد مرة واحدة فقط اضائة : يجب ان لا يحتوي على اكثر من 64 حرف نصي , ولا يكون بلغة HTML او اي لغة اخرى

*عنصر “contact”

يحتوي على البريد الالكتروني لكاتب الملف , أو لمدير الموقع المتطلبات: عنصر غير اساسي  و يمكن ان يتواجد لمرة واحدة فقط

*عنصر “tags”

يضهر من اسمه , يحتوي على اوسمة او كلمات مفتاحية للموقع المبحوث فيه المتطلبات : عنصر غير اساسي ويمكن ان يضهر لمرة واحدة فقط . اضائة : يجب ان لا يحتوي على اكثر من 256 حرف نصي , ولا تكون بلغة HTML او اي لغة اخرى

*عنصر “image”

يحتوي بداخله رابط للصورة او الايقونة التي ستضهر في مربع البحث للدلالة على الموقع وتستطيع التحكم بالارتفاع والعرض من خلال العنصرين “height” و “width” ويجب ان تكون الصورة اما بصيغة ICO او JPG اوPNG , وبالابعاد 16*16 اضائة : يجب ان تكون القيمة داخل العنصر رابط URL المتطلبات: عنصر غير اساسي , يمكن ان يتواجد مرة واحدة فقط .

* عنصر “url”

العنصر الاهم في هذا الملف , وهو الذي سيضهر نتائج البحث في الموقع , وتضع بداخله عنوان الموقع متبوع بمتغير البحث وبعدها {search terms} مثال

http://www.google.com/search?q= {search terms}

العمل على HTML

في البداية يجب اضافة الكود التالي داخل وسم <head> في الملف

<link rel="search" type="application/opensearchdescription+xml" href="The XML file dictionary" title="your search's title" />

تحميل الملف

انصحك بتحميل هذا الملف الافتراضي , وتستطيع تعديله كما تريد حسب موقعك

file_xml

اخترت لكم

وسوم: , ,




لا تعليقات على "open search XML , ونظرة اقرب"

يمكنك استخدام اي من الابتسامات التالية :

اكتب تعليقك




التصنيفات

معي , ومعكم

تصنيفاتي

متواجد .. هناك

اقتبس منهم

سأراكم فرحين يوماً ...


حول المدونة


هذه مدونة الطالب حسين مكي عدنان , في ثانوية دار الارقم الاسلامية ,اكتب فيها كل ما يدور في ذهني حول التقنية والمجتمع من حولي ... !
شمرة وجهي تفزز اللي يتفرج عليه ! , عآد تتحملوني "^^
! لتتعرف علي اكثر

google google