على الارجح أن اول شيء تريد ان تفعله بمجرد تثبيت وتشغيل , 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"/>

<imgcaption figure_your_own_greenstone_home_page|%!– id:264 –%صفحه Greenstone الرئيسية الخاصة بك <Updated date="18-Mar-2008 by Kamal Salih"/> ></imgcaption>

الشكل <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>

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_ {
# }

يمكنك استخدام الشكل <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"/>

_macroname_ {
...
}

على سبيل المثال ، العمود الاخضر اسفل الجانب الايسر من صفحات Greenstone هو معرف في macro _header_ ، وإزالة القيمة منه سوف تزيله ، كما هو مبين في نهاية الشكل <Crossref target="figure" ref="yourhome_dm"/>. <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 لجعل عنوان الموقع الخاص بك اكثر ملاءمة . على سبيل المثال ، على نظامنا عنوان الموقع 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"/>

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

ثم إنك ستصل الى نظام المكتبه الرقميه الخاصة بك مباشرة من موقع 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"/>

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

اذا كان جهازك لا يملك اسم نطاق (مثل 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"/>