atom narrow

ضيق

ضيق شيء.
أداة التنقل رمز مستوحاة من unite.vim ، emacs-helm.
مزيد من المعلومات حول ويكي

ما هذا؟

• توفير تضييق واجهة المستخدم مثل emacs-helm و unite/denite.vim.
• لا تهدف إلى أن تصبح "يمكن فتح أي شيء من حزمة واجهة المستخدم الضيقة.
• التركيز البدائي هو على الكود .
• يقدم مقدم الخدمة عناصر (على سبيل المثال بواسطة ملفات search في المشروع) ، يمكنك تصفية العناصر عن طريق الاستعلام لتضييق نطاقًا أكثر.
• أثناء تحريك المؤشر على المحرر النشط ، يتم مزامنة العنصر الحالي على الضيق التلقائي.
• لم تعد تضيع مثل "أين أنا؟" عندما تعمل على ملفات متعددة.
• دع الضيق ينقل إلى العنصر التالي/السابق للمساعدة في تركيزك.
• قم بتحرير بثقة لعدم النظر عن طريق التحرير المباشر (تحرير على ag search result على المحرر الضيق ثم تطبيق التغييرات على الملف الحقيقي).
• في الاعتبار
  • لوحة مفاتيح الملاحة.
  • تكامل VIM-Mode-Plus (أنا أيضًا مشرف على VIM-Mode-Plus).
• انظر أيضًا Usecase على Wiki و Q&A على هذا المستند

أدوار في اللعب.

• narrow-editor أو narrow-ui : تصفية عناصر عن طريق الاستعلام وتقديم عناصر.
• narrow-provider : توفير العناصر لتضييق.

ملخص

شريط التحكم

مقدمي الخدمات المجمعة

يمكنك التحقق من صور GIF لجميع المزود المجمعة هنا.
يمكنني استخدام scan ، search ، git-diff-all ، symbols في Basis اليومية ، لمقدمي الخدمات الآخرين الذين لا أستخدمهم كثيرًا.

• scan : مسح المحرر الحالي.
• search : ابحث بواسطة ag (تحتاج إلى تثبيت ag بنفسك).
• atom-scan : على غرار search ولكن استخدم Atom's atom.workspace.scan .
• fold : توفير صفوف الظهر للطي كعنصر.
• git-diff-all : أظهر جميع ملف الحالة المعدلة عبر المشروع.
• symbols : توفير رموز للملف الحالي.
• project-symbols : توفير معلومات الرموز على مستوى المشروع عن طريق قراءة ملف tags .

جولة سريعة

لمتابعة هذا السرعة ، لا تحتاج إلى مفتاح مخصص.

Step1. أساسي باستخدام narrow:scan

1. افتح بعض محرر النصوص ، ثم عبر أوامر-PALETTET ، استدعاء Narrow Scan .
2. تم فتح narrow-editor ، والعناصر الأولية هي كل خطوط على المحرر. أثناء الكتابة ، يمكنك تضييق العناصر.
3. عندما تكتب apple كاستعلام. يتم سرد جميع عناصر مطابقة apple .
4. يمكنك تحريك المفتاح العادي up أو down (أو j ، k في وضع القراءة فقط) إلى عناصر الحفر السريع.
5. enter للتأكيد. عند تأكيد ، أغلقت narrow-editor .

يتم تمكين وضع القراءة فقط افتراضيًا.

Step2. التنقل من خارج narrow-editor .

1. افتح بعض محرر النصوص ، ثم عبر أوامر-PALETTET ، استدعاء Narrow Scan .
2. افتتح narrow-editor . أثناء الكتابة ، يمكنك تضييق العناصر.
3. انقر فوق "استدعاء المحرر". وشاهد الموضع الذي تم النقر عليه narrow-editor تلقائيًا.
4. ctrl-cmd-n للانتقال إلى next-item ، ctrl-cmd-p للانتقال إلى previous-item .

• إذا كنت مستخدمًا لـ VIM-Mode-Plus ، فيمكنك استخدام tab و shift-tab .

5. يمكنك إغلاق narrow-editor بواسطة ctrl-g (لا حاجة إلى التركيز على narrow-editor ).
6. إذا كنت ترغب في تغيير المساعدين الضيقة ، فيجب عليك التركيز على narrow-editor

