██████╗  ██████╗  ██╗   ██╗ ███╗   ██╗ ████████╗
    ██╔════╝  ██╔══██╗ ██║   ██║ ████╗  ██║ ╚══██╔══╝
    ██║  ███╗ ██████╔╝ ██║   ██║ ██╔██╗ ██║    ██║
    ██║   ██║ ██╔══██╗ ██║   ██║ ██║╚██╗██║    ██║
    ╚██████╔╝ ██║  ██║ ╚██████╔╝ ██║ ╚████║    ██║
     ╚═════╝  ╚═╝  ╚═╝  ╚═════╝  ╚═╝  ╚═══╝    ╚═╝
        ███████╗  ██████╗  ███╗   ██╗ ████████╗
        ██╔════╝ ██╔═══██╗ ████╗  ██║ ╚══██╔══╝
        █████╗   ██║   ██║ ██╔██╗ ██║    ██║
        ██╔══╝   ██║   ██║ ██║╚██╗██║    ██║
        ██║      ╚██████╔╝ ██║ ╚████║    ██║
        ╚═╝       ╚═════╝  ╚═╝  ╚═══╝    ╚═╝

Output in a nice font to the console for banners or logos using cfonts

Getting Started

This plugin requires Grunt >=0.4.0

If you haven’t used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you’re familiar with that process, you may install this plugin with this command:

npm install grunt-font --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-font');

The font task

Overview

In your project’s Gruntfile, add a section named font to the data object passed into grunt.initConfig().

grunt.initConfig({
	font: {
		start: {
			text: 'Welcome',
		},
	},
});

Options

Please check cfonts documentation for all options.

Usage Examples

Default Options

In this example, the default options are used which will print your text in block and white.

font: {
	start: {
		text: 'Welcome',
		options: {
			font: 'block',       // define the font face
			align: 'left',       // define text alignment
			colors: ['white'],   // define all colors
			background: 'Black', // define the background color
			letterSpacing: 1,    // define letter spacing
			lineHeight: 1,       // define the line height
			space: true,         // define if the output text should have empty lines on top and on the bottom
			maxLength: 0         // define how many character can be on one line
		},
	},
},

Custom Options

Choose different colors:

font: {
	start: {
		text: 'Welcome',
		option: {
			colors: ['black', 'blue'],
			background: 'cyan',
		},
	},
},

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Lint and test your code using Grunt.

Release History

• 1.0.1 - updated to cfonts ^2.3.0 and removed lock file
• 1.0.0 - updated to cfonts ^2.1.0
• 0.0.14 - updated to cfonts 1.2.0
• 0.0.13 - updated to cfonts 1.0.1
• 0.0.12 - updated to cfonts 1.0.0
• 0.0.11 - Updated peerDependencies for grunt 1.0
• 0.0.10 - Updated devDependencies for grunt 1.0
• 0.0.9 - updated to cfonts 0.0.13
• 0.0.8 - updated to cfonts 0.0.10
• 0.0.7 - fixed settings object
• 0.0.6 - updated docs
• 0.0.5 - separated into two node modules
• 0.0.4 - fixed block font parameters
• 0.0.3 - added letter spacing option
• 0.0.2 - path fixes
• 0.0.1 - alpha test

License

Copyright (c) Dominik Wilkowski. Licensed under the GNU GPLv2.