Update docs
This commit is contained in:
parent
91cd6c6288
commit
56ec5719a2
@ -8,9 +8,9 @@
|
||||
|==============
|
||||
|Setting|Description
|
||||
|<<aliases,aliases>>|Aliases for commands.
|
||||
|<<auto_save.config,auto_save.config>>|Whether to save the config automatically on quit.
|
||||
|<<auto_save.config,auto_save.config>>|Save the config automatically on quit.
|
||||
|<<auto_save.interval,auto_save.interval>>|How often (in milliseconds) to auto-save config/cookies/etc.
|
||||
|<<auto_save.session,auto_save.session>>|Whether to always save the open pages.
|
||||
|<<auto_save.session,auto_save.session>>|Always restore open sites when qutebrowser is reopened.
|
||||
|<<bindings.commands,bindings.commands>>|Keybindings mapping keys to commands in different modes.
|
||||
|<<bindings.default,bindings.default>>|Default keybindings. If you want to add bindings, modify `bindings.commands` instead.
|
||||
|<<bindings.key_mappings,bindings.key_mappings>>|This setting can be used to map keys to other keys.
|
||||
@ -37,12 +37,12 @@
|
||||
|<<colors.downloads.stop.fg,colors.downloads.stop.fg>>|Color gradient end for download text.
|
||||
|<<colors.downloads.system.bg,colors.downloads.system.bg>>|Color gradient interpolation system for download backgrounds.
|
||||
|<<colors.downloads.system.fg,colors.downloads.system.fg>>|Color gradient interpolation system for download text.
|
||||
|<<colors.hints.bg,colors.hints.bg>>|Background color for hints. Note that you can use a `rgba(...)` value for transparency.
|
||||
|<<colors.hints.bg,colors.hints.bg>>|Background color for hints.
|
||||
|<<colors.hints.fg,colors.hints.fg>>|Font color for hints.
|
||||
|<<colors.hints.match.fg,colors.hints.match.fg>>|Font color for the matched part of hints.
|
||||
|<<colors.keyhint.bg,colors.keyhint.bg>>|Background color of the keyhint widget.
|
||||
|<<colors.keyhint.fg,colors.keyhint.fg>>|Text color for the keyhint widget.
|
||||
|<<colors.keyhint.suffix.fg,colors.keyhint.suffix.fg>>|Highlight color for keys to complete the current keychain
|
||||
|<<colors.keyhint.suffix.fg,colors.keyhint.suffix.fg>>|Highlight color for keys to complete the current keychain.
|
||||
|<<colors.messages.error.bg,colors.messages.error.bg>>|Background color of an error message.
|
||||
|<<colors.messages.error.border,colors.messages.error.border>>|Border color of an error message.
|
||||
|<<colors.messages.error.fg,colors.messages.error.fg>>|Foreground color of an error message.
|
||||
@ -57,8 +57,8 @@
|
||||
|<<colors.prompts.selected.bg,colors.prompts.selected.bg>>|Background color for the selected item in filename prompts.
|
||||
|<<colors.statusbar.caret.bg,colors.statusbar.caret.bg>>|Background color of the statusbar in caret mode.
|
||||
|<<colors.statusbar.caret.fg,colors.statusbar.caret.fg>>|Foreground color of the statusbar in caret mode.
|
||||
|<<colors.statusbar.caret.selection.bg,colors.statusbar.caret.selection.bg>>|Background color of the statusbar in caret mode with a selection
|
||||
|<<colors.statusbar.caret.selection.fg,colors.statusbar.caret.selection.fg>>|Foreground color of the statusbar in caret mode with a selection
|
||||
|<<colors.statusbar.caret.selection.bg,colors.statusbar.caret.selection.bg>>|Background color of the statusbar in caret mode with a selection.
|
||||
|<<colors.statusbar.caret.selection.fg,colors.statusbar.caret.selection.fg>>|Foreground color of the statusbar in caret mode with a selection.
|
||||
|<<colors.statusbar.command.bg,colors.statusbar.command.bg>>|Background color of the statusbar in command mode.
|
||||
|<<colors.statusbar.command.fg,colors.statusbar.command.fg>>|Foreground color of the statusbar in command mode.
|
||||
|<<colors.statusbar.command.private.bg,colors.statusbar.command.private.bg>>|Background color of the statusbar in private browsing + command mode.
|
||||
@ -79,7 +79,7 @@
|
||||
|<<colors.tabs.bar.bg,colors.tabs.bar.bg>>|Background color of the tab bar.
|
||||
|<<colors.tabs.even.bg,colors.tabs.even.bg>>|Background color of unselected even tabs.
|
||||
|<<colors.tabs.even.fg,colors.tabs.even.fg>>|Foreground color of unselected even tabs.
|
||||
|<<colors.tabs.indicator.error,colors.tabs.indicator.error>>|Color for the tab indicator on errors..
|
||||
|<<colors.tabs.indicator.error,colors.tabs.indicator.error>>|Color for the tab indicator on errors.
|
||||
|<<colors.tabs.indicator.start,colors.tabs.indicator.start>>|Color gradient start for the tab indicator.
|
||||
|<<colors.tabs.indicator.stop,colors.tabs.indicator.stop>>|Color gradient end for the tab indicator.
|
||||
|<<colors.tabs.indicator.system,colors.tabs.indicator.system>>|Color gradient interpolation system for the tab indicator.
|
||||
@ -92,28 +92,28 @@
|
||||
|<<colors.webpage.bg,colors.webpage.bg>>|Background color for webpages if unset (or empty to use the theme's color)
|
||||
|<<completion.cmd_history_max_items,completion.cmd_history_max_items>>|How many commands to save in the command history.
|
||||
|<<completion.height,completion.height>>|The height of the completion, in px or as percentage of the window.
|
||||
|<<completion.quick,completion.quick>>|Whether to move on to the next part when there's only one possible completion left.
|
||||
|<<completion.scrollbar.padding,completion.scrollbar.padding>>|Padding of scrollbar handle in completion window (in px).
|
||||
|<<completion.quick,completion.quick>>|Move on to the next part when there's only one possible completion left.
|
||||
|<<completion.scrollbar.padding,completion.scrollbar.padding>>|Padding of scrollbar handle in the completion window (in px).
|
||||
|<<completion.scrollbar.width,completion.scrollbar.width>>|Width of the scrollbar in the completion window (in px).
|
||||
|<<completion.show,completion.show>>|When to show the autocompletion window.
|
||||
|<<completion.shrink,completion.shrink>>|Whether to shrink the completion to be smaller than the configured size if there are no scrollbars.
|
||||
|<<completion.timestamp_format,completion.timestamp_format>>|How to format timestamps (e.g. for history)
|
||||
|<<completion.shrink,completion.shrink>>|Shrink the completion to be smaller than the configured size if there are no scrollbars.
|
||||
|<<completion.timestamp_format,completion.timestamp_format>>|How to format timestamps (e.g. for the history completion).
|
||||
|<<completion.web_history_max_items,completion.web_history_max_items>>|How many URLs to show in the web history.
|
||||
|<<confirm_quit,confirm_quit>>|Whether to confirm quitting the application.
|
||||
|<<content.accept_language,content.accept_language>>|Value to send in the `accept-language` header.
|
||||
|<<confirm_quit,confirm_quit>>|Whether quitting the application requires a confirmation.
|
||||
|<<content.cache.appcache,content.cache.appcache>>|Whether support for the HTML 5 web application cache feature is enabled.
|
||||
|<<content.cache.maximum_pages,content.cache.maximum_pages>>|The maximum number of pages to hold in the global memory page cache.
|
||||
|<<content.cache.size,content.cache.size>>|Size of the HTTP network cache. Empty to use the default value.
|
||||
|<<content.cache.size,content.cache.size>>|Size of the HTTP network cache. Null to use the default value.
|
||||
|<<content.cookies.accept,content.cookies.accept>>|Control which cookies to accept.
|
||||
|<<content.cookies.store,content.cookies.store>>|Whether to store cookies. Note this option needs a restart with QtWebEngine on Qt < 5.9.
|
||||
|<<content.cookies.store,content.cookies.store>>|Store cookies.
|
||||
|<<content.default_encoding,content.default_encoding>>|Default encoding to use for websites.
|
||||
|<<content.developer_extras,content.developer_extras>>|Enable extra tools for Web developers.
|
||||
|<<content.dns_prefetch,content.dns_prefetch>>|Whether to try to pre-fetch DNS entries to speed up browsing.
|
||||
|<<content.frame_flattening,content.frame_flattening>>|Whether to expand each subframe to its contents.
|
||||
|<<content.dns_prefetch,content.dns_prefetch>>|Try to pre-fetch DNS entries to speed up browsing.
|
||||
|<<content.frame_flattening,content.frame_flattening>>|Expand each subframe to its contents.
|
||||
|<<content.geolocation,content.geolocation>>|Allow websites to request geolocations.
|
||||
|<<content.headers.accept_language,content.headers.accept_language>>|Value to send in the `Accept-Language` header.
|
||||
|<<content.headers.custom,content.headers.custom>>|Set custom headers for qutebrowser HTTP requests.
|
||||
|<<content.headers.do_not_track,content.headers.do_not_track>>|Value to send in the `DNT` header.
|
||||
|<<content.headers.referer,content.headers.referer>>|Send the Referer header
|
||||
|<<content.headers.referer,content.headers.referer>>|Send the Referer header.
|
||||
|<<content.headers.user_agent,content.headers.user_agent>>|User agent to send. Unset to send the default.
|
||||
|<<content.host_blocking.enabled,content.host_blocking.enabled>>|Whether host blocking is enabled.
|
||||
|<<content.host_blocking.lists,content.host_blocking.lists>>|List of URLs of lists which contain hosts to block.
|
||||
@ -121,11 +121,11 @@
|
||||
|<<content.hyperlink_auditing,content.hyperlink_auditing>>|Enable or disable hyperlink auditing (`<a ping>`).
|
||||
|<<content.images,content.images>>|Whether images are automatically loaded in web pages.
|
||||
|<<content.javascript.alert,content.javascript.alert>>|Show javascript alerts.
|
||||
|<<content.javascript.can_access_clipboard,content.javascript.can_access_clipboard>>|Whether JavaScript programs can read or write to the clipboard.
|
||||
|<<content.javascript.can_close_windows,content.javascript.can_close_windows>>|Whether JavaScript programs can close windows.
|
||||
|<<content.javascript.can_open_windows_automatically,content.javascript.can_open_windows_automatically>>|Whether JavaScript programs can open new windows without user interaction.
|
||||
|<<content.javascript.enabled,content.javascript.enabled>>|Enables or disables the running of JavaScript programs.
|
||||
|<<content.javascript.log,content.javascript.log>>|How to log javascript console messages.
|
||||
|<<content.javascript.can_access_clipboard,content.javascript.can_access_clipboard>>|Whether JavaScript can read from or write to the clipboard.
|
||||
|<<content.javascript.can_close_tabs,content.javascript.can_close_tabs>>|Whether JavaScript can close tabs.
|
||||
|<<content.javascript.can_open_tabs_automatically,content.javascript.can_open_tabs_automatically>>|Whether JavaScript can open new tabs without user interaction.
|
||||
|<<content.javascript.enabled,content.javascript.enabled>>|Enables or disables JavaScript.
|
||||
|<<content.javascript.log,content.javascript.log>>|How to log JavaScript console messages.
|
||||
|<<content.javascript.modal_dialog,content.javascript.modal_dialog>>|Use the standard JavaScript modal dialog for `alert()` and `confirm()`
|
||||
|<<content.javascript.prompt,content.javascript.prompt>>|Show javascript prompts.
|
||||
|<<content.local_content_can_access_file_urls,content.local_content_can_access_file_urls>>|Whether locally loaded documents are allowed to access other local urls.
|
||||
@ -139,18 +139,18 @@
|
||||
|<<content.print_element_backgrounds,content.print_element_backgrounds>>|Whether the background color and images are also drawn when the page is printed.
|
||||
|<<content.private_browsing,content.private_browsing>>|Open new windows in private browsing mode which does not record visited pages.
|
||||
|<<content.proxy,content.proxy>>|The proxy to use.
|
||||
|<<content.proxy_dns_requests,content.proxy_dns_requests>>|Whether to send DNS requests over the configured proxy.
|
||||
|<<content.ssl_strict,content.ssl_strict>>|Whether to validate SSL handshakes.
|
||||
|<<content.user_stylesheet,content.user_stylesheet>>|User stylesheet to use (absolute filename or filename relative to the config directory). Will expand environment variables.
|
||||
|<<content.proxy_dns_requests,content.proxy_dns_requests>>|Send DNS requests over the configured proxy.
|
||||
|<<content.ssl_strict,content.ssl_strict>>|Validate SSL handshakes.
|
||||
|<<content.user_stylesheets,content.user_stylesheets>>|A list of user stylesheets filenames to use.
|
||||
|<<content.webgl,content.webgl>>|Enables or disables WebGL.
|
||||
|<<content.xss_auditing,content.xss_auditing>>|Whether load requests should be monitored for cross-site scripting attempts.
|
||||
|<<downloads.location.directory,downloads.location.directory>>|The directory to save downloads to.
|
||||
|<<downloads.location.prompt,downloads.location.prompt>>|Whether to prompt the user for the download location.
|
||||
|<<downloads.location.remember,downloads.location.remember>>|Whether to remember the last used download directory.
|
||||
|<<downloads.location.prompt,downloads.location.prompt>>|Prompt the user for the download location.
|
||||
|<<downloads.location.remember,downloads.location.remember>>|Remember the last used download directory.
|
||||
|<<downloads.location.suggestion,downloads.location.suggestion>>|What to display in the download filename input.
|
||||
|<<downloads.open_dispatcher,downloads.open_dispatcher>>|The default program used to open downloads. If unset, the default internal handler is used.
|
||||
|<<downloads.open_dispatcher,downloads.open_dispatcher>>|The default program used to open downloads.
|
||||
|<<downloads.position,downloads.position>>|Where to show the downloaded files.
|
||||
|<<downloads.remove_finished,downloads.remove_finished>>|Number of milliseconds to wait before removing finished downloads. Will not be removed if value is -1.
|
||||
|<<downloads.remove_finished,downloads.remove_finished>>|Number of milliseconds to wait before removing finished downloads.
|
||||
|<<editor.command,editor.command>>|The editor (and arguments) to use for the `open-editor` command.
|
||||
|<<editor.encoding,editor.encoding>>|Encoding to use for the editor.
|
||||
|<<fonts.completion.category,fonts.completion.category>>|Font used in the completion categories.
|
||||
@ -176,74 +176,74 @@
|
||||
|<<fonts.web.size.default_fixed,fonts.web.size.default_fixed>>|The default font size for fixed-pitch text.
|
||||
|<<fonts.web.size.minimum,fonts.web.size.minimum>>|The hard minimum font size.
|
||||
|<<fonts.web.size.minimum_logical,fonts.web.size.minimum_logical>>|The minimum logical font size that is applied when zooming out.
|
||||
|<<hints.auto_follow,hints.auto_follow>>|Controls when a hint can be automatically followed without the user pressing Enter.
|
||||
|<<hints.auto_follow_timeout,hints.auto_follow_timeout>>|A timeout (in milliseconds) to inhibit normal-mode key bindings after a successful auto-follow.
|
||||
|<<hints.auto_follow,hints.auto_follow>>|Controls when a hint can be automatically followed without pressing Enter.
|
||||
|<<hints.auto_follow_timeout,hints.auto_follow_timeout>>|A timeout (in milliseconds) to ignore normal-mode key bindings after a successful auto-follow.
|
||||
|<<hints.border,hints.border>>|CSS border value for hints.
|
||||
|<<hints.chars,hints.chars>>|Chars used for hint strings.
|
||||
|<<hints.dictionary,hints.dictionary>>|The dictionary file to be used by the word hints.
|
||||
|<<hints.find_implementation,hints.find_implementation>>|Which implementation to use to find elements to hint.
|
||||
|<<hints.hide_unmatched_rapid_hints,hints.hide_unmatched_rapid_hints>>|Controls hiding unmatched hints in rapid mode.
|
||||
|<<hints.hide_unmatched_rapid_hints,hints.hide_unmatched_rapid_hints>>|Hide unmatched hints in rapid mode.
|
||||
|<<hints.min_chars,hints.min_chars>>|Minimum number of chars used for hint strings.
|
||||
|<<hints.mode,hints.mode>>|Mode to use for hints.
|
||||
|<<hints.next_regexes,hints.next_regexes>>|A comma-separated list of regexes to use for 'next' links.
|
||||
|<<hints.prev_regexes,hints.prev_regexes>>|A comma-separated list of regexes to use for 'prev' links.
|
||||
|<<hints.scatter,hints.scatter>>|Whether to scatter hint key chains (like Vimium) or not (like dwb). Ignored for number hints.
|
||||
|<<hints.scatter,hints.scatter>>|Scatter hint key chains (like Vimium) or not (like dwb).
|
||||
|<<hints.uppercase,hints.uppercase>>|Make chars in hint strings uppercase.
|
||||
|<<history_session_interval,history_session_interval>>|The maximum time in minutes between two history items for them to be considered being from the same session. Use -1 to disable separation.
|
||||
|<<ignore_case,ignore_case>>|Whether to find text on a page case-insensitively.
|
||||
|<<history_gap_interval,history_gap_interval>>|The maximum time in minutes between two history items for them to be considered being from the same browsing session.
|
||||
|<<ignore_case,ignore_case>>|Find text on a page case-insensitively.
|
||||
|<<input.ambiguous_timeout,input.ambiguous_timeout>>|Timeout (in milliseconds) for ambiguous key bindings.
|
||||
|<<input.forward_unbound_keys,input.forward_unbound_keys>>|Whether to forward unbound keys to the webview in normal mode.
|
||||
|<<input.insert_mode.auto_leave,input.insert_mode.auto_leave>>|Whether to leave insert mode if a non-editable element is clicked.
|
||||
|<<input.insert_mode.auto_load,input.insert_mode.auto_load>>|Whether to automatically enter insert mode if an editable element is focused after page load.
|
||||
|<<input.insert_mode.plugins,input.insert_mode.plugins>>|Whether to switch to insert mode when clicking flash and other plugins.
|
||||
|<<input.links_included_in_focus_chain,input.links_included_in_focus_chain>>|Whether hyperlinks should be included in the keyboard focus chain.
|
||||
|<<input.forward_unbound_keys,input.forward_unbound_keys>>|Forward unbound keys to the webview in normal mode.
|
||||
|<<input.insert_mode.auto_leave,input.insert_mode.auto_leave>>|Leave insert mode if a non-editable element is clicked.
|
||||
|<<input.insert_mode.auto_load,input.insert_mode.auto_load>>|Automatically enter insert mode if an editable element is focused after loading the page.
|
||||
|<<input.insert_mode.plugins,input.insert_mode.plugins>>|Switch to insert mode when clicking flash and other plugins.
|
||||
|<<input.links_included_in_focus_chain,input.links_included_in_focus_chain>>|Include hyperlinks in the keyboard focus chain when tabbing.
|
||||
|<<input.partial_timeout,input.partial_timeout>>|Timeout (in milliseconds) for partially typed key bindings.
|
||||
|<<input.rocker_gestures,input.rocker_gestures>>|Whether to enable Opera-like mouse rocker gestures. This disables the context menu.
|
||||
|<<input.spatial_navigation,input.spatial_navigation>>|Enables or disables the Spatial Navigation feature.
|
||||
|<<input.rocker_gestures,input.rocker_gestures>>|Enable Opera-like mouse rocker gestures.
|
||||
|<<input.spatial_navigation,input.spatial_navigation>>|Enable Spatial Navigation.
|
||||
|<<keyhint.blacklist,keyhint.blacklist>>|Keychains that shouldn\'t be shown in the keyhint dialog.
|
||||
|<<keyhint.delay,keyhint.delay>>|Time from pressing a key to seeing the keyhint dialog (ms)
|
||||
|<<keyhint.delay,keyhint.delay>>|Time from pressing a key to seeing the keyhint dialog (ms).
|
||||
|<<messages.timeout,messages.timeout>>|Time (in ms) to show messages in the statusbar for.
|
||||
|<<messages.unfocused,messages.unfocused>>|Whether to show messages in unfocused windows.
|
||||
|<<messages.unfocused,messages.unfocused>>|Show messages in unfocused windows.
|
||||
|<<new_instance_open_target,new_instance_open_target>>|How to open links in an existing instance if a new one is launched.
|
||||
|<<new_instance_open_target_window,new_instance_open_target_window>>|Which window to choose when opening links as new tabs.
|
||||
|<<prompt.filebrowser,prompt.filebrowser>>|Show a filebrowser in upload/download prompts.
|
||||
|<<prompt.radius,prompt.radius>>|The rounding radius for the edges of prompts.
|
||||
|<<scrolling.bar,scrolling.bar>>|Show a scrollbar.
|
||||
|<<scrolling.smooth,scrolling.smooth>>|Whether to enable smooth scrolling for web pages. Note smooth scrolling does not work with the `:scroll-px` command.
|
||||
|<<session_default_name,session_default_name>>|The name of the session to save by default, or unset for the last loaded session.
|
||||
|<<statusbar.hide,statusbar.hide>>|Whether to hide the statusbar unless a message is shown.
|
||||
|<<scrolling.smooth,scrolling.smooth>>|Enable smooth scrolling for web pages.
|
||||
|<<session_default_name,session_default_name>>|The name of the session to save by default.
|
||||
|<<statusbar.hide,statusbar.hide>>|Hide the statusbar unless a message is shown.
|
||||
|<<statusbar.padding,statusbar.padding>>|Padding for the statusbar.
|
||||
|<<statusbar.position,statusbar.position>>|The position of the status bar.
|
||||
|<<tabs.background,tabs.background>>|Whether to open new tabs (middleclick/ctrl+click) in background.
|
||||
|<<tabs.background,tabs.background>>|Open new tabs (middleclick/ctrl+click) in the background.
|
||||
|<<tabs.close_mouse_button,tabs.close_mouse_button>>|On which mouse button to close tabs.
|
||||
|<<tabs.favicons.scale,tabs.favicons.scale>>|Scale for favicons in the tab bar. The tab size is unchanged, so big favicons also require extra `tabs.padding`.
|
||||
|<<tabs.favicons.show,tabs.favicons.show>>|Whether to show favicons in the tab bar.
|
||||
|<<tabs.indicator_padding,tabs.indicator_padding>>|Padding for indicators
|
||||
|<<tabs.favicons.scale,tabs.favicons.scale>>|Scaling for favicons in the tab bar.
|
||||
|<<tabs.favicons.show,tabs.favicons.show>>|Show favicons in the tab bar.
|
||||
|<<tabs.indicator_padding,tabs.indicator_padding>>|Padding for tab indicators
|
||||
|<<tabs.last_close,tabs.last_close>>|Behavior when the last tab is closed.
|
||||
|<<tabs.mousewheel_switching,tabs.mousewheel_switching>>|Switch between tabs using the mouse wheel.
|
||||
|<<tabs.new_position.related,tabs.new_position.related>>|How new tabs opened from another tab are positioned.
|
||||
|<<tabs.new_position.unrelated,tabs.new_position.unrelated>>|How new tabs which aren't opened from another tab are positioned.
|
||||
|<<tabs.padding,tabs.padding>>|Padding for tabs
|
||||
|<<tabs.padding,tabs.padding>>|Padding around text for tabs
|
||||
|<<tabs.position,tabs.position>>|The position of the tab bar.
|
||||
|<<tabs.select_on_remove,tabs.select_on_remove>>|Which tab to select when the focused tab is removed.
|
||||
|<<tabs.show,tabs.show>>|When to show the tab bar.
|
||||
|<<tabs.show_switching_delay,tabs.show_switching_delay>>|Time to show the tab bar before hiding it when tabs.show is set to 'switching'.
|
||||
|<<tabs.tabs_are_windows,tabs.tabs_are_windows>>|Whether to open windows instead of tabs.
|
||||
|<<tabs.title.alignment,tabs.title.alignment>>|Alignment of the text inside of tabs
|
||||
|<<tabs.title.format,tabs.title.format>>|The format to use for the tab title. The following placeholders are defined:
|
||||
|<<tabs.tabs_are_windows,tabs.tabs_are_windows>>|Open a new window for every tab.
|
||||
|<<tabs.title.alignment,tabs.title.alignment>>|Alignment of the text inside of tabs.
|
||||
|<<tabs.title.format,tabs.title.format>>|The format to use for the tab title.
|
||||
|<<tabs.title.format_pinned,tabs.title.format_pinned>>|The format to use for the tab title for pinned tabs. The same placeholders like for title-format are defined.
|
||||
|<<tabs.width.bar,tabs.width.bar>>|The width of the tab bar if it's vertical, in px or as percentage of the window.
|
||||
|<<tabs.width.indicator,tabs.width.indicator>>|Width of the progress indicator (0 to disable).
|
||||
|<<tabs.width.pinned,tabs.width.pinned>>|The width for pinned tabs with a horizontal tabbar, in px.
|
||||
|<<tabs.wrap,tabs.wrap>>|Whether to wrap when changing tabs.
|
||||
|<<url.auto_search,url.auto_search>>|Whether to start a search when something else than a URL is entered.
|
||||
|<<url.default_page,url.default_page>>|The page to open if :open -t/-b/-w is used without URL. Use `about:blank` for a blank page.
|
||||
|<<url.default_page,url.default_page>>|The page to open if :open -t/-b/-w is used without URL.
|
||||
|<<url.incdec_segments,url.incdec_segments>>|The URL segments where `:navigate increment/decrement` will search for a number.
|
||||
|<<url.new_instance_open_target,url.new_instance_open_target>>|How to open links in an existing instance if a new one is launched.
|
||||
|<<url.new_instance_open_target_window,url.new_instance_open_target_window>>|Which window to choose when opening links as new tabs.
|
||||
|<<url.searchengines,url.searchengines>>|Definitions of search engines which can be used via the address bar.
|
||||
|<<url.start_pages,url.start_pages>>|The default page(s) to open at the start.
|
||||
|<<url.yank_ignored_parameters,url.yank_ignored_parameters>>|The URL parameters to strip with :yank url.
|
||||
|<<url.start_pages,url.start_pages>>|The page(s) to open at the start.
|
||||
|<<url.yank_ignored_parameters,url.yank_ignored_parameters>>|The URL parameters to strip with `:yank url`.
|
||||
|<<window.hide_wayland_decoration,window.hide_wayland_decoration>>|Hide the window decoration when using wayland (requires restart)
|
||||
|<<window.title_format,window.title_format>>|The format to use for the window title. The following placeholders are defined:
|
||||
|<<window.title_format,window.title_format>>|The format to use for the window title.
|
||||
|<<zoom.default,zoom.default>>|The default zoom level.
|
||||
|<<zoom.levels,zoom.levels>>|The available zoom levels.
|
||||
|<<zoom.mouse_divider,zoom.mouse_divider>>|How much to divide the mouse wheel movements to translate them into zoom increments.
|
||||
@ -258,7 +258,7 @@ Default: +pass:[{"w": "session-save", "q": "q
|
||||
|
||||
[[auto_save.config]]
|
||||
== auto_save.config
|
||||
Whether to save the config automatically on quit.
|
||||
Save the config automatically on quit.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -275,7 +275,7 @@ Default: +pass:[15000]+
|
||||
|
||||
[[auto_save.session]]
|
||||
== auto_save.session
|
||||
Whether to always save the open pages.
|
||||
Always restore open sites when qutebrowser is reopened.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -506,7 +506,8 @@ Default: +pass:[rgb]+
|
||||
|
||||
[[colors.hints.bg]]
|
||||
== colors.hints.bg
|
||||
Background color for hints. Note that you can use a `rgba(...)` value for transparency.
|
||||
Background color for hints.
|
||||
Note that you can use a `rgba(...)` value for transparency.
|
||||
|
||||
Default: +pass:[qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(255, 247, 133, 0.8), stop:1 rgba(255, 197, 66, 0.8))]+
|
||||
|
||||
@ -536,7 +537,7 @@ Default: +pass:[#FFFFFF]+
|
||||
|
||||
[[colors.keyhint.suffix.fg]]
|
||||
== colors.keyhint.suffix.fg
|
||||
Highlight color for keys to complete the current keychain
|
||||
Highlight color for keys to complete the current keychain.
|
||||
|
||||
Default: +pass:[#FFFF00]+
|
||||
|
||||
@ -626,13 +627,13 @@ Default: +pass:[white]+
|
||||
|
||||
[[colors.statusbar.caret.selection.bg]]
|
||||
== colors.statusbar.caret.selection.bg
|
||||
Background color of the statusbar in caret mode with a selection
|
||||
Background color of the statusbar in caret mode with a selection.
|
||||
|
||||
Default: +pass:[#a12dff]+
|
||||
|
||||
[[colors.statusbar.caret.selection.fg]]
|
||||
== colors.statusbar.caret.selection.fg
|
||||
Foreground color of the statusbar in caret mode with a selection
|
||||
Foreground color of the statusbar in caret mode with a selection.
|
||||
|
||||
Default: +pass:[white]+
|
||||
|
||||
@ -758,7 +759,7 @@ Default: +pass:[white]+
|
||||
|
||||
[[colors.tabs.indicator.error]]
|
||||
== colors.tabs.indicator.error
|
||||
Color for the tab indicator on errors..
|
||||
Color for the tab indicator on errors.
|
||||
|
||||
Default: +pass:[#ff0000]+
|
||||
|
||||
@ -844,7 +845,7 @@ Default: +pass:[50%]+
|
||||
|
||||
[[completion.quick]]
|
||||
== completion.quick
|
||||
Whether to move on to the next part when there's only one possible completion left.
|
||||
Move on to the next part when there's only one possible completion left.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -855,7 +856,7 @@ Default: +pass:[true]+
|
||||
|
||||
[[completion.scrollbar.padding]]
|
||||
== completion.scrollbar.padding
|
||||
Padding of scrollbar handle in completion window (in px).
|
||||
Padding of scrollbar handle in the completion window (in px).
|
||||
|
||||
Default: +pass:[2]+
|
||||
|
||||
@ -879,7 +880,7 @@ Default: +pass:[always]+
|
||||
|
||||
[[completion.shrink]]
|
||||
== completion.shrink
|
||||
Whether to shrink the completion to be smaller than the configured size if there are no scrollbars.
|
||||
Shrink the completion to be smaller than the configured size if there are no scrollbars.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -890,7 +891,7 @@ Default: empty
|
||||
|
||||
[[completion.timestamp_format]]
|
||||
== completion.timestamp_format
|
||||
How to format timestamps (e.g. for history)
|
||||
How to format timestamps (e.g. for the history completion).
|
||||
|
||||
Default: +pass:[%Y-%m-%d]+
|
||||
|
||||
@ -903,7 +904,7 @@ Default: +pass:[1000]+
|
||||
|
||||
[[confirm_quit]]
|
||||
== confirm_quit
|
||||
Whether to confirm quitting the application.
|
||||
Whether quitting the application requires a confirmation.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -914,17 +915,10 @@ Valid values:
|
||||
|
||||
Default: +pass:[["never"]]+
|
||||
|
||||
[[content.accept_language]]
|
||||
== content.accept_language
|
||||
Value to send in the `accept-language` header.
|
||||
|
||||
Default: +pass:[en-US,en]+
|
||||
|
||||
[[content.cache.appcache]]
|
||||
== content.cache.appcache
|
||||
Whether support for the HTML 5 web application cache feature is enabled.
|
||||
An application cache acts like an HTTP cache in some sense. For documents that use the application cache via JavaScript, the loader engine will first ask the application cache for the contents, before hitting the network.
|
||||
The feature is described in details at: http://dev.w3.org/html5/spec/Overview.html#appcache
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -947,7 +941,7 @@ This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.cache.size]]
|
||||
== content.cache.size
|
||||
Size of the HTTP network cache. Empty to use the default value.
|
||||
Size of the HTTP network cache. Null to use the default value.
|
||||
|
||||
Default: empty
|
||||
|
||||
@ -968,7 +962,8 @@ This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.cookies.store]]
|
||||
== content.cookies.store
|
||||
Whether to store cookies. Note this option needs a restart with QtWebEngine on Qt < 5.9.
|
||||
Store cookies.
|
||||
Note this option needs a restart with QtWebEngine on Qt < 5.9.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -987,7 +982,7 @@ Default: +pass:[iso-8859-1]+
|
||||
[[content.developer_extras]]
|
||||
== content.developer_extras
|
||||
Enable extra tools for Web developers.
|
||||
This needs to be enabled for `:inspector` to work and also adds an _Inspect_ entry to the context menu. For QtWebEngine, see `qutebrowser --help` instead.
|
||||
This needs to be enabled for `:inspector` to work and also adds an _Inspect_ entry to the context menu. For QtWebEngine, see `--enable-webengine-inspector` in `qutebrowser --help` instead.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1000,7 +995,7 @@ This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.dns_prefetch]]
|
||||
== content.dns_prefetch
|
||||
Whether to try to pre-fetch DNS entries to speed up browsing.
|
||||
Try to pre-fetch DNS entries to speed up browsing.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1013,7 +1008,7 @@ This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.frame_flattening]]
|
||||
== content.frame_flattening
|
||||
Whether to expand each subframe to its contents.
|
||||
Expand each subframe to its contents.
|
||||
This will flatten all the frames to become one scrollable page.
|
||||
|
||||
Valid values:
|
||||
@ -1037,6 +1032,12 @@ Valid values:
|
||||
|
||||
Default: +pass:[ask]+
|
||||
|
||||
[[content.headers.accept_language]]
|
||||
== content.headers.accept_language
|
||||
Value to send in the `Accept-Language` header.
|
||||
|
||||
Default: +pass:[en-US,en]+
|
||||
|
||||
[[content.headers.custom]]
|
||||
== content.headers.custom
|
||||
Set custom headers for qutebrowser HTTP requests.
|
||||
@ -1046,6 +1047,7 @@ Default: empty
|
||||
[[content.headers.do_not_track]]
|
||||
== content.headers.do_not_track
|
||||
Value to send in the `DNT` header.
|
||||
When this is set to true, qutebrowser asks websites to not track your identity. If set to null, the DNT header is not sent at all.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1056,13 +1058,14 @@ Default: +pass:[true]+
|
||||
|
||||
[[content.headers.referer]]
|
||||
== content.headers.referer
|
||||
Send the Referer header
|
||||
Send the Referer header.
|
||||
The Referer header tells websites from which website you were coming from when visting them.
|
||||
|
||||
Valid values:
|
||||
|
||||
* +always+: Always send.
|
||||
* +never+: Never send; this is not recommended, as some sites may break.
|
||||
* +same-domain+: Only send for the same domain. This will still protect your privacy, but shouldn't break any sites.
|
||||
* +always+: Always send the Referer.
|
||||
* +never+: Never send the Referer. This is not recommended, as some sites may break.
|
||||
* +same-domain+: Only send the Referer for the same domain. This will still protect your privacy, but shouldn't break any sites.
|
||||
|
||||
Default: +pass:[same-domain]+
|
||||
|
||||
@ -1142,7 +1145,7 @@ Default: +pass:[true]+
|
||||
|
||||
[[content.javascript.can_access_clipboard]]
|
||||
== content.javascript.can_access_clipboard
|
||||
Whether JavaScript programs can read or write to the clipboard.
|
||||
Whether JavaScript can read from or write to the clipboard.
|
||||
With QtWebEngine, writing the clipboard as response to a user interaction is always allowed.
|
||||
|
||||
Valid values:
|
||||
@ -1152,9 +1155,9 @@ Valid values:
|
||||
|
||||
Default: empty
|
||||
|
||||
[[content.javascript.can_close_windows]]
|
||||
== content.javascript.can_close_windows
|
||||
Whether JavaScript programs can close windows.
|
||||
[[content.javascript.can_close_tabs]]
|
||||
== content.javascript.can_close_tabs
|
||||
Whether JavaScript can close tabs.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1165,9 +1168,9 @@ Default: empty
|
||||
|
||||
This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.javascript.can_open_windows_automatically]]
|
||||
== content.javascript.can_open_windows_automatically
|
||||
Whether JavaScript programs can open new windows without user interaction.
|
||||
[[content.javascript.can_open_tabs_automatically]]
|
||||
== content.javascript.can_open_tabs_automatically
|
||||
Whether JavaScript can open new tabs without user interaction.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1178,7 +1181,7 @@ Default: empty
|
||||
|
||||
[[content.javascript.enabled]]
|
||||
== content.javascript.enabled
|
||||
Enables or disables the running of JavaScript programs.
|
||||
Enables or disables JavaScript.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1189,7 +1192,7 @@ Default: +pass:[true]+
|
||||
|
||||
[[content.javascript.log]]
|
||||
== content.javascript.log
|
||||
How to log javascript console messages.
|
||||
How to log JavaScript console messages.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1299,6 +1302,8 @@ Valid values:
|
||||
|
||||
Default: empty
|
||||
|
||||
This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.plugins]]
|
||||
== content.plugins
|
||||
Enables or disables plugins in Web pages.
|
||||
@ -1348,7 +1353,7 @@ Default: +pass:[system]+
|
||||
|
||||
[[content.proxy_dns_requests]]
|
||||
== content.proxy_dns_requests
|
||||
Whether to send DNS requests over the configured proxy.
|
||||
Send DNS requests over the configured proxy.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1361,7 +1366,7 @@ This setting is only available with the QtWebKit backend.
|
||||
|
||||
[[content.ssl_strict]]
|
||||
== content.ssl_strict
|
||||
Whether to validate SSL handshakes.
|
||||
Validate SSL handshakes.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1371,9 +1376,9 @@ Valid values:
|
||||
|
||||
Default: +pass:[ask]+
|
||||
|
||||
[[content.user_stylesheet]]
|
||||
== content.user_stylesheet
|
||||
User stylesheet to use (absolute filename or filename relative to the config directory). Will expand environment variables.
|
||||
[[content.user_stylesheets]]
|
||||
== content.user_stylesheets
|
||||
A list of user stylesheets filenames to use.
|
||||
|
||||
Default: empty
|
||||
|
||||
@ -1403,13 +1408,13 @@ Default: empty
|
||||
[[downloads.location.directory]]
|
||||
== downloads.location.directory
|
||||
The directory to save downloads to.
|
||||
If unset, a sensible os-specific default is used. Will expand environment variables.
|
||||
If unset, a sensible os-specific default is used.
|
||||
|
||||
Default: empty
|
||||
|
||||
[[downloads.location.prompt]]
|
||||
== downloads.location.prompt
|
||||
Whether to prompt the user for the download location.
|
||||
Prompt the user for the download location.
|
||||
If set to false, `download-directory` will be used.
|
||||
|
||||
Valid values:
|
||||
@ -1421,7 +1426,7 @@ Default: +pass:[true]+
|
||||
|
||||
[[downloads.location.remember]]
|
||||
== downloads.location.remember
|
||||
Whether to remember the last used download directory.
|
||||
Remember the last used download directory.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1444,7 +1449,8 @@ Default: +pass:[path]+
|
||||
|
||||
[[downloads.open_dispatcher]]
|
||||
== downloads.open_dispatcher
|
||||
The default program used to open downloads. If unset, the default internal handler is used.
|
||||
The default program used to open downloads.
|
||||
If null, the default internal handler is used.
|
||||
Any `{}` in the string will be expanded to the filename, else the filename will be appended.
|
||||
|
||||
Default: empty
|
||||
@ -1462,14 +1468,14 @@ Default: +pass:[top]+
|
||||
|
||||
[[downloads.remove_finished]]
|
||||
== downloads.remove_finished
|
||||
Number of milliseconds to wait before removing finished downloads. Will not be removed if value is -1.
|
||||
Number of milliseconds to wait before removing finished downloads.
|
||||
If set to -1, downloads are never removed.
|
||||
|
||||
Default: +pass:[-1]+
|
||||
|
||||
[[editor.command]]
|
||||
== editor.command
|
||||
The editor (and arguments) to use for the `open-editor` command.
|
||||
The arguments get split like in a shell, so you can use `\"` or `\'` to quote them.
|
||||
`{}` gets replaced by the filename of the file to be edited.
|
||||
|
||||
Default: +pass:[["gvim", "-f", "{}"]]+
|
||||
@ -1537,6 +1543,7 @@ Default: +pass:[8pt monospace]+
|
||||
[[fonts.monospace]]
|
||||
== fonts.monospace
|
||||
Default monospace fonts.
|
||||
Whenever "monospace" is used in a font setting, it\'s replaced with the fonts listed here.
|
||||
|
||||
Default: +pass:[xos4 Terminus, Terminus, Monospace, "DejaVu Sans Mono", Monaco, "Bitstream Vera Sans Mono", "Andale Mono", "Courier New", Courier, "Liberation Mono", monospace, Fixed, Consolas, Terminal]+
|
||||
|
||||
@ -1620,7 +1627,7 @@ Default: +pass:[6]+
|
||||
|
||||
[[hints.auto_follow]]
|
||||
== hints.auto_follow
|
||||
Controls when a hint can be automatically followed without the user pressing Enter.
|
||||
Controls when a hint can be automatically followed without pressing Enter.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1633,7 +1640,7 @@ Default: +pass:[unique-match]+
|
||||
|
||||
[[hints.auto_follow_timeout]]
|
||||
== hints.auto_follow_timeout
|
||||
A timeout (in milliseconds) to inhibit normal-mode key bindings after a successful auto-follow.
|
||||
A timeout (in milliseconds) to ignore normal-mode key bindings after a successful auto-follow.
|
||||
|
||||
Default: empty
|
||||
|
||||
@ -1668,7 +1675,7 @@ Default: +pass:[python]+
|
||||
|
||||
[[hints.hide_unmatched_rapid_hints]]
|
||||
== hints.hide_unmatched_rapid_hints
|
||||
Controls hiding unmatched hints in rapid mode.
|
||||
Hide unmatched hints in rapid mode.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1690,7 +1697,7 @@ Mode to use for hints.
|
||||
Valid values:
|
||||
|
||||
* +number+: Use numeric hints. (In this mode you can also type letters from the hinted element to filter and reduce the number of elements that are hinted.)
|
||||
* +letter+: Use the chars in the hints.chars setting.
|
||||
* +letter+: Use the chars in the `hints.chars` setting.
|
||||
* +word+: Use hints words based on the html elements and the extra words.
|
||||
|
||||
Default: +pass:[letter]+
|
||||
@ -1709,7 +1716,8 @@ Default: +pass:[["\\bprev(ious)?\\b", "\\bback\\b", "\\
|
||||
|
||||
[[hints.scatter]]
|
||||
== hints.scatter
|
||||
Whether to scatter hint key chains (like Vimium) or not (like dwb). Ignored for number hints.
|
||||
Scatter hint key chains (like Vimium) or not (like dwb).
|
||||
Ignored for number hints.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1729,15 +1737,16 @@ Valid values:
|
||||
|
||||
Default: empty
|
||||
|
||||
[[history_session_interval]]
|
||||
== history_session_interval
|
||||
The maximum time in minutes between two history items for them to be considered being from the same session. Use -1 to disable separation.
|
||||
[[history_gap_interval]]
|
||||
== history_gap_interval
|
||||
The maximum time in minutes between two history items for them to be considered being from the same browsing session.
|
||||
Items with less time between them are grouped when being displayed in `:history`. Use -1 to disable separation.
|
||||
|
||||
Default: +pass:[30]+
|
||||
|
||||
[[ignore_case]]
|
||||
== ignore_case
|
||||
Whether to find text on a page case-insensitively.
|
||||
Find text on a page case-insensitively.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1756,7 +1765,7 @@ Default: +pass:[500]+
|
||||
|
||||
[[input.forward_unbound_keys]]
|
||||
== input.forward_unbound_keys
|
||||
Whether to forward unbound keys to the webview in normal mode.
|
||||
Forward unbound keys to the webview in normal mode.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1768,7 +1777,7 @@ Default: +pass:[auto]+
|
||||
|
||||
[[input.insert_mode.auto_leave]]
|
||||
== input.insert_mode.auto_leave
|
||||
Whether to leave insert mode if a non-editable element is clicked.
|
||||
Leave insert mode if a non-editable element is clicked.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1779,7 +1788,7 @@ Default: +pass:[true]+
|
||||
|
||||
[[input.insert_mode.auto_load]]
|
||||
== input.insert_mode.auto_load
|
||||
Whether to automatically enter insert mode if an editable element is focused after page load.
|
||||
Automatically enter insert mode if an editable element is focused after loading the page.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1790,7 +1799,7 @@ Default: empty
|
||||
|
||||
[[input.insert_mode.plugins]]
|
||||
== input.insert_mode.plugins
|
||||
Whether to switch to insert mode when clicking flash and other plugins.
|
||||
Switch to insert mode when clicking flash and other plugins.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1801,7 +1810,7 @@ Default: empty
|
||||
|
||||
[[input.links_included_in_focus_chain]]
|
||||
== input.links_included_in_focus_chain
|
||||
Whether hyperlinks should be included in the keyboard focus chain.
|
||||
Include hyperlinks in the keyboard focus chain when tabbing.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1819,7 +1828,8 @@ Default: +pass:[5000]+
|
||||
|
||||
[[input.rocker_gestures]]
|
||||
== input.rocker_gestures
|
||||
Whether to enable Opera-like mouse rocker gestures. This disables the context menu.
|
||||
Enable Opera-like mouse rocker gestures.
|
||||
This disables the context menu.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1830,7 +1840,7 @@ Default: empty
|
||||
|
||||
[[input.spatial_navigation]]
|
||||
== input.spatial_navigation
|
||||
Enables or disables the Spatial Navigation feature.
|
||||
Enable Spatial Navigation.
|
||||
Spatial navigation consists in the ability to navigate between focusable elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow keys. For example, if a user presses the Right key, heuristics determine whether there is an element he might be trying to reach towards the right and which element he probably wants.
|
||||
|
||||
Valid values:
|
||||
@ -1849,7 +1859,7 @@ Default: empty
|
||||
|
||||
[[keyhint.delay]]
|
||||
== keyhint.delay
|
||||
Time from pressing a key to seeing the keyhint dialog (ms)
|
||||
Time from pressing a key to seeing the keyhint dialog (ms).
|
||||
|
||||
Default: +pass:[500]+
|
||||
|
||||
@ -1862,7 +1872,7 @@ Default: +pass:[2000]+
|
||||
|
||||
[[messages.unfocused]]
|
||||
== messages.unfocused
|
||||
Whether to show messages in unfocused windows.
|
||||
Show messages in unfocused windows.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1871,6 +1881,36 @@ Valid values:
|
||||
|
||||
Default: empty
|
||||
|
||||
[[new_instance_open_target]]
|
||||
== new_instance_open_target
|
||||
How to open links in an existing instance if a new one is launched.
|
||||
This happens when e.g. opening a link from a terminal.
|
||||
See `new_instance_open_target_window` to customize in which window the link is opened in.
|
||||
|
||||
Valid values:
|
||||
|
||||
* +tab+: Open a new tab in the existing window and activate the window.
|
||||
* +tab-bg+: Open a new background tab in the existing window and activate the window.
|
||||
* +tab-silent+: Open a new tab in the existing window without activating the window.
|
||||
* +tab-bg-silent+: Open a new background tab in the existing window without activating the window.
|
||||
* +window+: Open in a new window.
|
||||
|
||||
Default: +pass:[tab]+
|
||||
|
||||
[[new_instance_open_target_window]]
|
||||
== new_instance_open_target_window
|
||||
Which window to choose when opening links as new tabs.
|
||||
When `new_instance_open_target` is not set to `window`, this is ignored.
|
||||
|
||||
Valid values:
|
||||
|
||||
* +first-opened+: Open new tabs in the first (oldest) opened window.
|
||||
* +last-opened+: Open new tabs in the last (newest) opened window.
|
||||
* +last-focused+: Open new tabs in the most recently focused window.
|
||||
* +last-visible+: Open new tabs in the most recently visible window.
|
||||
|
||||
Default: +pass:[last-focused]+
|
||||
|
||||
[[prompt.filebrowser]]
|
||||
== prompt.filebrowser
|
||||
Show a filebrowser in upload/download prompts.
|
||||
@ -1901,7 +1941,8 @@ Default: empty
|
||||
|
||||
[[scrolling.smooth]]
|
||||
== scrolling.smooth
|
||||
Whether to enable smooth scrolling for web pages. Note smooth scrolling does not work with the `:scroll-px` command.
|
||||
Enable smooth scrolling for web pages.
|
||||
Note smooth scrolling does not work with the `:scroll-px` command.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1912,13 +1953,14 @@ Default: empty
|
||||
|
||||
[[session_default_name]]
|
||||
== session_default_name
|
||||
The name of the session to save by default, or unset for the last loaded session.
|
||||
The name of the session to save by default.
|
||||
If this is set to null, the session which was last loaded is saved.
|
||||
|
||||
Default: empty
|
||||
|
||||
[[statusbar.hide]]
|
||||
== statusbar.hide
|
||||
Whether to hide the statusbar unless a message is shown.
|
||||
Hide the statusbar unless a message is shown.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1946,7 +1988,7 @@ Default: +pass:[bottom]+
|
||||
|
||||
[[tabs.background]]
|
||||
== tabs.background
|
||||
Whether to open new tabs (middleclick/ctrl+click) in background.
|
||||
Open new tabs (middleclick/ctrl+click) in the background.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1969,13 +2011,14 @@ Default: +pass:[middle]+
|
||||
|
||||
[[tabs.favicons.scale]]
|
||||
== tabs.favicons.scale
|
||||
Scale for favicons in the tab bar. The tab size is unchanged, so big favicons also require extra `tabs.padding`.
|
||||
Scaling for favicons in the tab bar.
|
||||
The tab size is unchanged, so big favicons also require extra `tabs.padding`.
|
||||
|
||||
Default: +pass:[1.0]+
|
||||
|
||||
[[tabs.favicons.show]]
|
||||
== tabs.favicons.show
|
||||
Whether to show favicons in the tab bar.
|
||||
Show favicons in the tab bar.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -1986,7 +2029,7 @@ Default: +pass:[true]+
|
||||
|
||||
[[tabs.indicator_padding]]
|
||||
== tabs.indicator_padding
|
||||
Padding for indicators
|
||||
Padding for tab indicators
|
||||
|
||||
Default: +pass:[{"top": 2, "bottom": 2, "left": 0, "right": 4}]+
|
||||
|
||||
@ -2043,7 +2086,7 @@ Default: +pass:[last]+
|
||||
|
||||
[[tabs.padding]]
|
||||
== tabs.padding
|
||||
Padding for tabs
|
||||
Padding around text for tabs
|
||||
|
||||
Default: +pass:[{"top": 0, "bottom": 0, "left": 5, "right": 5}]+
|
||||
|
||||
@ -2093,7 +2136,7 @@ Default: +pass:[800]+
|
||||
|
||||
[[tabs.tabs_are_windows]]
|
||||
== tabs.tabs_are_windows
|
||||
Whether to open windows instead of tabs.
|
||||
Open a new window for every tab.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -2104,7 +2147,7 @@ Default: empty
|
||||
|
||||
[[tabs.title.alignment]]
|
||||
== tabs.title.alignment
|
||||
Alignment of the text inside of tabs
|
||||
Alignment of the text inside of tabs.
|
||||
|
||||
Valid values:
|
||||
|
||||
@ -2116,7 +2159,8 @@ Default: +pass:[left]+
|
||||
|
||||
[[tabs.title.format]]
|
||||
== tabs.title.format
|
||||
The format to use for the tab title. The following placeholders are defined:
|
||||
The format to use for the tab title.
|
||||
The following placeholders are defined:
|
||||
|
||||
* `{perc}`: The percentage as a string like `[10%]`.
|
||||
* `{perc_raw}`: The raw percentage, e.g. `10`
|
||||
@ -2181,7 +2225,8 @@ Default: +pass:[naive]+
|
||||
|
||||
[[url.default_page]]
|
||||
== url.default_page
|
||||
The page to open if :open -t/-b/-w is used without URL. Use `about:blank` for a blank page.
|
||||
The page to open if :open -t/-b/-w is used without URL.
|
||||
Use `about:blank` for a blank page.
|
||||
|
||||
Default: +pass:[https://start.duckduckgo.com/]+
|
||||
|
||||
@ -2198,33 +2243,6 @@ Valid values:
|
||||
|
||||
Default: +pass:[["path", "query"]]+
|
||||
|
||||
[[url.new_instance_open_target]]
|
||||
== url.new_instance_open_target
|
||||
How to open links in an existing instance if a new one is launched.
|
||||
|
||||
Valid values:
|
||||
|
||||
* +tab+: Open a new tab in the existing window and activate the window.
|
||||
* +tab-bg+: Open a new background tab in the existing window and activate the window.
|
||||
* +tab-silent+: Open a new tab in the existing window without activating the window.
|
||||
* +tab-bg-silent+: Open a new background tab in the existing window without activating the window.
|
||||
* +window+: Open in a new window.
|
||||
|
||||
Default: +pass:[tab]+
|
||||
|
||||
[[url.new_instance_open_target_window]]
|
||||
== url.new_instance_open_target_window
|
||||
Which window to choose when opening links as new tabs.
|
||||
|
||||
Valid values:
|
||||
|
||||
* +first-opened+: Open new tabs in the first (oldest) opened window.
|
||||
* +last-opened+: Open new tabs in the last (newest) opened window.
|
||||
* +last-focused+: Open new tabs in the most recently focused window.
|
||||
* +last-visible+: Open new tabs in the most recently visible window.
|
||||
|
||||
Default: +pass:[last-focused]+
|
||||
|
||||
[[url.searchengines]]
|
||||
== url.searchengines
|
||||
Definitions of search engines which can be used via the address bar.
|
||||
@ -2234,13 +2252,13 @@ Default: +pass:[{"DEFAULT": "https://duckduckgo.com/?q={}"}]
|
||||
|
||||
[[url.start_pages]]
|
||||
== url.start_pages
|
||||
The default page(s) to open at the start.
|
||||
The page(s) to open at the start.
|
||||
|
||||
Default: +pass:[["https://start.duckduckgo.com"]]+
|
||||
|
||||
[[url.yank_ignored_parameters]]
|
||||
== url.yank_ignored_parameters
|
||||
The URL parameters to strip with :yank url.
|
||||
The URL parameters to strip with `:yank url`.
|
||||
|
||||
Default: +pass:[["ref", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"]]+
|
||||
|
||||
@ -2257,7 +2275,8 @@ Default: empty
|
||||
|
||||
[[window.title_format]]
|
||||
== window.title_format
|
||||
The format to use for the window title. The following placeholders are defined:
|
||||
The format to use for the window title.
|
||||
The following placeholders are defined:
|
||||
|
||||
* `{perc}`: The percentage as a string like `[10%]`.
|
||||
* `{perc_raw}`: The raw percentage, e.g. `10`
|
||||
|
Loading…
Reference in New Issue
Block a user