/ASCII-Decorator

Convert selected text into banners made up of ASCII art.

Primary LanguagePython

Description

ASCII-Decorator is a simple plugin implementation of pyfiglet for Sublime Text 3. pyfiglet is a full port of FIGlet into pure python. FIGlet is a program that generates text banners, in a variety of typefaces, composed of letters made up of conglomerations of smaller ASCII characters.

Or simply:

    __________________     __         __                   __  __    _
   / ____/  _/ ____/ /__  / /_   ____/ /___  ___  _____   / /_/ /_  (_)____
  / /_   / // / __/ / _ \/ __/  / __  / __ \/ _ \/ ___/  / __/ __ \/ / ___/
 / __/ _/ // /_/ / /  __/ /_   / /_/ / /_/ /  __(__  )  / /_/ / / / (__  ) _ _
/_/   /___/\____/_/\___/\__/   \__,_/\____/\___/____/   \__/_/ /_/_/____(_|_|_)

Prerequisites

  1. Sublime Text 3
  2. Package Control

Installation

  1. (Preferred) Install via Package Control Plugin for Sublime Text 3
    1. Bring up command palette (cmd+shift+P or ctrl+shift+P)
      1. Select option: "Package Control: Install Package"
        1. Select ASCII-Decorator from the list.
  1. Install via git
    1. In a shell: path to the Sublime Text 3 Packages directory
      1. type: git clone https://github.com/viisual/ASCII-Decorator.git

Usage

  1. You can access the plugin via from selecting: Menu > Edit > ASCII Decorator
  2. You can access the plugin via the key-binding: super+shift+K or alt+shift+K

Todo

  1. There are currently 300+ ASCII fonts included; however, there is no simple way to specify a font.
    1. FIGlet provides other parameters which I'd like to implement into settings.
  2. Add a menu to the context sensative menu (when text is selected).
  3. Ensure I am handling whitespace and line endings properly across all OS.
  4. Come up with a way to add block style comments around generated selections.
All of the documentation and the majority of the work done was by
    Christopher Jones (cjones@insub.org).
pyfiglet Packaged by Peter Waller <peter.waller@gmail.com>,
various enhancements by Stefano Rivera <stefano@rivera.za.net>.
ported to Sublime Text 3 by Sascha Wolf <swolf.dev@gmail.com>

                        _|_|  _|            _|              _|
_|_|_|    _|    _|    _|            _|_|_|  _|    _|_|    _|_|_|_|
_|    _|  _|    _|  _|_|_|_|  _|  _|    _|  _|  _|_|_|_|    _|
_|    _|  _|    _|    _|      _|  _|    _|  _|  _|          _|
_|_|_|      _|_|_|    _|      _|    _|_|_|  _|    _|_|_|      _|_|
_|              _|                      _|
_|          _|_|                    _|_|