مكتبة Greenstone الرقميه مرشد المثبت
Chapter 6 إضفاء طابع شخصي على التثبيت الخاص بك
Contents
على الارجح أن اول شيء تريد ان تفعله بمجرد تثبيت وتشغيل , Greenstone هو إضفاء الطابع الشخصي علي الصفحة الرئيسية .الملف الذي يولد صفحة Greenstone الرئيسية يسمى home.dm ، ويوضع في الدليل الفرعي macros للدليل الذي تم فيه تثبيت Greenstone . (الافتراضي لنظم ويندوز Windows هو C:\Program Files\gsdl.) وهو ملف نص بسيط تحتاج لتعديله لانشاء صفحة جديدة. بدلا من التحرير ، فإننا نوصي بإنشاء ملف جديد ، يمكن القول بانه yourhome.dm .و سيكون هذا مثل "home.dm" ولكن سوف تحدد حزمة الموقع - وهو الحد الأدني لإنجاز العمل الفعلي - في طريقة مختلفة.
عندما تقوم بإنشاء الصفحة الرئيسية المختلفة، يجب ان تكون هناك وسيلة للربط في صفحات المكتبه الرقميه بحيث تتمكن من بحث و تصفح المجموعات على جهازك. الحل يكمن في ان Greenstone يعتمد على استخدام“macros” – و هذا يوضح لماذا تسمي صفحة-الموقع الصفحه “.dm” وليس “.html”- وهو ملف “macro” و ليس ملف “.html”— قياسي . ولكن لا تخف : فان ملف “macro” يتضمن اساسا لغة تأشير النص الفائق ، مع نثر وصفة سحرية داخله كما هو موضح ادناه. تعتبر لغة “macro” تسهيلة قوية ، و المبين إدناه ليس سوي جزء صغير - انظر مكتبه Greenstone الرقميه مرشد المطور لمزيد من المعلومات.
6.1 مثال
الشكل يبين مثال للصفحه الرئيسية لمكتبه رقميه جديدة. كل من روابط انقر هنا " ياخذك الى مرفق Greenstone المناسب – تم توليد هذه الصفحه بملف yourhome.dm الموضح في الشكل ."
|
package home
|
|
_content_ {
|
|
<h2>Your own Greenstone home page</h2>
|
|
<ul>
|
|
<table>
|
|
<tr valign=top><td>Search page for the demo collection<br></td>
|
|
<td><a href="_httpquery_&c=demo">Click here</a></td></tr>
|
|
<tr><td>"About" page for the demo collection</td>
|
|
<td><a href="_httppageabout_&c=demo">Click here</a></td></tr>
|
|
<tr><td>Preferences page for the demo collection</td>
|
|
<td><a href="_httppagepref_&c=demo">Click here</a></td></tr>
|
|
<tr><td>Home page</td>
|
|
<td><a href="_httppagehome_">Click here</a></td></tr>
|
|
<tr><td>Help page</td>
|
|
<td><a href="_httppagehelp_">Click here</a></td></tr>
|
|
<tr><td>Administration page</td>
|
|
<td><a href="_httppagestatus_">Click here</a></td></tr>
|
|
<tr><td>The Collector</td>
|
|
<td><a href="_httppagecollector_">Click here</a></td></tr>
|
|
</table>
|
|
</ul>
|
|
}
|
|
# if you hate the squirly green bar down the left-hand side of the
|
|
# page, uncomment these lines:
|
|
# _header_ {
|
|
# }
|
يمكنك استخدام الشكل كنموذج لتخلق بنفسك صفحة Greenstone الرئيسية الخاصة بك. بصورة اساسية ، هي تعرف macro يسمي المحتوي .content داخل الأقواس المعقوصة توجد لغة تأشير النص الفائق html العادية. يمكنك حشر نص اضافي ، جنبا الى جنب مع أوامر نسق عرض لغة تأشير النص الفائق html ، لوضع المحتوى الذي ترغب في رؤيته على الصفحه.يعتبر النص هو لغة تأشير النص الفائق html العادي؛ اذا اردت يمكنك تضمين الروابط واستخدام جميع التسهيلات الاخرى التي توفرها لغة تأشير النص الفائق html.
لربط صفحة موقعك الجديدة مع صفحات المكتبة الرقمية الأخري ، انت بحاجة الى استخدام الوصفة السحرية.في لغة macro هذه ، الوصفة السحرية هي عبارة عن كلمات محاطة بالعلامة ،_،. يمكنك ان ترى هذا في الشكل 4..على سبيل المثال ، _httppagehome_ تأخذك إلى صفحة الموقع ، _httppagehelp_ الى صفحة المساعدة ، وهكذا - في بعض الحالات انت بحاجة الى ادراج اسم المجموعة. على سبيل المثال ، _httpquery_&c=demo تحدد صفحة البحث للمجموعة النموذجية ؛بالنسبة للمجموعات الأخري يمكنك إستبدال demo باسم المجموعة المناسب .
تعريف macro يسمي المحتوي _content_ و هو ملف بسيط بلغة تأشير النص الفائق html. أي تشفير قياسي بلغة تأشير النص الفائق html يمكن أن يوضع داخل تعريف macro. ومع ذلك ، فان الحروف خاصة' '{', '}', '\', و '_' يجب ان توضع مع backslash لمنعها من قيد المعالجه بواسطة مفسرلغة macro.
علما ان تعريف _content_ لا يحتوي على الروؤس أو التذييلات بلغة تأشير النص الفائق html .اذا كنت تريد تغيير الرأس او الذيل من صفحه موقعك ، يجب عليك ان تعرف macros لل _header_ و / أو _footer_ ، واضافتها الى ملف yourhome.dm الملف في شكل
على سبيل المثال ، العمود الاخضر اسفل الجانب الايسر من صفحات Greenstone هو معرف في macro _header_ ، وإزالة القيمة منه سوف تزيله ، كما هو مبين في نهاية الشكل .
6.2 كيف تعدها للعمل.
يجب أن تعلم Greenstone عن صفحة الموقع الجديدة yourhome.dm . يقوم النظام بقراءة ملفات macro و التي تم تحديدها في ملف الإعداد الرئيسي main.cfg، حتى اذا قمت بإنشاء ملف جديد يجب عليك ادراجه هناك. الأسماء المتشابكة تعالج بصورة منطقيه : أحدث تعريف بالاسبقيه.
وهكذا لجعل برنامج مكتبة Greenstone الرقميه يستخدم صفحة الموقع في الشكل بدلا من الإفتراضية ، اولا قم بوضع ملف yourhome.dm في الشكل في دليل macros.ثم تحرير ملف الإعداد الرئيسي main.cfg لإستبدال home.dm مع yourhome.dm في قائمة ملفات macro التي يتم تحميلها في البدء.
6.3 اعادة توجيه موقع لgreenstone
قد ترغب في اعادة توجيه لبرنامج Greenstone لجعل عنوان الموقع الخاص بك اكثر ملاءمة . على سبيل المثال ، على نظامنا عنوان الموقع http://nzdl.org (وهو اختصار لHttp://nzdl.org/index.html) و هو اعادة توجيهها الى http://nzdl.org/cgi-bin/library .ينجز مزود ويب اباتشي Apache هذا مع Redirect التوجيهي. جنبا الى جنب مع غيرها من التوجيهات ، وهذا يعود الى ملف الإعداد C:\Program Files\Apache Group\Apache\conf\httpd.conf. لاعادة توجيه عنوان الموقع http://www.yourserver.comالى http://www.yourserver.com/cgi-bin/library ، ووضع هذا السطر في httpd.conf :
ثم إنك ستصل الى نظام المكتبه الرقميه الخاصة بك مباشرة من موقع http://www.yourserver.com . وبدلا من ذلك ، اذا كنت تريد موقع مثل http://www.Yourserver.com/greenstone ان يعاد توجيهه الى http://www.yourserver.com/cgi-bin/library ،قم بإدراجه في ملف httpd.conf
اذا كان جهازك لا يملك اسم نطاق (مثل www.yourserver.com "أعلاه) ، فقط قم بإستبدال www.yourserver.com بـ localhost في السطور اعلاه. طالما ان المتصفح يعمل على نفس الجهاز كما أن مزود الويب - الذي هو بالتأكيد اذا كان جهازك لا يملك اسم نطاق- له نفس التأثير كما سبق في إعادة التوجيهات اعلاه."
بدلا من وضع تعليمات اعادة توجيه التوجيهات في ملف httpd.conf ، ويمكنك بنفس المستوي وضعها في الملف .htaccess ضمن دليل الوثيقة الجذري للمزود. في الحقيقة ، القيام بهذا الإجراء له ميزتان - اولا ، تغييرات Htaccess تنفذ على الفور ، في حين انك تحتاج لأعادة تشغيل مزود ويب اباتشي Apache لإحداث التغيرات التي كتبت في httpd.conf. ثانيا ، على أنظمة يونيكس انت عادة تدخل كمستخدم أساسي “root” لتعديل httpd.conf ، في حين انك لا تقوم بهذا httpd.conf,