• استخدم ctrl-cmd-f ( narrow:focus ) لتركيز narrow-editor .
• استخدم ctrl-cmd-i ( narrow:focus-prompt ) للتركيز مباشرة على صف الاستعلام الضيق المحرر.
• كلا الأوامر متاح من الخارج/داخل المحرر الضيق.

7. تتوفر مفاتيح التنقل هذه لجميع المزود (على سبيل المثال search ، fold الخ).

Step3. تحرير مباشر

الحمير المباشرة "تحرير على narrow-editor ثم حفظ إلى الملف الحقيقي".
متاح لمقدمي الخدمات التالية.

• scan
• search
• atom-scan

️ هذه العملية خطيرة ، حيث يمكنك تحديث ملفات متعددة مرة واحدة. ️ يجب أن تكون حذراً بما يكفي لاستخدام هذه الميزة ، لا تستخدم هذه دون فهم ما تفعله. ️ أستطيع أن أقول آسف ، لكن لا يمكنني استرداد الملف لك.

1. افتح الملف من المشروع ، Place Lucsor للحصول على اسم متغير hello
2. ثم استدعاء Narrow Search By Current Word .
3. تظهر جميع عناصر مطابقة hello على محرر ضيق.
4. إذا كنت تريد ، يمكنك زيادة الضيق عن طريق الاستعلام.
5. ثم تحرير نص المحرر الضيق مباشرة .

• مكان المؤشر على hello . ثم ctrl-cmd-g ( find-and-replace:select-all ) ، ثم اكتب world .

6. استدعاء Narrow Ui: Update Real File من أوامر palette.
7. تم تنفيذ التغييرات التي أجريتها على عناصر المحرر الضيقة على الملف الحقيقي (وحفظها).
8. يمكنك التراجع عن التغييرات عن طريق إعادة تحرير العناصر على المحرر الضيق وإعادة تطبيق التغييرات بواسطة Narrow Ui: Update Real File .

Step4. [تجريبي] البحث عن الكلمة الرئيسية بالماوس

1. اضبط Search.startByDoubleClick إلى true من Settings-View.
2. انقر نقرًا مزدوجًا فوق الكلمة الرئيسية في المحرر.
3. في كل مرة تنقر فيها على النقر المزدوج على كلمة رئيسية ، يتم فتح محرر ضيق جديد ويتم استبدال Old One.
4. يمكنك متابعة النقر المزدوج أي محرر ضيق أو محرر عادي.

الأوامر

متوفر في جميع محرر النصوص

آخر

• narrow:focus : ( ctrl-cmd-f ) التركيز على narrow-editor ، إذا تم تنفيذه في narrow-editor ، فإنه يعيد التركيز على المحرر الأصلي.
• narrow:focus-prompt : ( ctrl-cmd-i ) يركز على موجه إدخال الاستعلام narrow-editor ، إذا تم تنفيذه في narrow-editor ، فإنه يعيد التركيز على المحرر الأصلي.
• narrow:refresh : تحديث العناصر يدويًا في narrow-editor .
• narrow:close : ( ctrl-g ) ، تم فتح narrow-editor حاليًا في وقت واحد.
• narrow:next-item : ( ctrl-cmd-n ) نقل المؤشر إلى وضع العنصر التالي.
• narrow:previous-item : ( ctrl-cmd-p ) نقل المؤشر إلى وضع العنصر السابق.
• narrow:reopen : (لا يوجد مفتاح افتراضي) إعادة فتح محرر ضيق مغلق حتى 10 مغلق حديث.
• narrow:query-current-word : ( ctrl-cmd-e ) استبدل استعلام narrow-editor النشط بكلمة المؤشر.
• narrow:previous-query-history : ( ctrl-cmd-[ ) استبدل استعلام narrow-editor النشط مع إدخال التاريخ السابق.
• narrow:next-query-history : ( ctrl-cmd-] ) استبدل استعلام narrow-editor النشط مع إدخال التاريخ التالي.

استدعاء توفير ضيق

لا يتم توفير keymaps

• narrow:scan
• narrow:scan-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search : Ag Search. تحتاج إلى التثبيت بنفك.
• narrow:search-by-current-word
• narrow:search-current-project
• narrow:search-current-project-by-current-word
• narrow:atom-scan
• narrow:atom-scan-by-current-word
• narrow:symbols
• narrow:symbols-by-current-word
• narrow:project-symbols :
• narrow:project-symbols-by-current-word :
• narrow:git-diff-all

متوفر في محرر ضيق (ضيق UI)

