Greenstone Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.


====== إضفاء طابع شخصي على التثبيت الخاص بك  <Updated date="18-Mar-2008 by Kamal Salih"/> ======

على الارجح أن  اول شيء تريد ان تفعله بمجرد تثبيت وتشغيل , Greenstone هو إضفاء الطابع الشخصي علي الصفحة الرئيسية .الملف الذي يولد صفحة Greenstone الرئيسية يسمى //home.dm // ، ويوضع في الدليل الفرعي //macros// للدليل الذي تم فيه تثبيت  Greenstone . (الافتراضي لنظم ويندوز Windows هو //C:\Program Files\gsdl//.) وهو ملف نص بسيط تحتاج لتعديله لانشاء صفحة جديدة. بدلا من التحرير ، فإننا نوصي بإنشاء ملف جديد ، يمكن القول بانه //yourhome.dm //.و سيكون هذا مثل "//home.dm//" ولكن سوف تحدد حزمة الموقع - وهو الحد الأدني لإنجاز العمل الفعلي - في طريقة مختلفة.<Updated date="18-Mar-2008 by Kamal Salih"/>

عندما تقوم بإنشاء الصفحة الرئيسية المختلفة، يجب ان تكون هناك وسيلة للربط في صفحات المكتبه الرقميه بحيث تتمكن من بحث و تصفح المجموعات على جهازك. الحل يكمن في  ان Greenstone يعتمد على استخدام“macros” – و هذا يوضح لماذا تسمي صفحة-الموقع  الصفحه “.dm”   وليس “.html”- وهو ملف “macro” و ليس ملف “.html”— قياسي . ولكن لا تخف : فان ملف “macro” يتضمن اساسا  لغة تأشير النص الفائق ، مع نثر وصفة سحرية داخله  كما هو موضح ادناه. تعتبر لغة “macro”  تسهيلة قوية ، و المبين إدناه ليس سوي جزء صغير - انظر // مكتبه Greenstone الرقميه مرشد المطور // لمزيد من المعلومات. <Updated date="18-Mar-2008 by Kamal Salih"/>

===== مثال  <Updated date="18-Mar-2008 by Kamal Salih"/> =====

<imgcaption figure_your_own_greenstone_home_page|%!-- id:264 --%صفحه  Greenstone  الرئيسية الخاصة بك <Updated date="18-Mar-2008 by Kamal Salih"/> ></imgcaption>
{{..:images:install_fig_3.png?395x227&direct}}

الشكل <Crossref target="figure" ref="your_own_greenstone_home_page"/> يبين مثال للصفحه الرئيسية  لمكتبه رقميه جديدة. كل من روابط  انقر هنا " ياخذك الى مرفق Greenstone المناسب – تم توليد هذه الصفحه بملف //yourhome.dm // الموضح في الشكل <Crossref target="figure" ref="yourhome_dm"/>." <Updated date="18-Mar-2008 by Kamal Salih"/>

