Introduce shortcodes

[alex-shpak]

I think to introduce some shortcodes for documentation. If you have some ideas please post here.

What I have now in mind:

• [x] Expandable panels
• [x] Multiple columns
• [x] Tabs
• [x] Button shorcode
• [x] Mermaid chart

[jordibares]

Hi Alex, sounds great.

I would say that tabs, accordions, buttons, notices, margins and a few others would be very handy for a book.

Check the components I have put together, if there is anything you need, let me know. https://www.houdiniguides.com/docs/collaborating/authoring/components

In terms of inspiration, I like a lot this https://edwardtufte.github.io/tufte-css/

I hope this helps

[alex-shpak]

Some shortcodes are coming https://github.com/alex-shpak/hugo-book/tree/feature/shortcodes

[alex-shpak]

Can't make my mind, maybe somebody has opinion.

I came with two syntaxes for columns view. Less verbose, but reserves --- separator in markdown

{{< columns >}}
# Left Content
Lorem markdownum insigne.
---
# Mid Content
Lorem markdownum insigne.
---
# Right Content
Lorem markdownum insigne.
{{< /columns >}}

More verbose but more clear, with child shortcode.

{{< columns >}}

{{< column >}}
# Left Content
Lorem markdownum insigne. 
{{< /column >}}

{{< column >}}
# Mid Content
Lorem markdownum insigne. 
{{< /column >}}

{{< column >}}
# Right Content
Lorem markdownum insigne. 
{{< /column >}}

{{< /columns >}}

I like first one, but afraid of magic.