يعني !vmp
إذا كنت ترغب في استخدام هذه المفاتيح مع vim-mode-plus ، فقم بتعيينها بنفسك.
انظر ويكي

• core:confirm : ( enter ) إغلاق narrow-editor
• narrow-ui:confirm-keep-open : الحفاظ على narrow-editor مفتوح
• narrow-ui:open-here : عنصر مفتوح في نفس جزء من جزء UI's.
• narrow-ui:preview-item : معاينة العنصر المحدد حاليًا يدويًا (لا تحتاج في معظم الحالات).
• narrow-ui:preview-next-item : ( tab ) معاينة العنصر التالي دون تحريك المؤشر من موجه استعلام narrow-editor .
• narrow-ui:preview-previous-item : ( shift-tab ) معاينة العنصر التالي دون تحريك المؤشر من موجه استعلام narrow-editor .
• narrow-ui:toggle-auto-preview : ( ctrl-r للمستخدم غير الوضع غير الفضائي) تعطيل/تمكين المقرر التلقائي لهذا narrow-editor .
• narrow-ui:move-to-prompt : ctrl-cmd-i
• narrow-ui:stop-insert : escape
• narrow-ui:update-real-file : تطبيق التغييرات التي تم إجراؤها في narrow-editor على الملف الحقيقي. (تحرير في narrow-editor ثم احفظه على ملف حقيقي.)
• narrow-ui:protect : لا keymap بشكل افتراضي ، حماية المحرر الضيق من تدميره بواسطة narrow:close ( ctrl-g ).
• narrow-ui:exclude-file : backspace ، استبعاد العناصر التي تتطابق مع FilePath من العنصر المحدد حاليًا.
• narrow-ui:clear-excluded-files : ctrl-backspace ، قائمة ملفات مستبعدة واضحة.
• narrow-ui:select-files : cmd-backspace ، حدد بشكل تفاعلي عناصر FilePath التي ستظهر على narrow-editor .
• narrow-ui:toggle-search-whole-word : alt-cmd-w
• narrow-ui:toggle-search-ignore-case : alt-cmd-c
• narrow-ui:toggle-search-use-regex : alt-cmd-/
• narrow-ui:start-insert : I ( !vmp ) ، a ( !vmp )
• narrow-ui:move-to-next-file-item : n ( !vmp )
• narrow-ui:move-to-previous-file-item : p ( !vmp )
• narrow-ui:relocate : لا يوجد مفتاح المفتاح افتراضيًا ، حيث تم فتح واجهة المستخدم بين مساحة العمل center و Dock bottom .

Keymaps

لا يوجد Keymap لاستدعاء مزود ضيق (على سبيل المثال narrow:scan ).
ابدأها من أوامر palette أو تعيين keymap في keymap.cson .

️ لم يتم تسوية Keymap الافتراضي بعد ، فمن المحتمل أن يتغير هذا في الإصدار المستقبلي.

keymap (مستخدم VIM-mode-plus) والتكوين

config.cson

  narrow :
    SelectFiles :
      rememberQuery : true
    confirmOnUpdateRealFile : false 

keymap.cson

شرح keymap بلدي.

• cmd-f : التركيز على محرر ضيقة وتركيز على المحرر الأصلي
• cmd-i : التركيز على تضييق نطاق موجه ومحرر محرر للمحرر الأصلي
• cmd-e :
  • عندما لا يكون للمساحة narrow-edior في مساحة العمل: ابدأ narrow:search-by-current-word .
  • عندما يكون لدى مساحة العمل واحدة على الأقل narrow-edior واحدة: query-current-word (بشكل افتراضي keymap).
    • استبدل استعلام النشط narrow-edior مع مؤشر كلمة.
• cmd-[ : narrow:previous-query-history استدعاء التاريخ السابق
• cmd-] : narrow:next-query-history ، أذكر التاريخ التالي
• ctrl-g : إغلاق narrow-editor من أي مكان.
• tab ، shift-tab : للانتقال إلى العنصر التالي/السابق.
• ; : تأكيد العنصر الحالي دون إغلاق narrow-editor ، يمكنني إغلاق narrow-editor بواسطة ctrl-g .

 # From outside of narrow-editor
# -------------------------

# `cmd-e` start `search-by-current-word` only when workspace does NOT have `narrow-editor`.
# NOTE: When workspace.has-narrow, `cmd-e` is mapped to `query-current-word` by default.
' atom-workspace:not(.has-narrow) atom-text-editor.vim-mode-plus:not(.insert-mode) ' :
  ' cmd-e ' : ' narrow:search-by-current-word '

' atom-text-editor.vim-mode-plus:not(.insert-mode) ' :
  ' ctrl-z ' :      ' narrow:reopen '
  ' space f ' :     ' narrow:fold '
  ' cmd-o ' :       ' narrow:symbols-by-current-word '
  ' cmd-shift-o ' : ' narrow:project-symbols-by-current-word '
  ' cmd-r ' :       ' narrow:symbols ' # Override default cmd-r
  ' cmd-shift-r ' : ' narrow:project-symbols ' # Override default cmd-shift-r
  ' space l ' :     ' narrow:scan '
  ' cmd-l ' :       ' narrow:scan-by-current-word '
  ' space s ' :     ' narrow:search '
  ' space G ' :     ' narrow:git-diff-all '

# When workspace has narrow-editor
' atom-workspace.has-narrow atom-text-editor.vim-mode-plus.normal-mode ' :
  ' cmd-f ' : ' narrow:focus ' # focus to narrow-editor
  ' cmd-i ' : ' narrow:focus-prompt ' # focus to prompt of narrow-editor

  # Following three command have ctrl- prefixed by default to avoid conflicts.
  # But I don' care conflict, prefer more accessible keymap.
  ' cmd-[ ' : ' narrow:previous-query-history '
  ' cmd-] ' : ' narrow:next-query-history '
  ' cmd-e ' : ' narrow:query-current-word '

# narrow-editor regardless of mode of vim
' atom-text-editor.narrow.narrow-editor[data-grammar="source narrow"] ' :
  ' cmd-f ' : ' narrow:focus '
  ' cmd-i ' : ' narrow:focus-prompt ' # cmd-i to return to calling editor.

  # Danger: apply change on narrow-editor to real file by `cmd-s`.
  ' cmd-s ' : ' narrow-ui:update-real-file '

  # Move ui in between bottom dock and center workspace.
  ' cmd-t ' : ' narrow-ui:relocate '

' atom-workspace.has-narrow atom-text-editor.vim-mode-plus.normal-mode,
  atom-workspace.has-narrow atom-text-editor.vim-mode-plus.visual-mode ' :
    ' cmd-e ' : ' narrow:query-current-word ' # set current word as query of active ui.

' atom-text-editor.narrow.narrow-editor.vim-mode-plus.normal-mode ' :
  ' g g ' : ' narrow-ui:move-to-prompt '
  ' s ' : ' narrow-ui:select-files '
  ' ; ' : ' narrow-ui:confirm-keep-open '
  ' n ' : ' narrow-ui:move-to-next-file-item '
  ' p ' : ' narrow-ui:move-to-previous-file-item '

التكوين الموصى به للحزم الأخرى.

• قم بقمع النوافذ المنبثقة في الإكمال التلقائي على محرر ضيق
• قم بتعطيل البحث المميز في VIM-Mode-Plus على المحرر الضيق

 " * " :
  " autocomplete-plus " :
    suppressActivationForEditorClasses : [
      # snip
      " narrow "
    ]
  # snip
  " vim-mode-plus " :
    highlightSearchExcludeScopes : [
      " narrow "
    ]

ملاحظات لمستخدم VIM-Mode-Plus

️ القيد: للتوافق مع VIM-mode-plus.

• إذا كنت تستخدم Atom v1.16.0 أو أكبر ،
  • لا تمكّن vim-mode-plus.automaticallyEscapeInsertModeOnActivePaneItemChange
  • إذا قمت بتمكينه ، فإن كل إدخال استعلام على محرر ضيق لمزود search يسبب وضع وضع insert-mode إلى normal-mode .
• إذا كنت تستخدم Atom v1.17.0 أو أكبر (حاليًا في الإصدار التجريبي).
  • هذا القيد لم يعد موجودًا.

keymap

تعلم keymap المتاحة كما الافتراضي.
على سبيل المثال ، يمكنك الانتقال إلى العنصر التالي أو السابق بحلول tab ، shift-tab (لكي يعمل هذا ، فأنت بحاجة إلى vim-mode-plus v0.81.0 أو أحدث).

ابدأ الضيق من شكل البحث عن مصلح VIM-Mode-Plus

إذا كنت مستخدمًا في VIM-Mode-Plus. يتوفر الأمر التالي من محرر Mini-Imiator ( / أو ? ).

