Tree

Th' tree shortcode displays a list as a tree wit' configur'ble ay'cons an' colors.

  • home
    • .config
    • My Documents
      • home.php

Usage

```tree
- home::folder
  - .config::folder
  - My Documents::folder::magic
    - home.php::fa-fw fab fa-php::#888cc4
```
{{% tree %}}
- home::folder
  - .config::folder
  - My Documents::folder::magic
    - home.php::fa-fw fab fa-php::#888cc4
{{% /tree %}}
{{ partial "shortcodes/tree.html" (dict
  "page" .
  "content" `- home::folder
  - .config::folder
  - My Documents::folder::magic
    - home.php::fa-fw fab fa-php::#888cc4`
)}}

Codefence rules be widely avail'ble 'n other Marrrkdown parsers like GitHub an' therefore be th' recommend rules fer generat'n portable Marrrkdown.

Parameter

Name Default Notes
<content> <empty> Yer list as Marrrkdown.

Item Rules

<NAME> [ :: <ICON> [ :: <COLOR> ] ]

Th' NAME can be followed by optional do'ble colons (::) t' define an ICON an' further optional do'ble colons t' define th' icon’s COLOR.

  • ICON: Font Awesome ay'con name set t' th' left o' th' NAME. If ye give a single str'n, it be selected from Font Awesome’s solid ay'cons. If ye want t' use a different set, ye have t' give th' complete styles after th' do'ble colons. See above example fer th' home.php.

  • COLOR: Th' CSS color value t' be used. If not set, th' primary color will be used.

    Ye can also set a style value known from other shorrrtcodes.

    • by severity: caut'n, important, info, note, tip, warning
    • by brand color: primary, secondary, accent
    • by color: blue, cyan, green, grey, magenta, orange, red
    • by special color: default, transparent, code
    • ye can also define yer own styles.

    If a style an' a named HTML color have th' same name, th' style color will be used.

Examples

Bigger example

Every poss'ble combinat'n

```tree
- just name
  - Documents
  - My Documents
- simple ay'cons::folder
  - Documents::folder
  - My Documents::folder
- not so simple ay'cons::file-alt::secondary
  - a.png::file-alt
  - a wit' border.png::file-alt
- mindblow'n ay'cons::fa-fw fab fa-markdown::accent
  - text.md::fa-fw fab fa-markdown
  - alternative text.md::fa-fw fab fa-markdown
- an' now wit' color::fa-fw fab fa-php
  - script.php::fa-fw fab fa-markdown::purple
  - alt script.php::fa-fw fab fa-markdown::#888cc4
  - magic.php::fa-fw fab fa-markdown::orange
```
  • name-only
    • Documents
    • My Documents
  • simple ay'cons
    • Documents
    • My Documents
  • not so simple ay'cons
    • a.png
    • a wit' border.png
  • mindblow'n ay'cons
    • text.md
    • alternative text.md
  • an' now wit' color
    • script.php
    • alt script.php
    • magic.php