الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

زوتيرو مريلة

ملخص

يحتوي هذا الريبو على تعليمات برمجية لـ Zotero Bib، بما في ذلك مكونات React وعميل الترجمة وأوراق الأنماط وموقع نقطة الدخول.

المتطلبات الأساسية

  1. عقدة JS مع npm
  2. أدوات سطر الأوامر الأساسية بما في ذلك rsync
  3. خادم الترجمة الموجود
  4. خادم bib الموجود
  5. الأنماط الموجودة الريبو

نسخة التنمية المحلية

الحصول على المكتبة

  1. git clone --recursive [email protected]:zotero/zoterobib.git

  2. cd zoterobib

  3. npm install

  4. npm start

سيعمل هذا على العرض التوضيحي على http://127.0.0.1:8001.

قد تحتاج إلى توفير خيارات التكوين (انظر أدناه) حتى تتمكن من تشغيل التخزين والترجمة.

افتراضيًا، يطلب خادم ترجمة وكلاء خادم التطوير إلى المضيف المحلي:1969 . إذا كان الخادم الخاص بك موجودًا في مكان آخر، فيجب عليك تقديم عنوان url، على سبيل المثال، ستبدو الخطوة الأخيرة أعلاه كما يلي:

  1. TRANSLATE_URL=http://localhost:1234 npm start

سيؤدي هذا إلى توكيل الطلبات من المتصفح إلى خادم الترجمة المحدد.

استخدام في الإنتاج

للحصول على ملفات جاهزة للإنتاج، استخدم الأمر npm التالي:

npm run build

إعدادات

من الممكن توفير معلمات التكوين للبناء (سواء في التطوير أو الإنتاج) باستخدام ملفات التكوين و/أو متغيرات البيئة.

أسهل طريقة هي نسخ config/default.json إلى config/local.json ووضع المتغيرات هناك (يتم تجاهل هذا الملف ولا يجب الالتزام به). وبدلاً من ذلك، يمكن استخدام متغيرات البيئة المدرجة في config/custom-environment-variables.json . لمزيد من التفاصيل حول كيفية توفير التكوينات، راجع حزمة config npm.

خيارات التكوين

يتم قبول خيارات التكوين التالية:

storeURL يحدد عنوان url لواجهة برمجة تطبيقات bib-server حيث يتم تخزين المراجع.

styleURL يحدد عنوان URL لموقع الويب style-repo . عند تركه فارغًا، سيتم استخدام الافتراضي وهو https://www.zotero.org/styles-files/styles.json

TranslatePrefix يحدد بادئة إضافية للمكان الذي يجب إرسال طلب خادم الترجمة إليه. مفيد في الحالات التي يتم فيها ترك translateURL فارغًا بحيث يكون من الممكن توجيه الطلبات إلى نقطة نهاية محددة في أي مكان تتم فيه استضافة zotero-bib.

TranslationURL يحدد عنوان URL لخادم الترجمة . افتراضيًا، يُفترض أن يقوم المضيف المحلي بتوكيل الطلب إلى خادم الترجمة.

apiAuthorityPart يحدد جزء السلطة من عنوان URL لطلبات Zotero API. الإعدادات الافتراضية هي api.zotero.org .

تكوين خادم التطوير

تشغيل npm start بالتحقق من متغيرات البيئة التالية:

TRANSLATE_URL مكان وكيل طلبات الترجمة، الافتراضي هو http://localhost:1969. افتراضيًا، سيرسل ZoteroBib طلبات الترجمة إلى window.location.origin ويجب تكوين خادم التطوير لتوكيل هذه الطلبات إلى خادم ترجمة.

المنفذ الذي يجب على خادم التطوير الاستماع إليه، يكون الإعداد الافتراضي هو 8001.

NO_HYDRATE عند الوصول إلى قائمة المراجع عن بعد، يمكن لـ ZoteroBib أن يرطب من HTML المعروض مسبقًا لتجنب الدوران أثناء التحميل. لأغراض التطوير، يتم تخزين قائمة المراجع المرمزة في hydrate.hbs ويتم استخدامها لخدمة أي طلب يتضمن معرف قائمة المراجع عن بعد. لتعطيل هذا السلوك، قم بتعيين NO_HYDRATE على 1 ، والذي سيخدم index.hbs بدلاً من ذلك، مما يعني أن قائمة المراجع يتم عرضها دائمًا من جانب العميل باستخدام قرص دوار.

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