harpoon

⇁ هاربون 2

هذا مهمل وجميع التغييرات المستقبلية ستكون على الفرع harpoon2 .

الحربة 2

الحالة : الدمج في الخط الرئيسي في 20 أبريل أو 9 يونيو (لطيف)

---

التمهيدي للحربة القديمة

الحربة

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

- الصورة مقدمة من بوب روست

⇁ العمل قيد التقدم

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

⇁ المشاكل:

1. أنت تعمل على قاعدة التعليمات البرمجية. متوسطة، كبيرة، صغيرة، أيا كان. تجد نفسك تتكرر مع مجموعة صغيرة من الملفات وقد سئمت من استخدام مكتشف غامض، :bnext & :bprev أصبحت متكررة للغاية، والملف البديل لا يقطعها تمامًا، وما إلى ذلك.
2. تريد تنفيذ بعض الأوامر الخاصة بالمشروع أو أن يكون لديك أي عدد من المحطات الطرفية المستمرة التي يمكن التنقل إليها بسهولة.

⇁ الحلول:

1. القدرة على التحديد، أو وضع علامات سريعة، وإنشاء ضغطات مفاتيح مستمرة للانتقال إلى الملفات التي تريدها.
2. محطات وملاحة غير محدودة.

⇁ التثبيت

• نيوفيم 0.5.0+ مطلوب
• التثبيت باستخدام مدير المكونات الإضافية المفضل لديك ( vim-plug في هذا المثال)

Plug ' nvim-lua/plenary.nvim ' " don't forget to add this one if you don't have it yet!
Plug ' ThePrimeagen/harpoon ' 

⇁ الحربة

سنشرح هنا كيفية استخدام قوة الحربة:

ماركس

يمكنك وضع علامة على الملفات التي تريد العودة إليها لاحقًا

: lua require ( " harpoon.mark " ). add_file ()

التنقل في الملفات

عرض كافة علامات المشروع مع:

: lua require ( " harpoon.ui " ). toggle_quick_menu ()

يمكنك الانتقال إلى أعلى وأسفل القائمة أو الدخول أو الحذف أو إعادة الترتيب. q و <ESC> يخرجان ويحفظان القائمة

يمكنك أيضًا التبديل إلى أي علامة دون إظهار القائمة، استخدم ما يلي مع فهرس العلامات المطلوب

: lua require ( " harpoon.ui " ). nav_file ( 3 )                  -- navigates to file 3

يمكنك أيضًا تدوير القائمة في كلا الاتجاهين

: lua require ( " harpoon.ui " ). nav_next ()                   -- navigates to next mark
: lua require ( " harpoon.ui " ). nav_prev ()                   -- navigates to previous mark

من القائمة السريعة، افتح ملفًا في: تقسيم عمودي باستخدام control+v، تقسيم أفقي باستخدام control+x، علامة تبويب جديدة باستخدام control+t

الملاحة الطرفية

يعمل هذا مثل التنقل بين الملفات باستثناء أنه في حالة عدم وجود محطة طرفية في الفهرس المحدد، يتم إنشاء محطة طرفية جديدة.

 lua require ( " harpoon.term " ). gotoTerminal ( 1 )             -- navigates to term 1

أوامر إلى المحطات الطرفية

يمكن إرسال الأوامر إلى أي محطة

 lua require ( " harpoon.term " ). sendCommand ( 1 , " ls -La " )    -- sends ls -La to tmux window 1

يمكن تخزين المزيد من الأوامر لوقت لاحق بسرعة

 lua require ( ' harpoon.cmd-ui ' ). toggle_quick_menu ()       -- shows the commands menu
lua require ( " harpoon.term " ). sendCommand ( 1 , 1 )           -- sends command 1 to term 1

دعم تموكس

يتم دعم tmux خارج الصندوق ويمكن استخدامه كبديل مباشر للأجهزة الطرفية العادية بمجرد تبديل 'term' with 'tmux' مثل ذلك

 lua require ( " harpoon.tmux " ). gotoTerminal ( 1 )             -- goes to the first tmux window
lua require ( " harpoon.tmux " ). sendCommand ( 1 , " ls -La " )    -- sends ls -La to tmux window 1
lua require ( " harpoon.tmux " ). sendCommand ( 1 , 1 )           -- sends command 1 to tmux window 1

يقبل sendCommand و goToTerminal أيضًا أي معرف جزء tmux صالح.

 lua require ( " harpoon.tmux " ). gotoTerminal ( " {down-of} " )   -- focus the pane directly below
lua require ( " harpoon.tmux " ). sendCommand ( " %3 " , " ls " )     -- send a command to the pane with id '%3'

بمجرد التبديل إلى نافذة tmux، يمكنك دائمًا التبديل مرة أخرى إلى neovim، وهو برنامج نصي bash صغير سيتحول إلى النافذة التي تقوم بتشغيل neovim.

في tmux.conf (أو في أي مكان لديك روابط مفاتيح)، قم بإضافة هذا

bind-key -r G run-shell " path-to-harpoon/harpoon/scripts/tmux/switch-back-to-nvim "

دعم التلسكوب

قم أولاً بتسجيل الحربة كامتداد للتلسكوب

 require ( " telescope " ). load_extension ( ' harpoon ' )

