فهرس الوثائق

الوثائق الرئيسية

  • README (هذه الوثيقة)

وثائق المطورين

  • مرجع واجهة برمجة التطبيقات (API) - وثائق واجهة برمجة التطبيقات العامة. يغطي إدارة البيانات الوصفية والتحكم في التنقل واشتراكات الأحداث لمطوري JavaScript/تايب سكريبت.
  • دليل الصياغة - دليل لمطوري القوالب. يتضمن مرجع فئة CSS، وخصائص مخصصة، وأمثلة على القوالب للوضعين الفاتح والداكن.
  • عملية بدء التشغيل - تسلسل تهيئة المكون الإضافي. تدفقات الإقلاع البارد مقابل تدفقات الإقلاع الدافئ، ودقة ذاكرة التخزين المؤقت للبيانات الوصفية، والتنظيف المؤجل، وخط أنابيب إنشاء المحتوى. يتضمن مخططات حورية البحر.
  • خط أنابيب البيانات الوصفية - تسلسل إعادة بناء ذاكرة التخزين المؤقت ومراحل خط أنابيب الموفر وإشارات الإكمال. يتضمن مخططات حورية البحر.
  • بنية التخزين - دليل لحاويات التخزين (حاويات التخزين (IndexedDB، التخزين المحلي، ذاكرة التخزين المؤقت، الإعدادات). أنماط تدفق البيانات وإرشادات الاستخدام.
  • بنية التقديم - التسلسل الهرمي لمكونات React، والتمرير الافتراضي مع تانستاك الافتراضي، وتحسينات الأداء، وتدفق البيانات.
  • تنظيم التمرير - كيف يضمن المكوّن الإضافي التمرير الدقيق عند تغير هياكل الشجرة (رؤية العلامات والإعدادات وغيرها)
  • هندسة الخدمات - طبقة منطق الأعمال: MetadataService، FileSystemOperations، ContentProviderRegistry. أنماط حقن التبعية وتدفق بيانات الخدمة.

1 التركيب

  1. تثبيت Obsidian - قم بتنزيله وتثبيته من obsidian.md
  2. تمكين إضافات المجتمع - انتقل إلى الإعدادات ← إضافات المجتمع ← تشغيل إضافات المجتمع
  3. تثبيت متصفح الدفاتر - انقر فوق "تصفح" → البحث عن "متصفح الدفاتر" → تثبيت
  4. تثبيت إعدادات النمط (اختياري) - لتخصيص الألوان والمظهر، ثبِّت إضافة "إعدادات النمط " من خلال البحث عن "إعدادات النمط" في إضافات المجتمع

2 الشروع في العمل

فيما يلي البرنامج التعليمي الرسمي لتعلم وإتقان المستكشف الدفتري:

Mastering Notebook Navigator

يحتوي الفيديو على ترجمة بـ 21 لغة.


3 الأمن والجودة

يتم فحص مستكشف دفتر الملاحظات باستخدام TypeScript و ESLint مع ملحق Obsidian ESLint الرسمي، و Prettier و Vitest وبناء الإنتاج قبل دمج التغييرات. يجب أن تكتمل البنية بدون أخطاء وبدون تحذيرات.

يتم تشغيل عمليات التحقق من الأمان من خلال CodeQL، مع سجل الفحص في عمليات تشغيل سير عمل CodeQL، وبطاقة أداء OpenSSF. تظهر الحالة الحالية في الشارات في أعلى هذه الصفحة.

يتم تشغيل Notebook Navigator محلياً، لكن بعض الميزات تقوم بإجراء طلبات HTTP موثقة للتحديثات والتنزيلات والمحتوى عن بُعد. راجع القسم 10 - الإفصاح عن الشبكة والتشخيص للاطلاع على القائمة الكاملة.


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


4 اختصارات لوحة المفاتيح

المفتاح الإجراء
↑/↓ التنقل لأعلى/لأسفل في الجزء الحالي
في جزء التنقل: طي الجزء أو الانتقال إلى الجزء الأصلي في جزء القائمة: التبديل إلى جزء التنقل
في جزء التنقل: توسيع جزء القائمة أو الانتقال إليه في جزء القائمة: الانتقال إلى المحرر
Tab في جزء التنقل: الانتقال إلى جزء القائمة في جزء القائمة: الانتقال إلى المحرر في حقل البحث: الانتقال إلى جزء القائمة
Shift+Tab في جزء القائمة: التبديل إلى جزء التنقل في حقل البحث: التبديل إلى جزء التنقل
Enter (macOS) F2 (Windows/Linux) إعادة تسمية العنصر مباشرةً في جزء التنقل أو جزء القائمة
Enter في جزء التنقل: فتح ملاحظة المجلد في Windows/Linux بشكل افتراضي (عند التمكين) في جزء القائمة: فتح الملف المحدد على جميع الأنظمة (عند التمكين) في حقل البحث: التبديل إلى جزء القائمة
مفتاح الهروب في حقل البحث: إغلاق البحث وتركيز الانتباه على جزء القائمة
PageUp/PageDown التمرير لأعلى/لأسفل في جزء التنقل وجزء القائمة
Home/End الانتقال إلى العنصر الأول/الأخير في الجزء الحالي
حذف مسافة للخلف حذف العنصر المحدد
Cmd/Ctrl+A تحديد جميع الملاحظات في المجلد الحالي
Cmd/Ctrl+النقر تبديل تحديد الملاحظات
Shift+النقر تحديد نطاق من الملاحظات
Shift+Home/End التحديد من الموضع الحالي إلى العنصر الأول/الأخير
Shift+↑/↓ توسيع التحديد لأعلى/لأسفل
Cmd/Ctrl+↑/↓ إعادة ترتيب الملفات المحددة لأعلى/لأسفل في وضع الفرز اليدوي

ملاحظة: يمكن تخصيص جميع اختصارات لوحة المفاتيح. راجع القسم 7 - مفاتيح الاختصار المخصصة للحصول على تفاصيل حول إضافة مفاتيح اختصارات لوحة المفاتيح على غرار VIM (h، j، k، l)، والمفاتيح البديلة، ومجموعات المعدلات.


5 الإعدادات المتزامنة والمحلية

تعرض العديد من الإعدادات في Notebook Navigator مفتاح تبديل المزامنة - رمز سحابة يبدل بين "تمكين المزامنة" و "تعطيل المزامنة". يتحكم هذا في مكان تخزين كل إعداد وما إذا كان يتم مشاركته عبر الأجهزة.

5.1 كيفية عمل المزامنة

تقوم إضافات Obsidian بتخزين تكوينها في data.json ، الموجود في .obsidian/plugins/notebook-navigator/data.json داخل مجلد القبو الخاص بك. عندما تستخدم خدمة مزامنة - مثل Obsidian Sync أو iCloud أو GitHub أو Dropbox أو Google Drive - تتم مزامنة هذا الملف عبر جميع أجهزتك مع بقية مخزنك. سينتشر أي إعداد محفوظ على data.json إلى كل جهاز يقوم بمزامنة المخزن.

Screenshot 2026-02-18 at 22 58 05

عندما يتم تمكين المزامنة (افتراضي) لإعداد ما، يتم حفظ القيمة على data.json وتتم مزامنتها مع جميع الأجهزة من خلال خدمة المزامنة.

Screenshot 2026-02-18 at 22 58 14

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

إذا كنت لا تستخدم خدمة مزامنة، فإن تبديل المزامنة ليس له أي تأثير عملي لأن data.json يتم تخزينه محلياً فقط.


6 بحث

يحتوي Notebook Navigator على وضعي بحث: البحث بالتصفية والبحث الشامل. قم بالتبديل بينهما باستخدام مفاتيح الأسهم لأعلى/لأسفل أو بالنقر على أيقونة البحث. اجمع بين أسماء الملفات والخصائص والعلامات والتواريخ والمرشحات في استعلام واحد (على سبيل المثال، meeting .status=active #work @thisweek).

6.1 تصفية البحث 1

تصفية الملفات حسب الاسم والعلامات والخصائص والتواريخ والمجلدات والملحقات والمهام داخل المجلد الحالي والمجلدات الفرعية. وضع البحث الافتراضي.

أسماء الملفات

  • word - مطابقة الملاحظات مع "كلمة" في اسم الملف
  • word1 word2 - اشتراط تطابق كل كلمة مع اسم الملف
  • -word - استبعاد الملاحظات التي تحتوي على "كلمة" في اسم الملف

الوسوم

  • #tag - تضمين الملاحظات مع العلامة (يطابق أيضًا العلامات المتداخلة مثل #tag/subtag)
  • # - تضمين الملاحظات الموسومة فقط
  • -#tag - استبعاد الملاحظات ذات العلامة
  • -# - تضمين الملاحظات غير الموسومة فقط
  • #tag1 #tag2 - تطابق كلا العلامتين (وضمني و)
  • #tag1 AND #tag2 - طابق كلا العلامتين (و)
  • #tag1 OR #tag2 - طابق أيًا من العلامتين
  • #a OR #b AND #c - و له أسبقية أعلى: يطابق #a ، أو كلاهما #b و #c
  • Cmd/Ctrl+النقر فوق علامة للإضافة باستخدام AND. Cmd/Ctrl+Shift+Click للإضافة باستخدام OR

الخصائص

  • .key - تضمين الملاحظات مع مفتاح الملكية
  • .key=value - تضمين الملاحظات التي تحتوي على قيمة العقار value
  • ."Reading Status" - مفتاح الملكية بمسافة بيضاء (مقتبسة من علامتي اقتباس)
  • ."Reading Status"="In Progress" - يجب أن تكون المفاتيح والقيم التي تحتوي على مسافات بيضاء مقتبسة من علامتي اقتباس
  • -.key - استبعاد الملاحظات مع مفتاح الملكية
  • -.key=value - استبعاد الملاحظات التي تحتوي على قيمة العقار value
  • Cmd/Ctrl+النقر فوق خاصية للإضافة باستخدام AND. Cmd/Ctrl+Shift+Click للإضافة بـ OR

الفلاتر

  • has:task - تضمين ملاحظات بالمهام غير المنجزة
  • -has:task - استبعاد الملاحظات التي تحتوي على مهام غير مكتملة
  • folder:meetings - تضمين الملاحظات حيث يحتوي اسم المجلد meetings
  • folder:/work/meetings - تضمين الملاحظات فقط في work/meetings (وليس المجلدات الفرعية)
  • folder:/ - تضمين الملاحظات في جذر القبو فقط
  • -folder:archive - استبعاد الملاحظات التي يحتوي فيها اسم المجلد على archive
  • -folder:/archive - استبعاد الملاحظات فقط في archive (وليس المجلدات الفرعية)
  • ext:md - تضمين الملاحظات مع الامتداد md (ext:.md مدعوم أيضًا)
  • -ext:pdf - استبعاد الملاحظات ذات الامتداد pdf
  • الجمع مع العلامات والأسماء والتواريخ (على سبيل المثال، folder:/work/meetings ext:md @thisweek)

التواريخ

  • @today - مطابقة الملاحظات من اليوم باستخدام حقل التاريخ الافتراضي
  • @yesterday, @last7d, @last30d, , @thisweek, @thismonth - نطاقات التواريخ النسبية
  • @2026-02-07 - تطابق يوم واحد (يدعم أيضًا @20260207)
  • @2026 - مطابقة سنة تقويمية
  • @2026-02 أو @202602 - مطابقة شهر تقويمي
  • @2026-W05 أو @2026W05 - مطابقة أسبوع ISO
  • @2026-Q2 أو @2026Q2 - مطابقة ربع السنة التقويمية
  • @13/02/2026 - تنسيقات رقمية مع فواصل (@07022026 يتبعون اللغة المحلية عند الغموض)
  • @2026-02-01..2026-02-07 - مطابقة نطاق يوم شامل (النهايات المفتوحة مدعومة)
  • @c:... أو @m:... - تاريخ إنشاء الهدف أو تعديله
  • -@... - استبعاد تطابق التاريخ

يتبع حقل التاريخ الافتراضي ترتيب الفرز الحالي. عند الفرز حسب الاسم، يتم تكوين حقل التاريخ في الإعدادات → ملاحظات → التاريخ → عند الفرز حسب الاسم.

و/ أو السلوك

AND و OR يعمل المشغلان في استعلامات العلامات/الخصائص فقط (الاستعلامات التي تحتوي فقط على مرشحات #tag أو -#tag أو # أو -# أو .key أو -.key أو .key=value أو -.key=value ). إذا كان الاستعلام يتضمن أيضًا أسماء أو تواريخ أو عوامل تصفية المهام أو عوامل تصفية المجلدات أو عوامل تصفية الامتدادات، تتم مطابقة AND و OR ككلمات اسم الملف بدلاً من ذلك.

  • استعلام المشغل: #work OR .status=started
  • استعلام مختلط: #work OR ext:md (يتم مطابقةOR في أسماء الملفات)

6.2 البحث الشامل

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

تعرض معاينات الملاحظات مقتطفات نتائج البحث الشامل بدلاً من نص المعاينة الافتراضي.

القيود المعروفة

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

7 مفاتيح اختصار مخصصة

قم بتحرير .obsidian/plugins/notebook-navigator/data.json لتخصيص مفاتيح الاختصار Notebook Navigator. افتح الملف وحدد موقع قسم keyboardShortcuts. يقوم كل إدخال بتعيين إجراء إلى رابط مفتاح واحد أو أكثر:

"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]

أضف روابط متعددة لكل إجراء لدعم المفاتيح البديلة، مثل المثال ArrowUp و K أعلاه. اجمع بين المعدلات في إدخال واحد بإدراج كل قيمة، على سبيل المثال "modifiers": ["Mod", "Shift"]. تسلسلات لوحة المفاتيح مثل gg أو dd غير مدعومة. أعد تحميل Obsidian بعد تحرير الملف.

7.1 المعدلات

المعدل المفتاح
Mod Cmd (macOS) / Ctrl (Win/Linux)
Alt بديل / خيار
Shift شيفت
Ctrl التحكم (يفضل Mod للمنصة المشتركة)

7.2 الإجراءات المتاحة

الإجراء مفتاح (مفاتيح) افتراضي
pane:move-up السهم لأعلى
pane:move-down السهم لأسفل
pane:page-up الصفحة لأعلى
pane:page-down الصفحة لأسفل
pane:home الصفحة الرئيسية
pane:end نهاية
pane:rename Enter (macOS)، F2 (Windows/Linux)
pane:delete-selected حذف، مسافة للخلف
navigation:collapse-or-parent السهم لليسار
navigation:expand-or-focus-list السهم لليمين
navigation:focus-list Tab
list:focus-navigation السهم الأيسر، Shift+Tab
list:focus-editor السهم لليمين، Tab
list:select-all Mod+A
list:extend-selection-up Shift+سهم لأعلى
list:extend-selection-down Shift+سهم لأسفل
list:manual-sort-up Mod+سهم لأعلى
list:manual-sort-down Mod+سهم لأسفل
list:range-to-start Shift+Home
list:range-to-end Shift+End
search:focus-list Tab، Enter
search:focus-navigation Shift+Tab
search:close Escape

8 أوامر

عيّن مفاتيح اختصار مخصصة لهذه الأوامر في إعدادات مفاتيح الاختصار في Obsidian:

العرض والتنقل

  • Notebook Navigator: Open يفتح متصفح الدفاتر في الشريط الجانبي الأيسر. إذا كان مفتوحًا بالفعل، ينقل تركيز لوحة المفاتيح إلى جزء القائمة. اقتراح: الارتباط بمفتاح اختصار مثل Cmd/Ctrl+Shift+E لنقل تركيز لوحة المفاتيح إلى جزء القائمة - هذا ضروري للتنقل الكامل على لوحة المفاتيح
  • Notebook Navigator: Toggle left sidebar تبديل الشريط الجانبي الأيسر. عند الفتح، يضبط طريقة عرض الشريط الجانبي الأيسر على متصفح دفتر الملاحظات (على عكس أمر "تبديل الشريط الجانبي الأيسر" المدمج في Obsidian الذي يستعيد طريقة عرض الشريط الجانبي الأيسر السابقة)
  • Notebook Navigator: Open homepage فتح عرض مستكشف دفتر الملاحظات وتحميل هدف الصفحة الرئيسية الذي تم تكوينه في الإعدادات
  • Notebook Navigator: Select vault profile فتح مشروط للتبديل بين ملفات تعريف القبو
  • Notebook Navigator: Reveal file يكشف الملف الحالي في المستكشف. يوسع المجلدات الرئيسية ويمرر إلى الملف. هذا الأمر مفيد إذا كان الإعداد Auto-reveal active note مغلقًا وتريد الكشف عن الملاحظات يدويًا. اقتراح: ربطه بمفتاح اختصار مثل Cmd/Ctrl+Shift+R لتغيير المجلد أو العلامة المحددة بسرعة إلى الملف الحالي
  • Notebook Navigator: Open all files فتح كافة الملاحظات في المجلد أو العلامة المحددة حالياً. عند فتح 15 ملفاً أو أكثر، يُظهر مربع حوار التأكيد
  • Notebook Navigator: Navigate to folder مربع حوار البحث للانتقال إلى أي مجلد
  • Notebook Navigator: Navigate to tag مربع حوار البحث للانتقال إلى أي علامة
  • Notebook Navigator: Navigate to property مربع الحوار "بحث" للانتقال إلى أي مفتاح خاصية أو قيمة خاصية
  • Notebook Navigator: Navigate back الانتقال إلى المجلد، أو العلامة، أو تحديد الخاصية السابقة في سجل المتصفح
  • Notebook Navigator: Navigate forward الانتقال إلى المجلد أو الوسم أو تحديد الخاصية التالية في سجل المتصفح
  • Notebook Navigator: Add to shortcuts إضافة أو إزالة الملف أو المجلد أو العلامة أو الخاصية الحالية من الاختصارات
  • Notebook Navigator: Open shortcut 1-9 فتح الاختصار حسب موضعه في قائمة الاختصارات
  • Notebook Navigator: Search يفتح حقل البحث السريع أو يركز عليه إذا كان مفتوحاً بالفعل. يستمر البحث بين الجلسات. اقتراح: الارتباط بمفتاح اختصار مثل Cmd/Ctrl+Shift+S لتصفية الملفات بسرعة
  • Notebook Navigator: Search whole vault يحدد المجلد الجذري لـ «Vault» ويفتح نافذة البحث مع تضمين المجلدات الفرعية (يتطلب تفعيل ميزة « Show root folder »)

الاختيار

  • Notebook Navigator: Select next file ينقل التحديد إلى الملف التالي في طريقة عرض المجلد أو العلامة الحالية. يحترم ترتيب الفرز المخصص. اقتراح: الارتباط بمفتاح اختصار مثل Option+Cmd+Right للانتقال بسرعة إلى الملف التالي في القائمة
  • Notebook Navigator: Select previous file ينقل التحديد إلى الملف السابق في طريقة عرض المجلد أو العلامة الحالية. يحترم ترتيب الفرز المخصص. اقتراح: الارتباط بمفتاح اختصار مثل Option+Cmd+Left للانتقال بسرعة إلى الملف السابق في القائمة

التخطيط والعرض

  • Notebook Navigator: Toggle dual pane layout تبديل التخطيط أحادي/ثنائي الجزء (سطح المكتب). اقتراح: الارتباط بمفتاح اختصار مثل Cmd/Ctrl+Shift+A للتبديل بسرعة بين تخطيط الجزء الواحد والتخطيط ثنائي الأجزاء
  • Notebook Navigator: Toggle dual pane orientation تبديل اتجاه الجزء المزدوج بين الأفقي والرأسي
  • Notebook Navigator: Toggle descendants تبديل عرض المجلدات الفرعية/الملاحظات التابعة للمجلدات والعلامات. اقتراح: الارتباط بمفتاح اختصار مثل Cmd/Ctrl+Shift+D للتبديل السريع لعرض الملاحظات من المجلدات الفرعية / التوابع
  • Notebook Navigator: Toggle hidden folders, tags, and notes إظهار أو إخفاء المجلدات والعلامات والملاحظات المخفية
  • Notebook Navigator: Toggle tag sort order التبديل بين الترتيب الأبجدي للعلامات والترتيب حسب التكرار
  • Notebook Navigator: Toggle tags by selection تبديل قصر العلامات على تلك الموجودة في الملاحظات داخل المجلد أو الخاصية المحددة
  • Notebook Navigator: Toggle properties by selection تبديل قصر الخصائص على تلك الموجودة في الملاحظات داخل المجلد أو العلامة المحددة
  • Notebook Navigator: Toggle compact mode تبديل وضع القائمة بين الوضع القياسي والمدمج
  • Notebook Navigator: Toggle pinned section إظهار الملاحظات المثبتة أو إخفاؤها في جزء القائمة
  • Notebook Navigator: Collapse / expand all items طي جميع العناصر أو توسيعها بناءً على الحالة الحالية. عند تمكين Keep selected item expanded (تشغيل افتراضي)، سيتم طي جميع المجلدات باستثناء المجلد الحالي. هذا مفيد للحفاظ على شجرة التنقل مرتبة عند البحث عن المستندات
  • Notebook Navigator: Collapse / expand selected item طي عنصر التنقل المحدد أو توسيعه

التقويم

  • Notebook Navigator: Toggle calendar تبديل تشغيل التقويم أو إيقاف تشغيله. اقتراح: الارتباط بمفتاح اختصار مثل Cmd/Ctrl+Shift+C لإظهار التقويم بسرعة
  • Notebook Navigator: Open daily note يفتح الملاحظة اليومية لليوم بناءً على إعدادات التقويم. إنشاء الملاحظة إذا لم تكن موجودة
  • Notebook Navigator: Open weekly note يفتح الملاحظة الأسبوعية الحالية. إنشاء الملاحظة إذا لم تكن موجودة
  • Notebook Navigator: Open monthly note يفتح الملاحظة الشهرية الحالية. ينشئ الملاحظة إذا لم تكن موجودة
  • Notebook Navigator: Open quarterly note يفتح الملاحظة الفصلية الحالية. إنشاء الملاحظة إذا لم تكن موجودة
  • Notebook Navigator: Open yearly note يفتح الملاحظة السنوية الحالية. ينشئ الملاحظة إذا لم تكن موجودة

عمليات الملفات

مهم: لا يحتوي Obsidian على سياق "المجلد أو العلامة الحالية"، لذلك عند إنشاء الملاحظات في Obsidian بشكل افتراضي يتم إنشاؤها في المجلد الجذر، أو نفس مجلد الملف الحالي، أو مجلد محدد. عند العمل باستخدام Notebook Navigator، فأنت تريد دائمًا إنشاء ملاحظات جديدة في المجلد أو العلامة المحددة حاليًا، لذا فإن أول شيء يجب عليك فعله هو ربط Cmd/Ctrl+N بـ Notebook Navigator: Create new note بحيث يتم دائمًا إنشاء ملاحظات جديدة في المجلد أو العلامة المحددة حاليًا. الأمر نفسه ينطبق أيضًا على نقل الملفات وحذفها. لهذا السبب يجب عليك استخدام هذه الأوامر بدلاً من أوامر Obsidian المضمنة عند استخدام Notebook Navigator.

  • Notebook Navigator: Create new note إنشاء ملاحظة في المجلد المحدد حالياً. اقتراح: ربط Cmd/Ctrl+N بهذا الأمر (قم بفك الربط من "إنشاء ملاحظة جديدة" الافتراضي لـ Obsidian أولاً)
  • Notebook Navigator: Create new note from template إنشاء ملاحظة من القالب الموجود في المجلد المحدد حالياً (يتطلب وجود Templater)
  • Notebook Navigator: Move files نقل الملفات المحددة إلى مجلد آخر. يحدد الملف التالي في المجلد الحالي
  • Notebook Navigator: Merge notes إنشاء ملاحظة واحدة من ملاحظات Markdown المحددة في ترتيب القائمة الحالية
  • Notebook Navigator: Convert to folder note قم بإنشاء مجلد مطابق لاسم الملف وانقل الملف بداخله كملاحظة المجلد
  • Notebook Navigator: Set as folder note إعادة تسمية الملف النشط إلى اسم ملاحظة المجلد الخاص به
  • Notebook Navigator: Detach folder note افصل ملاحظة المجلد في المجلد المحدد وأعد تسميته
  • Notebook Navigator: Pin all folder notes تثبيت جميع ملاحظات المجلدات في جميع المجلدات. لا يظهر هذا الأمر إلا عند تمكين ملاحظات المجلدات
  • Notebook Navigator: Delete files حذف الملفات المحددة. تحديد الملف التالي في المجلد الحالي

عمليات الوسم

  • Notebook Navigator: Add tag to selected files مربع حوار لإضافة علامة إلى الملفات المحددة. يدعم إنشاء علامات جديدة
  • Notebook Navigator: Set property on selected files مربع حوار لتعيين الخاصية على الملفات المحددة
  • Notebook Navigator: Remove tag from selected files مربع حوار لإزالة علامة محددة. تتم الإزالة فوراً إذا كانت علامة واحدة فقط
  • Notebook Navigator: Remove all tags from selected files مسح جميع العلامات من الملفات المحددة مع التأكيد

الصيانة

  • Notebook Navigator: Rebuild cache يُعيد إنشاء ذاكرة التخزين المؤقت المحلية ل Notebook Navigator المحلية. استخدم هذا إذا كنت تواجه علامات مفقودة أو معاينات غير صحيحة أو صور ميزات مفقودة

8.1 معرفات الأوامر

معرّف الأمر اسم الأمر
notebook-navigator:open مستكشف دفتر الملاحظات: فتح
notebook-navigator:toggle-left-sidebar مستكشف دفتر الملاحظات: تبديل الشريط الجانبي الأيسر
notebook-navigator:open-homepage مستكشف دفتر الملاحظات: فتح الصفحة الرئيسية
notebook-navigator:select-profile مستكشف دفتر الملاحظات: تحديد ملف تعريف الخزينة
notebook-navigator:select-profile-1 مستكشف دفتر الملاحظات: تحديد ملف تعريف الخزينة 1
notebook-navigator:select-profile-2 مستكشف دفتر الملاحظات: تحديد ملف تعريف الخزينة 2
notebook-navigator:select-profile-3 مستكشف دفتر الملاحظات: تحديد ملف تعريف الخزينة 3
notebook-navigator:reveal-file مستكشف دفتر الملاحظات: إظهار الملف
notebook-navigator:open-all-files مستكشف دفتر الملاحظات: فتح جميع الملفات
notebook-navigator:navigate-to-folder مستكشف دفتر الملاحظات: الانتقال إلى المجلد
notebook-navigator:navigate-to-tag مستكشف دفتر الملاحظات: الانتقال إلى العلامة
notebook-navigator:navigate-to-property مستكشف دفتر الملاحظات: الانتقال إلى خاصية
notebook-navigator:navigate-back مستكشف دفتر الملاحظات: الرجوع
notebook-navigator:navigate-forward مستكشف دفتر الملاحظات: الانتقال إلى الأمام
notebook-navigator:add-shortcut مستكشف دفتر الملاحظات: إضافة إلى الاختصارات
notebook-navigator:open-shortcut-1 مستكشف دفتر الملاحظات: فتح الاختصار 1
notebook-navigator:open-shortcut-2 مستكشف دفتر الملاحظات: فتح الاختصار 2
notebook-navigator:open-shortcut-3 مستكشف دفتر الملاحظات: فتح الاختصار 3
notebook-navigator:open-shortcut-4 مستكشف دفتر الملاحظات: فتح الاختصار 4
notebook-navigator:open-shortcut-5 مستكشف دفتر الملاحظات: فتح الاختصار 5
notebook-navigator:open-shortcut-6 مستكشف دفتر الملاحظات: افتح الاختصار 6
notebook-navigator:open-shortcut-7 مستكشف دفتر الملاحظات: افتح الاختصار 7
notebook-navigator:open-shortcut-8 مستكشف دفتر الملاحظات: افتح الاختصار 8
notebook-navigator:open-shortcut-9 مستكشف دفتر الملاحظات: افتح الاختصار 9
notebook-navigator:search مستكشف دفتر الملاحظات: بحث
notebook-navigator:search-vault مستكشف دفتر الملاحظات: البحث في المخزن بأكمله
notebook-navigator:toggle-dual-pane مستكشف دفتر الملاحظات: تبديل تخطيط الجزء المزدوج
notebook-navigator:toggle-dual-pane-orientation مستكشف دفتر الملاحظات: تبديل اتجاه الأجزاء المزدوجة
notebook-navigator:toggle-calendar مستكشف دفتر الملاحظات: تبديل التقويم
notebook-navigator:open-daily-note مستكشف دفتر الملاحظات: فتح ملاحظة يومية
notebook-navigator:open-weekly-note مستكشف دفتر الملاحظات: فتح ملاحظة أسبوعية
notebook-navigator:open-monthly-note مستكشف دفتر الملاحظات: فتح الملاحظة الشهرية
notebook-navigator:open-quarterly-note مستكشف دفتر الملاحظات: فتح الملاحظة الفصلية
notebook-navigator:open-yearly-note مستكشف دفتر الملاحظات: فتح الملاحظة السنوية
notebook-navigator:toggle-descendants مستكشف دفتر الملاحظات: تبديل العناصر التابعة
notebook-navigator:toggle-hidden مستكشف دفتر الملاحظات: تبديل المجلدات والعلامات والملاحظات المخفية
notebook-navigator:toggle-tag-sort مستكشف دفتر الملاحظات: تبديل ترتيب العلامات
notebook-navigator:toggle-tags-by-selection مستكشف دفتر الملاحظات: تبديل العلامات حسب التحديد
notebook-navigator:toggle-properties-by-selection مستكشف دفتر الملاحظات: تبديل الخصائص حسب التحديد
notebook-navigator:toggle-compact-mode مستكشف دفتر الملاحظات: تبديل الوضع المضغوط
notebook-navigator:toggle-pinned-section مستكشف دفتر الملاحظات: تبديل القسم المثبت
notebook-navigator:collapse-expand مستكشف دفتر الملاحظات: طي / توسيع جميع العناصر
notebook-navigator:collapse-expand-selected-item مستكشف دفتر الملاحظات: طي/توسيع العنصر المحدد
notebook-navigator:new-note مستكشف دفتر الملاحظات: إنشاء ملاحظة جديدة
notebook-navigator:new-note-from-template مستكشف دفتر الملاحظات: إنشاء ملاحظة جديدة من قالب
notebook-navigator:move-files مستكشف دفتر الملاحظات: نقل الملفات
notebook-navigator:merge-notes مستكشف دفتر الملاحظات: دمج الملاحظات
notebook-navigator:select-next-file مستكشف دفتر الملاحظات: تحديد الملف التالي
notebook-navigator:select-previous-file مستكشف دفتر الملاحظات: تحديد الملف السابق
notebook-navigator:convert-to-folder-note مستكشف دفتر الملاحظات: تحويل إلى ملاحظة مجلد
notebook-navigator:set-as-folder-note مستكشف دفتر الملاحظات: تعيين كملاحظة مجلد
notebook-navigator:detach-folder-note مستكشف دفتر الملاحظات: فصل ملاحظة المجلد
notebook-navigator:pin-all-folder-notes مستكشف دفتر الملاحظات: تثبيت جميع ملاحظات المجلد
notebook-navigator:delete-files مستكشف دفتر الملاحظات: حذف الملفات
notebook-navigator:add-tag مستكشف دفتر الملاحظات: إضافة علامة إلى الملفات المحددة
notebook-navigator:set-property مستكشف دفتر الملاحظات: تعيين خاصية للملفات المحددة
notebook-navigator:remove-tag مستكشف دفتر الملاحظات: إزالة العلامة من الملفات المحددة
notebook-navigator:remove-all-tags مستكشف دفتر الملاحظات: إزالة جميع العلامات من الملفات المحددة
notebook-navigator:rebuild-cache مستكشف دفتر الملاحظات: إعادة إنشاء ذاكرة التخزين المؤقت

9 ميزات

9.1 واجهة 1

  • تخطيط ثنائي الأجزاء - جزء التنقل (المجلدات/العلامات/الخصائص) وجزء القائمة (الملفات)
  • وضع الجزء الواحد - طرق عرض التنقل والقائمة مع انتقالات متحركة
  • الأجزاء القابلة لإعادة التخصيص - اتجاه التقسيم الأفقي أو الرأسي
  • التكبير المستقل لواجهة المستخدم -تكبير مستقل لواجهة المستخدم - تكبير متصفح دفتر الملاحظات دون تغيير تكبير Obsidian
  • عرض بدء التشغيل - التنقل أولاً أو القائمة أولاً
  • دعم متعدد اللغات - 21 لغة مع دعم تخطيط RTL
  • مجموعة أيقونات الواجهة - أيقونات واجهة المستخدم القابلة للتخصيص عبر المكون الإضافي

9.2 الملاحة 2

  • ملفات تعريف المخزن - طرق عرض متعددة تمت تصفيتها مع مجلدات/علامات/ملاحظات مخفية لكل ملف تعريف، ورؤية الملفات، والشعار، والاختصارات
  • الاختصارات - الملاحظات، والمجلدات، والعلامات، والخصائص، وعمليات البحث المحفوظة مع إمكانية التثبيت وإعادة الترتيب
  • الملاحظات/الملفات الحديثة - قسم العناصر الحديثة المخزنة في ملف تعريف المخزن، مثبتة اختياريًا مع اختصارات
  • التقويم - تقويم الملاحظات اليومية مع تحديد اليوم وميزة معاينة الصور ودعم التقسيم الرأسي
  • شجرة المجلدات - توسيع/طي المجلدات مع ترتيب المجلد الجذر اليدوي
  • شجرة العلامات - علامات هرمية مع ترتيب علامات جذر قابل للتكوين
  • متصفح الخصائص - تصفح خصائص الملفات مرتبة حسب المفتاح والقيمة مع عدد الملفات والألوان المخصصة والأيقونات والسحب والإفلات
  • الكشف التلقائي عن الملف النشط - توسيع المجلدات والتمرير للتحديد
  • لوحة المفاتيح والأوامر - مفاتيح الاختصار القابلة للتكوين، وأوامر سجل التحديد للخلف/للأمام، وأوامر الملف التالي/السابق، وأوامر فتح الاختصار 1-9

9.3 منظمات

  • تثبيت الملاحظات - احتفظ بالملاحظات المهمة في أعلى المجلدات والعلامات
  • ملاحظات المجلد - تعيين/فصل ملاحظات المجلد، وتثبيت ملاحظات المجلد، والخيار فتح في علامة تبويب جديدة
  • عمليات العلامات - إضافة/إزالة/مسح العلامات، وإعادة تسمية/حذف العلامات، وإنشاء ملاحظة في العلامة، والسحب والإفلات في التسلسل الهرمي للعلامة
  • فرز وتجميع مخصص - تجاوز إعدادات الفرز/التجميع لكل مجلد أو علامة
  • المظاهر لكل مجلد/علامة - صفوف العناوين، صفوف المعاينة، الوضع المضغوط، تبديل التوابع
  • المحتوى المخفي - مجلدات/علامات/ملاحظات/ملفات مخفية مع أنماط وخصائص المسألة الأمامية والتصفية المستندة إلى العلامات لكل ملف تعريف مخزن
  • استبعاد المجلدات من المجلدات التابعة - تجاهل المجلدات عند جمع الملاحظات من المجلدات الفرعية، وفقًا لملف تعريف الخزينة؛ وتظل المجلدات المستبعدة مرئية وتُظهر ملاحظاتها عند تحديدها
  • نظام الألوان والأيقونات - ألوان المجلدات/العلامات/الخصائص/الملفات، حزم الأيقونات، الرموز التعبيرية/أيقونات لوسيدي، قراءة/كتابة الأيقونات في الواجهة، تعيين الأيقونات حسب اسم الملف وفئة نوع الملف
  • تحذيرات الاسم - التحذير من أحرف نظام الملفات المحظورة والأحرف التي تقطع روابط Obsidian عند تسمية الملفات والمجلدات

9.4 عرض الملفات

  • معاينات الملاحظات - 1-5 أسطر معاينة مع تجريد HTML اختياري
  • الصور المصغرة - الصور المميزة بالإضافة إلى الصور المصغرة التي يتم إنشاؤها تلقائيًا لملفات PDF وSVG وملفات الرسومات المخزنة في ذاكرة التخزين المؤقتة للبيانات الوصفية
  • الصور الخارجية - التنزيلات الاختيارية للصور الخارجية والصور المصغرة على يوتيوب
  • تجميع التواريخ - تجميع الملاحظات حسب اليوم وأمس و7 أيام سابقة و30 يومًا سابقة و30 يومًا سابقة وشهور وسنوات عند فرزها حسب التاريخ
  • دعم المسألة الأمامية - قراءة أسماء الملاحظات والطوابع الزمنية من حقول المسألة الأمامية
  • البيانات الوصفية للملاحظات - إظهار تاريخ التعديل والعلامات في قائمة الملفات
  • الخصائص المخصصة - عرض خصائص المسألة الأمامية أو عدد الكلمات في قائمة الملفات مع تجاوزات لكل مجلد/علامة وألوان مخصصة
  • عرض المجلد الأصل - اسم المجلد الأصل الاختياري والأيقونة في قائمة الملفات
  • الوضع المضغوط - عرض مضغوط عند تعطيل المعاينة والتاريخ والصور
  • علامات قابلة للنقر - العلامات في قائمة الملفات تنتقل مباشرةً إلى تلك العلامة

9.5 الإنتاجية

  • البحث - التصفية حسب اسم الملف، والعلامات، والخصائص، والتواريخ، والمجلدات، والإضافات، والمهام باستخدام AND/OR/الاستثناءات
  • تكامل Omnisearch - البحث في النص الكامل عبر Omnisearch
  • السحب والإفلات - نقل الملفات، ووضع العلامات، وتعيين الاختصارات، وإعادة ترتيب شجرة العلامات، والمجلدات المحملة بنابض
  • قوائم السياق - إنشاء ملاحظات/مجلدات/لوحات/قواعد/رسومات وتشغيل إجراءات الملفات/العلامات
  • الرسومات - إنشاء رسومات Excalidraw و Tldraw من قوائم التنقل وقوائم جزء القائمة
  • القوالب - ملاحظة جديدة من أوامر القالب مع المكون الإضافي Templater
  • عمليات الملفات - إنشاء الملفات والمجلدات وإعادة تسميتها وتكرارها ونقلها وحذفها وسحبها
  • التصفية - استبعادات المجلدات/العلامات/الملاحظات/الملفات مع الأنماط وخصائص المادة الأمامية

10 الإفصاح عن الشبكة والتشخيص

يتم تشغيل Notebook Navigator محليًا، ولكن بعض الميزات تقوم بإجراء طلبات HTTP من Obsidian. يمكن لتسجيل تصحيح أخطاء بدء التشغيل أيضًا كتابة ملف تشخيصي محلي في مخزنك.

10.1 عمليات التحقق من تحديث الإصدار 1 (اختياري)

  • الإعداد: "التحقق من وجود إصدار جديد عند بدء التشغيل"
  • الطلب: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • التكرار: مرة واحدة على الأكثر كل 24 ساعة، عند بدء التشغيل
  • البيانات: يرسل بيانات تعريف HTTP القياسية؛ لا يتضمن محتوى القبو

10.2 تنزيل حزمة أيقونة 2 (اختياري)

  • الإعداد: تمكين حزمة الأيقونات في علامة التبويب حزم الأيقونات
  • الطلبات: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (البيان، الخط، البيانات الوصفية)
  • التخزين: مخزنة محلياً في قاعدة البيانات المفهرسة

10.3 الصور الخارجية ومقاطع الفيديو والصور المصغرة على يوتيوب

  • صور الميزات (اختياري): يتحكم فيه إعداد "تنزيل الصور الخارجية". يقوم بتنزيل الصور عن بُعد والصور المصغرة لصور الميزات وتخزينها محليًا في IndexedDB.
  • نموذج الترحيب (الإطلاق الأول): يقوم بتحميل صورة مصغرة ثابتة من https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • ما الجديد مشروط (عند التحديث/عند الفتح): تحميل صور لافتة الإصدار من https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg لملاحظات الإصدار التي تتضمن لافتة.
  • نافذة "ما الجديد" (عند التحديث / عند الفتح): تُحمّل مقاطع فيديو الإصدار من https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 للاطلاع على ملاحظات الإصدار التي تتضمن مقطع فيديو.
  • نافذة "ما الجديد" (عند فتح فيديو الإعلان): تفتح مقاطع فيديو الإعلانات من موقع https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4 حتى تتمكن المتصفحات من تشغيل الفيديو مباشرةً.
  • ما الجديد مشروط (عند التحديث/عند الفتح): تحميل صور يوتيوب المصغرة من https://img.youtube.com/vi/<id>/... لملاحظات الإصدار التي تتضمن رابط يوتيوب.

10.4 ملفات تصحيح أخطاء بدء التشغيل (اختياري)

  • الإعداد: "تسجيل تصحيح أخطاء بدء التشغيل"
  • التخزين: يكتب ملفًا مختومًا زمنيًا nn-debug-...md في جذر القبو، ثم يتوقف بعد استقرار بدء التشغيل. قد تتم مزامنة الملف إذا تمت مزامنة جذر القبو.
  • البيانات: تتضمن توقيت بدء التشغيل، وإصدار المكون الإضافي، والحد الأدنى من إصدار Obsidian المدعوم، والنظام الأساسي، وعدد مرات التخزين المؤقت، وعدد قوائم الانتظار، وحالة IndexedDB، وأخطاء التشخيص. لا يتضمن محتويات الملاحظات أو أسماء العلامات أو قيم المادة الأمامية أو قائمة بملفات المخزن.
  • المسارات والمعرفات: يمكن أن تتضمن تهيئة بدء التشغيل، وتشخيصات ملف PDF، وحالات الخطأ معرف تطبيق/مخزن Obsidian، أو مسارات PDF النسبية للقبو، أو تفاصيل مكدس الأخطاء. قم بمراجعة الملف وتنقيحه قبل مشاركته بشكل عام.
  • التحميل: لا يقوم Notebook Navigator بتحميل ملفات التصحيح. لا تتم مشاركتها إلا إذا قمت بتحميلها أو إرفاقها أو مزامنتها خارج المكون الإضافي.

10.5 الخصوصية ومعالجة البيانات

  • لا يرسل Notebook Navigator محتوى الملاحظات أو أسماء الملفات أو العلامات أو ملفات التصحيح إلى خادم Notebook Navigator.
  • يتم إجراء الطلبات إلى GitHub وYouTube وأي مضيف صور خارجي مباشرةً من جهازك وتتضمن بيانات HTTP الوصفية القياسية (عنوان IP، ووكيل المستخدم، وما شابه ذلك).
  • يتم تخزين حزم الأيقونات والصور التي تم تنزيلها محليًا (IndexedDB). يتم تخزين الملاحظات/الملفات الحديثة وحالة واجهة المستخدم محليًا (التخزين المحلي Obsidian).

11 نجمة التاريخ

Star History Chart


12 جهة اتصال

تم تصميم Notebook Navigator وصيانته بواسطة يوهان سانبيلاد. يوهان حاصل على درجة الدكتوراه في تطوير البرمجيات وعمل في مجال تطوير الابتكار في شركات مثل Apple و Electronic Arts و Google و Microsoft و Lego و SKF و Volvo Cars و Volvo Group و Yamaha.

لا تتردد في التواصل معي على موقع LinkedIn.


13 سؤالاً أو مشكلة؟

انضم إلى موقعنا Discord للحصول على الدعم والمناقشات، أو افتح مشكلة علىمستودع GitHub.

لا يتم قبول طلبات السحب. مع ظهور نهج البرمجة التفاعلية، لم يعد من الممكن ضمان أن تفي عمليات إرسال الأكواد الخارجية بمعايير الجودة التي يلتزم بها المشروع، لذا يتم إغلاق أي طلب سحب تلقائيًا. يُرجى المساهمة بالأفكار في شكل طلبات ميزات بدلاً من ذلك — قم بفتح تذكرة. راجع ملف CONTRIBUTING.md لمزيد من التفاصيل.


14 رخصة

هذا المشروع مرخّص بموجب رخصة جنو العمومية العامة الإصدار 3.0 - راجع ملف LICENSE للحصول على التفاصيل.