{"id":13477300,"url":"https://github.com/Valloric/MatchTagAlways","last_synced_at":"2025-03-27T05:31:22.450Z","repository":{"id":4583757,"uuid":"5725745","full_name":"Valloric/MatchTagAlways","owner":"Valloric","description":"A Vim plugin that always highlights the enclosing html/xml tags","archived":false,"fork":false,"pushed_at":"2024-03-28T19:17:23.000Z","size":494,"stargazers_count":540,"open_issues_count":21,"forks_count":24,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-10-13T10:21:03.907Z","etag":null,"topics":["html","syntax-highlighting","vim","xml"],"latest_commit_sha":null,"homepage":"http://valloric.github.com/MatchTagAlways/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Valloric.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-09-08T05:19:00.000Z","updated_at":"2024-09-21T21:02:13.000Z","dependencies_parsed_at":"2024-10-13T10:21:00.500Z","dependency_job_id":null,"html_url":"https://github.com/Valloric/MatchTagAlways","commit_stats":{"total_commits":38,"total_committers":10,"mean_commits":3.8,"dds":0.2894736842105263,"last_synced_commit":"352eb479a4ad1608e0880b79ab2357aac2cf4bed"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Valloric%2FMatchTagAlways","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Valloric%2FMatchTagAlways/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Valloric%2FMatchTagAlways/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Valloric%2FMatchTagAlways/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Valloric","download_url":"https://codeload.github.com/Valloric/MatchTagAlways/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245791478,"owners_count":20672665,"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":["html","syntax-highlighting","vim","xml"],"created_at":"2024-07-31T16:01:40.797Z","updated_at":"2025-03-27T05:31:21.913Z","avatar_url":"https://github.com/Valloric.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Always highlight enclosing tags\n\n[![Build Status](https://travis-ci.org/Valloric/MatchTagAlways.svg?branch=master)](https://travis-ci.org/Valloric/MatchTagAlways)\n\nThe MatchTagAlways.vim (MTA) plug-in for the [Vim text editor][vim] always\nhighlights the XML/HTML tags that enclose your cursor location. It's probably\neasiest to describe with a screenshot:\n\n![MatchTagAlways screen shot](http://i.imgur.com/qAf0N.gif)\n\nIt even works with HTML templating languages like Jinja or HTML5 use-cases\nlike unclosed tags. It's pretty smart and should do the right thing in most\ncases. If it doesn't, report the problem on the [issue tracker][tracker]!\n\n## Installation\n\nUse [Vundle][vundle] to install the plugin. You _are_ using Vundle to manage\nyour Vim plugins, right? [Pathogen][pathogen] works fine too (but I recommend\nVundle).\n\nNote that the plugin requires that your copy of Vim is compiled with Python\nsupport. You can check for this with `:echo has('python')` in Vim. If the output\nis `1`, then you have Python support.\n\nAfter installation you should be done. The plugin should be plug \u0026 play. It will\nautomatically turn itself on for HTML, XML and a few other HTML-like filetypes.\nYou can also explicitly turn it on for other filetypes too (more details in the\nOptions section).\n\n## Options\n\nAll options have reasonable defaults so if the plug-in works after installation\nyou don't need to change any options. These options can be configured in your\n[vimrc script] [vimrc] by including a line like this:\n\n    let g:mta_use_matchparen_group = 1\n\nNote that after changing an option in your [vimrc script] [vimrc] you have to\nrestart Vim for the changes to take effect.\n\n### The `g:mta_filetypes` option\n\nThis option holds all the filetypes for which this plugin will try to find and\nhighlight enclosing tags. It's a Vim dictionary with keys being Vim filetypes.\nThe values set for those keys don't matter and are not checked, the only thing\nthat matters is that a key is present in the dictionary (VimL has no sets).\n\nYou can find out what the current file's filetype is in Vim with `:set ft?`.\nDon't forget that question mark at the end!\n\nDefault: `{ 'html' : 1, 'xhtml' : 1, 'xml' : 1, 'jinja' : 1 }`\n\n    let g:mta_filetypes = {\n        \\ 'html' : 1,\n        \\ 'xhtml' : 1,\n        \\ 'xml' : 1,\n        \\ 'jinja' : 1,\n        \\}\n\n### The `g:mta_use_matchparen_group` option\n\nWhen set to 1, forces the use of the [MatchParen][matchparen] syntax group. This\nis the same group that Vim uses to highlight parens, braces etc. This option is\nuseful for people who want to use the same highlight color for both constructs.\n\nWhen set to 0, MTA will use a custom `MatchTag` syntax group with a default\nhighlight color. See the `g:mta_set_default_matchtag_color` option for\ninstructions on how to change that color.\n\nBy default, this option is set to 1 because this makes it very unlikely that\nyour colorscheme will conflict with the default colors used for the `MatchTag`\ngroup. It's the safe choice. Feel free to toggle this option to 0 (the author\nuses it like this).\n\nDefault: `1`\n\n    let g:mta_use_matchparen_group = 1\n\n### The `g:mta_set_default_matchtag_color` option\n\nThis option only makes sense when `g:mta_use_matchparen_group` is set to 0. When\nit is, `g:mta_set_default_matchtag_color` option can be used to prevent MTA from\noverwriting any color you have set for the `MatchTag` group.\n\nSo, if you want to use a custom color for tag highlighting, have both\n`g:mta_use_matchparen_group` and `g:mta_set_default_matchtag_color` set to 0 and\nthen set a custom color for `MatchTag` in your `vimrc`. For example, the\nfollowing command would set a light green text background and a black foreground\ncolor ('foreground' is the text color):\n\n    highlight MatchTag ctermfg=black ctermbg=lightgreen guifg=black guibg=lightgreen\n\nSee `:help highlight` for more details on text highlighting commands.\n\nDefault: `1`\n\n    let g:mta_set_default_matchtag_color = 1\n\n## Comands\n\nYou can use the plugin to also go to the closing tag if this tag is in the\nvisible screen. \n\n### `MtaJumpToOtherTag`\n\nJumps to the enclosing tag if the tag is visible. If you are on top of an\nopening tag, it will jump to the closing tag. If you are on the closing tag,\nit will jump to the opening tag. If you are inside a tag, then it will jump to\nthe closing tag. \n\nSetting a mapping for this command: \n\n    nnoremap \u003cleader\u003e% :MtaJumpToOtherTag\u003ccr\u003e\n\n## FAQ\n\n### I've noticed that sometimes no tags are highlighted. Why?\n\nThe plugin only scans the lines that are visible in your window. If an opening\ntag is visible but the closing tag is not, no tag will be highlighted. This is\nfor performance reasons (ie. what happens if the user opens a 10k HTML file?).\n\nIt's also possible that the plugin's parser is just out of ideas on how to\nextract the enclosing tags out of your text. This should be very rare though.\n\n## Contact\n\nIf you have questions, bug reports, suggestions, etc. please use the [issue\ntracker][tracker]. The latest\nversion is available at \u003chttp://valloric.github.com/MatchTagAlways/\u003e.\n\nThe author's homepage is \u003chttp://val.markovic.io\u003e.\n\n## License\n\nThis software is licensed under the [GPL v3 license][gpl].\n© 2012 Strahinja Val Markovic \u0026lt;\u003cval@markovic.io\u003e\u0026gt;.\n\n\n[vimrc]: http://vimhelp.appspot.com/starting.txt.html#vimrc\n[vim]: http://www.vim.org/\n[gpl]: http://www.gnu.org/copyleft/gpl.html\n[vundle]: https://github.com/gmarik/vundle#about\n[pathogen]: https://github.com/tpope/vim-pathogen#pathogenvim\n[matchparen]: http://vimhelp.appspot.com/pi_paren.txt.html\n[tracker]: https://github.com/Valloric/MatchTagAlways/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FValloric%2FMatchTagAlways","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FValloric%2FMatchTagAlways","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FValloric%2FMatchTagAlways/lists"}