Asciio exec-boxes

An “exec-box” is and object that lets you run an external command and put its output in a box. There are different types of exec-boxes explained below.

Multi command

Binding: «ib» «ctl-e» Add exec box

The simplest exec-box accepts multiple commands, one per line. It will redirect stderr for each command.

Editing the box will let you edit the command.

Verbatim

Binding: «ib» «ctl-v» Add exec box verbatim

This exec-box doesn’t redirect stderr, you can use it for commands that span multiple line or commands that take a multi line input

Editing the box will let you edit the command.

Once

**Binding: «ib» «ctl-o» Add exec box verbatim once

This exec-box will run your commands once, editing the box will let you edit the command’s output.

Add line numbers

Binding: «ib» «ctl-l» Add line numbered box

This is an example of a custom stencil which will add line numbers to your input.

Examples

Using previously generated output

Use ‘cat your_file’ as the command in the exec-box.

Tables

If you have data you want to use in a table, the simplest is to run an external command (there are tens of ASCII table generator in perl, go, JS, …) and insert the result in a text element.

      +------------+------------+------------+------------+
      | input_size ‖ algorithmA | algorithmB | algorithmC |
      +============+============+============+============+
      |     1      ‖ 206.4 sec. | 206.4 sec. | 0.02 sec.  |
      +------------+------------+------------+------------+
      |    250     ‖     -      |  80 min.   | 2.27 sec.  |
      +------------+------------+------------+------------+

I you just want to type your table data, use an exec-box to pass your table data to you favorite Markdown formatter.

If you don’t have a favorite formatter or it doesn’t render the tables as you want them, Asciio installs md-table-formatter which may do just what you want.

md-table-formatter can render in multiple style and has some rendering options.

Insert an exec-box, remove all borders, and type the following below, you can re-edit your command later.

md-table-formatter will parse your table description, align, and format your table

cat <<EOT | md-table-formatter
| Operation              | Bg     | 
| -----------                  | -----   |
| Edit selected element | douck |
| Add to selection                    | C00-1 |
| Quick link                   | 0A0-1 |
| Duplicate elements           | 0AS-1 |
| Insert flex point (in arrow) | CA0-1 |
EOT

FIGlet

Figlet generates large letters out of ordinary text.

You can specify a font with the -f option.

$ ls /usr/share/figlet/
646-ca.flc   646-hu.flc   646-se2.flc  big.flf       lean.flf      smslant.flf
646-ca2.flc  646-irv.flc  646-yu.flc   block.flf     mini.flf      standard.flf
646-cn.flc   646-it.flc   8859-2.flc   bubble.flf    mnemonic.flf  term.flf
646-cu.flc   646-jp.flc   8859-3.flc   digital.flf   moscow.flc    upper.flc
646-de.flc   646-kr.flc   8859-4.flc   frango.flc    script.flf    ushebrew.flc
646-dk.flc   646-no.flc   8859-5.flc   hz.flc        shadow.flf    uskata.flc
646-es.flc   646-no2.flc  8859-7.flc   ilhebrew.flc  slant.flf     utf8.flc
646-es2.flc  646-pt.flc   8859-8.flc   ivrit.flf     small.flf
646-fr.flc   646-pt2.flc  8859-9.flc   jis0201.flc   smscript.flf
646-gb.flc   646-se.flc   banner.flf   koi8r.flc     smshadow.flf

For example, we want to specify this font: slant

This is the exported effect:

            .-----------------------------------.
            |     _                _  _         |
            |    / \    ___   ___ (_)(_)  ___   |
            |   / _ \  / __| / __|| || | / _ \  |
            |  / ___ \ \__ \| (__ | || || (_) | |
            | /_/   \_\|___/ \___||_||_| \___/  |
            |                                   |
            '-----------------------------------'

            .------------------------------------.
            |     ___                 _  _       |
            |    /   |   _____ _____ (_)(_)____  |
            |   / /| |  / ___// ___// // // __ \ |
            |  / ___ | (__  )/ /__ / // // /_/ / |
            | /_/  |_|/____/ \___//_//_/ \____/  |
            |                                    |
            '------------------------------------'

Diagon

Diagon transforms markdown expressions into an ascii-art representation.

Mathematical Expressions

File Tree

Use exec verbatim box to input multiple lines.

plantuml

PlantUML