• vim-mode-plus-user:narrow:scan
• vim-mode-plus-user:narrow:search
• vim-mode-plus-user:narrow:search-current-project
• vim-mode-plus-user:narrow:atom-scan

كيفية تحرير منطقة البند للتحرير المباشر.

• في المحرر الضيق ، i ، a مؤشر نقل normal-mode إلى خط المطالبة.
• لذلك عندما ترغب في تحرير العناصر نفسها من أجل direct-edit update-real-file استخدم مفتاحًا آخر لإدخال insert-mode .
• I تعييني عمداً إلى vim-mode-plus:activate-insert-mode الذي يتم تعيينه عادة إلى i .
  • والتي قد لا تكون بديهية ، لكني أريد أن تجعل تحديث العناصر صعبًا. لذلك يجب على المستخدم كتابة I .
• بخلاف I ، يمكنك البدء insert-mode A ، c ، إلخ ..

سؤال وجواب

ما هي مقدمي الخدمات التي تستخدمها بجدية؟

في التحرير اليومي ، أنا أستخدم.

scan ، search ، git-diff-all ، symbols .

لماذا لا أستخدم الآخرين؟ السبب هنا.

• fold : لأنه يشبه symbols .
• atom-scan : يتم توفيره لمستخدم Windows الذي لا يمكنه استخدام search (Need ag أو rg ).

لاحظت أنه يمكنني إغلاق narrow-editor بواسطة cmd-w العادي ( core:close ). لماذا أحتاج narrow:close ؟ ما الفرق؟

الفرق الأكبر هو narrow:close Restore Editor State (Scrolltop ، Fold ، Active pane item) إذا كان المستخدم قد قام فقط preview من بدء التشغيل.

• narrow:close : إغلاق narrow-editor واستعادة المحرر عندما يكون ذلك مناسبًا. يمكن أيضًا إغلاق narrow-editor بغض النظر عن المحرر النشط الحالي.
• core:close : فقط تدمير narrow-editor .

استخدم أيهما تريد وفقًا لذلك. عادةً ما أستخدمها narrow:close وأحيانًا استخدم core:close مثلما أرغب في التركيز على عنصر في الجزء التالي من narrow-editor (لذلك لا تريد استعادة التركيز إلى محرر ضيقة مبدأ).

كيف يمكنني استبعاد ملف معين من narrow:search

استخدم backspace على العنصر

• استخدم backspace لاستبعاد ملف معين من النتيجة.
• ctrl-backspace قائمة ملفات واضحة
• هذه المفاتيح متوفرة في narrow-editor وأنت في read-only-mode

استخدم مزود select-files

• يمكنك إطلاق select-files بواسطة cmd-backspace أو النقر فوق folder-icon على شريط التحكم .

1. editor البحث عن طريق narrow:search ، ترى الكثير من العناصر editor المكررة
2. لكنك تريد استبعاد العناصر في ملف Markdown؟

• قم بتشغيل select-files ، يتم سرد جميع مسارات الملفات كعنصر.
• ثم اكتب md على الاستعلام ، ترى Marmdown FilePath أن Macheed md .
• ثم أضف ! ، الآن استفسارك هو md! ، يتم التعامل مع هذا لأن جميع الملفات لا تتطابق مع md .
• enter للتأكيد.

3. ترى عناصر مع عناصر في ملفات Markdown يتم استبعادها.
4. يمكنك إعادة إدخال الملفات لاستبعادها بإعادة إطلاق select-files .

• على سبيل المثال ، لاستبعاد مجلد spec ، يمكنك إضافة spec/! كاستعلام.
• على سبيل المثال لتضمين ملف .js فقط ، يمكنك تعيين استعلام على .js .

تريد أن تتخطى next-file ، previous-file

• استخدم n ، p في وضع read-only .

أريد narrow:symbols دائمًا في جزء يمينًا ولا تريد الإغلاق.

1. افتح narrow:symbols (أو ربما تريد استخدام narrow:fold )
2. حرك هذا narrow-editor عن طريق السحب والإسقاط إلى المكان الذي تريده.
3. من أوامر palette ، قم بتنفيذ Narrow Ui: Protect . الآن narrow-editor محمي.
4. لم يتم إغلاق narrow-editor المحمي بواسطة ctrl-g ( narrow:close ) ، وليس مغلقًا بواسطة التأكيد بواسطة enter .
5. للإغلاق ، استخدم زر cmd-w العادي أو إغلاق في علامة التبويب.