{"id":15178632,"url":"https://github.com/jhradilek/vim-dita","last_synced_at":"2026-02-02T10:35:22.554Z","repository":{"id":253480621,"uuid":"843560736","full_name":"jhradilek/vim-dita","owner":"jhradilek","description":"DITA 1.3 support for Vim","archived":false,"fork":false,"pushed_at":"2024-09-11T01:16:38.000Z","size":936,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-15T13:56:25.345Z","etag":null,"topics":["dita","dita-ot","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jhradilek.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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":"2024-08-16T19:39:31.000Z","updated_at":"2024-09-11T01:16:41.000Z","dependencies_parsed_at":"2024-08-17T02:43:50.712Z","dependency_job_id":"58f2055f-1c84-4205-aca7-14cf4b843504","html_url":"https://github.com/jhradilek/vim-dita","commit_stats":null,"previous_names":["jhradilek/vim-dita"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jhradilek/vim-dita","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhradilek%2Fvim-dita","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhradilek%2Fvim-dita/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhradilek%2Fvim-dita/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhradilek%2Fvim-dita/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jhradilek","download_url":"https://codeload.github.com/jhradilek/vim-dita/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhradilek%2Fvim-dita/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29010396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-02T08:40:12.472Z","status":"ssl_error","status_checked_at":"2026-02-02T08:40:10.926Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["dita","dita-ot","vim","vim-plugin"],"created_at":"2024-09-27T15:20:44.769Z","updated_at":"2026-02-02T10:35:22.528Z","avatar_url":"https://github.com/jhradilek.png","language":"Vim Script","funding_links":[],"categories":[],"sub_categories":[],"readme":"[#top]\n= vim-dita\n\n[#description]\n== Description\n\nThe *vim-dita* plug-in adds support for Darwin Information Typing Architecture (DITA) version 1.3 to Vim. It provides file type detection for DITA files, as well as syntax highlighting and omni completion for DITA maps and topics according to the official link:http://docs.oasis-open.org/dita/dita/v1.3/dita-v1.3-part3-all-inclusive.html[specification].\n\n[#features]\n== Features\n\n[#doctypes]\n=== Supported document types\n\nThe following are currently supported DITA document types and their corresponding `filetype` settings in Vim.\n\n[cols=\"1,1,1\"]\n|===\n|DITA document type |Expected file extension |Vim `filetype` setting\n\n|Map\n|`.ditamap`\n|`ditamap` †\n\n|Bookmap\n|`.ditamap`\n|`ditabookmap`\n\n|Topic\n|`.dita`\n|`ditatopic`\n\n|Concept\n|`.dita`\n|`ditaconcept`\n\n|Task\n|`.dita`\n|`ditatask`\n\n|Reference\n|`.dita`\n|`ditareference`\n\n|Glossary\n|`.dita`\n|`ditaglossary`\n\n|DITAVAL\n|`.ditaval`\n|`ditaval`\n|===\n\nFile type settings marked with the dagger symbol *†* are used by default for the selected file extension if the `DOCTYPE` directive can not be found on the first three lines of the file. To switch to a different file type manually, use the following Vim command:\n\n[literal,subs=\"+quotes\"]\n....\n**:set ft=__file_type__**\n....\n\n[#highlighting]\n=== Syntax highlighting\n\nThe plug-in provides syntax highlighting for each xref:doctypes[document type] separately to ensure that otherwise valid DITA elements are not highlighted for document types that do not allow them.\n\nimage::resources/vim-dita-highlighting.gif[Demonstration of syntax highlighting]\n\nNote that the plug-in only checks that the element is allowed in the particular document type, not whether it is used in the correct place. The visual distinction between valid and invalid elements also depends on the color scheme you use.\n\n[#completion]\n=== Omni completion\n\nThe plug-in provides contextual completion based on the DITA specification. When completing an element name, it allows you to cycle through elements that are valid children of the element your are in, when completing attribute names, it only offers attributes that are valid for that specific element, and if attribute values are limited to a list of possible values, it only offers you those values.\n\nimage::resources/vim-dita-completion.gif[Demonstration of omni completion]\n\nNote that the plug-in only checks whether the element is a valid child of its parent, not whether it is used in the right order or the correct number of times.\n\nBy default, the key combination for omni completion is set to `Ctrl+x Ctrl+o`. To cycle through the list of available options forwards, press `Ctrl+n`, to cycle through the list backwords, press `Ctrl+p`.\n\n[#snippets]\n=== Snippets\n\nThe plug-in provides a collection of snippets for each xref:doctypes[document type] separately to make the content creation faster.\n\nimage::resources/vim-dita-snippets.gif[Demonstration of snippets]\n\nNote that the snippets are currently under development and are not complete yet. The snippets require the link:https://github.com/SirVer/ultisnips[UltiSnips] plug-in to be installed.\n\n[#compiler]\n=== Compiler settings\n\nThe plug-in provides a custom compiler configuration for link:https://www.dita-ot.org/[DITA Open Toolkit] to make building previews of the content and resolving validation errors faster.\n\nimage::resources/vim-dita-compiler.gif[Demonstration of complier support]\n\nNote that DITA Open Toolkit needs to be installed and the `dita` command needs to be executable for this feature to work.\n\n[#copyright]\n== Copyright\n\nCopyright © 2024 Jaromir Hradilek\n\nThis program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhradilek%2Fvim-dita","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjhradilek%2Fvim-dita","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhradilek%2Fvim-dita/lists"}