mirror of https://github.com/Hilbis/Hilbish
45 lines
1.2 KiB
Markdown
45 lines
1.2 KiB
Markdown
---
|
|
title: Lunacolors
|
|
layout: doc
|
|
weight: -60
|
|
menu: docs
|
|
---
|
|
|
|
Lunacolors is an ANSI color/styling library for Lua. It is included
|
|
by default in standard Hilbish distributions to provide easy styling
|
|
for things like prompts and text.
|
|
|
|
For simple usage, a single color or style is enough. For example,
|
|
you can just use `lunacolors.blue 'Hello world'` and that'll return
|
|
blue text which you can print. This includes styles like bold,
|
|
underline, etc.
|
|
|
|
In other usage, you may want to use a format string instead of having
|
|
multiple nested functions for different styles. This is where the format
|
|
function comes in. You can used named keywords to style a section of text.
|
|
|
|
The list of arguments are:
|
|
Colors:
|
|
- black
|
|
- red
|
|
- green
|
|
- yellow
|
|
- blue
|
|
- magenta
|
|
- cyan
|
|
- white
|
|
|
|
Styles:
|
|
- reset
|
|
- bold
|
|
- dim
|
|
- italic
|
|
- underline
|
|
- invert
|
|
|
|
For the colors, there are background and bright variants. Background color
|
|
variants have a `Bg` suffix, while bright variants use the `bright` prefix.
|
|
These can also be combined. Note that appropriate camel casing must be applied.
|
|
For example, bright blue would be written as `brightBlue`, a cyan background as
|
|
`cyanBg`, and combining them would result in `brightBlueBg`.
|