acl anthology
1.0.0
يحتوي هذا المستودع على:
المنزل الرسمي لهذا المستودع هو https://github.com/acl-org/acl-anthology.
يرجى الاطلاع على ReadMe المنفصل لحزمة Python للحصول على معلومات مفصلة.
هذه هي التعليمات الأساسية حول إنشاء موقع مختارات ACL كما هو موضح على https://aclanthology.org/.
لبناء موقع مختارات ، ستحتاج:
bin/requirements.txt ؛ للتثبيت ، قم بتشغيل pip -r bin/requirements.txtlibyaml-dev و Cython قبل التشغيل ، make أول مرة ، فسيتم استخدام مكتبة Libyaml C بدلاً من تنفيذ Python ، مما يؤدي إلى تسريع البناء.هناك إجراء إجراءات github لإجراء النشر مباشرة من Github. لاستخدام هذا ، تحتاج إلى تحديد هذا المتغير في إعدادات المستودع الخاص بك (واجهة الويب: الإعدادات -> الأسرار):
PUBLISH_SSH_KEY : المفتاح السري في تنسيق PEM القياسي للمصادقة (بدون عبارة تمريرة) سيقوم Github بعد ذلك ببناء ونشر Master Crater تلقائيًا كلما تغير الفرع الرئيسي. يتم ذلك عبر هدف upload في Makefile.
استنساخ ريبيو المختارات إلى الجهاز المحلي الخاص بك:
$ git clone https://github.com/acl-org/acl-anthology شريطة أن تكون قد قمت بتثبيت جميع المتطلبات بشكل صحيح ، يجب أن يكون إنشاء موقع الويب بسيطًا make التشغيل من الدليل الذي استنسخت عليه الريبو.
سيكون موقع الويب الذي تم إنشاؤه بالكامل في build/anthology بعد ذلك. في حالة حدوث أي أخطاء أثناء هذه الخطوة ، يمكنك استشارة ReadMe التفصيلية لمزيد من المعلومات حول الخطوات الفردية التي يتم تنفيذها لإنشاء الموقع. يمكنك رؤية موقع الويب الناتج عن طريق إطلاق خادم ويب محلي مع make serve ، والذي سيخدمه على http: // localhost: 8000.
لاحظ أن بناء الموقع هو عملية كثيفة الموارد ؛ لا سيما الخطوة الأخيرة ، التي تستدعي هوغو ، تستخدم حوالي 18 ~ gb من ذاكرة النظام. يستغرق بناء المختارات حوالي 10 دقائق على جهاز كمبيوتر محمول مع SSD.
( ملاحظة: هذا لا يعني أنك تحتاج إلى هذا الكمية من ذاكرة الوصول العشوائي في نظامك ؛ في الواقع ، يبني موقع الويب بشكل جيد على جهاز كمبيوتر محمول مع ذاكرة الوصول العشوائي 8 جيجابايت. قد يتباطأ النظام مؤقتًا بسبب التبديل ، ومع ذلك. 18 غيغابايت هو الحد الأقصى لاستخدام ذاكرة الوصول العشوائي المبلغ عنه عند تشغيل hugo --minify --stepAnalysis .)
يمكن الاطلاع على المختارات محليًا عن طريق تشغيل hugo server في hugo/ Directory. لاحظ أنه يعيد بناء الموقع وبالتالي يستغرق حوالي دقيقة للبدء.
أولاً ، يكون إنشاء مرآة بطيئًا ويؤكد على البنية التحتية لعلم مختارات ACL لأنه في الإعداد الأولي ، يجب عليك تنزيل كل ملف من مختارات من خادم الويب الرسمي. يمكن أن يستغرق هذا ما يصل إلى 8 ساعات بغض النظر عن سرعة اتصالك . لذا من فضلك لا تلعب مع هذا فقط للمتعة.
إذا كنت ترغب في استضافة مرآة ، فيجب عليك تعيين متغيرين للبيئة:
ANTHOLOGY_PREFIX بادئة http يمكن الوصول إليها المرآة تحت على سبيل المثال https://example.com/my-awesome-mirror أو http://aclanthology.lst.uni-saarland.de (لاحظ أنه لا يوجد في النهاية!)ANTHOLOGYFILES يقيم الدليل الذي بموجبه الأوراق والمرفقات وما إلى ذلك على خادم الويب الخاص بك. يجب أن يكون هذا الدليل قابلاً للقراءة من قبل خادم الويب الخاص بك (من الواضح) ولكن لا ينبغي أن يكون دليلًا فرعيًا لدليل مرآة المختارات. باستخدام هذه المتغيرات ، تقوم make لإنشاء الصفحات وجعل make mirror لمرسيبة جميع الملفات الإضافية في دليل ملفات الإنشاء/مختارات. إذا قمت بإنشاء مرآة من قبل بالفعل ، فستقوم بتنزيل الملفات المفقودة فقط.
إذا كنت ترغب في عكس الأوراق ولكن ليس كل المرفقات ، فيمكنك تشغيل make mirror-no-attachments بدلاً من ذلك.
يمكنك بعد ذلك rsync build/website/ الدليل إلى خادم الويب الخاص بك أو ، إذا كنت تقدم المرآة في FOO فرعي ، فأنت مرآة build/website/FOO . يجب أن يكون دليل build/anthology-files RSYNC-ED إلى دليل ANTHOLOGYFILES لخادم الويب الخاص بك.
نظرًا لأنك ترغب في الحفاظ على المرآة محدثة ، يمكنك تعديل SHELL SCRIPT bin/acl-mirror-cronjob.sh لاحتياجاتك.
ستحتاج إلى هذا البرنامج على الخادم
إذا كنت تريد أن تكون عملية الإنشاء سريعة ، فقم بتثبيت cython3 و libyaml-dev (انظر أعلاه).
لاحظ أن توليد المختارات يستغرق قدرًا كبيرًا من ذاكرة الوصول العشوائي ، لذا تأكد من توفره على جهازك.
إذا كنت ترغب في المساهمة في مختارات ACL ، فيرجى إلقاء نظرة على:
كان هذا الريبو في الأصل الجناح/ACL وتم نقله إلى ACL-ORG اعتبارًا من 5 يونيو 2017.
يتم توزيع رمز بناء مختارات ACL بموجب ترخيص Apache ، v2.0.
