doc/tabs.txt

   1 The Wonders of Tabbed Browsing
   2 ------------------------------
   3
   4 In this information age with our stream of consciousness constantly being
   5 dispersed by links to different resources on the Net, it is a challenge to keep
   6 track of where you are going.  The need for being able to access several pages
   7 in parallel arises.  Tabbed browsing gives you an easy way to browse multiple
   8 sites in parallel.
   9
  10 If you are not already familiar with the concept of tabbed browsing you can
  11 think of a tab as a separate browsing context with its own history and various
  12 other browsing state information, such as search word and document loading.
  13 Whenever you stumble upon a link to a document that you want to follow without
  14 leaving the current document, you can open it in a new tab.  This makes it
  15 possible to more easily jump between pages on the Net and removes the need for
  16 running more than one ELinks for that purpose.
  17
  18 Options related to tabs are located under ``User Interface -> Window Tabs'' in
  19 the option manager.  In the configuration file the naming prefix is ``ui.tabs''.
  20
  21 Tabbed browsing has been supported since version 0.9.0 and is fairly complete.
  22 The documentation on tabs is therefore divided into two chapters: a general
  23 introduction and an introduction to advanced topics.
  24
  25
  26 Introduction to the basic actions involving tabs
  27 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  28
  29 The tab bar and the tab menu
  30 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  31
  32 The current state of all opened tabs are displayed in the tab bar.  The tab bar
  33 will, by default, become visible when more than one tab is open, but this is
  34 configurable.  For each open tab, the document title will be shown, possibly
  35 truncated.  The current tab is highlighted.  The tab bar will also display
  36 a load meter for tabs that are loading documents.  Finally, any tab that has not
  37 been selected since its document was loaded will be marked as ``fresh'' by using
  38 a different coloring scheme.
  39
  40 The tab menu gives access to tab specific actions along with some other useful
  41 document specific actions.  So even if you haven't configured keybindings for
  42 all actions, chances are you will find it in the tab menu.  By default, it is
  43 opened by pressing 'e'.
  44
  45 Creating new tabs
  46 ^^^^^^^^^^^^^^^^^
  47
  48 When creating new tabs, it is possible to specify whether to create the tab and
  49 make it the current active tab or if the tab is to be created ``in the
  50 background'' -- that is, without it taking over the focus.
  51
  52 Tabs can be created either with or without specifying a desired first document
  53 to load.  That is, you can open links or submitted forms in a new tab or just
  54 open a new tab.  Depending on your configuration, the latter will load the
  55 configured homepage in the newly created tab or simply leave the tab blank with
  56 no loaded document.
  57
  58 By default, 't' will open a new tab and 'T' will open the current link in a new
  59 backgrounded tab.  You can configure keybindings for opening a new tab in the
  60 background and opening the current link as the active tab.
  61
  62 Switching between tabs
  63 ^^^^^^^^^^^^^^^^^^^^^^
  64
  65 By default, it is possible to switch between tabs by using '<' and '>' to select
  66 the previous and next tab, respectively.  When positioned at the leftmost tab,
  67 and switching to the previous tab, the tab switching will perform a wrap-around
  68 so that the rightmost tab will be selected.  The wrap-around behaviour is
  69 configurable.
  70
  71 Closing tabs
  72 ^^^^^^^^^^^^
  73
  74 Tabs can by default be closed by pressing 'c'.  It is possible to optionally
  75 have a confirmation dialog pop up when closing a tab to avoid accidental
  76 closing.  To complement closing of the current tab, it is also possible to close
  77 all tabs but the current one.  No key is by default configured for this; the tab
  78 menu, however, provides this ability.
  79
  80 Note: downloads initiated from a tab are in no way tied to that tab, so tabs can
  81 be closed and the download will not be affected.
  82
  83
  84 Advanced topics involving tabs
  85 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  86
  87 Moving tabs
  88 ^^^^^^^^^^^
  89
  90 Newly created tabs are always positioned as the rightmost tab, but it is
  91 possible to move the current tab either to the left or the right.  The default
  92 keybindings have them bound to Alt-< and Alt->. Note, however, that there are
  93 problems recognizing those keybindings when using XTerm, so you might want to
  94 rebind them.
  95
  96 Saving and restoring tabs
  97 ^^^^^^^^^^^^^^^^^^^^^^^^^
  98
  99 Several features use bookmarks to save tabs; they will create a folder and
 100 bookmark therein the currently displayed document of each tab:
 101
 102 - You can explicitly command all tabs to be bookmarked.  This will ask you for
 103   a folder name in which the tabs will be bookmarked.
 104
 105 - At startup and shutdown tabs can automatically be bookmarked in order to save
 106   and restore the browsing state.  Note that when restoring, all history
 107   information will be gone.  It is possible to configure both tab saving and
 108   restoring via options in ``UI -> Sessions''.
 109
 110 - As a mean of crash protection, tabs can periodically be saved so that it is
 111   later possible to reconstruct opened tabs.  In case of a clean shutdown
 112   periodically saved tabs will be removed.