chore: updated doc for how to overwrite colors and highlight groups

dev-doc
Pocco81 3 years ago
parent a89fb11c7c
commit aef9299021

@ -416,27 +416,39 @@ integration = {
| Neon Latte | `neon_latte` | | Neon Latte | `neon_latte` |
| Light Melya | `light_melya` | | Light Melya | `light_melya` |
## Overriding colors ## Overwriting colors & hi groups
To override the colors for the Catppuccino theme you are using you'll pass the parameters to the `setup()` function you already used for configuring the plugin. This is the structure: Both colors and highlight groups can be overwritten like so:
```lua ```lua
local catppuccino = require("catppuccino") catppuccino.remap({<colors>},{<hi_groups>})
catppuccino.setup({<your_settings>}, {your_color_overrides})
``` ```
Example: setting the colorscheme to `Neon Latte` and changing the color `red` to `#ffffff` (white). Since you want to overwrite hi groups, then it's likely that you'll want to use the API to get the colors from x colorscheme as well:
```lua ```lua
local catppuccino = require("catppuccino") local err, colors = cp_api.get_colors("neon_latte")
catppuccino.setup({ ```
colorscheme = "neon_latte",
}, { Here is an example using the API to overwrite the color green and change the style of the comments:
red = "#ffffff",
```lua
local cp_api = require("catppuccino.api.colors")
local err, colors = cp_api.get_colors("neon_latte")
if err.status then -- good
catppuccino.remap({
green = "#ffffff"
},
{
Comment = { fg = colors.comment, style = "bold" }, -- any comment
}) })
end
``` ```
All editable fields are the same as the ones mentioned in any of the colorschemes found at: [`lua/catppuccino/color_schemes`](https://github.com/Pocco81/Catppuccino.nvim/tree/main/lua/catppuccino/color_schemes). You could also use one as a template, if you will. + For colorschemes: all editable fields are the same as the ones mentioned in any of the colorschemes found at: [`lua/catppuccino/color_schemes`](https://github.com/Pocco81/Catppuccino.nvim/tree/main/lua/catppuccino/color_schemes). You could also use one as a template, if you will.
+ For highlight groups: all the highlight groups have three editable fields: `fg` for the foreground, `bg` for the background and `style` for the style.
<br /> <br />
</details> </details>

Loading…
Cancel
Save