terminator_config: move 'default value' to the end of description
This commit is contained in:
parent
9b93abb8fe
commit
9a63671fe8
|
@ -2,12 +2,11 @@
|
||||||
:doctype: manpage
|
:doctype: manpage
|
||||||
:manmanual: Manual for Terminator
|
:manmanual: Manual for Terminator
|
||||||
:mansource: Terminator
|
:mansource: Terminator
|
||||||
:revdate: 2023-03-31
|
:revdate: 2023-04-03
|
||||||
:docdate: {revdate}
|
:docdate: {revdate}
|
||||||
|
|
||||||
== NAME
|
== NAME
|
||||||
// ~/.config/terminator/config - the config file for Terminator terminal emulator
|
terminator_config - the config file for Terminator terminal emulator
|
||||||
config - TODO
|
|
||||||
|
|
||||||
== DESCRIPTION
|
== DESCRIPTION
|
||||||
This file contains the configuration for *terminator*(1).
|
This file contains the configuration for *terminator*(1).
|
||||||
|
@ -51,173 +50,173 @@ These are the options Terminator currently supports in the
|
||||||
// --- Window behavior ---
|
// --- Window behavior ---
|
||||||
|
|
||||||
*window_state* = _string_::
|
*window_state* = _string_::
|
||||||
Default value: *normal* +
|
|
||||||
Control how the Terminator window opens.
|
Control how the Terminator window opens.
|
||||||
'normal' means it opens normally.
|
'normal' means it opens normally.
|
||||||
'maximise' means it opens in a maximised state.
|
'maximise' means it opens in a maximised state.
|
||||||
'fullscreen' means it opens in a fullscreen state.
|
'fullscreen' means it opens in a fullscreen state.
|
||||||
'hidden' means it stays hidden.
|
'hidden' means it stays hidden. +
|
||||||
|
Default value: *normal*
|
||||||
|
|
||||||
*always_on_top* = _boolean_::
|
*always_on_top* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, the window will always stay on top of other windows. +
|
||||||
If set to True, the window will always stay on top of other windows.
|
Default value: *False*
|
||||||
|
|
||||||
*sticky* = _boolean_::
|
*sticky* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*hide_on_lose_focus* = _boolean_::
|
*hide_on_lose_focus* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*hide_from_taskbar* = _boolean_::
|
*hide_from_taskbar* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*geometry_hinting* = _boolean_::
|
*geometry_hinting* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, the window will resize in step with font sizes. +
|
||||||
If set to True, the window will resize in step with font sizes.
|
Default value: *False*
|
||||||
|
|
||||||
*suppress_multiple_term_dialog* = _boolean_::
|
*suppress_multiple_term_dialog* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, Terminator will ask for confirmation when closing
|
If set to True, Terminator will ask for confirmation when closing
|
||||||
multiple terminals.
|
multiple terminals. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
// --- Window appearance ---
|
// --- Window appearance ---
|
||||||
|
|
||||||
*borderless* = _boolean_::
|
*borderless* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, the window will be started without window borders. +
|
||||||
If set to True, the window will be started without window borders.
|
Default value: *False*
|
||||||
|
|
||||||
=== Tab Behavior & Appearance
|
=== Tab Behavior & Appearance
|
||||||
|
|
||||||
*tab_position* = _string_::
|
*tab_position* = _string_::
|
||||||
Default value: *top* +
|
|
||||||
Specify where tabs are placed.
|
Specify where tabs are placed.
|
||||||
Can be any of: 'top', 'left', 'right', 'bottom', 'hidden'.
|
Can be any of: 'top', 'left', 'right', 'bottom', 'hidden'.
|
||||||
If set to 'hidden', the tab bar will not be shown. Hiding the tab is not
|
If set to 'hidden', the tab bar will not be shown. Hiding the tab is not
|
||||||
recommended, as it can be very confusing.
|
recommended, as it can be very confusing. +
|
||||||
|
Default value: *top*
|
||||||
|
|
||||||
*close_button_on_tab* = _boolean_::
|
*close_button_on_tab* = _boolean_::
|
||||||
Default value: *True* +
|
If set to True, tabs will have a close button on them. +
|
||||||
If set to True, tabs will have a close button on them.
|
Default value: *True*
|
||||||
|
|
||||||
// what is this???
|
// what is this???
|
||||||
*scroll_tabbar* = _boolean_::
|
*scroll_tabbar* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the tab bar will not fill the width of the window.
|
If set to True, the tab bar will not fill the width of the window.
|
||||||
The titlebars of the tabs will only take as much space as is necessary
|
The titlebars of the tabs will only take as much space as is necessary
|
||||||
for the text they contain. Except, that is, if the tabs no longer fit
|
for the text they contain. Except, that is, if the tabs no longer fit
|
||||||
the width of the window - in that case scroll buttons will appear to
|
the width of the window - in that case scroll buttons will appear to
|
||||||
move through the tabs.
|
move through the tabs. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*homogeneous_tabbar* = _boolean_::
|
*homogeneous_tabbar* = _boolean_::
|
||||||
Default value: *True* +
|
TODO +
|
||||||
TODO
|
Default value: *True*
|
||||||
|
|
||||||
=== Terminal Behavior & Appearance
|
=== Terminal Behavior & Appearance
|
||||||
|
|
||||||
// --- Terminal behavior ---
|
// --- Terminal behavior ---
|
||||||
|
|
||||||
*focus* = _string_::
|
*focus* = _string_::
|
||||||
Default value: *click* +
|
|
||||||
Specify how focus is given to terminals.
|
Specify how focus is given to terminals.
|
||||||
'click' means the focus only moves to a terminal after you click in it.
|
'click' means the focus only moves to a terminal after you click in it.
|
||||||
'sloppy' means the focus will follow the mouse pointer.
|
'sloppy' means the focus will follow the mouse pointer.
|
||||||
'system' means the focus will match that used by a GNOME window manager.
|
'system' means the focus will match that used by a GNOME window manager. +
|
||||||
|
Default value: *click*
|
||||||
|
|
||||||
*always_split_with_profile* = _boolean_::
|
*always_split_with_profile* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
Specify whether splits/tabs will continue to use the profile of their
|
Specify whether splits/tabs will continue to use the profile of their
|
||||||
peer terminal. If set to False, they will always use the default profile.
|
peer terminal. If set to False, they will always use the default profile. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*link_single_click* = _boolean_::
|
*link_single_click* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, clicking a link will open it even if *Ctrl* is not
|
If set to True, clicking a link will open it even if *Ctrl* is not
|
||||||
pressed.
|
pressed. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
// --- Copy & Paste behavior ---
|
// --- Copy & Paste behavior ---
|
||||||
|
|
||||||
*putty_paste_style* = _boolean_::
|
*putty_paste_style* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, right-click will paste the Primary selection,
|
If set to True, right-click will paste the Primary selection,
|
||||||
while middle-click will popup the context menu.
|
while middle-click will popup the context menu. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*putty_paste_style_source_clipboard* = _boolean_::
|
*putty_paste_style_source_clipboard* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*disable_mouse_paste* = _boolean_::
|
*disable_mouse_paste* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, mouse pasting will be disabled. +
|
||||||
If set to True, mouse pasting will be disabled.
|
Default value: *False*
|
||||||
|
|
||||||
*smart_copy* = _boolean_::
|
*smart_copy* = _boolean_::
|
||||||
Default value: *True* +
|
|
||||||
If set to True, and there is no selection, the shortcut is allowed to
|
If set to True, and there is no selection, the shortcut is allowed to
|
||||||
pass through. This is useful for overloading Ctrl-C to copy a selection,
|
pass through. This is useful for overloading Ctrl-C to copy a selection,
|
||||||
or send the SIGINT to the current process if there is no selection.
|
or send the SIGINT to the current process if there is no selection.
|
||||||
If False, the shortcut does not pass through at all, and the SIGINT does
|
If False, the shortcut does not pass through at all, and the SIGINT does
|
||||||
not get sent.
|
not get sent. +
|
||||||
|
Default value: *True*
|
||||||
|
|
||||||
*clear_select_on_copy* = _boolean_::
|
*clear_select_on_copy* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
// --- Terminal appearance ---
|
// --- Terminal appearance ---
|
||||||
|
|
||||||
*handle_size* = _integer_::
|
*handle_size* = _integer_::
|
||||||
Default value: *1* +
|
|
||||||
Specify the width of the separator between terminals.
|
Specify the width of the separator between terminals.
|
||||||
Anything outside the range 0-20 (inclusive) will be ignored and use your
|
Anything outside the range 0-20 (inclusive) will be ignored and use your
|
||||||
default theme value.
|
default theme value. +
|
||||||
|
Default value: *1*
|
||||||
|
|
||||||
*inactive_color_offset* = _float_::
|
*inactive_color_offset* = _float_::
|
||||||
Default value: *0.8* +
|
|
||||||
Specify how much to reduce the color values of fonts in terminals that
|
Specify how much to reduce the color values of fonts in terminals that
|
||||||
do not have focus.
|
do not have focus. +
|
||||||
|
Default value: *0.8*
|
||||||
|
|
||||||
*inactive_bg_color_offset* = _float_::
|
*inactive_bg_color_offset* = _float_::
|
||||||
Default value: *1.0* +
|
|
||||||
Specify how much to reduce the color values of the background in
|
Specify how much to reduce the color values of the background in
|
||||||
terminals that do not have focus.
|
terminals that do not have focus. +
|
||||||
|
Default value: *1.0*
|
||||||
|
|
||||||
*cell_width* = _float_::
|
*cell_width* = _float_::
|
||||||
Default value: *1.0* +
|
TODO +
|
||||||
TODO
|
Default value: *1.0*
|
||||||
|
|
||||||
*cell_height* = _float_::
|
*cell_height* = _float_::
|
||||||
Default value: *1.0* +
|
TODO +
|
||||||
TODO
|
Default value: *1.0*
|
||||||
|
|
||||||
*title_at_bottom* = _boolean_::
|
*title_at_bottom* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the terminal's titlebar will be drawn at the bottom
|
If set to True, the terminal's titlebar will be drawn at the bottom
|
||||||
instead of the top.
|
instead of the top. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
=== Miscellaneous
|
=== Miscellaneous
|
||||||
|
|
||||||
*dbus* = _boolean_::
|
*dbus* = _boolean_::
|
||||||
Default value: *True* +
|
|
||||||
Specify whether Terminator will load its DBus server.
|
Specify whether Terminator will load its DBus server.
|
||||||
When this server is loaded, running Terminator multiple times will cause
|
When this server is loaded, running Terminator multiple times will cause
|
||||||
the first Terminator process to open additional windows.
|
the first Terminator process to open additional windows.
|
||||||
If this configuration item is set to False, or the python dbus module is
|
If this configuration item is set to False, or the python dbus module is
|
||||||
unavailable, running Terminator multiple times will run a separate
|
unavailable, running Terminator multiple times will run a separate
|
||||||
Terminator process for each invocation.
|
Terminator process for each invocation. +
|
||||||
|
Default value: *True*
|
||||||
|
|
||||||
*extra_styling* = _boolean_::
|
*extra_styling* = _boolean_::
|
||||||
Default value: *True* +
|
TODO +
|
||||||
TODO
|
Default value: *True*
|
||||||
|
|
||||||
*broadcast_default* = _string_::
|
*broadcast_default* = _string_::
|
||||||
Default value: *group* +
|
|
||||||
Specify the default broadcast behavior.
|
Specify the default broadcast behavior.
|
||||||
Can be any of: 'all', 'group', 'off'.
|
Can be any of: 'all', 'group', 'off'. +
|
||||||
|
Default value: *group*
|
||||||
|
|
||||||
*use_custom_url_handler* = _boolean_::
|
*use_custom_url_handler* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, URL handling will be given over entirely to the program
|
If set to True, URL handling will be given over entirely to the program
|
||||||
specified by 'custom_url_handler'.
|
specified by 'custom_url_handler'. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*custom_url_handler* = _string_::
|
*custom_url_handler* = _string_::
|
||||||
Specify the path to a program which accepts a URI as an argument and
|
Specify the path to a program which accepts a URI as an argument and
|
||||||
|
@ -225,17 +224,17 @@ does something relevant with it.
|
||||||
This option is ignored unless *use_custom_url_handler* is set to True.
|
This option is ignored unless *use_custom_url_handler* is set to True.
|
||||||
|
|
||||||
*case_sensitive* = _boolean_::
|
*case_sensitive* = _boolean_::
|
||||||
Default value: *True* +
|
TODO +
|
||||||
TODO
|
Default value: *True*
|
||||||
|
|
||||||
*invert_search* = _boolean_::
|
*invert_search* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*enabled_plugins* = _list of strings_::
|
*enabled_plugins* = _list of strings_::
|
||||||
Default value: *['LaunchpadBugURLHandler', 'LaunchpadCodeURLHandler', 'APTURLHandler']* +
|
|
||||||
Specify which plugins will be loaded by default. All other plugin
|
Specify which plugins will be loaded by default. All other plugin
|
||||||
classes will be ignored.
|
classes will be ignored. +
|
||||||
|
Default value: *['LaunchpadBugURLHandler', 'LaunchpadCodeURLHandler', 'APTURLHandler']*
|
||||||
|
|
||||||
== keybindings
|
== keybindings
|
||||||
These are the options Terminator currently supports in the *keybindings*
|
These are the options Terminator currently supports in the *keybindings*
|
||||||
|
@ -251,75 +250,67 @@ format *+[[name]]+*.
|
||||||
=== General
|
=== General
|
||||||
|
|
||||||
*allow_bold* = _boolean_::
|
*allow_bold* = _boolean_::
|
||||||
Default value: *True* +
|
If set to True, text in the terminal can displayed in bold. +
|
||||||
If set to True, text in the terminal can displayed in bold.
|
Default value: *True*
|
||||||
|
|
||||||
*copy_on_selection* = _boolean_::
|
*copy_on_selection* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*disable_mousewheel_zoom* = _boolean_::
|
*disable_mousewheel_zoom* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, Ctrl+mouse_wheel will not zoom or unzoom the terminal. +
|
||||||
If set to True, Ctrl+mouse_wheel will not zoom or unzoom the terminal.
|
Default value: *False*
|
||||||
|
|
||||||
*word_chars* = _string_::
|
*word_chars* = _string_::
|
||||||
Default value: **-,./?%&#:_** +
|
TODO +
|
||||||
TODO
|
Default value: **-,./?%&#:_**
|
||||||
|
|
||||||
*cell_width* = _float_::
|
|
||||||
Default value: *1.0* +
|
|
||||||
TODO
|
|
||||||
|
|
||||||
*cell_height* = _float_::
|
|
||||||
Default value: *1.0* +
|
|
||||||
TODO
|
|
||||||
|
|
||||||
*mouse_autohide* = _boolean_::
|
*mouse_autohide* = _boolean_::
|
||||||
Default value: *True* +
|
If set to True, the mouse pointer will be hidden when typing. +
|
||||||
If set to True, the mouse pointer will be hidden when typing.
|
Default value: *True*
|
||||||
|
|
||||||
*term* = _string_::
|
*term* = _string_::
|
||||||
Default value: *xterm-256color* +
|
TODO +
|
||||||
TODO
|
Default value: *xterm-256color*
|
||||||
|
|
||||||
*colorterm* = _string_::
|
*colorterm* = _string_::
|
||||||
Default value: *truecolor* +
|
TODO +
|
||||||
TODO
|
Default value: *truecolor*
|
||||||
|
|
||||||
*split_to_group* = _boolean_::
|
*split_to_group* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*autoclean_groups* = _boolean_::
|
*autoclean_groups* = _boolean_::
|
||||||
Default value: *True* +
|
TODO +
|
||||||
TODO
|
Default value: *True*
|
||||||
|
|
||||||
// --- Font ---
|
// --- Font ---
|
||||||
|
|
||||||
*use_system_font* = _boolean_::
|
*use_system_font* = _boolean_::
|
||||||
Default value: *True* +
|
|
||||||
If set to True, the system default font will be used for text in the
|
If set to True, the system default font will be used for text in the
|
||||||
terminal. Otherwise, the value of *font* will be used.
|
terminal. Otherwise, the value of *font* will be used. +
|
||||||
|
Default value: *True*
|
||||||
|
|
||||||
*font* = _string_::
|
*font* = _string_::
|
||||||
Default value: *Mono 10* +
|
|
||||||
Specify which font to use for text in the terminal.
|
Specify which font to use for text in the terminal.
|
||||||
This option is ignored unless *use_system_font* is set to False.
|
This option is ignored unless *use_system_font* is set to False. +
|
||||||
|
Default value: *Mono 10*
|
||||||
|
|
||||||
// --- Cursor ---
|
// --- Cursor ---
|
||||||
|
|
||||||
*cursor_blink* = _boolean_::
|
*cursor_blink* = _boolean_::
|
||||||
Default value: *True* +
|
If set to True, the cursor will blink when not typing. +
|
||||||
If set to True, the cursor will blink when not typing.
|
Default value: *True*
|
||||||
|
|
||||||
*cursor_shape* = _string_::
|
*cursor_shape* = _string_::
|
||||||
Default value: *block* +
|
|
||||||
Specify the shape of the cursor.
|
Specify the shape of the cursor.
|
||||||
Can be any of: 'block', 'underline', 'ibeam'.
|
Can be any of: 'block', 'underline', 'ibeam'. +
|
||||||
|
Default value: *block*
|
||||||
|
|
||||||
*cursor_color_default* = _boolean_::
|
*cursor_color_default* = _boolean_::
|
||||||
Default value: *True* +
|
TODO +
|
||||||
TODO
|
Default value: *True*
|
||||||
|
|
||||||
*cursor_fg_color* = _color string_::
|
*cursor_fg_color* = _color string_::
|
||||||
Specify the foreground color to use for the cursor.
|
Specify the foreground color to use for the cursor.
|
||||||
|
@ -332,99 +323,98 @@ This option is ignored unless *cursor_color_default* is set to False.
|
||||||
// --- Bell ---
|
// --- Bell ---
|
||||||
|
|
||||||
*audible_bell* = _boolean_::
|
*audible_bell* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, a sound will be played when an application writes the
|
If set to True, a sound will be played when an application writes the
|
||||||
escape sequence for the terminal bell.
|
escape sequence for the terminal bell. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*visible_bell* = _boolean_::
|
*visible_bell* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the terminal will flash when an application writes the
|
If set to True, the terminal will flash when an application writes the
|
||||||
escape sequence for the terminal bell.
|
escape sequence for the terminal bell. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*urgent_bell* = _boolean_::
|
*urgent_bell* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*icon_bell* = _boolean_::
|
*icon_bell* = _boolean_::
|
||||||
Default value: *True* +
|
|
||||||
If set to True, a small icon will be shown on the terminal titlebar when
|
If set to True, a small icon will be shown on the terminal titlebar when
|
||||||
an application writes the escape sequence for the terminal bell.
|
an application writes the escape sequence for the terminal bell. +
|
||||||
|
Default value: *True*
|
||||||
|
|
||||||
*force_no_bell* = _boolean_::
|
*force_no_bell* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, the terminal bell will be completely disabled. +
|
||||||
If set to True, the terminal bell will be completely disabled.
|
Default value: *False*
|
||||||
|
|
||||||
=== Command
|
=== Command
|
||||||
|
|
||||||
*login_shell* = _boolean_::
|
*login_shell* = _boolean_::
|
||||||
Default value: *False* +
|
TODO +
|
||||||
TODO
|
Default value: *False*
|
||||||
|
|
||||||
*use_custom_command* = _boolean_::
|
*use_custom_command* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the value of *custom_command* will be used instead of
|
If set to True, the value of *custom_command* will be used instead of
|
||||||
the default shell.
|
the default shell. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*custom_command* = _string_::
|
*custom_command* = _string_::
|
||||||
Specify the command to execute instead of the default shell.
|
Specify the command to execute instead of the default shell.
|
||||||
This option is ignored unless *use_custom_command* is set to True.
|
This option is ignored unless *use_custom_command* is set to True.
|
||||||
|
|
||||||
*exit_action* = _string_::
|
*exit_action* = _string_::
|
||||||
Default value: *close* +
|
|
||||||
Specify the action to perform when the terminal is closed.
|
Specify the action to perform when the terminal is closed.
|
||||||
'close' means the terminal will be removed.
|
'close' means the terminal will be removed.
|
||||||
'restart' means the shell (or the command specified in *custom_command*)
|
'restart' means the shell (or the command specified in *custom_command*)
|
||||||
will be restarted.
|
will be restarted.
|
||||||
'hold' means the terminal will be kept open, even if the process in it
|
'hold' means the terminal will be kept open, even if the process in it
|
||||||
has terminated.
|
has terminated. +
|
||||||
|
Default value: *close*
|
||||||
|
|
||||||
=== Colors
|
=== Colors
|
||||||
|
|
||||||
*use_theme_colors* = _boolean_::
|
*use_theme_colors* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the theme's foreground and background colors will be
|
If set to True, the theme's foreground and background colors will be
|
||||||
used for the terminal. Otherwise, the values of *foreground_color* and
|
used for the terminal. Otherwise, the values of *foreground_color* and
|
||||||
*background_color* will be used.
|
*background_color* will be used. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*foreground_color* = _color string_::
|
*foreground_color* = _color string_::
|
||||||
Default value: *#AAAAAA* +
|
|
||||||
Specify the foreground color to use for the terminal.
|
Specify the foreground color to use for the terminal.
|
||||||
This option is ignored unless *use_theme_colors* is set to False.
|
This option is ignored unless *use_theme_colors* is set to False. +
|
||||||
|
Default value: *#AAAAAA*
|
||||||
|
|
||||||
*background_color* = _color string_::
|
*background_color* = _color string_::
|
||||||
Default value: *#000000* +
|
|
||||||
Specify the background color to use for the terminal.
|
Specify the background color to use for the terminal.
|
||||||
This option is ignored unless *use_theme_colors* is set to False.
|
This option is ignored unless *use_theme_colors* is set to False. +
|
||||||
|
Default value: *#000000*
|
||||||
|
|
||||||
*palette* = TODO::
|
*palette* = TODO::
|
||||||
TODO
|
TODO
|
||||||
|
|
||||||
*bold_is_bright* = _boolean_::
|
*bold_is_bright* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, bold text will have brighter colors. +
|
||||||
If set to True, bold text will have brighter colors.
|
Default value: *False*
|
||||||
|
|
||||||
=== Background
|
=== Background
|
||||||
|
|
||||||
*background_darkness* = _float_::
|
*background_darkness* = _float_::
|
||||||
Default value: *0.5* +
|
TODO +
|
||||||
TODO
|
Default value: *0.5*
|
||||||
|
|
||||||
*background_type* = _string_::
|
*background_type* = _string_::
|
||||||
Default value: *solid* +
|
|
||||||
Specify what type of background the terminal will have.
|
Specify what type of background the terminal will have.
|
||||||
'solid' means the background will be a solid (opaque) color.
|
'solid' means the background will be a solid (opaque) color.
|
||||||
'transparent' means the background will be a transparent color, with its
|
'transparent' means the background will be a transparent color, with its
|
||||||
transparency being the value of *background_darkness*.
|
transparency being the value of *background_darkness*.
|
||||||
'image' means the background will be an image, whose path is the value
|
'image' means the background will be an image, whose path is the value
|
||||||
of *background_image*; the background color will be drawn on top of it,
|
of *background_image*; the background color will be drawn on top of it,
|
||||||
with its transparenty being the value of *background_darkness*.
|
with its transparenty being the value of *background_darkness*. +
|
||||||
|
Default value: *solid*
|
||||||
|
|
||||||
*background_image* = _path string_::
|
*background_image* = _path string_::
|
||||||
Specify the path to an image that will be used as background.
|
Specify the path to an image that will be used as background.
|
||||||
This option is ignored unless *background_type* is set to 'image'.
|
This option is ignored unless *background_type* is set to 'image'.
|
||||||
|
|
||||||
*background_image_mode* = _string_::
|
*background_image_mode* = _string_::
|
||||||
Default value: *stretch_and_fill* +
|
|
||||||
Specify how the background image will be drawn.
|
Specify how the background image will be drawn.
|
||||||
'stretch_and_fill' means the image will fill the terminal entirely,
|
'stretch_and_fill' means the image will fill the terminal entirely,
|
||||||
without necessarily maintaining aspect ratio.
|
without necessarily maintaining aspect ratio.
|
||||||
|
@ -433,123 +423,124 @@ leaving blank bars, while maintaining aspect ratio.
|
||||||
'scale_and_crop' means the image will fill the terminal entirely,
|
'scale_and_crop' means the image will fill the terminal entirely,
|
||||||
eventually getting cropped, while maintaining aspect ratio.
|
eventually getting cropped, while maintaining aspect ratio.
|
||||||
'tiling' means the image will be repeated as to fill the terminal.
|
'tiling' means the image will be repeated as to fill the terminal.
|
||||||
This option is ignored unless *background_type* is set to 'image'.
|
This option is ignored unless *background_type* is set to 'image'. +
|
||||||
|
Default value: *stretch_and_fill*
|
||||||
|
|
||||||
*background_image_align_horiz* = _string_::
|
*background_image_align_horiz* = _string_::
|
||||||
Default value: *center* +
|
|
||||||
Specify the horizontal alignment of the background image.
|
Specify the horizontal alignment of the background image.
|
||||||
Can be any of: 'left', 'center', 'right'.
|
Can be any of: 'left', 'center', 'right'.
|
||||||
This option is ignored unless *background_type* is set to 'image'.
|
This option is ignored unless *background_type* is set to 'image'. +
|
||||||
|
Default value: *center*
|
||||||
|
|
||||||
*background_image_align_vert* = _string_::
|
*background_image_align_vert* = _string_::
|
||||||
Default value: *middle* +
|
|
||||||
Specify the vertical alignment of the background image.
|
Specify the vertical alignment of the background image.
|
||||||
Can be any of: 'top', 'middle', 'bottom'.
|
Can be any of: 'top', 'middle', 'bottom'.
|
||||||
This option is ignored unless *background_type* is set to 'image'.
|
This option is ignored unless *background_type* is set to 'image'. +
|
||||||
|
Default value: *middle*
|
||||||
|
|
||||||
=== Scrolling
|
=== Scrolling
|
||||||
|
|
||||||
*scrollbar_position* = _string_::
|
*scrollbar_position* = _string_::
|
||||||
Default value: *right* +
|
|
||||||
Specify where the terminal scrollbar is put.
|
Specify where the terminal scrollbar is put.
|
||||||
Can be any of: 'left', 'right', 'hidden'.
|
Can be any of: 'left', 'right', 'hidden'. +
|
||||||
|
Default value: *right*
|
||||||
|
|
||||||
*scroll_on_output* = _boolean_::
|
*scroll_on_output* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the terminall will scroll to the bottom when an
|
If set to True, the terminall will scroll to the bottom when an
|
||||||
application writes text to it.
|
application writes text to it. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*scroll_on_keystroke* = _boolean_::
|
*scroll_on_keystroke* = _boolean_::
|
||||||
Default value: *True* +
|
If set to True, the terminal will scroll to the bottom when typing. +
|
||||||
If set to True, the terminal will scroll to the bottom when typing.
|
Default value: *True*
|
||||||
|
|
||||||
*scrollback_infinite* = _boolean_::
|
*scrollback_infinite* = _boolean_::
|
||||||
Default value: *False* +
|
If set to True, the terminal will keep the entire scrollback history. +
|
||||||
If set to True, the terminal will keep the entire scrollback history.
|
Default value: *False*
|
||||||
|
|
||||||
*scrollback_lines* = _integer_::
|
*scrollback_lines* = _integer_::
|
||||||
Default value: *500* +
|
|
||||||
Specify how many lines of scrollback history will be kept by the
|
Specify how many lines of scrollback history will be kept by the
|
||||||
terminal. Lines that don't fit in the scrollback history will be
|
terminal. Lines that don't fit in the scrollback history will be
|
||||||
discarted. Note that setting large values can slow down rewrapping and
|
discarted. Note that setting large values can slow down rewrapping and
|
||||||
resizing.
|
resizing.
|
||||||
This option is ignored unless *scrollback_infinite* is set to False.
|
This option is ignored unless *scrollback_infinite* is set to False. +
|
||||||
|
Default value: *500*
|
||||||
|
|
||||||
=== Compatibility
|
=== Compatibility
|
||||||
|
|
||||||
*backspace_binding* = _string_::
|
*backspace_binding* = _string_::
|
||||||
Default value: *ascii-del* +
|
|
||||||
Specify what code will be generated by the backspace key.
|
Specify what code will be generated by the backspace key.
|
||||||
The value can be:
|
The value can be:
|
||||||
'ascii-del' for the ASCII DEL character;
|
'ascii-del' for the ASCII DEL character;
|
||||||
'control-h' for the ASCII BS character (Ctrl+H);
|
'control-h' for the ASCII BS character (Ctrl+H);
|
||||||
'escape-sequence' for the escape sequence typically bound to backspace
|
'escape-sequence' for the escape sequence typically bound to backspace
|
||||||
or delete;
|
or delete;
|
||||||
'automatic' for TODO.
|
'automatic' for TODO. +
|
||||||
|
Default value: *ascii-del*
|
||||||
|
|
||||||
*delete_binding* = _string_::
|
*delete_binding* = _string_::
|
||||||
Default value: *escape-sequence* +
|
|
||||||
Specify what code will be generated by the delete key.
|
Specify what code will be generated by the delete key.
|
||||||
The value can be:
|
The value can be:
|
||||||
'ascii-del' for the ASCII DEL character;
|
'ascii-del' for the ASCII DEL character;
|
||||||
'control-h' for the ASCII BS character (Ctrl+H);
|
'control-h' for the ASCII BS character (Ctrl+H);
|
||||||
'escape-sequence' for the escape sequence typically bound to backspace
|
'escape-sequence' for the escape sequence typically bound to backspace
|
||||||
or delete;
|
or delete;
|
||||||
'automatic' for TODO.
|
'automatic' for TODO. +
|
||||||
|
Default value: *escape-sequence*
|
||||||
|
|
||||||
=== Titlebar
|
=== Titlebar
|
||||||
|
|
||||||
*show_titlebar* = _boolean_::
|
*show_titlebar* = _boolean_::
|
||||||
Default value: *True* +
|
|
||||||
If set to True, the terminal will have a titlebar showing the current
|
If set to True, the terminal will have a titlebar showing the current
|
||||||
title of that terminal.
|
title of that terminal. +
|
||||||
|
Default value: *True*
|
||||||
|
|
||||||
*title_hide_sizetext* = _boolean_::
|
*title_hide_sizetext* = _boolean_::
|
||||||
Default value: *False* +
|
|
||||||
If set to True, the size of the terminal will not be written on its
|
If set to True, the size of the terminal will not be written on its
|
||||||
titlebar.
|
titlebar. +
|
||||||
|
Default value: *False*
|
||||||
|
|
||||||
*title_use_system_font* = _boolean_::
|
*title_use_system_font* = _boolean_::
|
||||||
Default value: *True* +
|
|
||||||
If set to True, the system default font will be used for text in the
|
If set to True, the system default font will be used for text in the
|
||||||
terminal's titlebar. Otherwise, the value of *title_font* will be used.
|
terminal's titlebar. Otherwise, the value of *title_font* will be used. +
|
||||||
|
Default value: *True*
|
||||||
|
|
||||||
*title_font* = _string_::
|
*title_font* = _string_::
|
||||||
Default value: *Sans 9* +
|
|
||||||
Specify which font to use for text in the terminal's titlebar.
|
Specify which font to use for text in the terminal's titlebar.
|
||||||
This option is ignored unless *title_use_system_font* is set to False.
|
This option is ignored unless *title_use_system_font* is set to False. +
|
||||||
|
Default value: *Sans 9*
|
||||||
|
|
||||||
// --- Titlebar colors ---
|
// --- Titlebar colors ---
|
||||||
|
|
||||||
*title_transmit_fg_color* = _color string_::
|
*title_transmit_fg_color* = _color string_::
|
||||||
Default value: *#ffffff* +
|
|
||||||
Specify the foreground color to use for the terminal's titlebar in case
|
Specify the foreground color to use for the terminal's titlebar in case
|
||||||
the terminal is focused.
|
the terminal is focused. +
|
||||||
|
Default value: *#ffffff*
|
||||||
|
|
||||||
*title_transmit_bg_color* = _color string_::
|
*title_transmit_bg_color* = _color string_::
|
||||||
Default value: *#c80003* +
|
|
||||||
Specify the background color to use for the terminal's titlebar in case
|
Specify the background color to use for the terminal's titlebar in case
|
||||||
the terminal is focused.
|
the terminal is focused. +
|
||||||
|
Default value: *#c80003*
|
||||||
|
|
||||||
*title_inactive_fg_color* = _color string_::
|
*title_inactive_fg_color* = _color string_::
|
||||||
Default value: *#000000* +
|
|
||||||
Specify the foreground color to use for the terminal's titlebar in case
|
Specify the foreground color to use for the terminal's titlebar in case
|
||||||
the terminal is unfocused.
|
the terminal is unfocused. +
|
||||||
|
Default value: *#000000*
|
||||||
|
|
||||||
*title_inactive_bg_color* = _color string_::
|
*title_inactive_bg_color* = _color string_::
|
||||||
Default value: *#c0bebf* +
|
|
||||||
Specify the background color to use for the terminal's titlebar in case
|
Specify the background color to use for the terminal's titlebar in case
|
||||||
the terminal is unfocused.
|
the terminal is unfocused. +
|
||||||
|
Default value: *#c0bebf*
|
||||||
|
|
||||||
*title_receive_fg_color* = _color string_::
|
*title_receive_fg_color* = _color string_::
|
||||||
Default value: *#ffffff* +
|
|
||||||
Specify the foreground color to use for the terminal's titlebar in case
|
Specify the foreground color to use for the terminal's titlebar in case
|
||||||
the terminal is in a group and is receiving input while unfocused.
|
the terminal is in a group and is receiving input while unfocused. +
|
||||||
|
Default value: *#ffffff*
|
||||||
|
|
||||||
*title_receive_bg_color* = _color string_::
|
*title_receive_bg_color* = _color string_::
|
||||||
Default value: *#0076c9* +
|
|
||||||
Specify the background color to use for the terminal's titlebar in case
|
Specify the background color to use for the terminal's titlebar in case
|
||||||
the terminal is in a group and is receiving input while unfocused.
|
the terminal is in a group and is receiving input while unfocused. +
|
||||||
|
Default value: *#0076c9*
|
||||||
|
|
||||||
== SEE ALSO
|
== SEE ALSO
|
||||||
*terminator*(1), http://www.voidspace.org.uk/python/configobj.html
|
*terminator*(1), http://www.voidspace.org.uk/python/configobj.html
|
||||||
|
|
Loading…
Reference in New Issue