… | |
… | |
88 | =item selection-popup (enabled by default) |
88 | =item selection-popup (enabled by default) |
89 | |
89 | |
90 | Binds a popup menu to Ctrl-Button3 that lets you convert the selection |
90 | Binds a popup menu to Ctrl-Button3 that lets you convert the selection |
91 | text into various other formats/action (such as uri unescaping, perl |
91 | text into various other formats/action (such as uri unescaping, perl |
92 | evalution, web-browser starting etc.), depending on content. |
92 | evalution, web-browser starting etc.), depending on content. |
|
|
93 | |
|
|
94 | Other extensions can extend this popup menu by pushing a code reference onto |
|
|
95 | C<@urxvt::ext::selection_popup::hook>, that is called whenever the popup is displayed. |
|
|
96 | |
|
|
97 | It's sole argument is the popup menu, which can be modified. The selection |
|
|
98 | is in C<$_>, which can be used to decide wether to add something or not. |
|
|
99 | It should either return nothing or a string and a code reference. The |
|
|
100 | string will be used as button text and the code reference will be called |
|
|
101 | when the button gets activated and should transform C<$_>. |
|
|
102 | |
|
|
103 | The following will add an entry C<a to b> that transforms all C<a>s in |
|
|
104 | the selection to C<b>s, but only if the selection currently contains any |
|
|
105 | C<a>s: |
|
|
106 | |
|
|
107 | push urxvt::ext::selection_popup::hook, sub { |
|
|
108 | /a/ ? ("a to be" => sub { s/a/b/g } |
|
|
109 | : () |
|
|
110 | }; |
93 | |
111 | |
94 | =item searchable-scrollback<hotkey> (enabled by default) |
112 | =item searchable-scrollback<hotkey> (enabled by default) |
95 | |
113 | |
96 | Adds regex search functionality to the scrollback buffer, triggered |
114 | Adds regex search functionality to the scrollback buffer, triggered |
97 | by a hotkey (default: C<M-s>). While in search mode, normal terminal |
115 | by a hotkey (default: C<M-s>). While in search mode, normal terminal |
… | |
… | |
164 | window. Illustrates overwriting the refresh callbacks to create your own |
182 | window. Illustrates overwriting the refresh callbacks to create your own |
165 | overlays or changes. |
183 | overlays or changes. |
166 | |
184 | |
167 | =item selection-pastebin |
185 | =item selection-pastebin |
168 | |
186 | |
169 | Uploads the selection as textfile to a remote site. |
187 | This is a little rarely useful extension that Uploads the selection as |
|
|
188 | textfile to a remote site (or does other things). (The implementation is |
|
|
189 | not currently secure for use in a multiuser environment as it writes to |
|
|
190 | F</tmp> directly.). |
|
|
191 | |
|
|
192 | It listens to the C<selection-pastebin:remote-pastebin> keyboard command, |
|
|
193 | i.e. |
170 | |
194 | |
171 | URxvt.keysym.C-M-e: perl:selection-pastebin:remote-pastebin |
195 | URxvt.keysym.C-M-e: perl:selection-pastebin:remote-pastebin |
172 | |
196 | |
173 | To set the command to upload the file set this resource: |
197 | Pressing this combination runs a command with C<%> replaced by the name of |
|
|
198 | the textfile. This command can be set via a resource: |
174 | |
199 | |
175 | URxvt.selection-pastebin-cmd: rsync -apP % ruth:/var/www/www.ta-sa.org/files/txt/. |
200 | URxvt.selection-pastebin.cmd: rsync -apP % ruth:/var/www/www.ta-sa.org/files/txt/. |
176 | |
201 | |
177 | The % is the placeholder for the textfile. The name of the textfile is the hex encoded |
202 | And the default is likely not useful to anybody but the few people around |
178 | md5 sum of the selection. |
203 | here :) |
|
|
204 | |
|
|
205 | The name of the textfile is the hex encoded md5 sum of the selection, so |
|
|
206 | the same content should lead to the same filename. |
|
|
207 | |
179 | After an successful upload the selection will be replaced by the following url |
208 | After a successful upload the selection will be replaced by the text given |
180 | (the % is the placeholder for the filename): |
209 | in the C<selection-pastebin-url> resource (again, the % is the placeholder |
|
|
210 | for the filename): |
181 | |
211 | |
182 | URxvt.selection-pastebin-url: http://www.ta-sa.org/files/txt/% |
212 | URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% |
183 | |
213 | |
184 | =back |
214 | =back |
185 | |
215 | |
186 | =head1 API DOCUMENTATION |
216 | =head1 API DOCUMENTATION |
187 | |
217 | |
… | |
… | |
403 | |
433 | |
404 | =item on_focus_out $term |
434 | =item on_focus_out $term |
405 | |
435 | |
406 | Called wheneever the window loses keyboard focus, before rxvt-unicode does |
436 | Called wheneever the window loses keyboard focus, before rxvt-unicode does |
407 | focus out processing. |
437 | focus out processing. |
|
|
438 | |
|
|
439 | =item on_configure_notify $term, $event |
408 | |
440 | |
409 | =item on_key_press $term, $event, $keysym, $octets |
441 | =item on_key_press $term, $event, $keysym, $octets |
410 | |
442 | |
411 | =item on_key_release $term, $event, $keysym |
443 | =item on_key_release $term, $event, $keysym |
412 | |
444 | |
… | |
… | |
583 | =back |
615 | =back |
584 | |
616 | |
585 | =cut |
617 | =cut |
586 | |
618 | |
587 | BEGIN { |
619 | BEGIN { |
588 | urxvt->bootstrap; |
|
|
589 | |
|
|
590 | # overwrite perl's warn |
620 | # overwrite perl's warn |
591 | *CORE::GLOBAL::warn = sub { |
621 | *CORE::GLOBAL::warn = sub { |
592 | my $msg = join "", @_; |
622 | my $msg = join "", @_; |
593 | $msg .= "\n" |
623 | $msg .= "\n" |
594 | unless $msg =~ /\n$/; |
624 | unless $msg =~ /\n$/; |
… | |
… | |
607 | sub verbose { |
637 | sub verbose { |
608 | my ($level, $msg) = @_; |
638 | my ($level, $msg) = @_; |
609 | warn "$msg\n" if $level <= $verbosity; |
639 | warn "$msg\n" if $level <= $verbosity; |
610 | } |
640 | } |
611 | |
641 | |
612 | my $extension_pkg = "extension0000"; |
|
|
613 | my %extension_pkg; |
642 | my %extension_pkg; |
614 | |
643 | |
615 | # load a single script into its own package, once only |
644 | # load a single script into its own package, once only |
616 | sub extension_package($) { |
645 | sub extension_package($) { |
617 | my ($path) = @_; |
646 | my ($path) = @_; |
618 | |
647 | |
|
|
648 | no strict 'refs'; |
|
|
649 | |
619 | $extension_pkg{$path} ||= do { |
650 | $extension_pkg{$path} ||= do { |
620 | my $pkg = "urxvt::" . ($extension_pkg++); |
651 | $path =~ /([^\/\\]+)$/; |
|
|
652 | my $pkg = $1; |
|
|
653 | $pkg =~ s/[^[:word:]]/_/g; |
|
|
654 | $pkg = "urxvt::ext::$pkg"; |
621 | |
655 | |
622 | verbose 3, "loading extension '$path' into package '$pkg'"; |
656 | verbose 3, "loading extension '$path' into package '$pkg'"; |
623 | |
657 | |
624 | open my $fh, "<:raw", $path |
658 | open my $fh, "<:raw", $path |
625 | or die "$path: $!"; |
659 | or die "$path: $!"; |
626 | |
660 | |
|
|
661 | @{"$pkg\::ISA"} = urxvt::term::extension::; |
|
|
662 | |
627 | my $source = |
663 | my $source = |
628 | "package $pkg; use strict; use utf8;\n" |
664 | "package $pkg; use strict; use utf8;\n" |
629 | . "use base urxvt::term::extension::;\n" |
|
|
630 | . "#line 1 \"$path\"\n{\n" |
665 | . "#line 1 \"$path\"\n{\n" |
631 | . (do { local $/; <$fh> }) |
666 | . (do { local $/; <$fh> }) |
632 | . "\n};\n1"; |
667 | . "\n};\n1"; |
633 | |
668 | |
634 | eval $source |
669 | eval $source |