💾 Archived View for gemini.ctrl-c.club › ~ssb22 › termlayout.gmi captured on 2024-05-26 at 15:29:26. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

TermLayout

TermLayout is a text-mode HTML formatter for Unix terminals which supports:

Ruby markup (multiple rt and rb elements are stacked)
Tables (including nesting and alignment)
Wide characters (uses locale settings from LC_CTYPE, LANG etc)
Smaller terminal sizes. In some cases a table will still end up being wider than the terminal and not easily reflowable; if that happens then at least each cell should fit. But in many cases TermLayout can arrange for no horizontal scrolling to be necessary.

Unrecognised markup is left in the output for inspection.

TermLayout is not a Web browser: it has no facilities for navigating links. It is meant only for formatting text on a terminal using HTML markup. I wrote it when I wanted to page through a document with Ruby markup in fbterm but couldn’t find a text-mode browser that would format this markup correctly.

Download termlayout.py; you will need Python (2 or 3) and a command prompt. (You can also use pip install termlayout or pipx run termlayout if you prefer, and there is history on GitHub.)

termlayout.py

If you are using TermLayout with an annotator generated by Annotator Generator, you might also be interested in this tmux-annotator script which sets up tmux with a “hotkey” to annotate the current screen and display the result in TermLayout.

TermLayout is free software licensed under the Apache License, Version 2.0.

Legal

All material © Silas S. Brown unless otherwise stated. Apache is a registered trademark of The Apache Software Foundation. GitHub is a trademark of GitHub Inc. Python is a trademark of the Python Software Foundation. Unix is a trademark of The Open Group. Any other trademarks I mentioned without realising are trademarks of their respective holders.