mirror of
https://github.com/ascii-boxes/boxes.git
synced 2025-02-15 01:00:40 +01:00
51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
|
---
|
||
|
|
title: Docs - Config Step-by-Step
|
||
|
|
permalink: /config-step.html
|
||
|
|
redirect_from:
|
||
|
|
- /docs/config-step.html
|
||
|
|
- /docs/config-step.shtml
|
||
|
|
created_at: 1999-04-06
|
||
|
|
last_modified_at: 2014-12-23 22:50:09 +0100
|
||
|
|
---
|
||
|
|
|
||
|
|
# A New Design, Step By Step
|
||
|
|
|
||
|
|
Finally, we will take a brief look at the step-by-step process of creating a new design. A complex new design can be
|
||
|
|
done in less than five minutes!
|
||
|
|
|
||
|
|
1. **Create an empty box design.**
|
||
|
|
The only entry so far between the `BOX` and `END` statements is an empty `SAMPLE` block.
|
||
|
|
|
||
|
|
1. **Draw your box.**
|
||
|
|
Do it inside the sample block. Just draw it like you think it should look.
|
||
|
|
|
||
|
|
1. **Create the `SHAPES` block.**
|
||
|
|
Create your shapes by pasting from the `SAMPLE` block. Remember that all lines in shape definitions must be of
|
||
|
|
equal length.
|
||
|
|
|
||
|
|
1. **Add the other entries.**
|
||
|
|
You must at least add the `ELASTIC` entry, but this is also the time to add any other entries you might need.
|
||
|
|
|
||
|
|
1. **Take care of quoting.** There are two ways to do that:
|
||
|
|
|
||
|
|
- If there are only a few double quotes or backslashes in your strings, tell your editor to double all
|
||
|
|
backslashes in the `SHAPES` block for you. Do not double the backslashes before this point, or you will not be
|
||
|
|
able to undo it so easily (see below). Then escape the double quotes (`"`) by telling your editor to put a
|
||
|
|
backslash in front of every double quote which is part of a string.
|
||
|
|
- If you've got a lot of double quotes or backslashes in your strings, simply choose some other characters to be
|
||
|
|
the special characters. This is achieved via the
|
||
|
|
[`delimiter` statement]({{ site.baseurl }}/config-syntax.html#delim).
|
||
|
|
|
||
|
|
1. **Do not leave your editor just yet.**
|
||
|
|
Instead try out your design. This is because if you made a mistake with the line lengths or something, you can
|
||
|
|
still easily undo the doubling of backslashes. Otherwise, it may become difficult to judge how long a line is.
|
||
|
|
|
||
|
|
1. **Refine your design.**
|
||
|
|
Repeat appropriate steps until done.
|
||
|
|
|
||
|
|
It is precision work to finalize the box design. But this needs to be done only once, and the box design can be shared
|
||
|
|
and reused easily.
|
||
|
|
|
||
|
|
|
||
|
|
Read on in the next part: [Complete Examples of Box Designs]({{ site.baseurl }}/config-complete_exp.html)
|