/*
██████ █████ ███ ██ ███ ██ ███████ ██████
██ ██ ██ ██ ████ ██ ████ ██ ██ ██ ██
██████ ███████ ██ ██ ██ ██ ██ ██ █████ ██████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ██ ██ ██ ████ ██ ████ ███████ ██ ██
██████ ██████ ███ ███ ███ ███ ███████ ███ ██ ████████ ███████
██ ██ ██ ████ ████ ████ ████ ██ ████ ██ ██ ██ ██
██ ██ ██ ██ ████ ██ ██ ████ ██ █████ ██ ██ ██ ██ ███████ ██████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ██████ ██ ██ ██ ██ ███████ ██ ████ ██ ███████
*/
credits: lunar_limbo, original author: IMFUZZ
Organize your code with large ASCII font comments to quickly idenfity your position in the file.
Deeply customize
the output with prefix, suffix, perLinePrefix, and more. Use commands
or stored configs
to quickly add large banner comments using figlet. With geddski.macros you can setup keybinds
for your favorite configs
Play around with over 275+ mostly useless ascii fonts in this sandbox.
NEW! Is your favorite figlet missing? No problem! Add your own .flf fonts for use with this extension. Create your own or download from the many sources online
Designed primarily so you can save your favorite styles in reusable configs. Find your favorite figlet fonts and settings and assign them to a keyboard shortcut!
see contributions for other commands
The figlet settings can be best understood by playing with this tool
font
horizontalLayout
verticalLayout
trimTrailingWhitespace
trimEmptyLines
Some languages don't have both styles of comments. Some langauges have different standards for how to use those comment styles. Take your pick.
block
: only use block style comment, but fallback to line comment if noneline
: only use line style comment, but fallback to block comment if noneboth
: always put both block and line comments in outputThese are rather straight forward. But remember these caveats:
prefix
suffix
perLinePrefix
favorites
- store your favorite fonts in a list for easy selection with ApplyFromFavorites
customFonts
- list of paths to custom figlet font files you may download
configDescriptionKeys
- a list of 'keys' which are shown when displaying ApplyFromConfig
to add more data than simply the name
configs
- a list of configs saved for reuse with ApplyFromConfig
, All settings in contributions can be added to a config. If a settings is not specified in a config, the default option is used.
"banner-comments-plus.configs": {
"h1": {
"font": "Small",
"trimEmptyLines": true,
"commentStyle": "block",
"prefix": "",
"suffix": "--------------------------------------------------"
}
}
The args
value MUST match the key
given to the config in your settings.
"macros": {
"banner-comments-plus-h1": [
{"command": "banner-comments-plus.ApplyFromConfig", "args": "h1"},
]
}
{
"key": "ctrl+shift+delete",
"command": "macros.banner-comments-plus-h1",
"when": "editorTextFocus"
}
None!