<imgcaption figure_yourhome_dm|%!-- id:266 --%تستخدم //yourhome.dm // لخلق الشكل <Crossref target="figure" ref="your_own_greenstone_home_page"/> <Updated date="18-Mar-2008 by Kamal Salih"/> ></imgcaption>
<code>
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_ {
# }
</code>



يمكنك استخدام الشكل <Crossref target="figure" ref="yourhome_dm"/> كنموذج لتخلق بنفسك صفحة Greenstone الرئيسية الخاصة بك. بصورة اساسية ، هي تعرف macro يسمي المحتوي  .//content// داخل الأقواس المعقوصة توجد لغة تأشير النص الفائق html العادية. يمكنك حشر نص اضافي ، جنبا الى جنب مع أوامر نسق عرض  لغة تأشير النص الفائق html ، لوضع المحتوى الذي ترغب في رؤيته على الصفحه.يعتبر النص هو لغة تأشير النص الفائق html العادي؛ اذا اردت يمكنك تضمين الروابط واستخدام جميع التسهيلات الاخرى التي توفرها لغة تأشير النص الفائق html. <Updated date="18-Mar-2008 by Kamal Salih"/>

لربط صفحة موقعك الجديدة مع صفحات المكتبة الرقمية الأخري ، انت بحاجة الى استخدام الوصفة السحرية.في لغة  macro  هذه ، الوصفة السحرية هي عبارة عن كلمات محاطة بالعلامة ،_،. يمكنك ان ترى هذا في الشكل <imgref figure_yourhome_dm>..على سبيل المثال ، //_httppagehome_// تأخذك إلى صفحة الموقع ، //_httppagehelp_// الى صفحة المساعدة ، وهكذا - في بعض الحالات انت بحاجة الى ادراج اسم المجموعة. على سبيل المثال ، //_httpquery_&c=demo// تحدد صفحة البحث للمجموعة النموذجية ؛بالنسبة للمجموعات الأخري يمكنك إستبدال //demo//  باسم المجموعة المناسب .<Updated date="18-Mar-2008 by Kamal Salih"/>

تعريف macro يسمي المحتوي  //_content_// و هو ملف بسيط بلغة تأشير النص الفائق html. أي تشفير قياسي بلغة تأشير النص الفائق html  يمكن أن يوضع داخل تعريف macro. ومع ذلك ، فان الحروف خاصة' '{', '}', '\', و '_' يجب ان توضع مع backslash لمنعها من قيد المعالجه بواسطة مفسرلغة macro. <Updated date="18-Mar-2008 by Kamal Salih"/>

علما ان تعريف //_content_// لا يحتوي على الروؤس أو التذييلات بلغة تأشير النص الفائق html .اذا كنت تريد تغيير الرأس او الذيل من صفحه موقعك ، يجب عليك ان تعرف macros لل  //_header_// و / أو //_footer_//  ، واضافتها الى ملف //yourhome.dm // الملف في شكل  <Updated date="18-Mar-2008 by Kamal Salih"/>

<code>
_macroname_ {
...
}
</code>

على سبيل المثال ، العمود الاخضر اسفل الجانب الايسر من صفحات Greenstone هو معرف في  macro   //_header_ // ، وإزالة القيمة منه سوف تزيله ، كما هو مبين في نهاية الشكل <Crossref target="figure" ref="yourhome_dm"/>. <Updated date="18-Mar-2008 by Kamal Salih"/>

===== كيف تعدها للعمل.<Updated date="18-Mar-2008 by Kamal Salih"/> =====

يجب أن تعلم Greenstone عن صفحة الموقع  الجديدة //yourhome.dm //. يقوم النظام بقراءة ملفات macro و التي تم تحديدها في ملف الإعداد الرئيسي //main.cfg//، حتى اذا قمت بإنشاء ملف جديد يجب عليك ادراجه هناك. الأسماء المتشابكة تعالج بصورة منطقيه : أحدث تعريف بالاسبقيه. <Updated date="18-Mar-2008 by Kamal Salih"/>

وهكذا لجعل برنامج مكتبة Greenstone الرقميه يستخدم صفحة الموقع في الشكل <Crossref target="figure" ref="your_own_greenstone_home_page"/> بدلا من الإفتراضية ، اولا قم بوضع ملف //yourhome.dm// في الشكل <Crossref target="figure" ref="yourhome_dm"/> في دليل  //macros//.ثم تحرير ملف الإعداد الرئيسي //main.cfg// لإستبدال //home.dm // مع //yourhome.dm // في قائمة ملفات macro التي يتم تحميلها في البدء. <Updated date="18-Mar-2008 by Kamal Salih"/>

===== اعادة توجيه موقع لgreenstone <Updated date="18-Mar-2008 by Kamal Salih"/> =====

قد ترغب في اعادة توجيه لبرنامج 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 // :<Updated date="18-Mar-2008 by Kamal Salih"/>

<code>
Redirect /index.html http://www.yourserver.com/cgi-bin/library
</code>

ثم إنك ستصل الى نظام المكتبه الرقميه الخاصة بك مباشرة من موقع //http:%%//%%www.yourserver.com //. وبدلا من ذلك ، اذا كنت تريد موقع مثل // http:%%//%%www.Yourserver.com/greenstone // ان يعاد توجيهه الى // http:%%//%%www.yourserver.com/cgi-bin/library  // ،قم بإدراجه في ملف //httpd.conf //  <Updated date="18-Mar-2008 by Kamal Salih"/>

<code>
Redirect /greenstone http://www.yourserver.com/cgi-bin/library
</code>

اذا كان جهازك لا يملك اسم نطاق (مثل www.yourserver.com "أعلاه) ، فقط قم بإستبدال //www.yourserver.com // بـ // localhost // في السطور اعلاه. طالما ان المتصفح يعمل على نفس الجهاز كما أن مزود الويب - الذي هو بالتأكيد اذا كان جهازك لا يملك اسم نطاق- له نفس التأثير كما سبق في إعادة التوجيهات اعلاه." <Updated date="18-Mar-2008 by Kamal Salih"/>

بدلا من وضع تعليمات  اعادة توجيه التوجيهات في ملف //httpd.conf // ، ويمكنك بنفس المستوي وضعها في الملف //.htaccess// ضمن دليل الوثيقة الجذري للمزود. في الحقيقة ، القيام بهذا الإجراء له ميزتان - اولا ، تغييرات // Htaccess // تنفذ على الفور ، في حين انك تحتاج لأعادة تشغيل مزود ويب  اباتشي Apache لإحداث التغيرات التي كتبت في //httpd.conf//. ثانيا ، على أنظمة يونيكس انت عادة تدخل  كمستخدم أساسي “root” لتعديل //httpd.conf // ، في حين انك لا تقوم بهذا //httpd.conf//, <Updated date="18-Mar-2008 by Kamal Salih"/>