Table alignment for Emacs and Sublime Text (from dev 66442bdd4d5d)

doc/edit/sublime/Klammertext_in_Sublime_Text.md

@@ -12,7 +12,8 @@ Emacs mode closely; where the two intentionally differ, the file headers say so.
 | `Klammertext.sublime-syntax` | Syntax highlighting.  Colors the text-removal constructs (`#`, `##`, `#[...]#`) and the three `@`-tiers — application `@`, definition `@@`, system `@@@` — each as an opening vs. a close, plus `^`-escapes and verbatim `@code ... code@` spans. |
 | `Klammertext.py` | Plugin with two features that share one context-sensitive matcher: jump between an opening and its close, and live highlighting of the matching delimiter as the caret moves (mismatched or unbalanced delimiters flag in red). |
 | `Klammertext_indent.py` | **Experimental.** Reindentation per the Klammertext convention (see below).  A separate unit: delete this one file to disable indentation; nothing else is affected. |
-| `Default.sublime-keymap` | Binds jump-to-match to **Ctrl+M** and reindent to **Ctrl+Alt+I**, scoped to Klammertext files. |
+| `Klammertext_align.py` | **Experimental.** Table alignment (see below).  Also a separate, deletable unit. |
+| `Default.sublime-keymap` | Binds jump-to-match to **Ctrl+M**, reindent to **Ctrl+Alt+I**, and table alignment to **Ctrl+Alt+A**, scoped to Klammertext files. |
 | `Comments.tmPreferences` | Comment toggling: **Ctrl+/** inserts `# ` (line removal), **Ctrl+Shift+/** wraps in `#[ ... ]#` (block removal). |
 | `Breakers` / `Celeste` / `Mariana` / `Monokai` / `Sixteen` `.sublime-color-scheme` | Color overrides for Sublime's five built-in schemes — one hue system, full intensity on the dark schemes, scaled down on the light ones.  Additive: they recolor only the Klammertext delimiters and leave the rest of each scheme unchanged. |
 | `Klammertext_in_Sublime_Text.md` | This file. |
@@ -50,6 +51,7 @@ adaptive `region.*` scopes, which were added in ST4.
 | **Ctrl+/** | Toggle line comment (`#`) |
 | **Ctrl+Shift+/** | Toggle block comment (`#[ ... ]#`) |
 | **Ctrl+Alt+I** | Reindent the selected lines (the current line when there is just a caret) — experimental, see "Indentation" below |
+| **Ctrl+Alt+A** | Align the columns of the table containing the caret — experimental, see "Table alignment" below |
 
 Ctrl+M is Sublime's own "go to matching bracket" key, reused here because the
 built-in cannot match Klammertext's context-dependent `@`.  macOS users who
@@ -91,6 +93,34 @@ ask for it.  To disable the feature, delete `Klammertext_indent.py` and the
 Ctrl+Alt+I entry in `Default.sublime-keymap` (or just the keymap entry, to
 keep the command available from plugins).
 
+## Table alignment (experimental)
+
+`Klammertext_align.py` ports the Emacs mode's table alignment
+(`doc/emacs/klammertext-align.el`): **Ctrl+Alt+A** with the caret anywhere
+inside a `@table` span pads the cells of its rows so the `|` separators line
+up:
+
+```
+@table
+  First item | Second | A third item that's longer ||
+  Row 2      | Text   | Not as long                ||
+@
+```
+
+A row is one line ending with the row delimiter `||` (the customary trailing
+delimiter; the last row may omit it).  Alignment is for small data items, so
+a row is left untouched — and contributes nothing to the column widths —
+when any of its cells is longer than `CELL_MAX` (30) characters or the row
+spans lines.  If the aligned rows would exceed `ROW_MAX` (100) columns,
+nothing changes and the status bar says so.  The padding is semantically
+free: the SKS strips cell content, no whitespace is ever inserted inside a
+bar run (which would turn a `||` row separator into an empty `| |` cell),
+and bars inside a nested klammer in a cell (`@frac 1 | 2 @`) belong to that
+klammer, not the table.  Aligned rows adopt the leading whitespace of the
+first aligned row — run Ctrl+Alt+I first if the rows disagree.  The limits
+sit at the top of `Klammertext_align.py`, mirrored from the Emacs
+defcustoms.
+
 ## Colors
 
 Colors are installed automatically for all five of Sublime's built-in schemes.