itdominator/terminator
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
527d892ebd
terminator/doc/manual/_build/html/gettingstarted.html
Stephen Boddy 1d977cc6aa A manual has been added to Terminator 
* Added source and generated html of manual, and API doc
* setup.py can install the manual (and by extension do can debuild)
* setup.py has (inactive) code for generating the html from the source
  but this will break if rtd theme is not available
* A few changes to doc strings to make the autodoc prettier
* Added help shortcut, by default F1 to open the local manual
* Added button to About tab to launch manual
* A couple of additional string to translate related to manual/help
2015-08-08 04:11:30 +02:00

1027 lines
54 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Getting Started &mdash; Terminator 1.0 alpha documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="top" title="Terminator 1.0 alpha documentation" href="index.html"/>
<link rel="next" title="Preferences Window" href="preferences.html"/>
<link rel="prev" title="Document history" href="history.html"/>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> Terminator
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Contents:</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="licensing.html">Licensing</a></li>
<li class="toctree-l1"><a class="reference internal" href="history.html">Document history</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="">Getting Started</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#the-context-menu">The Context Menu</a></li>
<li class="toctree-l2"><a class="reference internal" href="#navigating-around">Navigating around</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#click-able-items">Click-able items</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#changing-the-current-layout">Changing the current layout</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#using-the-splitters">Using the splitters</a></li>
<li class="toctree-l3"><a class="reference internal" href="#dragging-and-dropping-a-terminal">Dragging and dropping a terminal</a></li>
<li class="toctree-l3"><a class="reference internal" href="#using-the-keyboard">Using the keyboard</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#resetting-the-terminal">Resetting the terminal</a></li>
<li class="toctree-l2"><a class="reference internal" href="#the-scrollbar-and-scrollback-buffer">The scrollbar and scrollback buffer</a></li>
<li class="toctree-l2"><a class="reference internal" href="#search-the-buffer">Search the buffer</a></li>
<li class="toctree-l2"><a class="reference internal" href="#zooming-the-terminal">Zooming the terminal</a></li>
<li class="toctree-l2"><a class="reference internal" href="#setting-titles">Setting Titles</a></li>
<li class="toctree-l2"><a class="reference internal" href="#insert-terminal-number">Insert terminal number</a></li>
<li class="toctree-l2"><a class="reference internal" href="#next-prev-profile">Next/Prev profile</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="preferences.html">Preferences Window</a><ul>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#global">Global</a><ul>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#behaviour">Behaviour</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#appearance">Appearance</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#terminal-titlebar">Terminal Titlebar</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#profiles">Profiles</a><ul>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#general">General</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#cursor">Cursor</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#terminal-bell">Terminal bell</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#not-in-terminator">Not in Terminator</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#command">Command</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#id1">Not in Terminator</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#colours">Colours</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#foreground-and-background">Foreground and Background</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#palette">Palette</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#id2">Not in Terminator</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#background">Background</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#scrolling">Scrolling</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#compatibility">Compatibility</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#encoding">Encoding</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#layouts">Layouts</a></li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#keybindings">Keybindings</a></li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#plugins">Plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#about">About</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="layouts.html">Layouts and the Layout Launcher</a><ul>
<li class="toctree-l2"><a class="reference internal" href="layouts.html#the-layout-launcher">The Layout Launcher</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="grouping.html">The Grouping Menu</a><ul>
<li class="toctree-l2"><a class="reference internal" href="grouping.html#manipulating-terminal-groups">Manipulating terminal groups</a></li>
<li class="toctree-l2"><a class="reference internal" href="grouping.html#broadcasting-input-to-multiple-terminals">Broadcasting input to multiple terminals</a></li>
<li class="toctree-l2"><a class="reference internal" href="grouping.html#insert-terminal-number">Insert terminal number</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="plugins.html">Plugins</a><ul>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#included-plugins">Included plugins</a><ul>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#activity-watch">Activity Watch</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#apt-url-handler">APT URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#custom-commands-menu">Custom Commands Menu</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#inactivity-watch">Inactivity Watch</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#launchpad-bug-url-handler">Launchpad Bug URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#launchpad-code-url-handler">Launchpad Code URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#logger">Logger</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#maven-plugin-url-handler">Maven Plugin URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#terminal-shot">Terminal Shot</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#test-plugin">Test Plugin</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#third-party-plugins">Third party plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#installing-a-plugin">Installing a plugin</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#creating-your-own-plugins">Creating your own plugins</a><ul>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#the-basics-of-a-plugin">The basics of a plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#url-handlers">URL Handlers</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#context-menu-items">Context menu items</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#wrap-up">Wrap up</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="advancedusage.html">Advanced Usage</a><ul>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#command-line-options">Command line options</a><ul>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#general-options">General options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#window-options">Window options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#shell-options">Shell options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#layout-options">Layout options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#custom-window-manager-options">Custom Window Manager options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#debugging-options">Debugging options</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#the-config-file">The Config file</a></li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#debugging">Debugging</a></li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#dbus">DBus</a></li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#remotinator">Remotinator</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">Frequently Asked Questions</a><ul>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why">Why...</a><ul>
<li class="toctree-l3"><a class="reference internal" href="faq.html#write-in-python-it-s-slow-bloated-bad">...write in Python? It&#8217;s slow/bloated/bad?</a><ul>
<li class="toctree-l4"><a class="reference internal" href="faq.html#performance">Performance</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#memory-use-the-dumb-way">Memory use - The dumb way</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#memory-use-the-sensible-way">Memory use - The sensible way</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#python-sucks">&#8220;Python sucks!&#8221;</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#in-summary">In summary</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-do-i">How do I...</a><ul>
<li class="toctree-l3"><a class="reference internal" href="faq.html#make-terminator-work-like-quake-style-terminals">...make Terminator work like Quake style terminals?</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="gettinginvolved.html">Getting involved</a><ul>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#translations">Translations</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#improve-icons-artwork">Improve icons/artwork</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#terminator-action-shots">Terminator action shots</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#manual-updates">Manual updates</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#testing">Testing</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#bugs">Bugs</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#plugins">Plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#main-application-development">Main Application Development</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#gtk3-port">GTK3 Port</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#api-docs">API Docs</a></li>
</ul>
</li>
</ul>
</div>
&nbsp;
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Terminator</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>Getting Started</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/gettingstarted.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document">
<img alt="Because this is the symbol learner drivers use in the UK." class="align-right" src="_images/icon_gettingstarted.png" />
<div class="section" id="getting-started">
<span id="id1"></span><h1>Getting Started<a class="headerlink" href="#getting-started" title="Permalink to this headline"></a></h1>
<p>This page is an introduction and tutorial, that will get you familiar
with Terminator&#8217;s features. Additional functional areas are explored
in other pages, but at the end of this page you&#8217;ll be getting a good
idea of the power of Terminator.</p>
<p>When you first start Terminator you will get a default, minimal window,
looking something like the following:</p>
<img alt="_images/basic_window.png" src="_images/basic_window.png" />
<p>There may be some cosmetic differences, but it should look fairly
similar. It may in fact look a little too minimal to some of you, but
this is a deliberate policy. Keep the focus on the terminal, not on a
cluttered interface. This is why we don&#8217;t waste space on a traditional
menu bar and toolbar. Even the terminal scrollbar and titlebar (the
red strip) can be turned off, although you do lose ease-of-access to
some of Terminators more powerful features if you do.</p>
<p>Many functions are triggered with keyboard shortcuts. But mousers aren&#8217;t
completely abandoned. Lets look again at the basic interface, but with
the two primary menus showing:</p>
<img alt="_images/window_breakdown.png" src="_images/window_breakdown.png" />
<ol class="arabic simple">
<li><a class="reference internal" href="#context-menu"><span>The Context Menu</span></a> -
This is the main menu reached with <code class="docutils literal"><span class="pre">right-click</span></code> over a terminal, and
will let you access all the settings, profiles, shortcuts and
configurations. It is however kept brief to avoid the mega-menus that
sometimes grow unchecked.</li>
<li><a class="reference internal" href="grouping.html#grouping-menu"><span>The Grouping Menu</span></a> -
This is reached with a <code class="docutils literal"><span class="pre">click</span></code> on the trio of coloured boxes in the
titlebar. Later, when we cover Grouping and broadcasting to multiple
terminals we will cover this properly. For now it is enough to know
where it is and how to trigger it.</li>
</ol>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">You will never see a window that looks like this, as it is
impossible to have both menus up at the same time.</p>
</div>
<div class="section" id="the-context-menu">
<span id="context-menu"></span><h2>The Context Menu<a class="headerlink" href="#the-context-menu" title="Permalink to this headline"></a></h2>
<p>The context menu is split into five parts. The first part is the standard
Copy and Paste for text that has been highlighted with the mouse. There
are shortcuts too:</p>
<table border="1" class="docutils">
<colgroup>
<col width="19%" />
<col width="81%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Copy</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">C</span></code></td>
</tr>
<tr class="row-odd"><td>Paste</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">V</span></code></td>
</tr>
</tbody>
</table>
<p>The second section is where the fun starts. <strong>Split Horizontally</strong> and <strong>Split
Vertically</strong> are used to divide the current space for the current terminal
half. Your original terminal takes the top/left half, and a new terminal
is started and placed in the right/bottom half. You can repeat this as
often as you wish, sub-dividing down until the terminals are completely
impractical. Here&#8217;s a window that is split Horizontally, Vertically, and
Horizontally again:</p>
<img alt="_images/split_window.png" src="_images/split_window.png" />
<p>Between the terminals you can see a space that is a splitter grab handle.
You can grab these and drag them, and the terminals will resize. In this
way Terminator acts a lot like a tiling window manger. It lets you arrange
many terminals in a single view, allowing adjustments as your needs change.</p>
<p>The last item in this part of the menu is to <strong>Open tab</strong>. This will give
you a tab like most other terminal programs. Unlike most other terminals,
in Terminator you can also split the terminals in each tab as often as you
like.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The same effects could have been achieved with <a class="reference internal" href="#layout-shortcuts"><span>shortcuts</span></a>, and is the case for most actions.</p>
</div>
<p>The third part of the menu will <strong>Close</strong> the current terminal. It&#8217;s on
its own to prevent accidents.</p>
<p>The entries in the fourth part allow you to temporarily focus on one
terminal. <strong>Zoom terminal</strong> will zoom into the current terminal hiding all
other terminals and tabs, and increasing the the size of the font. This can
be handy to eliminate distractions, give yourself a bit more space for the
current task, or even when giving presentations or training. <strong>Maximise
terminal</strong> is almost identical, except that it does not increase the size of
the terminal font.</p>
<p>When you are zoomed or maximised it is not possible to split terminals,
or create new tabs, so the entries for those actions disappear from
the menu. So too do the zoom and maximise options, and in their place is
a <strong>Restore all terminals</strong> entry. This will take you back to your windows
original layout, and restore the font size if necessary.</p>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">An outstanding issue is that sometimes the font size
selected when zooming in can be a bit extreme. You can use
<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">wheelup</span></code>/<code class="docutils literal"><span class="pre">wheeldown</span></code> to increase and
decrease the font size if this happens. This will not
affect the restored font size.</p>
</div>
<p>The fifth part of the menu has three items. <strong>Show scrollbar</strong> will toggle
the scrollbar on a per terminal basis. There is also a way to define this
in the Profiles. <strong>Preferences</strong> lets you configure and tune Terminator to
better suit your needs and is further described <a class="reference internal" href="preferences.html#preferences"><span>here</span></a>.
Lastly, <strong>Encodings</strong> will allow you to select a different encoding to the
default of UTF-8.</p>
<p>There are actually additional optional items that can be added to the
menu that will only be shown if you enable those <a class="reference internal" href="plugins.html#plugins"><span>Plugins</span></a> that
add menu items.</p>
</div>
<div class="section" id="navigating-around">
<h2>Navigating around<a class="headerlink" href="#navigating-around" title="Permalink to this headline"></a></h2>
<p>Apart from the obvious of clicking the terminal for focus, there are a number
of shortcuts that will move the focus around:</p>
<table border="1" class="docutils">
<colgroup>
<col width="22%" />
<col width="27%" />
<col width="51%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Options</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Move focus</td>
<td>Up, Down, Left, Right</td>
<td><code class="docutils literal"><span class="pre">Alt</span></code>+<code class="docutils literal"><span class="pre">&lt;Arrow&gt;</span></code></td>
</tr>
<tr class="row-odd"><td>Cycle to terminal</td>
<td>Next, Prev</td>
<td>(<code class="docutils literal"><span class="pre">Shift</span></code>+)<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">Tab</span></code></td>
</tr>
<tr class="row-even"><td>Focus to terminal</td>
<td>Next, Prev</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">N</span></code>/<code class="docutils literal"><span class="pre">P</span></code></td>
</tr>
<tr class="row-odd"><td>Switch to tab #</td>
<td>1 to 10</td>
<td>&nbsp;</td>
</tr>
<tr class="row-even"><td>Switch tab</td>
<td>Previous, Next</td>
<td><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">PgUp</span></code>/<code class="docutils literal"><span class="pre">PgDn</span></code></td>
</tr>
<tr class="row-odd"><td>Context menu</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Menu</span> <span class="pre">Key</span></code></td>
</tr>
<tr class="row-even"><td>Help <a class="footnote-reference" href="#id3" id="id2">[1]</a></td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">F1</span></code></td>
</tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2">[1]</a></td><td>Although as you&#8217;re reading this, I guess you figured that one out!</td></tr>
</tbody>
</table>
<p>Once the Context menu is visible, it can be navigated with the arrow keys.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">For me the two different sets of next/prev shortcuts are a bit of a
mystery. Something to look into.</p>
</div>
<div class="section" id="click-able-items">
<span id="clickable-items"></span><h3>Click-able items<a class="headerlink" href="#click-able-items" title="Permalink to this headline"></a></h3>
<img alt="_images/plugins_links.png" src="_images/plugins_links.png" />
<p>Terminator can make strings of text that match a pattern click-able.
The user can perform two additional actions on these when the mouse
pointer hovers overs the item:</p>
<ul>
<li><dl class="first docutils">
<dt><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">click</span></code></dt>
<dd><p class="first last">Will try to open the item in a suitable
program depending on what the type of the item is (see below).</p>
</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt><code class="docutils literal"><span class="pre">right-click</span></code></dt>
<dd><p class="first">Will add two entries to <a class="reference internal" href="#context-menu"><span>The Context Menu</span></a>:</p>
<ul class="last">
<li><p class="first"><em>Open link</em> - Same as <code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">click</span></code></p>
<p>The description might be different depending on the type of the
item (see below).</p>
</li>
<li><p class="first"><em>Copy address</em> - Copies the URL to the clipboard</p>
<p>In some types this may be converted into a different form
depending on what the item represents.</p>
</li>
</ul>
</dd>
</dl>
</li>
</ul>
<p>Here are the built-in formats understood:</p>
<table border="1" class="docutils">
<colgroup>
<col width="34%" />
<col width="15%" />
<col width="51%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td><strong>URL</strong></td>
<td><strong>Note</strong></td>
<td><strong>Made up example, Don&#8217;t use!</strong></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="news://user&#64;host:port/path">news://user&#64;host:port/path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="news://steve&#64;news.example.org:1234/announce">news://steve&#64;news.example.org:1234/announce</a></td>
</tr>
<tr class="row-odd"><td><a class="reference external" href="telnet://user&#64;host:port/path">telnet://user&#64;host:port/path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="telnet://steve&#64;insecure.example.,org:1234">telnet://steve&#64;insecure.example.,org:1234</a></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="nntp://user&#64;host:port/path">nntp://user&#64;host:port/path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="nntp://steve&#64;news.example.org:1234/announce">nntp://steve&#64;news.example.org:1234/announce</a></td>
</tr>
<tr class="row-odd"><td><a class="reference external" href="file://user&#64;host:port/path">file://user&#64;host:port/path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="file://steve&#64;localhost/var/log/syslog">file://steve&#64;localhost/var/log/syslog</a> <br />
<a class="reference external" href="file:///var/log/syslog">file:///var/log/syslog</a></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="http://user&#64;host:port/path">http://user&#64;host:port/path</a></td>
<td>+ <a class="reference external" href="https://">https://</a></td>
<td><a class="reference external" href="http://steve&#64;www.example.org/index.html">http://steve&#64;www.example.org/index.html</a></td>
</tr>
<tr class="row-odd"><td><a class="reference external" href="ftp://user&#64;host:port/path">ftp://user&#64;host:port/path</a></td>
<td>+ ftps://</td>
<td><a class="reference external" href="ftp://steve&#64;ftp.example.org/var/log/">ftp://steve&#64;ftp.example.org/var/log/</a></td>
</tr>
<tr class="row-even"><td>webcal://user&#64;host:port/path</td>
<td>&nbsp;</td>
<td>webcal://steve&#64;webcal.example.org/today</td>
</tr>
<tr class="row-odd"><td>wwwhostname.domain:port/path</td>
<td>&nbsp;</td>
<td>www-server.example.org/index.html <br />
www.example.org</td>
</tr>
<tr class="row-even"><td>ftphostname.domain:port/path</td>
<td>&nbsp;</td>
<td>ftp-server.example.org/var/log/ <br />
ftp.example.org</td>
</tr>
<tr class="row-odd"><td colspan="3"><strong>VoIP</strong></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="callto:user:number&#64;path">callto:user:number&#64;path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="callto:steve:0123456789&#64;not/sure/here">callto:steve:0123456789&#64;not/sure/here</a></td>
</tr>
<tr class="row-odd"><td><a class="reference external" href="h323:user:number&#64;path">h323:user:number&#64;path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="h323:steve:0123456789&#64;not/sure/here">h323:steve:0123456789&#64;not/sure/here</a></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="sip:user:number&#64;path">sip:user:number&#64;path</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="sip:steve:0123456789&#64;not/sure/here">sip:steve:0123456789&#64;not/sure/here</a></td>
</tr>
<tr class="row-odd"><td colspan="3"><strong>E-Mail</strong></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="mailto:name&#37;&#52;&#48;host">mailto:name<span>&#64;</span>host</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="mailto:steve&#37;&#52;&#48;example&#46;org">mailto:steve<span>&#64;</span>example<span>&#46;</span>org</a></td>
</tr>
<tr class="row-odd"><td colspan="3"><strong>News</strong></td>
</tr>
<tr class="row-even"><td><a class="reference external" href="news:name&#64;host:port">news:name&#64;host:port</a></td>
<td>&nbsp;</td>
<td><a class="reference external" href="news:steve&#64;news.example.org:1234">news:steve&#64;news.example.org:1234</a></td>
</tr>
</tbody>
</table>
<p>These are just the ones built-in by default to Terminator. The
<a class="reference internal" href="plugins.html#plugins"><span>Plugins</span></a> can extend this further with a <strong>URL Handler</strong>,
although strictly speaking it does not have to be a <em>URL</em> - as can be
seen from some of the above - just a well defined pattern that can be
matched.</p>
</div>
</div>
<div class="section" id="changing-the-current-layout">
<h2>Changing the current layout<a class="headerlink" href="#changing-the-current-layout" title="Permalink to this headline"></a></h2>
<p>I&#8217;ve already used the term <em>layout</em> a few times in this page already.
I should define what exactly is meant by a layout.</p>
<p>A layout describes the collection of windows in the current process,
the tabs, and how the windows and tabs are divided up into terminals.
It also includes the positions, dimensions, as well as other aspects
related to how Terminator looks.</p>
<p>Besides the items in the <a class="reference internal" href="#context-menu"><span>The Context Menu</span></a> there are three main
methods to adjust the layout.</p>
<div class="section" id="using-the-splitters">
<h3>Using the splitters<a class="headerlink" href="#using-the-splitters" title="Permalink to this headline"></a></h3>
<p>So, by now you&#8217;ve probably made a few splits and used the mouse to drag them
about, and you now have something resembling the following, minus the highlights:</p>
<img alt="_images/rebalance_01.png" src="_images/rebalance_01.png" />
<p>Terminator lets us <em>rebalance</em> the terminals, equally dividing the available
space between the <em>siblings</em>.</p>
<p>The different highlighting shows the siblings. The key thing to understand is
that the blue splitters are considered siblings, which are <em>children</em> of the
green <em>parent</em>. The green is itself a child of the red parent. By double-clicking
the splitter, the space will be divided evenly between the siblings. So,
double-clicking any of the blue splitters will give:</p>
<img alt="_images/rebalance_02.png" src="_images/rebalance_02.png" />
<p>If instead we <code class="docutils literal"><span class="pre">double-click</span></code> on the green splitter, we get:</p>
<img alt="_images/rebalance_03.png" src="_images/rebalance_03.png" />
<p>But there&#8217;s more! We can use two modifier keys to rebalance more collections of
siblings. <code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">double-click</span></code> the splitter and all children,
grandchildren, and so on, will be rebalanced. <code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">double-click</span></code> and
all parents, grandparents, and so, on, will be re-balanced. You guessed it!
<code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">double-click</span></code> and all visible terminals
will be rebalanced. It will not affect terminals in other windows or tabs.</p>
<p><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">double-click</span></code> on green:</p>
<img alt="_images/rebalance_04.png" src="_images/rebalance_04.png" />
<p><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">double-click</span></code> on green:</p>
<img alt="_images/rebalance_05.png" src="_images/rebalance_05.png" />
<p><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">double-click</span></code> on green:</p>
<img alt="_images/rebalance_06.png" src="_images/rebalance_06.png" />
</div>
<div class="section" id="dragging-and-dropping-a-terminal">
<h3>Dragging and dropping a terminal<a class="headerlink" href="#dragging-and-dropping-a-terminal" title="Permalink to this headline"></a></h3>
<p>There are two ways to drag a terminal from one location to another with in the
window. The simplest is to use the titlebar at the top of each terminal. Simply
<code class="docutils literal"><span class="pre">click-drag</span></code>, and you will be able to hover over the other terminals and drop
the dragged terminal to move it:</p>
<img alt="_images/dragterminal_01.png" src="_images/dragterminal_01.png" />
<p>Here you can see a preview of the dragged terminal - scaled if large - and shading
to show which area it will cover, which can be the top, bottom, left or right of
an existing terminal.</p>
<p>The above action results in the following:</p>
<img alt="_images/dragterminal_02.png" src="_images/dragterminal_02.png" />
<p>The other way to drag a terminal can be done from within the terminal with
<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">right-click-drag</span></code>.</p>
<p>You can drag between tabs by initiating a drag and hovering over the tab.
Terminator will switch to the tab under the cursor, and the terminal can be
dropped.</p>
<p>You can also drag between Terminator windows <em>provided the windows are part
of the same process</em>. By default all windows will be part of the same process.</p>
</div>
<div class="section" id="using-the-keyboard">
<span id="layout-shortcuts"></span><h3>Using the keyboard<a class="headerlink" href="#using-the-keyboard" title="Permalink to this headline"></a></h3>
<p>Of course, with Terminator being a terminal application, it makes sense to keep
your hands on the keyboard as much as possible. So there are many shortcuts that
you can tailor to your own preference. Here are the ones that will affect the
layout:</p>
<table border="1" class="docutils">
<colgroup>
<col width="20%" />
<col width="27%" />
<col width="53%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Options</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>New instance <a class="footnote-reference" href="#id6" id="id4">[2]</a></td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">I</span></code></td>
</tr>
<tr class="row-odd"><td>New window</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">I</span></code></td>
</tr>
<tr class="row-even"><td>New Tab</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">T</span></code></td>
</tr>
<tr class="row-odd"><td>Split terminal</td>
<td>Horizontally, Vertically</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">O</span></code>/<code class="docutils literal"><span class="pre">E</span></code></td>
</tr>
<tr class="row-even"><td>Hide window <a class="footnote-reference" href="#id7" id="id5">[3]</a></td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">Alt</span></code>+<code class="docutils literal"><span class="pre">A</span></code></td>
</tr>
<tr class="row-odd"><td>Close window</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">Q</span></code></td>
</tr>
<tr class="row-even"><td>Close terminal</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">W</span></code></td>
</tr>
<tr class="row-odd"><td>Toggle fullscreen</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">F11</span></code></td>
</tr>
<tr class="row-even"><td>Resize terminal</td>
<td>Up, Down, Left, Right</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">&lt;Arrow&gt;</span></code></td>
</tr>
<tr class="row-odd"><td>Rotate terminals</td>
<td>(Anti-)Clockwise</td>
<td>(<code class="docutils literal"><span class="pre">Shift</span></code>+)<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">R</span></code></td>
</tr>
<tr class="row-even"><td>Move Tab</td>
<td>Left, Right</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">PgUp</span></code>/<code class="docutils literal"><span class="pre">PgDn</span></code></td>
</tr>
<tr class="row-odd"><td>Zoom terminal</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">Z</span></code></td>
</tr>
<tr class="row-even"><td>Maximise terminal</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">X</span></code></td>
</tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id6" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4">[2]</a></td><td>This is a separate process. As such, drag and drop will not work
to or from this new window, or subsequent windows launched using
the <code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">I</span></code> while the focus is in the
new instance.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id7" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id5">[3]</a></td><td>Hide window will currently only work on the first window of the
first terminator instance that you start. That is because at
present it binds the shortcut globally (it has to, or it cannot
unhide) and this can only be done once. This may change in
future.</td></tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="resetting-the-terminal">
<h2>Resetting the terminal<a class="headerlink" href="#resetting-the-terminal" title="Permalink to this headline"></a></h2>
<p>There are two shortcuts available for fixing the terminal if it
starts to misbehave.</p>
<table border="1" class="docutils">
<colgroup>
<col width="31%" />
<col width="69%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Reset</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">R</span></code></td>
</tr>
<tr class="row-odd"><td>Reset + Clear</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">G</span></code></td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="the-scrollbar-and-scrollback-buffer">
<h2>The scrollbar and scrollback buffer<a class="headerlink" href="#the-scrollbar-and-scrollback-buffer" title="Permalink to this headline"></a></h2>
<p>As already mentioned, there is a <a class="reference internal" href="#context-menu"><span>Context Menu</span></a>
item to toggle the scrollbar. There is also a shortcut listed here.</p>
<p>In addition there are shortcuts for moving up and down in the
scrollback buffer with more flexibility:</p>
<table border="1" class="docutils">
<colgroup>
<col width="31%" />
<col width="15%" />
<col width="54%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Options</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Toggle scrollbar</td>
<td>&nbsp;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">S</span></code></td>
</tr>
<tr class="row-odd"><td>Page <a class="reference internal" href="#vs" id="id8">[VS]</a></td>
<td>Up, Down</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">PgUp</span></code>/<code class="docutils literal"><span class="pre">PgDn</span></code></td>
</tr>
<tr class="row-even"><td>X Lines <a class="reference internal" href="#vs" id="id9">[VS]</a> <a class="reference internal" href="#xl" id="id10">[XL]</a></td>
<td>Up, Down</td>
<td><code class="docutils literal"><span class="pre">wheelup</span></code>/<code class="docutils literal"><span class="pre">wheeldown</span></code></td>
</tr>
<tr class="row-odd"><td>Page <a class="reference internal" href="#ts" id="id11">[TS]</a></td>
<td>Up, Down</td>
<td>&nbsp;</td>
</tr>
<tr class="row-even"><td>Half page <a class="reference internal" href="#ts" id="id12">[TS]</a></td>
<td>Up, Down</td>
<td>&nbsp;</td>
</tr>
<tr class="row-odd"><td>Line <a class="reference internal" href="#ts" id="id13">[TS]</a></td>
<td>Up, Down</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="vs" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[VS]</td><td><em>(<a class="fn-backref" href="#id8">1</a>, <a class="fn-backref" href="#id9">2</a>)</em> Default actions from VTE that are not configurable.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="xl" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id10">[XL]</a></td><td>Where X may vary depending on distribution. On mine it is 4.</td></tr>
</tbody>
</table>
<table class="docutils citation" frame="void" id="ts" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[TS]</td><td><em>(<a class="fn-backref" href="#id11">1</a>, <a class="fn-backref" href="#id12">2</a>, <a class="fn-backref" href="#id13">3</a>)</em> Additional movement options from Terminator that are configurable.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="search-the-buffer">
<h2>Search the buffer<a class="headerlink" href="#search-the-buffer" title="Permalink to this headline"></a></h2>
<p>It is possible to search the buffer, although at this time there is
a limitation that the found string is not highlighted.</p>
<table border="1" class="docutils">
<colgroup>
<col width="29%" />
<col width="71%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Begin search</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">F</span></code></td>
</tr>
</tbody>
</table>
<p>Resulting in a search bar at the bottom of the focused terminal:</p>
<img alt="_images/search.png" src="_images/search.png" />
<p>This has buttons for moving back and forward through the results, as
well as an option to wrap the search around.</p>
</div>
<div class="section" id="zooming-the-terminal">
<h2>Zooming the terminal<a class="headerlink" href="#zooming-the-terminal" title="Permalink to this headline"></a></h2>
<p>As mentioned above it is possible to zoom into and out of a terminal.
There are also some modifiers to zoom more than just the current
terminal.</p>
<table border="1" class="docutils">
<colgroup>
<col width="30%" />
<col width="70%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Target in <a class="footnote-reference" href="#id15" id="id14">[4]</a></td>
<td><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">+</span></code>/<code class="docutils literal"><span class="pre">wheelup</span></code></td>
</tr>
<tr class="row-odd"><td>Target out</td>
<td><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">-</span></code>/<code class="docutils literal"><span class="pre">wheeldown</span></code></td>
</tr>
<tr class="row-even"><td>Target reset</td>
<td><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">0</span></code></td>
</tr>
<tr class="row-odd"><td>+Receivers in</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">wheelup</span></code></td>
</tr>
<tr class="row-even"><td>+Receivers out</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">wheeldown</span></code></td>
</tr>
<tr class="row-odd"><td>+Receivers reset</td>
<td>N/A (TBD, plus in/out)</td>
</tr>
<tr class="row-even"><td>All in</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">wheelup</span></code></td>
</tr>
<tr class="row-odd"><td>All out</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">wheeldown</span></code></td>
</tr>
<tr class="row-even"><td>All reset</td>
<td>N/A (TBD, plus in/out)</td>
</tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id15" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id14">[4]</a></td><td>Target terminal is the current terminal when using the
keyboard shortcuts, or the terminal under the mouse when using
the <code class="docutils literal"><span class="pre">wheelup</span></code>/<code class="docutils literal"><span class="pre">wheeldown</span></code>.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="setting-titles">
<h2>Setting Titles<a class="headerlink" href="#setting-titles" title="Permalink to this headline"></a></h2>
<p>If you&#8217;re anything like me, you&#8217;ve spent time clicking among the half a
dozen different terminals in the taskbar, trying to find the right one.
Or maybe for you it is with tabs.</p>
<p>In Terminator you can rename three things:</p>
<table border="1" class="docutils">
<colgroup>
<col width="18%" />
<col width="48%" />
<col width="34%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Edit</th>
<th class="head">Mouse</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Window</td>
<td>N/A</td>
<td><code class="docutils literal"><span class="pre">Alt</span></code>+<code class="docutils literal"><span class="pre">T</span></code></td>
</tr>
<tr class="row-odd"><td>Titlebar</td>
<td><code class="docutils literal"><span class="pre">double-click</span></code> titlebar</td>
<td>N/A (TBD)</td>
</tr>
<tr class="row-even"><td>Tab</td>
<td><code class="docutils literal"><span class="pre">double-click</span></code> tab</td>
<td>N/A (TBD)</td>
</tr>
</tbody>
</table>
<p>Additionally all three can be saved/loaded from a <a class="reference internal" href="layouts.html#layouts"><span>layout</span></a>,
or the window title can be set using a
<a class="reference internal" href="advancedusage.html#command-line-options"><span>command line option</span></a>.</p>
</div>
<div class="section" id="insert-terminal-number">
<span id="insert-termnum-shortcut"></span><h2>Insert terminal number<a class="headerlink" href="#insert-terminal-number" title="Permalink to this headline"></a></h2>
<p>These shortcuts let you enumerate your terminals. It is handy if you
need to login to a number of sequentially numbered machines. With
multiple terminals the ordering may seem strange, but this is due to
the nature of the splitting and the order in which the splits were
performed.</p>
<table border="1" class="docutils">
<colgroup>
<col width="63%" />
<col width="37%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Insert terminal number</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">1</span></code></td>
</tr>
<tr class="row-odd"><td>Insert zero padded terminal number</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">0</span></code></td>
</tr>
</tbody>
</table>
<p>These actions can also be done from <a class="reference internal" href="grouping.html#grouping-menu"><span>The Grouping Menu</span></a>.</p>
</div>
<div class="section" id="next-prev-profile">
<h2>Next/Prev profile<a class="headerlink" href="#next-prev-profile" title="Permalink to this headline"></a></h2>
<p>It is possible to cycle back and forth through the available profiles
that are defined in the <a class="reference internal" href="preferences.html#prefs-profiles"><span>Profiles</span></a> tab of the <a class="reference internal" href="preferences.html#preferences"><span>Preferences Window</span></a>,
changing the behaviour and appearance of the current terminal.</p>
<table border="1" class="docutils">
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Next profile</td>
<td>&nbsp;</td>
</tr>
<tr class="row-odd"><td>Previous profile</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
<p>In both cases there is currently no default shortcut set. I&#8217;m not
convinced they would be used often enough to warrant assigning
them. For those that find it useful, the feature is there to be
configured.</p>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="preferences.html" class="btn btn-neutral float-right" title="Preferences Window" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="history.html" class="btn btn-neutral" title="Document history" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2015, Stephen Boddy, licensed under the CC-BY-SA..
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'1.0 alpha',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink