DSpace

وثائق DSpace | إصدارات DSpace | ويكي DSpace | الدعم

نظرة عامة

برنامج DSpace مفتوح المصدر هو تطبيق مستودع جاهز يُستخدم من قبل أكثر من 2000 مؤسسة حول العالم لتوفير وصول دائم إلى الموارد الرقمية. لمزيد من المعلومات، تفضل بزيارة http://www.dspace.org/

يتكون DSpace من جزء خلفي يعتمد على Java وجزء أمامي يعتمد على Angular.

• الجزء الخلفي (هذه القاعدة البرمجية) يوفر واجهة REST API، بالإضافة إلى واجهات أخرى تعتمد على الآلة (مثل OAI-PMH و SWORD إلخ)
  • عقد REST موجود على https://github.com/DSpace/RestContract
• الجزء الأمامي (https://github.com/DSpace/dspace-angular/) هو واجهة المستخدم المبنية على REST API

الإصدارات السابقة من DSpace (v6.x وما دون) استخدمت واجهتي مستخدم مختلفتين (XMLUI و JSPUI). لم تعد هذه الواجهات مدعومة في الإصدار 7 فما فوق.

• لا يزال فرع الصيانة للإصدارات الأقدم متاحاً، راجع dspace-6_x لصيانة 6.x.

التنزيلات

• الجزء الخلفي (REST API): https://github.com/DSpace/DSpace/releases
• الجزء الأمامي (واجهة المستخدم): https://github.com/DSpace/dspace-angular/releases

التوثيق / التثبيت

يمكن الاطلاع على وثائق كل إصدار عبر الإنترنت أو تنزيلها من ويكي التوثيق.

تعليمات تثبيت أحدث إصدار من DSpace متاحة على: https://wiki.lyrasis.org/display/DSDOC9x/Installing+DSpace

يرجى ملاحظة أنه، باعتبار DSpace تطبيق ويب Java، فإنه يتطلب قاعدة بيانات (PostgreSQL) وحاوية servlet (عادة Tomcat) ليعمل. يمكن العثور على مزيد من المعلومات حول هذه المتطلبات وجميع المتطلبات الأساسية الأخرى في تعليمات التثبيت أعلاه.

تشغيل DSpace 9 في Docker

ملاحظة: في الوقت الحالي، ليست لدينا صور Docker جاهزة للإنتاج لـ DSpace. ومع ذلك، لدينا نصوص Docker Compose سريعة البدء لأغراض التطوير أو الاختبار.

انظر تشغيل DSpace 9 مع Docker Compose

المساهمة

انظر وثائق المساهمة

الحصول على المساعدة

يوفر DSpace قوائم بريدية عامة يمكنك من خلالها طرح الأسئلة أو مناقشة المواضيع. نرحب بالجميع للمشاركة في هذه القوائم:

• [email protected] : مناقشة عامة حول منصة DSpace، الإعلانات، مشاركة أفضل الممارسات
• [email protected] : قائمة بريدية للدعم الفني. انظر أيضاً دليل كيفية استكشاف الأخطاء وإصلاحها.
• [email protected] : قائمة بريدية للمطورين / التطوير

يتوفر أيضاً قسم أسئلة وأجوبة ممتاز تحت وسم DSpace على Stackoverflow

خيارات دعم إضافية على https://wiki.lyrasis.org/display/DSPACE/Support

لدى DSpace أيضاً شبكة نشطة من مزودي الخدمة. إذا كنت تفضل توظيف مزود خدمة لتثبيت DSpace أو ترقيته أو تخصيصه أو استضافته، فنحن نوصي بالتواصل مع أحد مزودي الخدمة المعتمدين.

متتبع المشكلات

يستخدم DSpace GitHub لتتبع المشكلات:

• مشكلات الجزء الخلفي (REST API): https://github.com/DSpace/DSpace/issues
• مشكلات الجزء الأمامي (واجهة المستخدم): https://github.com/DSpace/dspace-angular/issues

الاختبار

تشغيل الاختبارات

افتراضياً، في DSpace، يتم تعطيل اختبارات الوحدة واختبارات التكامل. ومع ذلك، يتم تشغيلها تلقائياً بواسطة GitHub Actions لجميع طلبات السحب والتزامات الكود.

• كيفية تشغيل كل من اختبارات الوحدة (عبر maven-surefire-plugin) واختبارات التكامل (عبر maven-failsafe-plugin):

  mvn install -DskipUnitTests=false -DskipIntegrationTests=false
  

• كيفية تشغيل اختبارات الوحدة فقط:

  mvn test -DskipUnitTests=false
  

• كيفية تشغيل اختبار وحدة واحد

  # تشغيل جميع الاختبارات في فئة اختبار محددة
  # ملاحظة: failIfNoTests=false مطلوب لتخطي الاختبارات في الوحدات الأخرى
  mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName] -DfailIfNoTests=false
  
  # تشغيل طريقة اختبار واحدة في فئة اختبار محددة
  mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false
  

• كيفية تشغيل اختبارات التكامل فقط

  mvn install -DskipIntegrationTests=false
  

• كيفية تشغيل اختبار تكامل واحد

  # تشغيل جميع اختبارات التكامل في فئة اختبار محددة
  # ملاحظة: failIfNoTests=false مطلوب لتخطي الاختبارات في الوحدات الأخرى
  mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName] -DfailIfNoTests=false
  
  # تشغيل طريقة اختبار واحدة في فئة اختبار محددة
  mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false
  

• كيفية تشغيل اختبارات وحدة DSpace محددة فقط

  # قبل تشغيل اختبارات وحدة واحدة فقط، قد تحتاج الوحدات الأخرى إلى التثبيت في ~/.m2
  cd [dspace-src]
  mvn clean install
  
  # ثم انتقل إلى الدليل الفرعي للوحدة، وقم بتشغيل أمر الاختبار
  cd [dspace-src]/dspace-server-webapp
  # اختر أمر الاختبار من القوائم أعلاه
  

الترخيص

كود مصدر DSpace متاح بحرية تحت ترخيص BSD 3-Clause القياسي. الترخيص الكامل متاح في ملف LICENSE أو عبر الإنترنت على http://www.dspace.org/license/

يستخدم DSpace مكتبات طرف ثالث قد تكون موزعة تحت تراخيص مختلفة. هذه التراخيص مدرجة في ملف LICENSES_THIRD_PARTY.