Antlers Prettier Plugin

The Antlers Prettier plugin offers a Prettier plugin based on the same engine that powers all other Antlers Toolbox formatting offerings.

Installation

The Antlers Prettier Plugin can be installed with npm using the following command:

npm install prettier-plugin-antlers

Note: Make sure you have at least version 1.1.7.

Prettier 3 Configuration

To install the Prettier 3 plugin, use the following command:

npm install prettier-plugin-antlers@^2 --save-dev

After installing the plugin, you will need to update your .prettierrc file and make sure it contains the following values:

{
    "plugins": [
        "prettier-plugin-antlers"
    ],
    "overrides": [
        {
            "files": [
                "*.antlers.html"
            ],
            "options": {
                "parser": "antlers"
            }
        }
    ]
}

Prettier 2 Installation and Configuration

To install the Prettier 2 plugin, use the following command:

npm install prettier-plugin-antlers@^1 --save-dev

If you continuously receive errors like "could not resolve module prettier-plugin-antlers", the following updates to a project's .prettierrc have proved successful:

{
    "plugins": [
        "./node_modules/prettier-plugin-antlers/"
    ],
    "overrides": [
        {
        "files": "*.antlers.html",
        "vscodeLanguageIds": ["antlers"],
        "options": {
            "parser": "antlers"
        }
        }
    ]
}

Visual Studio Code and Prettier

If you receive errors similar to "No formatter for 'Antlers' found" after installing the Prettier Visual Studio Code extension and the Antlers plugin, you may need to update your Visual Studio Code settings and add Antlers as one of the Prettier extensions. Inside your setting's JSON file, you can apply changes similar to the following:

{
  "[antlers]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "prettier.documentSelectors": [
    "**/*.antlers.html"
  ]
}

Tailwind CSS Prettier Plugin Compatibility

This plugin does not ship with the Tailwind CSS Prettier plugin. If you'd like to have that as well, you will need to install it separately :)

Reporting Issues

If you come across an issue, or have a suggestion to improve Antlers Toolbox, feel free to create an issue on the project's GitHub repository here:

https://github.com/Stillat/vscode-antlers-language-server/issues

If you are looking to report a security vulnerability, please do not create an issue on the GitHub repository.

To report sensitive issues or a security vulnerability please email [email protected] with the relevant details.

Emails requesting information on bounties, etc. will not be responded to.

License

This formatter utility is open-sourced software licensed under the MIT license.