RFC: change syntax of yfm-tabs (move to directive syntax)

[d3m1d0v]

Description

The syntax of YFM-Tabs is quite complex and inconvenient. There are several issues with it:

• curly liquid-like syntax for open and close block. It requires its exact spelling, empty lines before and after the content, named closing syntax
• syntax of bullet-list for describe tab name and its content. It requires to specify correct indentation on left from tab content

Proposal

First, add support of directive syntax for YFM-Tabs block: replace curly markup of opening and closing with directive syntax.

Second, abandon syntax of lists for tab and its content and come up with another, more convenient one, in which you do not need to add an indentation for the content.

[d3m1d0v]

Proposals for syntax

Directive for container and list syntax for tabs

The easiest way. Just change curly syntax for container to directive syntax

:::tabs
- Tab 1
  Content of tab 1

- Tab 2

  Content of tab 2

  More content of tab 2
:::

With `::` marker for tabs

Using :: as marker of start new tab

If contents of tabs container do not start with ::, then tab is automatically added using text contents for tab title.

:: Tab title should work like heading: only one line, without breaks, with support of inline markup.

Disadvantages of this solution:

• marker :: can be parsed as block directive, such as ::block. To fix this, we can change marker to %% or use another symbols

:::tabs

A tab for this content will be created automatically

:: Tab 1
Content of tab 1

:: Tab 2

Content of tab 2

More content of tab 2
:::

With %% marker

:::tabs

%% Tab 1
Content of tab 1

%% Tab 2

Content of tab 2

More content of tab 2
:::

Like list but without indentation

:::tabs

~ Tab 1
Content of tab 1

~ Tab 2

Content of tab 2

More content of tab 2
:::

[d3m1d0v]

We choose between this

:::tabs

:: Tab 1

Content of tab 1

:::

and that

:::tabs

::tab [Tab 1]

Content of tab 1

:::