Tagbar - это плагин VIM, который обеспечивает простой способ просмотреть теги текущего файла и получить обзор его структуры. Это происходит путем создания боковой панели, которая отображает сгенерированные CTAGS теги текущего файла, упорядоченную их сферой. Это означает, что, например, методы в C ++ отображаются под классом, в котором они определены.
Tagbar не является инструментом общего назначения для управления файлами tags . Это создает только те теги, которые ему нужны на лету в памяти, не создавая никаких файлов. Управление файлами tags предоставляется другими плагинами, как, например, Gutentags.
Vim> = 7.3.1058 или любая версия Neovim.
Реализация CTAGS: мы настоятельно рекомендуем любую версию Universal CTAGS. Это поддерживаемая вилка обильных CTAG со многими числами ошибок, поддержкой многих других форматов и правильной поддержкой Unicode.
В некоторой степени обильные CTAGS 5,5 или выше работают, но в конечном итоге будут устареть.
Некоторые дополнительные форматы также могут быть обработаны другими поставщиками, такими как JSCTAGS или PHPCTAG.
Извлеките архив или клонируйте хранилище в каталог в вашем 'runtimepath' или используйте менеджер плагинов по вашему выбору, как патоген. Не забудьте запустить :helptags если ваш менеджер плагинов не делает этого для вас, поэтому вы можете получить доступ к документации с помощью :help tagbar .
Если исполняемый файл CTAGS не установлен в одном из каталогов в вашей переменной среды $PATH , вы должны установить переменную g:tagbar_ctags_bin , см. Документацию для получения дополнительной информации.
Поместите что -то вроде следующего в ~/.vimrc:
nmap <F8> :TagbarToggle <CR> Если вы сделаете это, ключ F8 будет переключать окно Tagbar. Вы, конечно, можете использовать любой ярлык, который вы хотите. Для более гибких способов открыть и закрыть окно (и оставшаяся часть функциональности) см. Документацию с использованием :help tagbar .
Для филетипов, которые не поддерживаются обильными CTAGS, посмотрите вики, чтобы увидеть, предлагают ли другие проекты поддержку для них и как их использовать. Пожалуйста, добавьте любые другие проекты/конфигурации, которые вы найдете или создаете себя, чтобы другие тоже могли извлечь выгоду из них.
Если вы заметили, что есть некоторые ошибки в том, как отображается структура вашего файла в Tagbar, пожалуйста, убедитесь, что ошибка на самом деле находится в Tagbar, прежде чем сообщить о проблеме. Поскольку Tagbar использует обширные CTAGS и совместимые программы для выполнения фактического анализа файлов, вполне вероятно, что вместо этого ошибка на самом деле в программе, ответственной за этот филетип.
Есть пример в :h tagbar-issues о том, как запускать CTAGS вручную, чтобы вы могли определить, где на самом деле есть ошибка. Если ошибка на самом деле находится в CTAGS, пожалуйста, сообщите об этом на их веб -сайте, так как я ничего не могу с этим поделать в Tagbar. Спасибо!
Вы также можете взглянуть на ошибки CTAGS, которые ранее были поданы против Tagbar.
Tagbar распространяется в соответствии с условиями лицензии VIM , см. Включенный файл лицензии.
Тагбар был первоначально написан Яном Ларресом. Это активно поддерживается Калебом Макленнан и Дэвидом Хегланд. По крайней мере, 75 других внесли функции и исправления ошибок за эти годы. Пожалуйста, документируйте проблемы или отправьте запросы на привлечение на GitHub.