mirror of https://github.com/texmacs/doc.git
97 lines
5.6 KiB
Tcl
97 lines
5.6 KiB
Tcl
<TeXmacs|1.99.5>
|
|
|
|
<style|<tuple|tmdoc|english>>
|
|
|
|
<\body>
|
|
<tmdoc-title|Structured editing>
|
|
|
|
As a general rule, the behaviour of most structured editing operations is
|
|
conditioned by the <em|<rigid|current focus>>. By default, the focus is on
|
|
the innermost tag that contains the cursor. Whenever some selection is
|
|
active, the focus is rather on the innermost tag that contains the
|
|
selection. During structured operations, such as navigating among similar
|
|
tags, the focus may temporarily be set to something else. The current focus
|
|
is visually indicated by the innermost cyan box around the cursor.
|
|
|
|
For instance, the <em|structured insertion> commands
|
|
<shortcut|(structured-insert-left)>, <shortcut|(structured-insert-right)>,
|
|
<shortcut|(structured-insert-up)> and <shortcut|(structured-insert-down)>
|
|
have a particular meaning both inside tables and trees. Inside tables, they
|
|
allow you to insert new rows and columns (see
|
|
figure<nbsp><reference|matrix-insert-fig>). Inside trees, they correspond
|
|
to the insertion of new nodes (see figure<nbsp><reference|tree-insert-fig>).
|
|
If you are inside a<nbsp>tree inside a table, then the innermost tag is a
|
|
tree, and node insertions will take precedence over the insertion of new
|
|
rows and columns.
|
|
|
|
For most editing operations, a \Pdefault particular behaviour\Q has been
|
|
defined. This behaviour may potentially be overridden for a few exceptional
|
|
tags. In our example of structured insertion, the default behaviour of
|
|
<shortcut|(structured-insert-left)> and
|
|
<shortcut|(structured-insert-right)> is to insert a new argument to the tag
|
|
at the left or at the right of the cursor (when allowed). Inside tables,
|
|
this behaviour is overridden so as to insert entire columns.
|
|
|
|
<\big-figure>
|
|
<\equation*>
|
|
<matrix|<tformat|<table|<row|<cell|a>|<cell|b<cursor>>|<cell|c>>|<row|<cell|d>|<cell|e>|<cell|f>>>>><space|5em><matrix|<tformat|<table|<row|<cell|a>|<cell|b>|<cell|<cursor>>|<cell|c>>|<row|<cell|d>|<cell|e>|<cell|>|<cell|f>>>>><space|2em><matrix|<tformat|<table|<row|<cell|a>|<cell|<cursor>>|<cell|b>|<cell|c>>|<row|<cell|d>|<cell|>|<cell|e>|<cell|f>>>>><space|2em><matrix|<tformat|<table|<row|<cell|a>|<cell|b>|<cell|c>>|<row|<cell|>|<cell|<cursor>>|<cell|>>|<row|<cell|d>|<cell|e>|<cell|f>>>>><space|2em><matrix|<tformat|<table|<row|<cell|>|<cell|<cursor>>|<cell|>>|<row|<cell|a>|<cell|b>|<cell|c>>|<row|<cell|d>|<cell|e>|<cell|f>>>>>
|
|
</equation*>
|
|
<|big-figure>
|
|
<label|matrix-insert-fig>Assume that the cursor is at the position of
|
|
<cursor> inside the left-most matrix. Then the four other matrices
|
|
respectively correspond to the insertion of a new column at the
|
|
left<nbsp>(<shortcut|(structured-insert-left)>) or
|
|
right<nbsp>(<shortcut|(structured-insert-right)>), <abbr|resp.> a new row
|
|
above<nbsp>(<shortcut|(structured-insert-up)>) or
|
|
below<nbsp>(<shortcut|(structured-insert-down)>).
|
|
</big-figure>
|
|
|
|
<\big-figure|<tree|a|b|c<cursor>|d><space|3em><space|3em><tree|a|b|<cursor>|c|d><space|3em><tree|a|b|c|<cursor>|d><space|3em><tree|a|b|<tree|<cursor>|c>|d><space|3em><tree|a|b|<tree|c|<cursor>>|d>>
|
|
<label|tree-insert-fig>Assume that the cursor is at the position of
|
|
<cursor> inside the left-most tree. Then the four other trees
|
|
respectively correspond to the insertion of a new node at the
|
|
left<nbsp>(<shortcut|(structured-insert-left)>), at the
|
|
right<nbsp>(<shortcut|(structured-insert-right)>),
|
|
above<nbsp>(<shortcut|(structured-insert-up)>) or
|
|
below<nbsp>(<shortcut|(structured-insert-down)>).
|
|
</big-figure>
|
|
|
|
Similarly, still in the case of matrices, the keys
|
|
<shortcut|(structured-insert-start)>, <shortcut|(structured-insert-end)>,
|
|
<shortcut|(structured-insert-top)> and <shortcut|(structured-insert-bottom)>
|
|
can be used for inserting a new first or last column, <abbr|resp.> a new
|
|
first or last row. The keys <shortcut|(structured-remove-left)> and
|
|
<shortcut|(structured-remove-right)> are mapped to the commands for
|
|
backward <abbr|resp.> forward <em|structured deletion>. For matrices, this
|
|
will result in the removal of the column before or after the cursor (see
|
|
figure<nbsp><reference|matrix-remove-fig>). In order to remove the
|
|
enclosing environment you may use <shortcut|(remove-structure-upwards)> or
|
|
<shortcut|(remove-structure-upwards)>.
|
|
|
|
<\big-figure>
|
|
<\equation*>
|
|
<matrix|<tformat|<table|<row|<cell|a>|<cell|b<cursor>>|<cell|c>>|<row|<cell|d>|<cell|e>|<cell|f>>>>><space|5em><matrix|<tformat|<table|<row|<cell|b<cursor>>|<cell|c>>|<row|<cell|e>|<cell|f>>>>><space|2em><matrix|<tformat|<table|<row|<cell|a>|<cell|<cursor>c>>|<row|<cell|d>|<cell|f>>>>><space|2em>b<cursor>
|
|
</equation*>
|
|
<|big-figure>
|
|
<label|matrix-remove-fig>Assume that the cursor is at the position of
|
|
<cursor> inside the left-most matrix. Then pressing the
|
|
keys<nbsp><shortcut|(structured-remove-left)> and
|
|
<shortcut|(structured-remove-right)> respectively result in the next two
|
|
matrices. Pressing either<nbsp><shortcut|(remove-structure-upwards)> or
|
|
<shortcut|(remove-structure-upwards)> replaces the matrix by the content
|
|
of the cell in which you are, leaving you with the <math|b> at the
|
|
right-hand side.
|
|
</big-figure>
|
|
|
|
<tmdoc-copyright|1998--2005|Joris van der Hoeven>
|
|
|
|
<tmdoc-license|Permission is granted to copy, distribute and/or modify this
|
|
document under the terms of the GNU Free Documentation License, Version 1.1
|
|
or any later version published by the Free Software Foundation; with no
|
|
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
|
|
Texts. A copy of the license is included in the section entitled "GNU Free
|
|
Documentation License".>
|
|
</body>
|
|
|
|
<initial|<\collection>
|
|
</collection>> |