الصفحة الرئيسية>موارد بناء الموقع>بيانات الموقع
تنزيل

أداة رسم الخرائط Cocoda

أداة قائمة على الويب لإنشاء تعيينات بين أنظمة تنظيم المعرفة.

جرب أحدث إصدار من الإصدار ، وإصدار التطوير الحالي ، واستشر وثائق الاستخدام!

جدول المحتويات

  • ثَبَّتَ
    • إصدارات إطلاق
    • إصدارات التطوير
    • خدمة الملفات
    • عامل ميناء
  • الاستخدام
  • إعدادات
  • المشرفون
  • يساهم
  • رخصة

ثَبَّتَ

إصدارات إطلاق

يمكن تنزيل الإصدارات في شكل ملفات ثابتة. استخراج في دليل خادم الويب وضبط ملف التكوين cocoda.json . يمكنك أتمتة تنزيل واستخراج أحدث إصدار مع JQ مثل هذا: 

 # You can also manually download the latest release here: https://github.com/gbv/cocoda/releases/latest
wget -N $( curl -s https://api.github.com/repos/gbv/cocoda/releases/latest | jq -r ' .assets[].browser_download_url ' )
unzip cocoda- * .zip
rm cocoda- * .zip

يكون الدليل cocoda جاهزًا لتقديمه مع أي خادم ويب.

إصدارات التطوير

بدلاً من ذلك ، من الممكن استنساخ مستودع Cocoda: 

git clone https://github.com/gbv/cocoda.git
cd cododa

ثم قم بتثبيت وحدات العقدة المطلوبة باستخدام NPM وقم ببناء التشغيل (يتطلب node.js v18 أو أعلى ، موصى بها V20): 

npm ci
npm run build

يتم إنشاء الملفات في Distory dist ، بما في ذلك ملف التكوين.

خدمة الملفات

يمكن استخدام أي خادم ويب لخدمة ملفات Cocoda. لا يوجد تكوين خاص ضروري. على سبيل المثال باستخدام حزمة http-server NPM لخدمة Cocoda على http: // localhost: 8000: 

 # serve the pre-built release
npx http-server -p 8000 cocoda/
# or serve the build version
npx http-server -p 8000 dist/

عامل ميناء

Cocoda متاح أيضًا عبر Docker. يرجى الرجوع إلى وثائق Docker لمزيد من المعلومات والتعليمات.

الاستخدام

هناك دليل مستخدم نهائي مكتظ باللغة الألمانية والإنجليزية. من المحتمل أن تكون النسخة الألمانية أكثر حداثة. توجد مصادر الوثائق في docs الدليل.

إعدادات

بالنسبة للإصدار الذي تم إنشاؤه مسبقًا ، يمكن تجاوز خيارات التكوين باستخدام cocoda.json في جذر الدليل. وترد الخيارات الافتراضية في ملف config/cocoda.default.json (يرجى الرجوع إلى هذا الملف للحصول على أمثلة حول كيفية استخدام خيارات التكوين). عند استخدام بناء يدوي ، قم بإنشاء ملف config/cocoda.json وإعادة البناء ( npm run build ) بعد التحرير (يمكنك أيضًا تشغيل npm run build -- --config-only إذا كان لديك بالفعل بناء في مجلد dist/ NENE فقط وتحتاج فقط إلى تحديث ملف التكوين). يتم التعرف على الحقول التالية حتى الآن:

  • العنوان : العنوان الرئيسي للمثال كسلسلة عادي

  • الشعارات : قائمة الشعارات التي يجب عرضها على اليسار على العنوان ، ولكل منها حقول فرعية:

    • file : عنوان URL للصور بالنسبة للدليل static
    • alt : نص بديل للصورة ، إذا كان لا يمكن عرض الصورة ، كسلسلة عادية
    • url : عنوان URL للربط من الشعار

  • القائمة : قائمة روابط للعرض في القائمة ، ولكل منها حقول فرعية:

    • url : عنوان URL الرابط
    • prefLabel : رسم خرائط لرموز اللغة لربط العناوين

  • SearchLinks : قائمة روابط البحث لربط بسرعة بالموارد الخارجية من المفاهيم. كل SearchLink لها حقول فرعية:

    • url قالب url مع المعلمات المحتملة {prefLabel} و/أو {notation}
    • prefLabel : رسم خرائط لرموز اللغة لربط العناوين

  • مفضلات : قائمة المفردات URIS ليتم تفضيلها افتراضيًا.

  • اللغات : صفيف مع لغات الواجهة المدعومة

  • السجلات : يسرد السجلات أين تحصل على البيانات من

  • OverridEregistries : false (افتراضي) أو عناصر تحكم true ما إذا كنت تريد تجاوز السجلات المدرجة في config/cocoda.default.json

  • Auth : URL إلى مثيل لخادم تسجيل الدخول لاستخدامه للمصادقة

  • قوائم المفاهيم : قائمة قوائم المفاهيم. يمكن أن تكون كل قائمة كائنًا أو عنوان URL الذي يقوم بإرجاع كائن JSON. الكائنات هي في الأساس سجلات JSKOS مع الخصائص المطلوبة prefLabel concepts . إذا كانت concepts عبارة عن سلسلة ، فسيُعتبر عنوان URL الذي يعيد مجموعة JSON من المفاهيم. الخصائص الاختيارية هي notation و scopeNote .

  • Autorefresh : كائن مع قيم تحديث تلقائي بالمللي ثانية. autoRefresh.mappings تحدد عدد المرات التي سيتم فيها إعادة تحميل التعيينات في MapPingBrowser (افتراضيًا: 10000 = كل 10 ثوان) ، autoRefresh.update يحدد عدد المرات التي سيبحث فيها الكوكودا عن تحديث (افتراضي: 120000 = كل دقيقتين).

باستخدام الإصدار الذي تم تصميمه مسبقًا ، يجب إعادة تحميل التطبيق فقط بعد تحرير ملف التكوين.

المشرفون

  • STEFANDESU
  • @nichtich

يساهم

ترحب مساهماتك في تحسين COCODA بشكل كبير: يرجى فتح مشكلة github للحصول على اقتراحات الميزة وتقارير الأخطاء! راجع الملف المساهمين. md لمزيد من المعلومات حول كيفية ومكان المساهمة بشكل أفضل وللتفاصيل التطوير.

راجع https://gbv.github.io/cocoda/ لتوثيق API تلقائيًا من مصادر العقدة.

رخصة

MIT © 2019 Verbundzentrale des GBV (VZG)

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل