notero

نوتيرو

Notero هو مكون إضافي لـ Zotero لمزامنة العناصر والملاحظات في Notion. لاستخدامه:

1. ؟ قم بتكوين قاعدة بيانات Notion الخاصة بك.
2. ؟ قم بتثبيت البرنامج المساعد Notero في Zotero.
3. ؟ اختر مجموعات Zotero الخاصة بك لمراقبتها.
4. إضافة أو تحديث العناصر في مجموعاتك.
5. شاهد عناصرك متزامنة مع Notion!

مفهوم بواسطةarhoff ??‍؟ | بنيت مع ؟ بواسطة @ دفانوني

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

• لماذا استخدام نوتيرو؟
• كيف يعمل نوتيرو
• التثبيت والإعداد
• أدلة الاستخدام
• الأسئلة المتداولة
• مثال لقواعد بيانات المفاهيم
• تطوير

لماذا استخدام نوتيرو؟

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

كيف يعمل نوتيرو

يراقب مكون Notero الإضافي عناصر Zotero التي تتم إضافتها أو تعديلها ضمن أي مجموعات تحددها في تفضيلات Notero. عند إضافة عنصر أو تعديله، يقوم Notero ببعض الأشياء:

• احفظ صفحة تحتوي على خصائص عنصر Zotero (العنوان، المؤلفون، وما إلى ذلك) في قاعدة بيانات Notion المحددة في تفضيلات Notero.
• أضف علامة notion إلى عنصر Zotero.
• أضف مرفقًا إلى عنصر Zotero الذي يرتبط بالصفحة في Notion.

بالإضافة إلى توفير طريقة ملائمة لفتح صفحة Notion من Zotero، يعمل الرابط المرفق أيضًا كمرجع لـ Notero حتى يتمكن من تحديث صفحة Notion المقابلة لعنصر Zotero معين.

مزامنة العناصر

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

يمكنك أيضًا مزامنة العناصر من المجموعة أو قوائم سياق العناصر (النقر بزر الماوس الأيمن):

• لمزامنة جميع العناصر في مجموعة، افتح قائمة السياق الخاصة بالمجموعة وحدد مزامنة العناصر مع Notion .
• لمزامنة عنصر واحد أو عناصر متعددة، حدد العنصر (العناصر) في الجزء الرئيسي، وافتح قائمة السياق، وحدد مزامنة مع Notion .

ملحوظة

لمنع وظيفة "المزامنة عند التعديل" من الحفظ في Notion عدة مرات، لا يقوم Notero بإعلام Zotero عند إضافة العلامة والرابط المرفق إلى عنصر. وهذا يعني أنها قد لا تظهر في Zotero على الفور، وقد تحتاج إلى الانتقال إلى عنصر مختلف والعودة لإظهارها.

مزامنة الملاحظات والتعليقات التوضيحية لملفات PDF

يمكن مزامنة ملاحظات Zotero المرتبطة بعنصر ما في Notion كمحتوى للصفحة المقابلة لهذا العنصر. كما هو الحال مع العناصر العادية، يمكنك مزامنة الملاحظات يدويًا باستخدام خيار Sync to Notion في قائمة السياق.

يمكن تمكين المزامنة التلقائية للملاحظات عبر خيار مزامنة الملاحظات في تفضيلات Notero. عند التمكين، ستتم مزامنة الملاحظات تلقائيًا كلما تم تعديلها. بالإضافة إلى ذلك، عند مزامنة عنصر عادي، ستتم مزامنة جميع ملاحظاته أيضًا إذا لم تتم مزامنتها بالفعل.

لمزامنة التعليقات التوضيحية (الملاحظات والإبرازات) من ملف PDF، ستحتاج أولاً إلى استخراجها في ملاحظة Zotero:

1. حدد عنصرًا أو ملف PDF، وافتح قائمة السياق، وحدد إضافة ملاحظة من التعليقات التوضيحية .
2. إذا رغبت في ذلك، قم بتمكين ألوان التمييز من القائمة الموجودة في الجزء العلوي الأيمن من لوحة الملاحظات.

مثال على إنشاء ملاحظة من التعليقات التوضيحية بتنسيق PDF

CleanShot.2023-07-26.at.20.41.32-converted.mp4

التثبيت والإعداد

يتطلب استخدام Notero إعداد قاعدة بيانات Notion، وربطها بـ Notero، وتثبيت ملحق Notero الإضافي في Zotero. تعليمات الإعداد التفصيلية أدناه.

تكوين الفكرة

1. قم بإنشاء قاعدة بيانات Notion التي ترغب في مزامنة عناصر Zotero بها.

   انظر الأمثلة أدناه التي يمكنك تكرارها في مساحة عمل Notion الخاصة بك.

2. أنشئ تكاملًا داخليًا لـ Notion على https://www.notion.com/my-integrations وقم بتمكين جميع "إمكانات المحتوى".

   مثال على إعدادات قدرات التكامل

   

3. لاحظ "سر التكامل الداخلي" من الخطوة السابقة.

4. منح التكامل الخاص بك الوصول إلى قاعدة البيانات الخاصة بك.

   من مستندات مطور Notion :

   1. انتقل إلى صفحة قاعدة البيانات في مساحة العمل الخاصة بك.
   2. انقر على قائمة ••• المزيد في الزاوية العلوية اليمنى من الصفحة.
   3. قم بالتمرير لأسفل وانقر فوق "الاتصال بـ" .
   4. ابحث عن التكامل الخاص بك وحدده في قائمة البحث عن اتصالات....

   مثال لإعدادات الاتصال من وثائق Notion

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

خصائص قاعدة بيانات الفكرة

يمكن لـ Notero مزامنة البيانات للخصائص المذكورة أدناه. الخاصية الوحيدة التي يتطلبها Notero هي تلك التي لها نوع الخاصية Title . الخصائص الأخرى اختيارية، لذا يمكنك فقط استخدام الخصائص التي تناسب احتياجاتك.

يمكن تسمية خاصية العنوان بشيء آخر غير Name طالما أنها لا تتعارض مع أي من أسماء الخصائص الأخرى. يجب تكوين اسم ونوع الخصائص الأخرى تمامًا كما هو محدد هنا. لاحظ أن أسماء الخصائص حساسة لحالة الأحرف، لذا يجب أن تتطابق الأحرف الكبيرة تمامًا.

ومن المقرر دعم تخصيص الخصائص في المستقبل؛ راجع المسألة رقم 355.

اسم العقار	نوع العقار	ملحوظات
Name	عنوان	التنسيق قابل للتكوين عبر خيار Notion Page Title في تفضيلات Notero
Abstract	نص
Authors	نص
Citation Key	نص	يتطلب BibTeX أفضل
Collections	تحديد متعدد
Date	نص
Date Added	تاريخ
Date Modified	تاريخ
DOI	عنوان URL
Editors	نص
Extra	نص
File Path	نص
Full Citation	نص	يعتمد التنسيق على إعداد Zotero للتصدير → النسخ السريع → تنسيق العنصر
In-Text Citation	نص	يعتمد التنسيق على إعداد Zotero للتصدير → النسخ السريع → تنسيق العنصر
Item Type	يختار
Place	نص
Proceedings Title	نص
Publication	نص
Series Title	نص
Short Title	نص
Tags	تحديد متعدد
Title	نص
URL	عنوان URL
Year	رقم
Zotero URI	عنوان URL	يفتح العناصر الموجودة في مكتبة الويب إذا قمت بتسجيل الدخول إلى Zotero

تثبيت وتكوين البرنامج المساعد Notero

مهم

• يتطلب الإصدار الأخير من Notero Zotero 7.0 أو أعلى.
• يتوفر دعم Zotero 6.0.27 والإصدارات الأحدث في Notero v0.5.17.
• راجع سجل التغيير للاطلاع على كافة ملاحظات الإصدار.

1. قم بتنزيل أحدث إصدار من ملف .xpi .
   • ملاحظة لمستخدمي Firefox: ستحتاج إلى النقر بزر الماوس الأيمن فوق رابط التنزيل أعلاه واختيار حفظ الرابط باسم... لتنزيل الملف بشكل صحيح.
   • إذا لم يعمل رابط التنزيل أعلاه، فيمكنك تنزيل ملف .xpi من قسم الأصول في صفحة الإصدار الأخير.
2. افتح Zotero Plugins Manager عبر عنصر القائمة Tools → Plugins .
3. قم بتثبيت ملف .xpi إما عن طريق:
   • قم بسحبه وإسقاطه في نافذة Plugins Manager أو
   • تحديده باستخدام خيار تثبيت البرنامج المساعد من ملف... في قائمة الترس في الزاوية العلوية اليمنى من النافذة
4. افتح تفضيلات Notero من عنصر القائمة أدوات → تفضيلات Notero... ، وأدخل التفضيلات المطلوبة.
   • ملاحظة لمستخدمي Zotero 7: تم نقل تفضيلات Notero إلى قسم في نافذة تفضيلات Zotero الرئيسية.

أدلة الاستخدام

لمزيد من الأدلة المرئية حول إعداد Notero واستخدامه، راجع الموارد التالية التي أعدها أعضاء رائعون في المجتمع:

• استخدام Notion وZotero لإنشاء أداة تعقب الأدبيات (منشور مدونة) بقلم جويل جونسون
• كيفية مزامنة Zotero → Notion // سير عمل ورقة البحث (برنامج تعليمي لعام 2023) (فيديو) بقلم هولي جين
• تدوين الملاحظات الذكية من خلال البدء بدمج Zotero وNotion: خطوة أولى (فيديو) للدكتور جينغجينغ لين

إذا كنت ترغب في مشاركة كيفية استخدامك لـ Notero وتريد أن يتم إدراجك هنا، فلا تتردد في إرسال رسالة عامة أو الاتصال بي!

الأسئلة المتداولة

كيفية المزامنة من Notion مرة أخرى إلى Zotero

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

كيفية مزامنة الملفات المرفقة في Notion

لا توجد حاليًا طريقة جيدة لمزامنة الملفات أو الارتباط بالملفات المحلية بسبب القيود التالية مع Notion:

• لا تدعم Notion API حاليًا تحميل الملفات.
• يدعم Notion فقط عناوين URL http: و https: لذا لا يمكن الارتباط مباشرة بالملف باستخدام file: URL.

في الوقت الحالي، أفضل الحلول هي:

• استخدم خاصية File Path لتوجيهك إلى موقع الملف المحلي.
• إذا قمت بمزامنة ملفاتك مع حساب Zotero الخاص بك، فيمكنك فتح واجهة الويب Zotero من خاصية Zotero URI ثم فتح الملف من هناك.

كيفية مزامنة العناصر الموجودة بشكل مجمّع

لمزامنة عناصر متعددة موجودة بالفعل في مجموعة مراقبة، يمكنك القيام بذلك من قوائم سياق المجموعة أو العنصر. راجع قسم مزامنة العناصر أعلاه.

كيفية إصلاح أخطاء Notion API

تعذر العثور على قاعدة البيانات

إذا تلقيت الخطأ التالي:

APIResponseError: تعذر العثور على قاعدة البيانات ذات المعرف: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

هذا يعني على الأرجح أنك لم تمنح Notero إمكانية الوصول إلى قاعدة بيانات Notion الخاصة بك. تأكد من اتباع جميع الخطوات الواردة في قسم تكوين الفكرة. يجب أن يؤدي النقر فوق الزر ••• الموجود في الزاوية العلوية اليمنى من قاعدة البيانات الخاصة بك إلى إظهار اتصال للتكامل الذي قمت بإنشائه لـ Notero.

مثال على إعدادات الاتصال

لا يمكن تحديث الصفحة التي تم أرشفتها

إذا تلقيت الخطأ التالي:

APIResponseError: لا يمكن تحديث الصفحة المؤرشفة. يجب عليك إلغاء أرشفة الصفحة قبل التحديث.

يمكن أن يحدث هذا عندما يحاول Notero مزامنة عنصر تم بالفعل إنشاء صفحة Notion له من مزامنة سابقة، ولكن تم حذف هذه الصفحة منذ ذلك الحين. (لاحظ أن حذف صفحة Notion ينقلها إلى سلة المهملات، وتشير واجهة برمجة تطبيقات Notion إلى هذا على أنه "مؤرشف.")

كما هو موضح في قسم كيفية عمل Notero، يقوم Notero بربط عناصر Zotero بصفحات Notion من خلال رابط يسمى Notion مرفق بالعنصر. لحل المشكلة، قم بحذف مرفق الارتباط هذا الموجود على العنصر (العناصر) المسبب للمشكلة، ثم قم بإجراء المزامنة مرة أخرى.

ليست خاصية موجودة

إذا تلقيت الخطأ التالي:

APIResponseError: الخاصية ليست خاصية موجودة

يمكن أن يحدث هذا إذا قمت مسبقًا بمزامنة العناصر في قاعدة بيانات Notion واحدة ثم قمت بتغيير تفضيلات Notero الخاصة بك لتحديد قاعدة بيانات مختلفة. ربما يحاول Notero تحديث الصفحات في قاعدة البيانات القديمة بدلاً من إنشاء صفحات في قاعدة البيانات الجديدة، ويمكن أن يحدث هذا الخطأ إذا تم تكوين خصائص مختلفة في قواعد البيانات المختلفة.

لحل هذه المشكلة، يجب عليك حذف قاعدة البيانات القديمة في Notion ثم حذفها نهائيًا من سلة المهملات في Notion.

مثال لقواعد بيانات المفاهيم

نحن نقدم بعض الأمثلة على قواعد بيانات Notion التي تم تكوينها مع جميع الخصائص التي تمت مزامنتها بواسطة Notero.

بمجرد فتح أحد الأمثلة، انقر فوق الزر "تكرار" في الزاوية العلوية اليمنى من الصفحة لتكراره في مساحة عمل Notion الخاصة بك.

مثال أساسي

قاعدة بيانات فارغة تحتوي فقط على الخصائص التي تمت مزامنتها بواسطة Notero. مفيد إذا كنت تريد البدء من الصفر وتخصيصه بنفسك.

مثال متقدم

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

عرض جدول المعلومات الببليوغرافية

• يتيح عرض الجدول سهولة تحرير الإدخالات.
• انتقل بسهولة إلى المصدر الأصلي من خلال النقر على خاصية DOI أو URL .
  • قد تحتاج معرفات DOI الخاصة بالكتب إلى النسخ واللصق يدويًا من الحقل Extra في Zotero.
• انقر فوق خاصية Zotero URI لعرض/تحرير الإدخال في Zotero أو لتصدير إدخال المراجع بنمط اقتباس مختلف.

عرض لوحة حالة القراءة

• تتبع المراجع الواعدة التي تحتاج إلى تحديد موقعها، والكتب والمقالات التي طلبتها عبر الإعارة بين المكتبات، والأعمال ذات الصلة بما يكفي لتبرير تدوين ملاحظات متعمقة أو كتابة مذكرة.

عرض جدول مراجعة الأدبيات

• قم بتحليل ومقارنة سمات الأدبيات التي تقوم بمراجعتها بسرعة (على سبيل المثال، الإطار النظري، والعينة، والأساليب المستخدمة، والنتائج الرئيسية، وما إلى ذلك)
• يمكنك الارتباط بسهولة بأعمال أخرى باستخدام خاصية Related References (على سبيل المثال، مقالات في نفس العدد الخاص، فصول كتاب في نفس الكتاب المحرر، دراسات وتعليقات تستجيب لأعمال أخرى أو توسعها).

عرض معرض الكتب

• أضف صورة غلاف (على سبيل المثال، انقر بزر الماوس الأيمن → انسخ عنوان الصورة من أمازون).
• تتبع الكتب التي تمتلكها، واستعارتها، وإقراضها للآخرين.
  • إضافة تواريخ الاستحقاق والتذكيرات لكتب المكتبة والقروض بين المكتبات.

تطوير

تم دعم Notero بمكوّن إضافي لـ generator-zotero ويستخدم نصوص بناء مستوحاة بشكل كبير من zotero-plugin. شكرًا جزيلاً لـretorquere على إنشائها.

الإعداد المحلي

تعتمد الخطوات الموضحة أدناه على وثائق Zotero Plugin Development، ومن المفترض أن تسمح لك بإنشاء Notero وتشغيله بنفسك.

1. لتجنب أي ضرر محتمل لملف تعريف Zotero الافتراضي الخاص بك، يمكنك إنشاء ملف تعريف جديد لأغراض التطوير.

2. قم بإنشاء ملف باسم zotero.config.json والذي سيحتوي على خيارات التكوين المستخدمة لبدء تشغيل Zotero. راجع zotero.config.example.json للحصول على ملف مثال يحتوي على أوصاف لجميع خيارات التكوين المتاحة.

3. تثبيت التبعيات:

    npm ci
   

4. أنشئ Notero وابدأ تشغيل Zotero مع تثبيت المكون الإضافي:

    npm start
   

   وبدلاً من ذلك، يمكنك بدء الإصدار التجريبي المطلوب من Zotero:

    npm run start-beta
   

   يقوم البرنامج النصي start بعدد من الخطوات:

   1. قم بتنفيذ npm run build لإنشاء المكون الإضافي في دليل build .

   2. إذا تم تعريفه، فقم بتشغيل الأمر scripts.prestart المحدد في zotero.config.json .

   3. اكتب ملفًا يحتوي على المسار المطلق لدليل build في دليل extensions في دليل ملف تعريف Zotero.

   4. قم بإزالة أسطر extensions.lastAppBuildId و extensions.lastAppVersion من prefs.js في دليل ملف تعريف Zotero.

   5. ابدأ تشغيل Zotero باستخدام ملف التعريف المحدد في zotero.config.json ووسائط سطر الأوامر التالية:

       -purgecaches -ZoteroDebugText -jsdebugger -datadir profile
      

   6. إذا تم تعريفه، فقم بتشغيل الأمر scripts.poststart المحدد في zotero.config.json ، مع تزويده بمتغير البيئة ZOTERO_PID .

الافراج عن نسخة جديدة

يتم تنفيذ الإصدارات عبر إجراءات GitHub. يحدد سير عمل release الوظائف التالية:

release-please

تستخدم هذه الوظيفة إجراء "الإصدار من فضلك" لإنشاء ممثلين رئيسيين للإصدار عندما يتم دفع الالتزامات الجديدة التي تواجه المستخدم إلى الفرع main . سيؤدي إصدار PR إلى زيادة إصدار الحزمة وتحديث سجل التغيير. عندما يتم دمج العلاقات العامة، تقوم هذه المهمة بعد ذلك بإنشاء علامة إصدار جديدة وإصدار GitHub.

publish-artifacts

يتم تشغيل هذه المهمة عند إنشاء إصدار جديد بواسطة وظيفة release-please . يقوم بإنشاء ملف .xpi وينشره في الإصدار. كما يقوم أيضًا بإنشاء ملف بيان محدث ونشره في إصدار release .