Marked Diagrams - Markdeep iteration

[G-Ambatte]

This PR adds the Marked-Diagrams module, which uses the functions from Markdeep to generate SVGs from ASCII source.

Example Brew:

Content:

{{wide
```diagram

+-------------------+                           ^                      .---.
|    A Box          |__.--.__    __.-->         ║      .-.             |   |   ║   ║   |   |
|                   |        '--'               v     | * |<---        |   |   ║   v   v   |
+-------------------+                                  '-'             |   +---+<==+===+---+->
                       Round                                       *---(-. |   |   ^   ║   ^
  .-----------------.  .-------.    .----------.         .-------.     | | |   |   |   ║   ║
 |   Mixed Rounded  | |         |  / Diagonals  \        |   |   |     | | |
 | & Square Corners |  '--. .--'  /              \       |---+---|     '-)-'       .--+-----.
 '--+------------+-'  .--. |     '-------+--------'      |   |   |       |        / Search /
    |            |   |    | '---.        |               '-------'       |       '-+------'
    |<==========>|   |    |      |       v                Interior                 |     ^
    '           <---'      '----'   .-----------.              ---.     .---       v     |
 .------------------.  Diag line    | .-------. +---.              \   /           .     |
 |   if (a > b)     +---.      .--->| |       | |    | Curved line  \ /           / \    |
 |   obj->fcn()     |    \    /     | '-------' |<--'                +           /   \   |
 '------------------'     '--'      '--+--------'      .--. .--.     |  .-.     +Done?+-'
    .---+-----.                        |   ^           |\ | | /|  .--+ |   |     \   /
    |   |     | Join        \|/    |   |   | Curved    | \| |/ | |    \    |      \ /
    |   |     +---->  ◌    --◍--   |    '-'  Vertical  '--' '--'  '--  '--'        +  .---.
 <--+---+-----'       |     /|\    ║                                               |  | 3 |
                      v            ║                not:line    'quotes'        .-'   '---'
  .-.             .---+--------.   |        /            A || B   *bold*       |        ^
 |   |           |   Not a dot  |  |   <---+===<--    A dash--is not a line    v        |
  '-'             '---------+--'          /           Nor/is this.            ---       |

--->~~~>--->===>~~~>====----====~~~~----.__.----.__.----~~~~====----====<~~~<===<---<~~~<---

\```  <= Please note, the end of this codefence is escaped so GitHub doesn't parse it incorrectly
}}

Styling:

.page svg {
  width: 100%;
}

Result:

---

Limitations

The current function from MarkDeep does not generate actual polygons, but rather disjoint collections of paths. Thus, most styling is not possible on most diagram features.

[G-Ambatte]

The test diagram in a deployment document:

https://homebrewery-pr-4376.herokuapp.com/edit/L5XFZ-FoHbmZ

[5e-Cleric]

can characters be escaped of the diagram? for example say i wanted to have a single o in a text, but that makes the white circle, can i escape it to get the text?

[5e-Cleric]

It works even better than i thought, although having to add manually the spaces or any character back for everything to realign is a bit of a pain.

[G-Ambatte]

It works even better than i thought, although having to add manually the spaces or any character back for everything to realign is a bit of a pain.

I have been experimenting with the deployment and I definitely don't hate the diagrams... but the inability to style arrows or blocks individually is definitely problematic.

[ericscheid]

It's a fascinating implementation of what is essentially just ASCII Art.

[G-Ambatte]

It's a fascinating implementation of what is essentially just ASCII Art.

I'm not against implementing this functionality; it's better than the nothing that is currently available... Perhaps changing the activation language from diagram to asciiArt might help tune down user expectations to a more reasonable level.

[5e-Cleric]

What does this PR need to reach completion? or is it ready already

[G-Ambatte]

What does this PR need to reach completion? or is it ready already

At this point, if we want to move ahead with it, we either:

a) bring the Markdeep diagram extension files into the Homebrewery project, or
b) publish the Markdeep Diagrams for Markdown as a full Marked extension, so that this PR no longer points at the repository on my personal GitHub; probably bringing it into the NC umbrella, much like has been done with the other Marked extensions.

Beyond redirecting the module location, I think this PR is as ready as it's going to get.

[5e-Cleric]

What does this PR need to reach completion? or is it ready already

At this point, if we want to move ahead with it, we either:

a) bring the Markdeep diagram extension files into the Homebrewery project, or b) publish the Markdeep Diagrams for Markdown as a full Marked extension, so that this PR no longer points at the repository on my personal GitHub; probably bringing it into the NC umbrella, much like has been done with the other Marked extensions.

Beyond redirecting the module location, I think this PR is as ready as it's going to get.

I vote for b, makes it way easier to remove if we ever want to stop using it, opens it up for other people, and will be less things to test in-house.

[5e-Cleric]

This is now completely broken when pulling from master, got any idea?

[G-Ambatte]

This is now completely broken when pulling from master, got any idea?

I changed the name of the package to better reflect it's origin in Markdeep, and forgot to update the dependency in package.json. It's fixed now, but now there's a hanging conflict with stylelint. I'll dig a little deeper and see what's going on with that.