Editor indentation for Emacs and Sublime Text; container guides point to editor support (from dev 5d35f256476e)

doc/edit/sublime/Klammertext_in_Sublime_Text.md

@@ -11,7 +11,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). |
-| `Default.sublime-keymap` | Binds jump-to-match to **Ctrl+M**, scoped to Klammertext files. |
+| `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. |
 | `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. |
@@ -48,11 +49,48 @@ adaptive `region.*` scopes, which were added in ST4.
 | caret on a klammer `@` | The matching delimiter boxes automatically; a name mismatch or unbalanced delimiter boxes in red with a status-bar message (equivalent of `show-paren-mode`) |
 | **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+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
 prefer `super+m` can change it in `Default.sublime-keymap`.
 
+## Indentation (experimental)
+
+`Klammertext_indent.py` ports the Emacs mode's indentation
+(`doc/emacs/klammertext-indent.el`): **Ctrl+Alt+I** reindents the line(s)
+touched by the selection to reflect the klammer nesting, two spaces per level:
+
+```
+@ol
+  Item one
+| Item two
+  @ol
+    Embedded item one
+  | Embedded item two
+  @
+| Item three
+@
+```
+
+The rule: a line indents to 2 × depth; a line *beginning* with a bar run
+(`|`, `||`, …) or a closing delimiter sits one level less — at its owner's
+opening column, so bars and closes line up under the `@` of the klammer they
+belong to.  All three `@`-tiers indent uniformly.  Exceptions: `@document`
+contributes no level (a document's paragraphs stay at the left margin); lines
+inside verbatim `@code` content, inside `@eval` argument spans (inline Python
+is indentation-sensitive), and inside removed regions are never touched.  The
+policy lists (`TRANSPARENT_KLAMMERS`, `CODE_KLAMMERS`, `INDENT_OFFSET`) are at
+the top of `Klammertext_indent.py`, kept in sync with the Emacs defcustoms.
+
+Sublime's own Reindent (Edit ￫ Line ￫ Reindent) is driven by single-line
+regex patterns that cannot express Klammertext nesting, so this is a plugin
+command instead.  Nothing reformats automatically (no on-Enter auto-indent):
+whitespace is content in Klammertext, so indentation happens only when you
+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).
+
 ## Colors
 
 Colors are installed automatically for all five of Sublime's built-in schemes.
@@ -75,16 +113,17 @@ exact values are in each file's header comment.
 
 ## Keeping literal klammers in sync
 
-Klammers whose content is verbatim (`@code ... code@`) are listed in three
+Klammers whose content is verbatim (`@code ... code@`) are listed in four
 places that must agree — a Sublime syntax/plugin cannot read the Emacs
 defcustom, so the list is duplicated:
 
 - `klammertext-literal-klammers` in `doc/emacs/klammertext-mode.el` (the source of truth)
 - `LITERAL_KLAMMERS` in `Klammertext.py`
+- `LITERAL_KLAMMERS` in `Klammertext_indent.py`
 - the `@code` rule and `literal_code` context in `Klammertext.sublime-syntax`
 
-All three are seeded with just `code`.  When you add or remove a literal
-klammer, change all three.
+All four are seeded with just `code`.  When you add or remove a literal
+klammer, change all four.
 
 ## Not included