vimwiki
v2024.01.24
中文
Vimwiki هو wiki شخصية لـ VIM - عدد من الملفات النصية المرتبطة التي لديها تمييز بناء الجملة الخاص بها. انظر Vimwiki Wiki للحصول على موقع مثال على موقع ويب مصمم مع Vimwiki!
إذا كنت مهتمًا بالمساهمة ، فراجع هذا القسم.
مع Vimwiki ، يمكنك:
للقيام ببداية سريعة ، اضغط على <Leader>ww (الافتراضي هو ww ) للانتقال إلى ملف Wiki الفهرس الخاص بك. بشكل افتراضي ، يقع في ~/vimwiki/index.wiki . انظر :h vimwiki_list لتسجيل مسار/ويكي مختلف.
إطعامه مع المثال التالي:
= My knowledge base =
* Tasks -- things to be done _yesterday_!!!
* Project Gutenberg -- good books are power.
* Scratchpad -- various temporary stuff.
ضع المؤشر على Tasks واضغط على Enter لإنشاء رابط. بمجرد الضغط عليها ، ستصبح Tasks [[Tasks]] - رابط Vimwiki. اضغط على Enter مرة أخرى لفتحه. قم بتحرير الملف وحفظه ، ثم اضغط على Backspace للقفز إلى الفهرس.
يمكن بناء رابط Vimwiki من أكثر من كلمة واحدة. فقط حدد بصريًا الكلمات المراد ربطها واضغط على Enter. جربه ، مع Project Gutenberg . يجب أن تبدو النتيجة شيئًا مثل:
= My knowledge base =
* [[Tasks]] -- things to be done _yesterday_!!!
* [[Project Gutenberg]] -- good books are power.
* Scratchpad -- various temporary stuff.
تم اختبار Vimwiki على Vim> = 7.3 . قد تعمل على الإصدارات القديمة ولكن لن يتم دعمها رسميًا. من المعروف أن العمل على Neovim ، على الرغم من أنه من المحتمل أن يكون له أخطاء خاصة Neovim.
تأكد من أن لديك هذه الإعدادات في ملف VIMRC الخاص بك:
set nocompatible
filetype plugin on
syntax onبدونهم ، لن يعمل Vimwiki بشكل صحيح.
git clone https://github.com/vimwiki/vimwiki.git ~ /.vim/pack/plugins/start/vimwiki
# to generate documentation i.e. ':h vimwiki'
vim -c ' helptags ~/.vim/pack/plugins/start/vimwiki/doc ' -c quit
ملحوظات:
:h helptags لمشكلات في تثبيت الوثائق.:h packages cd ~ /.vim
mkdir bundle
cd bundle
git clone https://github.com/vimwiki/vimwiki.git
أضف ما يلي إلى تكوين البرنامج المساعد في VIMRC:
Plug ' vimwiki/vimwiki '
ثم تشغيل :PlugInstall .
أضف Plugin 'vimwiki/vimwiki' إلى ملف VIMRC الخاص بك وتشغيله:
vim +PluginInstall +qall
قم بتنزيل أرشيف الرمز البريدي واستخراجه في ~/.vim/bundle/
ثم قم بتشغيل Vim ، Run :Helptags ثم :help vimwiki للتحقق من تثبيتها.
= Header1 =
== Header2 ==
=== Header3 ===
*bold* -- bold text
_italic_ -- italic text
[[wiki link]] -- wiki link
[[wiki link|description]] -- wiki link with description
* bullet list item 1
- bullet list item 2
- bullet list item 3
* bullet list item 4
* bullet list item 5
* bullet list item 6
* bullet list item 7
- bullet list item 8
- bullet list item 9
1. numbered list item 1
2. numbered list item 2
a) numbered list item 3
b) numbered list item 4
للحصول على عناصر بناء الجملة الأخرى ، انظر :h vimwiki-syntax
- [.] Partially completed item with sub-tasks
- [X] Completed sub-task
- [ ] Incomplete sub-task
- [ ] Other incomplete sub-task
- [ ] Incomplete item
ملاحظة: قد تمنع المحطة الخاصة بك التقاط بعض الروابط الافتراضية المذكورة أدناه. انظر :h vimwiki-local-mappings للحصول على اقتراحات للربط البديل إذا واجهت مشكلة.
<Leader>ww - فتح ملف فهرس الويكي الافتراضي.<Leader>wt - فتح ملف فهرس Wiki الافتراضي في علامة تبويب جديدة.<Leader>ws - حدد وفتح ملف فهرس الويكي.<Leader>wd - حذف ملف wiki الذي أنت فيه.<Leader>wr - إعادة تسمية ملف wiki الذي أنت فيه.<Enter> - اتبع/إنشاء رابط wiki.<Shift-Enter> -تقسيم ومتابعة/إنشاء رابط wiki.<Ctrl-Enter> -تقسيم عمودي ومتابعة/إنشاء رابط wiki.<Backspace> - العودة إلى رابط الوالدين (السابق).<Tab> - ابحث عن رابط الويكي التالي.<Shift-Tab> -ابحث عن رابط الويكي السابق. ارجع إلى الوثائق الكاملة على :h vimwiki-mappings لرؤية العديد من الارتباطات.
:Vimwiki2HTML - تحويل رابط الويكي الحالي إلى HTML.:VimwikiAll2HTML - تحويل جميع روابط wiki الخاصة بك إلى HTML.:help vimwiki-commands قائمة جميع الأوامر.:help vimwiki - General Vimwiki Help Docs. يشحن Vimwiki حاليًا بـ 3 بناء جملة: Vimwiki (افتراضي) ، Markdown (Markdown) ، و MediaWiki (Media). من بين هؤلاء ، يتم دعم بناء جملة Vimwiki الأصلي ، يليه تخفيض. لا يتم تقديم وعود ل MediaWiki.
ملاحظة: فقط بناء الجملة الافتراضي مع محول HTML مدمج. للاطلاع على Marmdown أو MediaWiki ، انظر :h vimwiki-option-custom_wiki2html . بعض الأمثلة وأدوات الطرف الثالث متوفرة هنا.
إذا كنت تفضل استخدام بناء جملة Markdown أو MediaWiki ، فقم بتعيين الخيار التالي في .vimrc :
let g: vimwiki_list = [{ ' path ' : ' ~/vimwiki/ ' ,
' syntax ' : ' markdown ' , ' ext ' : ' md ' }]
سيعامل هذا الخيار جميع ملفات Markdown في نظامك كجزء من Vimwiki (تحقق من set filetype? ). يضيف
let g: vimwiki_global_ext = 0 إلى .vimrc لتقييد عملية Vimwiki على تلك المسارات المدرجة فقط في g:vimwiki_list . لن يتم التعامل مع ملفات Markdown الأخرى كصفحات Wiki. انظر G: vimwiki_global_ext.
إذا كنت ترغب في إيقاف تشغيل الدعم للتمديد الآخر (على سبيل المثال ، تعطيل إنشاء Wiki و Link الجديد عن طريق الخطأ لملفات Markdown العادية) ، قم بتعيين الخيار التالي في .vimrc قبل Packadd Vimwiki:
let g: vimwiki_ext2syntax = {}انظر G: vimiki_ext2syntax
مشكلات GitHub هي الطريقة الأساسية لرفع تقارير الأخطاء أو طلبات الميزات.
موارد إضافية:
لدى Vimwiki الكثير من المستخدمين ولكن عدد قليل جدًا من المطورين المتكررين أو الأشخاص الذين يساعدون المجتمع. لذلك يتم تقدير مساعدتك. يمكن للجميع المساعدة! انظر #625 للحصول على معلومات حول كيفية المساعدة.
أيضًا ، ألق نظرة على المساهمة. md و design_notes.md
رخصة معهد ماساتشوستس للتكنولوجيا
حقوق الطبع والنشر (C) 2008-2010 Maxim Kim 2013-2017 Daniel Schemala
يتم منح الإذن بموجب هذا ، مجانًا ، لأي شخص يحصل على نسخة من هذا البرنامج وملفات الوثائق المرتبطة به ("البرنامج") ، للتعامل في البرنامج دون تقييد ، بما في ذلك على سبيل المثال لا الحصر حقوق استخدام الأشخاص ونسخها ودمجها ودمجها وتوزيعها وتوزيعها على ما يلي:
يجب إدراج إشعار حقوق الطبع والنشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الكبيرة من البرنامج.
يتم توفير البرنامج "كما هو" ، دون أي ضمان من أي نوع ، صريح أو ضمني ، بما في ذلك على سبيل المثال لا الحصر ضمانات القابلية للتسويق واللياقة لغرض معين وعدم الانفجار. لا يجوز بأي حال من الأحوال أن يكون المؤلفون أو حاملي حقوق الطبع والنشر مسؤولاً عن أي مطالبة أو أضرار أو مسؤولية أخرى ، سواء في إجراء عقد أو ضرر أو غير ذلك ، ناشئة عن أو خارج البرنامج أو الاستخدام أو غيرها من المعاملات في البرنامج.
