{"id":15178665,"url":"https://github.com/maluscat/vim-less-autocompile","last_synced_at":"2026-03-01T03:02:40.898Z","repository":{"id":251403696,"uuid":"837286763","full_name":"Maluscat/vim-less-autocompile","owner":"Maluscat","description":"Automatically compile Less into CSS on save","archived":false,"fork":false,"pushed_at":"2024-08-03T21:57:33.000Z","size":8,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-23T19:24:00.256Z","etag":null,"topics":["autocompile","css","less","plugin","vim"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maluscat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-02T16:02:54.000Z","updated_at":"2024-10-25T14:52:52.000Z","dependencies_parsed_at":"2024-09-23T10:02:39.334Z","dependency_job_id":null,"html_url":"https://github.com/Maluscat/vim-less-autocompile","commit_stats":{"total_commits":10,"total_committers":1,"mean_commits":10.0,"dds":0.0,"last_synced_commit":"b7baf1ab2f23301f1e6d39090b4ef5006322e7ec"},"previous_names":["maluscat/vim-less-autocompile"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Maluscat/vim-less-autocompile","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maluscat%2Fvim-less-autocompile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maluscat%2Fvim-less-autocompile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maluscat%2Fvim-less-autocompile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maluscat%2Fvim-less-autocompile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maluscat","download_url":"https://codeload.github.com/Maluscat/vim-less-autocompile/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maluscat%2Fvim-less-autocompile/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29959284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T01:47:18.291Z","status":"online","status_checked_at":"2026-03-01T02:00:07.437Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["autocompile","css","less","plugin","vim"],"created_at":"2024-09-27T15:21:14.716Z","updated_at":"2026-03-01T03:02:40.843Z","avatar_url":"https://github.com/Maluscat.png","language":"Vim Script","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vim-less-autocompile\nTiny vim plugin that takes care of automatically compiling [Less](https://lesscss.org/)\nfiles into a corresponding CSS file on save.\n\nThis plugin came about for personal use and is very simple, so it might not handle some\nedge cases (like unreadable files, etc.). If you find anything lacking, please feel free\nto open an issue or contribute yourself!\n\n\n## Prerequisites\nIn order to utilize this plugin, [Less](https://lesscss.org/) needs to be installed.\nThis is done globally via NodeJS:\n```sh\nnpm install -g less\n```\n\nIt is also recommended to have a Less file type (syntax highlighting) plugin installed.\n[vim-less](https://github.com/groenewege/vim-less) is a good choice.\n\n\n## Installation\nInstall using your favorite Vim plugin manager. For example, using [vim-plug](https://github.com/junegunn/vim-plug):\n```vim\nPlug 'Maluscat/vim-less-autocompile'\n```\n\n\n## Usage\nThere is no global configuration (yet?). Everything is configured on a per-file basis:\n\nTo use, simply put a comment on the first line of your Less file that specifies the\nconfiguration you want to use (see below). It is a comma separated list of arguments that are passed\nto the `lessc` command. An argument itself is denoted as a colon separated key-value pair.\n\n### Mandatory arguments\nEvery file that should be compiled must have one of two mandatory arguments: `out` or `main`.\n\nThe `out` argument specifies the destination path for the CSS file\nthat will get compiled on save.\n- `// out: ./path/to/output.css`\n\nYou can also redirect the compilation to another file using the `main` argument instead\nof `out` (recursively, if needed).\nThis is useful if the specified files are not intended for direct compilation\nbecause they are dependencies of the main file, which should be compiled instead.\nMultiple files are separated by a pipe without spaces:\n- `// main: ./path/to/main.less`\n- `// main: ./main1.less|../main2.less|main3.less`\n\n\n\n### Basic example\nAssuming both files are in the same folder:\n\n*colors.less*:\n```less\n// main: styles.less\n@color: red;\n```\n*styles.less*:\n```less\n// out: styles.css\n@include 'colors.less';\nbody {\n  color: @color;\n}\n```\nNow, when saving of any of the two files, it compiles to:\n\n*styles.css*\n```css\nbody {\n  color: red;\n}\n```\n\nAny compilation errors will be accumulated and passed on to Vim.\n\n### Other arguments\nBesides the mandatory arguments above, any other arguments of the `lessc` command line tool\nmay be applied in the same manner.\nFor readability (and laziness) purposes, only double-dash arguments may be specified,\nmeaning `lint` (from `lessc --lint`) is fine, but `l` (from `lessc -l`) will be nonsensical.\n\nThe following will compile to a `./main.css` with the arguments `--lint --source-map=main-map.map`:\n```less\n// out: main.css, lint, source-map: main-map.map\n...\n```\n\nWhen specifying additional arguments in a file that has a `main` instead of an `out`,\nthey are merged with the arguments of the main file (recursively, if needed).\n\n\n## Contribution\nAny reported issues, feedback, ideas and other contributions are greatly appreciated!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaluscat%2Fvim-less-autocompile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaluscat%2Fvim-less-autocompile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaluscat%2Fvim-less-autocompile/lists"}