Tabler
Tabler is a simple bot that lets you create readable, simple or complex tables in your server. It uses a range of easy to understand options to let you create awesome looking tables.
Get started
To create a table, you can use the t!table command. It takes two main arguments over two lines:
- The first line, right after the command, is where you provide options, such as
--singleLine. - The second line, and any subsequent lines, are used for the rows, columns and content of the table.
Here's an example of a simple table you can create with one option:
Let's break it down:
- The command
t!tableis used along with an option,--col(1).width=20, and 3 rows of content - The option
--col(1).width=20tells the bot to set the first column's content (beingName,FrederickandBob) to have a width of 20 spaces across. - The table's rows and content are being split by a
|, which tells the bot to make a new column
Pretty easy, isn't it?
In-depth
Options
| Option | Description | Alias(es) | Default Value |
|---|---|---|---|
| lineOnAllRows | Whether to add line separating each row, or only the top row | lineall | Default: false (line only on top row) |
| singleLine | Whether to only use one line (good for horizontal tables) | sinline | false |
| border | The template to use for specifying which characters to use for the table's borders Valid options: honeywell, norc, ramac, void |
honeywell | |
| col(index/"all") | Used to modify specific or all column settings. A list of column options can be seen below. | not applicable |
| Option | Description | Default Value |
|---|---|---|
| col.width | The width of the column in spaces, must be greater than 0, | auto (content length) |
| col.paddingLeft | How many spaces to insert before the content | 0 |
| col.paddingRight | How many spaces to insert after the content | 0 |
| col.wordWrap | Whether to wrap the content to the next line at the nearest space, or at a special character | false |
| col.truncate | How many characters to display before wrapping to the next line. Used by default instead of word wrapping. | 100 |
| col.alignment | Which direction to align content in a row towards Valid options: left, center, right |
left |
Default border templates available
Planned Features
- Automatic parsing of GitHub-flavoured tables in chat (detecting and displaying them properly)
- Custom border templates and the ability to create your own, use them alongside the defaults, and share them with others
- An option for a custom prefix
- A command to manually convert a GitHub-flavoured table
- The ability to save tables per-user and share them across servers, or upload them to a service like Pastebin
All coming really soon 😊
Need help?
Join the support server to request help and suggest features or report bugs.