Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
xfce:xfce4-appfinder:preferences [2019/04/09 21:44] – [Behaviour] blueberrybrowniexfce:xfce4-appfinder:preferences [2024/12/11 11:18] (current) – kevinbowen
Line 1: Line 1:
-====== Preferences ====== +~~NOTOC~~ 
-This page details all the settings available for the Application Finder. To edit settings, open up the application in it's expanded mode and select ''Preferences''.+{{ xfce:xfce4-appfinder.png?nolink|}} 
 +====== xfce4-appfinder - Preferences ====== 
 +This page details all of the settings available for the Application Finder. To edit the settings, open up the application in its expanded mode and select {gui>Preferences}. 
 + 
 +  * **[[#General|General]]** 
 +    * **[[#Behaviour|Behaviour]]** 
 +    * **[[#Appearance|Appearance]]** 
 +    * **[[#History|History]]** 
 +  * **[[#Custom Actions|Custom Actions]]** 
 +    * **[[#Usage|Usage]]** 
 + 
 +---- 
 ===== General ===== ===== General =====
  
-<figure "General Preferences"> +<figure "xfce4-appfinder General Preferences Tab"> 
-{{:xfce:xfce4-appfinder:xfce4-appfinder-preferences-general.png?nolink&|}}+{{:xfce:xfce4-appfinder:xfce-appfinder-genprefs.png?400|xfce4-appfinder General Preferences Tab}}
 </figure> </figure>
 +
 +----
  
 ==== Behaviour ==== ==== Behaviour ====
Line 12: Line 26:
 ! Select this option to make the Application Finder select the last selected category in the expanded view. If this option is disabled, the category {gui>All Applications} is selected. ! Select this option to make the Application Finder select the last selected category in the expanded view. If this option is disabled, the category {gui>All Applications} is selected.
 ? Always centre the window ? Always centre the window
-! By default, [[../xfwm4:|Xfwm4]] might position the window in a place that isn't in the centre of the screen (see the section [[..:xfwm4:wmtweaks|Placement]] under Window Manager Tweaks to change this behaviour). Select this option to always centre the Application Finder screen on startup, regardless of Window Manager settings.+! By default, [[:xfce:xfwm4:|Xfwm4]] might position the window in a place that isn't in the centre of the screen (see the section [[:xfce:xfwm4:wmtweaks|Placement]] under Window Manager Tweaks to change this behaviour). Select this option to always centre the Application Finder screen on startup, regardless of Window Manager settings.
 ? Keep running instance in the background ? Keep running instance in the background
 ! Keeps Application Finder running in the background to speed up opening times. You might want to disable this to reduce memory usage. ! Keeps Application Finder running in the background to speed up opening times. You might want to disable this to reduce memory usage.
 ? Single window ? Single window
-! Only keep one instance of the application open at a time.+! This option in only active if {gui>Keep running instance in the background} is enabled. Only keep one instance of the application open at a time. 
 +? Sort recently user items first 
 +! Sort items by frequency, i.e. taking into account the frequency and how recent an item has been launched. 
 + 
 +[[|Back to Top]] 
 +----
  
 ==== Appearance ==== ==== Appearance ====
  
 ? View items as icons ? View items as icons
-! Select this option to show the applications and command in a //icon view// instead of a //list view//.+! Select this option to show the applications and commands as icons rather than in a list view.
 ? Text beside icons ? Text beside icons
-! This option in only active if {gui>View items as icons} is enabled. Select this option to position the application name or command beside the icon, instead of below.+! This option in only active if {gui>View items as icons} is enabled. Select this option to position the application name or command beside the icon rather than below.
 ? Item icon size ? Item icon size
 ! The size of the icons in the item view. ! The size of the icons in the item view.
 +? Hide category pane
 +! Hides the category side pane when in expanded mode.
 ? Category icon size ? Category icon size
-! The size of the category icons in the side-pane.+! The size of the category icons in the side pane. 
 + 
 +---- 
  
 ==== History ==== ==== History ====
  
-? Clear custom command history +? Clear Custom Command History 
-! Use this option to remove the history of "Custom Commands" you've entered in the collapsed mode that did not match any of the installed application commands.+! Use this option to remove the history of custom commands you've entered in the collapsed mode that did not match any of the installed application commands.
  
-===== Actions =====+[[|Back to Top]] 
 +----
  
-<figure "Custom Actions"> 
-{{:xfce:xfce4-appfinder:xfce4-appfinder-preferences-actions.png?nolink&|}} 
-</figure> 
  
-==== Introduction ==== 
  
-Custom actions can be used to match commands entered in the collapsed view and use them to quickly perform tasks.+===== Custom Actions ===== 
 +You can set custom actions to quickly perform tasks when a certain character or combination of characters is entered in the collapsed view. For example, you can go to a certain article on Wikipedia by typing ''!w'' and then the article name.
  
-It can for example be use the make shortcuts to commands, but also to send arguments to a website, for quick searching.+<figure "xfce4-appfinder Custom Actions Tab"> 
 +{{:xfce:xfce4-appfinder:xfce-appfinder-custacts.png|xfce4-appfinder Custom Actions Tab}} 
 +</figure>
  
-By default 4 custom actions are predefined, but you can change this to anything you like. See also the [[examples]] in the dedicated wiki page. 
  
-==== Usage ====+[[|Back to Top]] 
 +----
  
-You can add a new (empty) action by clicking on the {gui>Add} (+) button and remove the selected action by pressing the {gui>Delete} (x) button. 
  
-Strings in the Application Finder by the {gui>type} and {gui>pattern} or the action. If there is a match, the {gui>command} is executed as a replacement for the entered string.+==== Usage ==== 
 +You can add a new (empty) action by clicking on the {gui>Add} (+) button and remove the selected action by pressing the {gui>Delete} (x) button. You can edit an existing action by selecting it from the list and using the {gui>Type}, {gui>Pattern} and {gui>Command} fields.
  
 ? Type ? Type
-! There are two types of pattern matches. +! There are two types of pattern matches: 
-  ? Prefix + 
-  ! If this type is selected, there is a match if the entered string starts with {gui>pattern}. +  * **Prefix** - if this type is selected, there is a match if the entered string starts with the pattern specified. 
-  ? Regular Expression +  * **Regular Expression** - For complex matches you can write a [[https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions|Perl-compatible regular expression]] that's matched against the entered string.
-  ! For complex matches you can write a [[https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions|Perl-compatible regular expression]] that is matched against the entered string.+
 ? Pattern ? Pattern
-! Depending on the selected {gui>type} it will describe the matching prefix or regular expression.+! Depending on the type selected, it describes the prefix or regular expression.
 ? Command ? Command
-! The command that is executed when the pattern is matched. To include (parts) of the match the following variables are available:+! The command that is executed when the pattern is matched. To include parts of the search in the command the following variables are available:
   ? Prefix   ? Prefix
-    ? %s +  ! **%s** - Include the string after the matched pattern. For example, if the prefix-pattern is ''abc'' and the entered command is ''abcdef'', ''%s'' will be replaced with ''def''. 
-    ! Include the string after the matched pattern. So if the prefix-pattern is ''abc'' and the entered command ''abcdef'', ''%s'' will be replaced with ''def''. +  ! **%S** - Include the complete string after the matched pattern. For example, if the prefix-pattern is ''abc'' and the entered command is ''abcdef'', ''%s'' will be replaced with ''abcdef''.
-    ? %S +
-    ! Include the complete string after the matches pattern. So if the prefix-pattern is ''abc'' and the entered command ''abcdef'', ''%s'' will be replaced with ''abcdef''.+
   ? Regular Expression   ? Regular Expression
-  ! During the process of matching, the match results of subpattern between parentheses ''( )'' are recorded for later use. ''\'' plus a number to refer to the corresponding substring. ''\1'' refers to 1st pair of parentheses' match result, ''\2'' refers to 2nd pair of parentheses' match result. A special case is ''\0'' which will be replaced with the entire match. +  ! During the process of matching, the results of the sub-pattern between parentheses ''( )'' are recorded for later use. ''\'' plus a number to refers to the corresponding sub-string. For instance, ''\1'' refers to the 1st pair of parentheses' match result, while ''\2'' refers to 2nd pair of parentheses' match result. A special case is ''\0'', which will be replaced with the entire match. 
-  ! If the pattern is ''^ab(.*)fg$'' and the entered command ''abcdefg'', ''\1'' will be replaced with ''cde''.+  ! If the pattern is ''^ab(.*)fg$'' and the entered command ''abcdefg'' for example, ''\1'' will be replaced with ''cde''. 
 +? Save match in command history 
 +! Select this option if you want matches to be saved in the {gui>Commands History} category. 
      
 +
 +[[|Back To Top]]
 +----
 +[[:xfce:xfce4-appfinder:start:|Return to xfce4-appfinder Main Documentation Page]]