Skip to content

Latest commit

 

History

History
43 lines (34 loc) · 2.38 KB

banner.md

File metadata and controls

43 lines (34 loc) · 2.38 KB

banner

Purpose

Prints a message in a banner. I often use this inside scripts or in interactive loop as an eye catcher.

Syntax

Syntax: banner [--character C] [--box] [--left] [--center] [--middle] [--right] [--color COLOR] [text ...]

Options and arguments

Option Description Default
--character C Use C as the border character The default is to use use a box-style border. See --box.
--box Toggles use of the box-style border: corner characters, vertical bars on the sides, and horizontal bars on the top and bottom. If box-style borders are disabled and an alternate character is not specified, a hash character is used instead. The default is to use use a box-style border.
--left Text is left-justified, assuming there are multiple lines of text. This is the default
--center Text is centered, assuming there are multiple lines of text. The default is to left-justified text
--right Text is right-justified, assuming there are multiple lines of text. The default is to left-justified text
--color COLOR Print the banner in a specific color. This must be one of: black, blue, brown, cyan, darkgray, green, lightblue, lightcyan, lightgray, lightgreen, lightpurple, lightred, orange, purple, red, white, or yellow but best effors are taken to normalize input (eg: Light Red) and accept unambiguous abbreviations (eg: blu). The default is the default foreground color for the terminal. This is typically customizable by your emulator/terminal so to definitively say the default is black or white is inaccurate.
  • Text is taken from the command line after any options and arguments, if there is such text.
  • Text is taken from stdin if there is no text after the options and arguments, assuming stdin is directed via a file or pipe. The command fails if there are no arguments and stdin is the terminal.

Examples

$ banner hello
┏━━━━━━━┓
┃ hello ┃
┗━━━━━━━┛
$ echo -e "The time is\n$(date)" | banner --center --box
################################
#         The time is          #
# Wed Nov  1 16:55:59 EDT 2017 #
################################
$

Color

Example of banner with --color option

Example of all colors