org roam
v2.2.2
org-roam هو نظام إدارة المعرفة النص العادي. إنه يجلب بعضًا من ميزات Roam الأكثر قوة إلى النظام البيئي الوضع ORG.
يقترض org-roam مبادئ من طريقة Zettelkasten ، مما يوفر حلاً لتوصيل الملاحظات غير الهرمي. يجب أن تعمل أيضًا كحل توصيل ولعب لأي شخص يستخدم بالفعل وضع Org for Wiki الشخصي.
ستجد أدناه تعليمات التثبيت الأساسية لكيفية تثبيت org-roam بسرعة باستخدام بيئات مختلفة لأغراض مختلفة. لمزيد من المعلومات التفصيلية ، يرجى قراءة الدليل.
package.el يمكنك تثبيت org-roam من melpa أو melpa مستقر باستخدام package.el :
M-x package-install RET org-roam RET
straight.el التثبيت من MELPA أو MELPA مستقر باستخدام straight.el :
( straight-use-package 'org-roam ) أو مع use-package :
( use-package org-roam
:straight t
...)إذا كنت بحاجة إلى تثبيت الحزمة مباشرة من مستودع المصدر ، بدلاً من MELPA ، توضح العينة التالية كيفية القيام بذلك:
( use-package org-roam
:straight ( :host github :repo " org-roam/org-roam "
:files ( :defaults " extensions/* " ))
...)إذا كنت تخطط لاستخدام الشوكة المحلية الخاصة بك للتطوير والمساهمة ، فإن العينة التالية ستصل بك إلى هناك:
( use-package org-roam
:straight ( :local-repo " /path/to/org-roam-fork "
:files ( :defaults " extensions/* " )
:build ( :not compile))
...) Doom's :lang org مع دعم لـ org-roam ، ولكن لم يتم تمكينها بشكل افتراضي. لتنشيطها تمرير +roam2 إلى وحدة org في $DOOMDIR/init.el (على سبيل المثال (org +roam2) ) ، احفظ الملف وقم بتشغيل doom sync -u في قشرتك.
لتوفير استقرار أفضل ، دبوس الحزمة لالتزام معين. إذا كنت بحاجة إلى إلغاء وضعه (لا ينصح بذلك ، فاطلب Doom لتصوير الحزمة بدلاً من ذلك) استخدم التالي في packages.el الخاصة بك.
(unpin! org-roam) إذا كنت ترغب في استخدام وصفة مختلفة لـ org-roam لبعض الأسباب ، فيمكنك استخدام النموذج التالي في packages.el الخاصة بك.
(package! org-roam) يمكنك تمرير :pin "commit hash" لعلان الحزمة لالتزام معين.
مع العينة التالية ، يمكنك تثبيت الحزمة مباشرة من مستودع المصدر:
(package! org-roam
:recipe ( :host github :repo " org-roam/org-roam "
:files ( :defaults " extensions/* " )))وإذا كنت تخطط لاستخدام الشوكة المحلية الخاصة بك للتطوير أو المساهمة ، فإن العينة التالية ستجعلك هناك:
(package! org-roam
:recipe ( :local-repo " /path/to/org-roam-fork "
:files ( :defaults " extensions/* " )
:build ( :not compile)))لتثبيت الحزمة دون استخدام مدير الحزمة ، لديك الخيارين التاليين:
git من مستودع المصدر.في كلتا الحالتين ، ستحتاج إلى التأكد من أن لديك جميع التبعيات المطلوبة. وتشمل هذه:
بعد تثبيت الحزمة ، ستحتاج إلى إعداد load-path بشكل صحيح إلى الحزمة:
( add-to-list 'load-path " /path/to/org-roam/ " )
( add-to-list 'load-path " /path/to-org-roam/extensions/ " ) بعد ذلك ، يجب أن تكون قادرًا على حل (require 'org-roam) دون أي مشاكل.
يأتي Org-Roam أيضًا مع ملفات .texi لتكاملها مع نظام المعلومات المدمج لـ emacs. اقرأ الدليل للعثور على مزيد من التفاصيل حول كيفية تثبيتها يدويًا.
إليك عينة أساسية للغاية لتكوين org-roam باستخدام use-package :
( use-package org-roam
:ensure t
:custom
(org-roam-directory ( file-truename " /path/to/org-files/ " ))
:bind (( " C-c n l " . org-roam-buffer-toggle)
( " C-c n f " . org-roam-node-find)
( " C-c n g " . org-roam-graph)
( " C-c n i " . org-roam-node-insert)
( " C-c n c " . org-roam-capture)
; ; Dailies
( " C-c n j " . org-roam-dailies-capture-today))
:config
; ; If you're using a vertical completion framework, you might want a more informative completion interface
( setq org-roam-node-display-template ( concat " ${title:*} " ( propertize " ${tags:10} " 'face 'org-tag )))
(org-roam-db-autosync-mode)
; ; If using org-roam-protocol
( require 'org-roam-protocol )) لاحظ أن وظيفة file-truename ضرورية فقط عند استخدام الرابط الرمزي إلى org-roam-directory . لن يقوم Org-Roam تلقائيًا بحل الرابط الرمزي للدليل.
أنتج David Wilson من System Cafters مقطع فيديو تمهيدي يغطي الأوامر الأساسية:
قبل إنشاء موضوع/مشكلة جديدة ، يرجى أن تكون على دراية بوقتنا والتأكد من أنه لم يتم معالجته بالفعل على Github أو في الخطاب.
للإبلاغ عن الأخطاء واقتراح ميزة جديدة استخدم تعقب المشكلات. إذا كان لديك بعض التعليمات البرمجية التي ترغب في دمجها ، فافتح طلب سحب. يرجى أيضًا رؤية المساهمة.
حقوق الطبع والنشر © Jethro Kuan والمساهمين. تم توزيعه بموجب ترخيص GNU العام ، الإصدار 3.
