This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Bedrock Markup Language Mod v1.3
By Leslie E. Krause
Bedrock Markup Language is an extensible markup language and API specifically tailored
for Minetest formspecs with simple-to-use tags for layout and formatting (e.g. colors,
headers, borders, rows and columns), builtin word-wrapping, and support for embedded
images (e.g. skins, items, etc.)
It makes a particularly nice drop-in replacement for the default sign and book editors,
if you want to give your users the ability to create nicer looking messages, rather than
accepting raw formspec strings which could pose security risks.
There is support for 15 text colors (including white) via the following inline tags:
[q=gray][/q] - gray text
[q=red][/q] - red text
[q=green][/q] - green text
[q=blue][/q] - blue text
[q=cyan][/q] - cyan text
[q=magenta][/q] - magenta text
[q=yellow][/q] - yellow text
[q=black][/q] - black text
[q=brown][/q] - brown text
[q=teal][/q] - teal text
[q=purple][/q] - purple text
[q=olive][/q] - olive text
[q=indigo][/q] - indigo text
[q=maroon][/q] - maroon text
There is also support for rows and columns via the [r] and [c] tags. Both tags accept an
optional numeric attribute to alter the size of the cell to be rendered.
You can set the depth of all cells on the next row using [r=#], and you can set the width
of the next cell using [c=#]. In both cases, # must be a number (or 0 for the default).
The unit of measurement is an approximation of the standard "em" used in typography.
Here is a basic table with two rows and two columns:
> Upper left cell[c]Upper right cell
> [r]
> Lower left cell[c]Lower right cell
Notice how the initial [r] tag is missing, and the initial [c] tags are also missing. Not
to worry! The lexer automatically fills in these tags behind the scenes. It is entirely
optional to include them. This markup is more verbose, but produces the same results:
> [r=0][c=0]Upper left cell[c=0]Upper right cell
> [r=0][c=0]Lower left cell[c=0]Lower right cell
By default rows and columns are evenly spaced vertically and/or horizontally for the most
pleasing appearance. The lexer is capable of automatically resizing rows and columns to
fit within the allowed dimensions of the formspec and to prevent overruns.
In addition to all of the features described above, you can easily add bordered text,
headline text, and even images (both skin and item textures) into your formspecs!
[b]<text>
Insert a new border row with a depth of 1.0
[b=#]<text>
Same as above, but with the specified depth
[h]<text>
Insert a new header row with a depth of 1.0
[h=#]<text>
Same as above, but with the specified depth
[i]<item_name>
Insert the specified item texture with a width of 2.0 (if image is too big to fit on
the current row, then it will be shrunk to fit).
[i=#]<item_name>
Same as above, but with the specified width
[s]<skin_name>
Insert the specified skin texture with a width of 2.0 (if image is too big to fit on
the current row, then it will be shrunk to fit).
[s=#]<skin_name>
Same as above, but with the specified width
It is also possible to include dynamic text using variable interpolation:
$name - the name of the current player
$item - the wielded item of the current player (for use with the [
Leslie Krause
6ac436e9f4