2025-03-14 21:59:59 -06:00
|
|
|
# boxes
|
|
|
|
|
|
|
|
|
|
> Draw, remove, and repair ASCII art boxes.
|
|
|
|
|
> More information: <https://boxes.thomasjensen.com/boxes-man-1.html>.
|
|
|
|
|
|
|
|
|
|
- Draw a box around a string:
|
|
|
|
|
|
|
|
|
|
`echo "{{string}}" | boxes`
|
|
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
- Remove a box from a string:
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
`echo "{{string}}" | boxes {{[-r|--remove]}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
- Specify the box design:
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
`echo "{{string}}" | boxes {{[-d|--design]}} {{parchment}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
- Specify the box size (in columns by lines):
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
`echo "{{string}}" | boxes {{[-s|--size]}} {{10}}x{{5}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
- Align the box text [h]orizonally (at [l]eft, [c]enter or [r]ight):
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
`echo "{{string}}" | boxes {{[-a|--align]}} h{{l|c|r}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
- Align the box text [v]ertically (at [t]op, [c]enter or [b]ottom):
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
`echo "{{string}}" | boxes {{[-a|--align]}} v{{t|c|b}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- [j]ustify the box text (at [l]eft, [c]enter or [r]ight):
|
|
|
|
|
|
2025-04-03 20:36:56 -06:00
|
|
|
`echo "{{string}}" | boxes {{[-a|--align]}} j{{l|c|r}}{{vt}}`
|