Explaining Code Using ASCII Art

Re:Explaining Code Using ASCII Art by matrix8967 on Monday June 27, 2022 @08:49AM (#31893841)

Man - this is my fkn brand.

Plain text is almost a universal truth -- and it's easy to church up your documentation with a well presented ASCII chart.

Some ANSI Color Codes and ASCIInema can carry you a long way.

Here's a list of plain text information tools from my notes:

  https://mbarkhau.keybase.pub/asciigrid/
  https://gitlab.com/mbarkhau/asciigrid/

ascii-tables is exactly what is says on the label.

  https://ozh.github.io/ascii-tables/
  https://github.com/ozh/ascii-tables/

  https://www.netpen.io/main/
  https://github.com/ebirger/netpen/

svgbob and svg-term are both great for creating SVGs out of these plain text files:

  https://github.com/marionebl/svg-term-cli/
  https://ivanceras.github.io/svgbob-editor/
  https://github.com/ivanceras/svgbob/

Here are some TUI/CLI focused frameworks. These are over kill for me - but maybe useful to someone here:

  https://www.textualize.io/
  https://charm.sh/
  http://maaslalani.com/slides/
  https://github.com/peterbrittain/asciimatics/

TUI/Text-Based presentaion tools:

  https://sli.dev/
  https://github.com/slidevjs/slidev/
  https://github.com/maaslalani/slides/
  http://maaslalani.com/slides/
  https://github.com/d0c-s4vage/lookatme/
  https://github.com/chunqiuyiyu/ervy/

Honorable Mention goes to wtf-util and it's TUI configurator:

  https://wtfutil.com/
  https://github.com/ggerganov/wtf-tui

Thanks for coming to my ted talk!

[ Parent | on HN ]

Re:Explaining Code Using ASCII Art by mbar84 on Monday June 27, 2022 @09:15AM (#31894151)

Thanks for the shoutout. AsciiGrid is dockerized should you want to run it yourself, for example because the keybase website happens to not be serving it anymore: https://github.com/mbarkhau/asciigrid#docker

[ Parent | on HN ]

Re:Explaining Code Using ASCII Art by ggeorgovassilis on Tuesday June 28, 2022 @02:54AM (#31904918)

Plug for my side project: https://animasci.com/

Runs in the browser, editor for animated ASCII art, exports as embeddable javascript and animated GIFs.

[ Parent | on HN ]

Re:Explaining Code Using ASCII Art by Ciph on Tuesday June 28, 2022 @01:54AM (#31904553)

Marp is pretty neat for markdown presentations, not too complicated and has useful (and pretty!) output.

https://marp.app/

[ Parent | on HN ]

Re:Explaining Code Using ASCII Art by grandchild on Monday June 27, 2022 @02:21PM (#31898525)

maybe add https://asciiflow.com ?

[ Parent | on HN ]

Re:Explaining Code Using ASCII Art by throwamon on Monday June 27, 2022 @02:02PM (#31898256)

> Plain text is almost a universal truth

Would you mind explaining what you mean by this? I take it you mean it ubiquitous, which of course it is, but as a phenomenon I'd much rather see things that look like they come from the real world, with color, depth, texture, and I'd much rather see a future where interactions with computers are moving in that direction.

[ Parent | on HN ]