2015-08-08 02:11:30 +00:00
<!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 > Layouts and the Layout Launcher — 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 = "The Grouping Menu" href = "grouping.html" / >
< link rel = "prev" title = "Preferences Window" href = "preferences.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" > < a class = "reference internal" href = "gettingstarted.html" > Getting Started< / a > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#the-context-menu" > The Context Menu< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#navigating-around" > Navigating around< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "gettingstarted.html#click-able-items" > Click-able items< / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#changing-the-current-layout" > Changing the current layout< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "gettingstarted.html#using-the-splitters" > Using the splitters< / a > < / li >
< li class = "toctree-l3" > < a class = "reference internal" href = "gettingstarted.html#dragging-and-dropping-a-terminal" > Dragging and dropping a terminal< / a > < / li >
< li class = "toctree-l3" > < a class = "reference internal" href = "gettingstarted.html#using-the-keyboard" > Using the keyboard< / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#resetting-the-terminal" > Resetting the terminal< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#the-scrollbar-and-scrollback-buffer" > The scrollbar and scrollback buffer< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#search-the-buffer" > Search the buffer< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#zooming-the-terminal" > Zooming the terminal< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#setting-titles" > Setting Titles< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#insert-terminal-number" > Insert terminal number< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettingstarted.html#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 current" > < a class = "current reference internal" href = "" > Layouts and the Layout Launcher< / a > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "#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’ 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" > “ Python sucks!” < / 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 >
2015-08-21 00:11:31 +00:00
< li class = "toctree-l2" > < a class = "reference internal" href = "gettinginvolved.html#terminator-api-docs" > Terminator API Docs< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "gettinginvolved.html#other-docs-for-developers" > Other Docs for Developers< / a > < / li >
2015-08-08 02:11:30 +00:00
< / ul >
< / li >
< / ul >
< / div >
< / 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 > » < / li >
< li > Layouts and the Layout Launcher< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "_sources/layouts.txt" rel = "nofollow" > View page source< / a >
< / li >
< / ul >
< hr / >
< / div >
< div role = "main" class = "document" >
< img alt = "Favourites. Stars or hearts, and hearts won't look good on the red backbround." class = "align-right" src = "_images/icon_layout.png" / >
< div class = "section" id = "layouts-and-the-layout-launcher" >
< span id = "layouts" > < / span > < h1 > Layouts and the Layout Launcher< a class = "headerlink" href = "#layouts-and-the-layout-launcher" title = "Permalink to this headline" > ¶< / a > < / h1 >
< p > < strong > Layouts< / strong > are how Terminator helps you quickly start a given set of
windows with the terminals arranged just how you like, and even
launching unique commands in each one.< / p >
< p > You have already seen a glimpse of this in the < a class = "reference internal" href = "preferences.html#prefs-layouts" > < span > Layouts< / span > < / a >
tab of the < a class = "reference internal" href = "preferences.html#preferences" > < span > Preferences Window< / span > < / a > . Here it is again:< / p >
< img alt = "_images/prefs_layouts.png" src = "_images/prefs_layouts.png" / >
< p > It’ s simple to create a new layout. Just launch new windows, add tabs
and splits, arrange them, and customise them to your liking.< / p >
< p > Layouts will currently directly detect and save:< / p >
< ul class = "simple" >
< li > Window sizes and positions as well as the fullscreen or maximised state< / li >
< li > Splitter positions< / li >
< li > Custom window, tab and titlebar names< / li >
< li > The profile of each terminal< / li >
< li > Group setting of each terminal< / li >
< li > The active terminal per window or tab, and the active tab per window if applicable< / li >
< li > The UUID of each terminal< / li >
< / ul >
< p > When done, use the < a class = "reference internal" href = "preferences.html#prefs-layouts" > < span > Layouts< / span > < / a > section of the < a class = "reference internal" href = "preferences.html#preferences" > < span > Preferences Window< / span > < / a >
to keep this layout for future use. You save them by using the < strong > Add< / strong >
or < strong > Save< / strong > buttons, where < em > Add< / em > creates a new layout entry and
prompts for a name, and < em > Save< / em > updates the currently selected layout.< / p >
< div class = "admonition warning" >
< p class = "first admonition-title" > Warning< / p >
< p > Currently some things are not detected by the code, and
have to be configured in the < a class = "reference internal" href = "preferences.html#prefs-layouts" > < span > Layouts< / span > < / a > tab of
the < a class = "reference internal" href = "preferences.html#preferences" > < span > Preferences Window< / span > < / a > < em > after< / em > the layout is saved/added.< / p >
< p > This means that if you use the < em > Save< / em > button in the
< a class = "reference internal" href = "preferences.html#prefs-layouts" > < span > Layouts< / span > < / a > after spending time setting the
items below, you < em > will< / em > lose these stored values.< / p >
< ul class = "simple" >
< li > Custom command< / li >
< li > Working directory< / li >
< / ul >
< p > First get the layout right, then edit these within the
< a class = "reference internal" href = "preferences.html#prefs-layouts" > < span > Layouts< / span > < / a > tab of the < a class = "reference internal" href = "preferences.html#preferences" > < span > Preferences Window< / span > < / a > . You
do < strong > not< / strong > need to use the < em > Save< / em > button to keep these
settings.< / p >
< p class = "last" > There is potential to improve this behaviour.< / p >
< / div >
< div class = "section" id = "the-layout-launcher" >
< span id = "layout-launcher" > < / span > < h2 > The Layout Launcher< a class = "headerlink" href = "#the-layout-launcher" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > You can set up an application launcher with the < code class = "docutils literal" > < span class = "pre" > -l< / span > < span class = "pre" > LAYOUT< / span > < / code > option
which will load the named layout, but what if you have a long list of
layouts, like me? It can be annoying distinguishing between 30 items
with the same icon, waiting for a tool-tip to tell you which one you’ re
about to launch. No-one has the stamina to draw 30 distinct icons
representing all these layouts either!< / p >
< img alt = "_images/layoutlauncher.png" class = "align-right" src = "_images/layoutlauncher.png" / >
< p > Enter the < strong > Layout Launcher< / strong > , as shown on the right. This will list
all of your saved layouts in alphabetical order, apart from
< em > default< / em > , which is always at the top. You can < code class = "docutils literal" > < span class = "pre" > double-click< / span > < / code > an
entry, highlight it and select < strong > Launch< / strong > , or use the keyboard to move
the highlight, pressing < code class = "docutils literal" > < span class = "pre" > Return< / span > < / code > to launch.< / p >
< p > The < em > Layout Launcher< / em > can be opened from a running terminal using a
shortcut, or by running Terminator with the < code class = "docutils literal" > < span class = "pre" > -s< / span > < / code > option. This
option could be set in an application launcher, to get to the Layout
Launcher with a single click.< / p >
< p > You can have more than one < em > Layout Launcher< / em > window open, or you could
launch one at the beginning, and pin it to always be on the visible
workspace.< / p >
< p > Here’ s a brief run-down of keyboard and mouse use:< / p >
< table border = "1" class = "docutils" >
< colgroup >
< col width = "40%" / >
< col width = "28%" / >
< col width = "32%" / >
< / colgroup >
< thead valign = "bottom" >
< tr class = "row-odd" > < th class = "head" > Action< / th >
< th class = "head" > Mouse< / th >
< th class = "head" > Default Shortcut< / th >
< / tr >
< / thead >
< tbody valign = "top" >
< tr class = "row-even" > < td > Open the Layout Launcher< / td >
< td > N/A< / td >
< td > < code class = "docutils literal" > < span class = "pre" > Alt< / span > < / code > +< code class = "docutils literal" > < span class = "pre" > L< / span > < / code > < / td >
< / tr >
< tr class = "row-odd" > < td > Move Up/Down list< / td >
< td > < code class = "docutils literal" > < span class = "pre" > click< / span > < / code > < / td >
< td > < code class = "docutils literal" > < span class = "pre" > < Up/Down< / span > < span class = "pre" > Arrow> < / span > < / code > < / td >
< / tr >
< tr class = "row-even" > < td > Launch a layout< / td >
< td > < code class = "docutils literal" > < span class = "pre" > double-click< / span > < / code > < / td >
< td > < code class = "docutils literal" > < span class = "pre" > Return< / span > < / code > < / td >
< / tr >
< / tbody >
< / table >
< / div >
< / div >
< / div >
< footer >
< div class = "rst-footer-buttons" role = "navigation" aria-label = "footer navigation" >
< a href = "grouping.html" class = "btn btn-neutral float-right" title = "The Grouping Menu" accesskey = "n" > Next < span class = "fa fa-arrow-circle-right" > < / span > < / a >
< a href = "preferences.html" class = "btn btn-neutral" title = "Preferences Window" accesskey = "p" > < span class = "fa fa-arrow-circle-left" > < / span > Previous< / a >
< / div >
< hr / >
< div role = "contentinfo" >
< p >
© 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 >
