boxes/index.md

layout	redirect_from
default	/docs/index.html /docs/index.shtml /docs/legal.html /docs/legal.shtml /boxes.shtml /links.html

Boxes is a command line program which draws, removes, and repairs ASCII art boxes.
Learn more, Download/Install

{% comment %} ---------------------------------------------------------------------------------------- {% endcomment %}

Elasticity

The boxes adjust to match the size of your content

Creativity

Create and share your own box designs

Previous Next

{% comment %} ---------------------------------------------------------------------------------------- {% endcomment %}

{% if site.posts.size > 0 %} {% include heading.html level=3 slug="whats-new" text="What's New" %}

{%- for post in site.posts limit:2 -%}

{%- if post.release -%} {{ post.release }} released {%- else -%} {%- if post.content contains '' -%} {{ post.title }} {%- else -%} {{- post.title -}} {%- endif -%} {%- endif -%}

{{ post.date | date: "%b %-d, %Y" }}

{{- post.content | split:'' | first | markdownify | replace: '

', '

' | replace: '

','' -}} {%- if post.content contains '' -%}
... read more

{%- else -%}

{%- endif -%}

{% if post.release -%}

Download - Release History

{%- endif %}

{%- endfor %}

{% if site.posts.size > 2 %}

» All Blog posts

{{ site.posts.first.date | date: "%b %-d, %Y" }}

The What's New page has the comprehensive list of all blog posts.

{% endif %}

{% endif %}

{% comment %} ---------------------------------------------------------------------------------------- {% endcomment %} {% include heading.html level=3 slug="more" text="More About Boxes" %}

Boxes is a command line program which draws, removes, and repairs ASCII art boxes. It operates as a [text filter]({{ site.baseurl }}/filters.html). The generated boxes may even be removed and repaired again if they were badly damaged by editing of the text inside. Since boxes may be open on any side, boxes can also be used to create (regional) comments in any programming language.

Boxes is useful for making the function headers in your programming language look better, for spicing up news postings and emails, or just for decorating documentation files. Since the drawn box is matched in size to your input text, you can use boxes in scripts to dynamically add boxes around stuff.

Boxes integrates into your text editor ([learn how]({{ site.baseurl }}/editors.html)).

Boxes can be configured via [command line options]({{ site.baseurl }}/boxes-man-1.html#OPTIONS), so that your text looks just right in its new surrounding box. You can even configure regular expressions to change the text when a box is added or removed.

New box designs of all sorts can easily be added and shared by appending to a free format configuration file. Be creative!

Boxes is free software under the GNU General Public License, version 2 ([GPLv2]({{ site.link_license }})).