mirror of
https://github.com/gryf/tabbedalt.git
synced 2025-12-17 11:30:31 +01:00
Renamed tabbed to tabbedalt.
To not confuse people with original extension, I renamed tabbed to tabbedalt, which can be read as "tabbed alternative".
This commit is contained in:
60
README.rst
60
README.rst
@@ -1,9 +1,9 @@
|
||||
======
|
||||
Tabbed
|
||||
======
|
||||
=========
|
||||
Tabbedalt
|
||||
=========
|
||||
|
||||
This is modified tabbed extension for well known `urxvt-unicode`_ terminal
|
||||
emulator
|
||||
This is modified, alternative tabbed extension for well known `urxvt-unicode`_
|
||||
terminal emulator
|
||||
|
||||
Features
|
||||
--------
|
||||
@@ -20,7 +20,7 @@ Features
|
||||
* Fast navigation to first ten tabs (if available) with shortcut ``Ctrl+[num]``,
|
||||
where *num* can be 0 to 9. ``CTRL+0`` will switch to tenth tab.
|
||||
* Numbers in tabs can be switched off in by setting
|
||||
resource:``URxvt.tabbed.tab-numbers: false``
|
||||
resource:``URxvt.tabbedalt.tab-numbers: false``
|
||||
* Integrated `activity indicator`_ with additional features like colors and
|
||||
different characters instead of simply asterisk depending on time.
|
||||
|
||||
@@ -33,12 +33,12 @@ Features
|
||||
Installation
|
||||
------------
|
||||
|
||||
Copy tabbed into ``~/.urxvt/ext`` directory.
|
||||
Copy tabbedalt into ``~/.urxvt/ext`` directory.
|
||||
|
||||
Add these to your ``~/.Xdefaults``::
|
||||
|
||||
! Perl extension config
|
||||
URxvt.perl-ext: tabbed
|
||||
URxvt.perl-ext: tabbedalt
|
||||
|
||||
And that's it. On some systems, there might be a need to reload X resources:
|
||||
|
||||
@@ -58,20 +58,20 @@ New button
|
||||
You can disable ``[NEW]`` button, just to save the space. Just add following
|
||||
line to yours ``~/.Xdefaults`` file::
|
||||
|
||||
URxvt.tabbed.new-button: false
|
||||
URxvt.tabbedalt.new-button: false
|
||||
|
||||
Colors
|
||||
~~~~~~
|
||||
|
||||
You can change all of the colors regarding tabs appearance. Here are defaults::
|
||||
|
||||
URxvt.tabbed.tabbar-fg: 15
|
||||
URxvt.tabbed.tabbar-bg: 8
|
||||
URxvt.tabbed.tab-fg: 8
|
||||
URxvt.tabbed.tab-bg: 0
|
||||
URxvt.tabbed.active-fg: 1
|
||||
URxvt.tabbed.actives-fg: 5
|
||||
URxvt.tabbed.actived-fg: 4
|
||||
URxvt.tabbedalt.tabbar-fg: 15
|
||||
URxvt.tabbedalt.tabbar-bg: 8
|
||||
URxvt.tabbedalt.tab-fg: 8
|
||||
URxvt.tabbedalt.tab-bg: 0
|
||||
URxvt.tabbedalt.active-fg: 1
|
||||
URxvt.tabbedalt.actives-fg: 5
|
||||
URxvt.tabbedalt.actived-fg: 4
|
||||
|
||||
Tab activity
|
||||
~~~~~~~~~~~~
|
||||
@@ -80,7 +80,7 @@ Tabs can change colors depending on the activity of terminal under certain tab.
|
||||
Colors can be defined as described in section above. You can change the time
|
||||
for either *group* of activity::
|
||||
|
||||
URxvt.tabbed.tabbar-timeouts: 16:.:8:::4:+
|
||||
URxvt.tabbedalt.tabbar-timeouts: 16:.:8:::4:+
|
||||
|
||||
The value can should be read as colon separated fields. In this case it would
|
||||
be read as:
|
||||
@@ -108,7 +108,7 @@ Tab numbers
|
||||
You can turn off tab numbers and leave only name of the tab. Handy to save the
|
||||
space::
|
||||
|
||||
URxvt.tabbed.tab-numbers: false
|
||||
URxvt.tabbedalt.tab-numbers: false
|
||||
|
||||
Creating custom classes
|
||||
-----------------------
|
||||
@@ -121,11 +121,11 @@ Let's assume, that one want to add three kind of custom shells:
|
||||
|
||||
Three resources should be created in ``.Xdefaults``::
|
||||
|
||||
URxvt.tabbed.tabcmds.1: N|shell
|
||||
URxvt.tabbed.tabcmds.2: R|root|su -
|
||||
URxvt.tabbed.tabcmds.3: M|mc|mc
|
||||
URxvt.tabbedalt.tabcmds.1: N|shell
|
||||
URxvt.tabbedalt.tabcmds.2: R|root|su -
|
||||
URxvt.tabbedalt.tabcmds.3: M|mc|mc
|
||||
|
||||
Numbered attribute just after ``URxvt.tabbed.tabcmds`` resource is an ordinal
|
||||
Numbered attribute just after ``URxvt.tabbedalt.tabcmds`` resource is an ordinal
|
||||
number, started from 1. There shouldn't be gaps between numbers, otherwise
|
||||
custom shells defined after a gap will not work.
|
||||
|
||||
@@ -146,34 +146,34 @@ By default, there is default shortcut available for creating standard shell
|
||||
(like the *shell* class from example above) under ``Shift+Down``. It might be
|
||||
however disabled by setting::
|
||||
|
||||
URxvt.tabbed.disable-shift-down: true
|
||||
URxvt.tabbedalt.disable-shift-down: true
|
||||
|
||||
and from now on, default ``Ctrl+Shift+N`` shortcut will be available for
|
||||
creating new shell, if there is no existing mapping for this shortcut. You can
|
||||
override the mapping for something different, getting above example, we will
|
||||
override first class, which reside under shortcut ``Ctrl+Shift+N``::
|
||||
|
||||
URxvt.tabbed.tabcmds.1: N|rss|newsboat
|
||||
URxvt.tabbedalt.tabcmds.1: N|rss|newsboat
|
||||
|
||||
But beware, from now on, you'll be unable to create simple shell tabs, unless
|
||||
you explicitly create class for a shell, so the full changed example will looks
|
||||
like::
|
||||
|
||||
URxvt.tabbed.tabcmds.1: N|rss|newsboat
|
||||
URxvt.tabbed.tabcmds.2: R|root|su -
|
||||
URxvt.tabbed.tabcmds.3: M|mc|mc
|
||||
URxvt.tabbed.tabcmds.4: S|shell
|
||||
URxvt.tabbedalt.tabcmds.1: N|rss|newsboat
|
||||
URxvt.tabbedalt.tabcmds.2: R|root|su -
|
||||
URxvt.tabbedalt.tabcmds.3: M|mc|mc
|
||||
URxvt.tabbedalt.tabcmds.4: S|shell
|
||||
|
||||
Startup tabs
|
||||
------------
|
||||
|
||||
There is possibility to tell tabbed which tabs should be auto started during
|
||||
There is possibility to tell tabbedalt which tabs should be auto started during
|
||||
first window launch. First, you'll need to have some custom tab commands.
|
||||
Let's assume, that there are already defined three custom shells, like in
|
||||
section above. If one wanted to start shell, mc and root session, following
|
||||
line should be placed in ``~/.Xdefaults``::
|
||||
|
||||
URxvt.tabbed.session: S|M|R
|
||||
URxvt.tabbedalt.session: S|M|R
|
||||
|
||||
Renaming tabs
|
||||
-------------
|
||||
|
||||
@@ -55,11 +55,11 @@
|
||||
# midnight commander and root (namely - su command). Three resources should
|
||||
# be created:
|
||||
#
|
||||
# URxvt.tabbed.tabcmds.1: N|shell
|
||||
# URxvt.tabbed.tabcmds.2: R|root|su -
|
||||
# URxvt.tabbed.tabcmds.3: M|mc|mc
|
||||
# URxvt.tabbedalt.tabcmds.1: N|shell
|
||||
# URxvt.tabbedalt.tabcmds.2: R|root|su -
|
||||
# URxvt.tabbedalt.tabcmds.3: M|mc|mc
|
||||
#
|
||||
# URxvt.tabbed.tabcmds.[number] is a ordinal number, started from 1. There
|
||||
# URxvt.tabbedalt.tabcmds.[number] is a ordinal number, started from 1. There
|
||||
# shouldn't be gaps between numbers, otherwise custom shells defined after a
|
||||
# gap will not work.
|
||||
#
|
||||
@@ -210,10 +210,10 @@ sub new_tab {
|
||||
if defined $value;
|
||||
}
|
||||
|
||||
$term->resource (perl_ext_2 => $term->resource ("perl_ext_2") . ",-tabbed");
|
||||
$term->resource (perl_ext_2 => $term->resource ("perl_ext_2") . ",-tabbedalt");
|
||||
};
|
||||
|
||||
push @urxvt::TERM_EXT, urxvt::ext::tabbed::tab::;
|
||||
push @urxvt::TERM_EXT, urxvt::ext::tabbedalt::tab::;
|
||||
|
||||
my $term = new urxvt::term
|
||||
$self->env, $urxvt::RXVTNAME,
|
||||
@@ -377,7 +377,7 @@ sub on_init {
|
||||
$self->{resource} = [map $self->resource ("+$_"), 0 .. urxvt::NUM_RESOURCES - 1];
|
||||
|
||||
$self->resource (int_bwidth => 0);
|
||||
$self->resource (name => "URxvt.tabbed");
|
||||
$self->resource (name => "URxvt.tabbedalt");
|
||||
$self->resource (pty_fd => -1);
|
||||
|
||||
$self->option ($urxvt::OPTION{scrollBar}, 0);
|
||||
@@ -652,7 +652,7 @@ sub tab_property_notify {
|
||||
()
|
||||
}
|
||||
|
||||
package urxvt::ext::tabbed::tab;
|
||||
package urxvt::ext::tabbedalt::tab;
|
||||
|
||||
# helper extension implementing the subwindows of a tabbed terminal.
|
||||
# simply proxies all interesting calls back to the tabbed class.
|
||||
Reference in New Issue
Block a user