{"id":15178686,"url":"https://github.com/yggdroot/indentline","last_synced_at":"2025-10-01T19:31:00.500Z","repository":{"id":5677223,"uuid":"6887156","full_name":"Yggdroot/indentLine","owner":"Yggdroot","description":"A vim plugin to display the indention levels with thin vertical lines","archived":true,"fork":false,"pushed_at":"2023-07-14T01:57:38.000Z","size":140,"stargazers_count":4149,"open_issues_count":77,"forks_count":229,"subscribers_count":65,"default_branch":"master","last_synced_at":"2024-10-28T05:13:18.325Z","etag":null,"topics":["indentline","vim","vim-plugin"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yggdroot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://github.com/Yggdroot/SponsorMe/blob/main/README.md#donate"]}},"created_at":"2012-11-27T16:52:11.000Z","updated_at":"2024-10-25T11:56:29.000Z","dependencies_parsed_at":"2022-07-14T10:21:33.814Z","dependency_job_id":"e26cf9a4-eb29-4d1d-830a-eabdfb12c1cc","html_url":"https://github.com/Yggdroot/indentLine","commit_stats":{"total_commits":177,"total_committers":53,"mean_commits":3.339622641509434,"dds":"0.44067796610169496","last_synced_commit":"d15d63bf9c4a74a02470d4bc8ecce53df13e3a75"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yggdroot%2FindentLine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yggdroot%2FindentLine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yggdroot%2FindentLine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yggdroot%2FindentLine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yggdroot","download_url":"https://codeload.github.com/Yggdroot/indentLine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234892715,"owners_count":18902907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["indentline","vim","vim-plugin"],"created_at":"2024-09-27T15:21:28.647Z","updated_at":"2025-10-01T19:31:00.172Z","avatar_url":"https://github.com/Yggdroot.png","language":"Vim Script","readme":"indentLine\n==========\n\nThis plugin is used for displaying thin vertical lines at each indentation level for code indented with spaces. For code indented with tabs I think there is no need to support it, because you can use `:set list lcs=tab:\\|\\ (here is a space)`.\n\n## Requirements\nThis plugin takes advantage of the newly provided `conceal` feature in Vim 7.3, so this plugin will not work with lower versions of Vim.\n\nMacOS users: The copy of Vim provided in MacOS may not have the conceal feature enabled (check with `echo has('conceal')`), which will prevent the plugin from loading. To fix this, we recommend using the homebrew version of Vim.\n\n## Installation\nIf you are using VIM version 8 or higher you can use its built-in package management; see `:help packages` for more information. Just run these commands in your terminal:\n```bash\ngit clone https://github.com/Yggdroot/indentLine.git ~/.vim/pack/vendor/start/indentLine\nvim -u NONE -c \"helptags  ~/.vim/pack/vendor/start/indentLine/doc\" -c \"q\"\n```\n\nOtherwise, these are some of the other options:\n\n* To install the plugin just put the plugin files in your `~/.vim` (Linux) or `~/vimfiles` (Windows).\n\n* If you use a plugin manager you can put the whole directory into your `~/.vim/bundle/` directory ([Pathogen][pathogen]) or add the line `Plugin 'Yggdroot/indentLine'` to your `.vimrc` ([Vundle][vundle]).\n\n## Customization\nTo apply customization, apply the variable definitions to your `.vimrc` file.\n\n**Change Character Color**\n\nindentLine will overwrite 'conceal' color with grey by default. If you want to highlight conceal color with your colorscheme, disable by:\n```vim\nlet g:indentLine_setColors = 0\n```\n\nOr you can use the same colors as another highlight group. To use the same colors that are used for tab indents, use the 'SpecialKey' group:\n```vim\nlet g:indentLine_defaultGroup = 'SpecialKey'\n```\n\nOr you can customize conceal color by:\n```vim\n\" Vim\nlet g:indentLine_color_term = 239\n\n\" GVim\nlet g:indentLine_color_gui = '#A4E57E'\n\n\" none X terminal\nlet g:indentLine_color_tty_light = 7 \" (default: 4)\nlet g:indentLine_color_dark = 1 \" (default: 2)\n\n\" Background (Vim, GVim)\nlet g:indentLine_bgcolor_term = 202\nlet g:indentLine_bgcolor_gui = '#FF5F00'\n```\n\n**Change Indent Char**\n\nVim and GVim\n```vim\nlet g:indentLine_char = 'c'\n```\nwhere `'c'` can be any ASCII character. You can also use one of `¦`, `┆`, `│`, `⎸`, or `▏` to display more beautiful lines. However, these characters will only work with files whose encoding is UTF-8.\n\nor\n```vim\nlet g:indentLine_char_list = ['|', '¦', '┆', '┊']\n```\neach indent level has a distinct character.\n\n**Change Conceal Behaviour**\n\nThis plugin enables the Vim `conceal` feature which automatically hides stretches of text based on syntax highlighting. This setting will apply to all syntax items.\n\nFor example, users utilizing the built in json.vim syntax file will no longer see quotation marks in their JSON files\n(see below how to disable conceal for JSON without disabling indentLine).\n\nindentLine will overwrite your \"concealcursor\" and \"conceallevel\" with default value:\n\n```vim\nlet g:indentLine_concealcursor = 'inc'\nlet g:indentLine_conceallevel = 2\n```\n\nYou can customize these settings, but the plugin will not function if `conceallevel` is not set to 1 or 2.\n\nIf you want to keep your conceal setting, put this line to your vim dotfile:\n```vim\nlet g:indentLine_setConceal = 0\n```\n\nSee the [VIM Reference Manual](http://vimdoc.sourceforge.net/htmldoc/version7.html#new-conceal) for more information on the `conceal` feature.\n\n\n**Disabling conceal for JSON and Markdown without disabling indentLine plugin**\n\nEven though this plugin requires conceal to be enabled for it to work, it is\npossible to disable conceal for JSON and Markdown files and still get the\nindentLine plugin to show indent lines for those files.\n\nBuiltin [json.vim](https://github.com/vim/vim/blob/master/runtime/syntax/json.vim)\nand [markdown.vim](https://github.com/vim/vim/blob/master/runtime/syntax/markdown.vim)\nsyntax allow disabling conceal by setting the following vars:\n\n* JSON\n```vim\nlet g:vim_json_conceal=0\n```\n\n* Markdown\n```vim\nlet g:markdown_syntax_conceal=0\n```\n\nIf you use other syntax plugins for those file types, you will need to check\ntheir docs, as they may use different vars or have different ways to configure\nthis.\n\n**Disable by default**\n```vim\nlet g:indentLine_enabled = 0\n```\n\n### Commands\n`:IndentLinesToggle` toggles lines on and off.\n\n### Font patching\nIf you find all the standard unicode and ASCII characters too obtrusive, you might consider patching your font with the [indentLine-dotted-guide.eps][glyph] glyph provided.  [FontForge][fontforge] makes the process amazingly simple:\n\n 1. Download and install FontForge.\n 2. Locate and open your terminal/gVim font.\n 3. Open the font in FontForge, choose __Goto__ from the __View__ menu and select _Private Use Area_ from the drop down box.\n 4. In the private use area, locate a blank spot for the glyph. Make a note of the code, e.g. `U+E0A3`.\n 5. Double-click the selected code point to open the font drawing tool.\n 6. From the __File__ menu, select __Import...__ and locate the _indentLine-dotted-guide.eps_ file.\n 7. Once imported, choose __File__ -\u003e __Generate Fonts__ and choose a location and file type for the new font.\n\nOnce completed, your new font will contain the more subtle dotted guide and all you have to do is set that glyph to `g:indentLine_char` in your `.vimrc` file.\n\n[glyph]: glyph/indentLine-dotted-guide.eps\n[fontforge]: http://fontforge.github.io/\n\n## Self promotion\nIf you think this script is helpful, follow the [GitHub repository][repository], and don't forget to vote for it on Vim.org! ([vimscript #4354][script]).\n\n[pathogen]: https://github.com/tpope/vim-pathogen\n[vundle]: https://github.com/gmarik/vundle\n[repository]: https://github.com/Yggdroot/indentLine\n[script]: http://www.vim.org/scripts/script.php?script_id=4354\n\n## Screenshots\n\n### Vertical bars\n![Screenshot](http://i.imgur.com/KVi0T.jpg)\n\n### Patched font\n![Screenshot](http://i.imgur.com/2ZA7oaZ.png)\n\n### Leading Spaces\n![Screenshot](http://i.imgur.com/tLYkb79.png)\n\n![Screenshot](http://i.imgur.com/07Atrrs.png)\n\n## License\n- MIT\n","funding_links":["https://github.com/Yggdroot/SponsorMe/blob/main/README.md#donate"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyggdroot%2Findentline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyggdroot%2Findentline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyggdroot%2Findentline/lists"}