حاليًا يتم دعم العلامات فقط في التلسكوب

 :Telescope harpoon marks

⇁ التكوين

إذا كان تكوين الحربة أمرًا مرغوبًا فيه، فيجب أن يتم ذلك من خلال وظيفة إعداد الحربة

 require ( " harpoon " ). setup ({ ... })

الإعدادات العالمية

إليك جميع الإعدادات العامة المتاحة مع قيمها الافتراضية

 global_settings = {
    -- sets the marks upon calling `toggle` on the ui, instead of require `:w`.
    save_on_toggle = false ,

    -- saves the harpoon file upon every change. disabling is unrecommended.
    save_on_change = true ,

    -- sets harpoon to run the command immediately as it's passed to the terminal when calling `sendCommand`.
    enter_on_sendcmd = false ,

    -- closes any tmux windows harpoon that harpoon creates when you close Neovim.
    tmux_autoclose_windows = false ,

    -- filetypes that you want to prevent from adding to the harpoon list menu.
    excluded_filetypes = { " harpoon " },

    -- set marks specific to each git branch inside git repository
    mark_branch = false ,

    -- enable tabline with harpoon marks
    tabline = false ,
    tabline_prefix = "   " ,
    tabline_suffix = "   " ,
}

أوامر المحطة الطرفية التي تم تكوينها مسبقًا

لتكوين الأوامر الطرفية مسبقًا لاستخدامها لاحقًا

 projects = {
    -- Yes $HOME works
    [ " $HOME/personal/vim-with-me/server " ] = {
        term = {
            cmds = {
                " ./env && npx ts-node src/index.ts "
            }
        }
    }
}

⇁ التسجيل

• تتم كتابة السجلات إلى harpoon.log داخل مسار ذاكرة التخزين المؤقت nvim ( :echo stdpath("cache") )
• مستويات السجل المتاحة هي trace أو debug أو info أو warn أو error أو fatal . warn هو الافتراضي
• يمكن ضبط مستوى السجل باستخدام vim.g.harpoon_log_level (يجب أن يكون قبل setup() )
• إطلاق nvim باستخدام HARPOON_LOG=debug nvim له الأسبقية على vim.g.harpoon_log_level .
• القيم الافتراضية غير الصالحة تعود warn .

⇁ أخرى

كيف تختلف علامات Harpoon عن العلامات العالمية vim

إنها تخدم غرضًا مشابهًا، إلا أن علامات الحربة تختلف بعدة طرق رئيسية:

1. يقومون تلقائيًا بتحديث موقعهم داخل الملف
2. يتم حفظها لكل مشروع .
3. يمكن تحريرها يدويًا مقابل استبدالها (التبديل أسهل)

الدافع وراء محطات هاربون

1. أرغب في استخدام الجهاز حيث يمكنني gF وgF معالجة أي أخطاء ناشئة عن التنفيذ داخل الجهاز والتي لا تتناسب مع شيء مثل الإرسال. (ليس فقط إجراء الاختبارات ولكن ربما خادم يعمل لمدة X من الوقت قبل أن يتعطل).
2. أريد أن يكون الجهاز ثابتًا ويمكنني العودة إلى أحد المحطات العديدة باستخدام بعض تقنيات الإصبع وإعادة تحليل أي من معلومات التنفيذ التي لم تكن بالضرورة مرتبطة بالخطأ.
3. أرغب في الحصول على أوامر يمكن ربطها بالمحطات الطرفية وإرسالها دون الكثير من التفكير. نوع من الحل الوسط بين اختبار vim وكتابتها فقط في محطة طرفية (تكوين مشروع تلفزيون netflix لا يتم تطويره تمامًا وهناك العديد من الطرق للتكوين).

استخدم عرضًا ديناميكيًا لقائمة Harpoon المنبثقة

في بعض الأحيان، لا يكون العرض الافتراضي البالغ 60 عريضًا بدرجة كافية. يوضح المثال التالي كيفية تكوين عرض مخصص عن طريق تعيين عرض القائمة بالنسبة لعرض النافذة الحالية.

 require ( " harpoon " ). setup ({
    menu = {
        width = vim . api . nvim_win_get_width ( 0 ) - 4 ,
    }
})

جدول

افتراضيًا، سيستخدم سطر الجدول السمة الافتراضية لموضوعك. يمكنك التخصيص عن طريق تحرير النقاط البارزة التالية:

• HarpoonInactive
• HarpoonActive
• HarpoonNumberActive
• HarpoonNumberInactive

مثال لجعله أكثر نظافة:

 vim . cmd ( ' highlight! HarpoonInactive guibg=NONE guifg=#63698c ' )
vim . cmd ( ' highlight! HarpoonActive guibg=NONE guifg=white ' )
vim . cmd ( ' highlight! HarpoonNumberActive guibg=NONE guifg=#7aa2f7 ' )
vim . cmd ( ' highlight! HarpoonNumberInactive guibg=NONE guifg=#7aa2f7 ' )
vim . cmd ( ' highlight! TabLineFill guibg=NONE guifg=white ' )

نتيجة:

⇁ الاجتماعية

للأسئلة حول Harpoon، هناك قناة #harpoon على خادم Primeagen's Discord.

• الفتنة
• نشل
• تغريد