Об этом проекте
telescope.nvim — это высокорасширяемый нечёткий поиск по спискам, построенный на основных возможностях Neovim и написанный на Lua. Он ориентирован на модульность и допускает настройку как глобально через setup(), так и для каждого пикера через параметры, передаваемые встроенным функциям.
Требования включают Neovim с LuaJIT и plenary.nvim. Рекомендуемые зависимости: ripgrep (нужен для live_grep и grep_string), fd и nvim-web-devicons для иконок. Для улучшения производительности сортировки рекомендуются нативные сортировщики, такие как telescope-fzf-native.nvim или telescope-fzy-native.nvim. Установка обычно выполняется через фиксацию тега релиза, например с помощью lazy.nvim; после установки советуют запускать :checkhealth telescope.
Плагин предоставляет большой набор встроенных пикеров. Пикеры файлов включают find_files, git_files, grep_string и live_grep. Пикеры Vim охватывают buffers, oldfiles, commands, tags, command_history, search_history, help_tags, man_pages, marks, colorscheme, quickfix, loclist, jumplist, vim_options, registers, autocommands, spell_suggest, keymaps, filetypes, highlights, current_buffer_fuzzy_find, current_buffer_tags, resume и pickers. Пикеры Neovim LSP включают lsp_references, lsp_incoming_calls, lsp_outgoing_calls, lsp_document_symbols, lsp_workspace_symbols, lsp_dynamic_workspace_symbols, diagnostics, lsp_implementations, lsp_definitions и lsp_type_definitions. Git-пикеры включают git_commits, git_bcommits, git_bcommits_range, git_branches, git_status и git_stash. Также есть пикер treesitter и пикеры списков, такие как planets, builtin, reloader и symbols.
Превьюеры предоставляются для файлов, результатов grep и списков quickfix; есть варианты vim_buffer_ с использованием буферов Neovim и подсветкой tree-sitter или regex, а также терминальные варианты, использующие cat или bat. Превьюеры по умолчанию используют vim.filetype для определения типа файла по имени, shebang и modeline. Автокоманда TelescopePreviewerLoaded позволяет настраивать окно предпросмотра для каждого типа файла.
Сортировщики, раскладки и темы настраиваются, а маппинги полностью настраиваются через документированный набор по умолчанию, охватывающий навигацию, выбор, открытие файлов в сплитах или вкладках, прокрутку предпросмотра, переключение мультивыбора, отправку результатов в quickfix и вставку слов из исходного окна в приглашение. Действия можно переназначать или создавать собственные с помощью transform_mod. Расширения поддерживаются через отдельную таблицу конфигурации; проект ведёт вики с примерами, рецептами конфигурации и информацией о расширениях.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.