mirror of https://github.com/Hilbis/Hilbish
42 lines
1.1 KiB
Markdown
42 lines
1.1 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:
|
|
- bold
|
|
- dim
|
|
- italic
|
|
- underline
|
|
- invert
|
|
|
|
For the colors, there are background and bright variants. The background
|
|
color variants have a suffix of `Bg` and bright has a prefix of `bright`.
|
|
Note that appropriate camel casing has to be applied to them. So bright
|
|
blue would be `brightBlue` and background cyan would be `cyanBg`.
|