Using the Find and Replace in Files Feature

You do not need to have any files open in order to use this window pane to search for text.

Do one of the following, depending on the part of the user interface you are using:

• Ribbon Select the Home ribbon. In the Find and Replace section select Find and Replace in Files.

  Switching between ribbons and the tool strip… You can use the Options dialog to switch between ribbons and the classic tool strip layout. See Switching Between Ribbons and the Tool Strip. 

  More about ribbon options… Keep in mind that the smaller the application window becomes, the more the options in a ribbon shrink. Therefore, you might only see a small icon instead of text, or you might see only a section name displayed with a down arrow to access the options in it. You can hover over small icons to see tooltips that describe them. You can also enlarge the application window or click one of the section drop-downs in the ribbon to locate a hidden feature.

• Menu Select Edit>Find and Replace>Find and Replace in Files.
• Keyboard Shortcut Press CTRL+SHIFT+F.

Following are the options available in this window pane:

• Find When you first open the window pane, this field is automatically populated, based on the text selected in the document, or the text where the cursor is resting. You can also select text and press CTRL+SHIFT+F to populate the field. Another option is to simply type text or click the down arrow and select a recent search term.
• Replace with Type the text that will replace the found text. You can also click the down arrow and select a recent search term.
• Find In Select one of the following:
  • (current document) Lingo looks for the text in the active document.
  • (documents in the same folder) Lingo looks for the text in all documents located in the same folder as the current one.
  • (all open documents) Lingo looks for the text in all documents currently open in the interface.
  • (whole project) Lingo looks for the text in files that are contained in the entire project.
• Find Options Use any of the following additional options:
  • Match case Lingo finds only occurrences of the text that match the case (e.g., uppercase, lowercase) of the text entered in the Find field.
  • Whole word You can now look for whole words only (e.g., if you enter "stand" as the search term, it will find "stand," but not "standing").
  • Find in Source Lingo finds only occurrences of the text that appear in source (untranslated) documents.
  • Find in Target Lingo finds only occurrences of the text that appear in target (translated) documents.

  • Use This is an advanced feature for users who are familiar with wildcard and regular expressions in searches. If you select this check box, you can specify whether the search will include wildcards or regular expressions.

    wildcards

    A wildcard lets you substitute a single character for one or more other characters when searching for text strings. The most common wildcard characters are the question mark (?)—which represents a single character—and the asterisk (*)—which represents any combination of characters.

    To use wildcards in the Find and Replace in Files window pane, enter the expression in the Find what field, select the Use check box, and from the drop-down choose Wildcards.

    

    examples

    Following are some examples of wildcards:

    Wildcard Examples	Result
    s*t	Finds "secret," "select," accessibility," and so on
    stand*	Finds "stand," "standing," standard," "stand-in," "outstanding," and so on
    gloss?.doc	Finds "glossy.doc," but not "glossary.doc"

    For more information about wildcards, see http://tinyurl.com/279p2nf.

    regular expressions

    Regular expressions (also referred to as regex or regexp) are similar to wildcards in that they let you find matching strings of text. However, they are more powerful than wildcards.

    To use regular expressions in the Find and Replace in Files window pane, enter the expression in the Find what field, select the Use check box, and from the drop-down choose Regular Expressions.

    When using regular expressions, backreferences are supported. For more information about backreferences, see http://www.regular-expressions.info/backref.html.

    

    examples

    Following are some examples of regular expressions:

    Expression	Description
    [a-z]	Matches any lowercase letter
    [A-Z]	Matches any uppercase letter
    \d	Matches any decimal digit
    \D	Matches any non-digit
    \s	Matches any white-space character
    {…}	Explicit quantifier For example, a{3} finds "aaa"
    |	Alternation For example, gray|grey finds "gray" or "grey"
    (…)	Logical grouping
    ?	0 or 1 of previous expression; forces minimal matching when expression might match several strings within a search string For example, reg(ular expressions?|ex(p|es?) finds "regular expression," "regular expressions," regex, regexp, or "regexes"

    For more examples and information about regular expressions, see the following:

    http://www.regular-expressions.info/

    http://regexlib.com/CheatSheet.aspx

    Note: Lingo supports only .NET Framework regular expressions. For more information, see http://msdn.microsoft.com/en-us/library/hs600312.aspx.

• Result Options Select one of the following:
  • Results Window 1 Lingo will display the search results (list of files) in the Find Results 1 window pane.
  • Results Window 2 Lingo will display the search results (list of files) in the Find Results 2 window pane.
• Find Next Click this to locate the next occurrence of the text.
• Find Previous Click this to locate the previous occurrence of the text.
• Skip File Click this to skip searching in the current file and move on to the next one.
• Find All Click this to find and list all occurrences of the text in the Find Results window pane at the bottom of the user interface. The label on this button changes to "Stop Find" while a search is being processed. This is one way to tell that a search is in progress. Another way is to watch the counter in the Find Results window pane. This shows how many occurrences of matching text have been found; if the number continues to go higher, the search is still in progress.
• Replace Click this to replace only the current instance of found text.

• Replace All Lingo replaces all of the matching text in all files included in the search. If matches are found in files that are already open, Lingo replaces the text in those files and "dirties" them (i.e., an asterisk is shown in the tab, indicating the file has been changed and needs to be saved). Therefore, you can undo the changes if necessary in each of those files or save them. As for files that are not already open in the user interface, Lingo does not open them at all. Instead, it simply replaces all of the matching text it finds and automatically saves those files. Therefore, you cannot undo those changes because the files were never opened.

• [Progress Bar] A green bar at the bottom of the window pane shows the progress of the search.