ExternalFinder XML Format

• items: This element has an optional attribute priority.
• item: This element has an optional attribute nopopup.
• name: A string to show as a menu item. For a mnemonic, you can use '&' (written in XML as '&').
• url: A URL with a {target} placeholder with optional attributes: target and encoding.
• command: A command string with a {target} placeholder with optional attributes: target, encoding, and delimiter.
• keystroke: A definition of the keyboard shortcut (same as OmegaT's custom keyboard shortcut). Ref. KeyStroke (Java Platform SE 8 )

XML examples:

• The value of the priority attribute determines the position of items on popup menu. The default value is 50. See EditorPopups.java.

• The value of nopopup attribute MUST be true.
• The value of target attribute can be both, ascii_only, or non_ascii_only.
• The value of encoding attribute can be default, escape, or none. The difference between default and escape is the whitespace which becomes + with default (URL Encoding) and %20 with escape (for some web sites).
• The default values of target and encoding attributes are both and default.

<?xml version="1.0" encoding="UTF-8" ?>
<items priority="50">
    <item nopopup="true">
        <name>Google</name>
        <url target="both" encoding="default">https://www.google.com/search?q={target}</url>
        <url target="ascii_only">https://www.google.com/search?q=define%3A{target}</url>
        <keystroke>ctrl shift F</keystroke>
    </item>
    <item>
        <name>Yahoo</name>
        <url target="ascii_only">http://search.yahoo.com/search?p={target}</url>
        <url target="non_ascii_only">http://search.yahoo.co.jp/search?p={target}</url>
    </item>
    <item>
        <name>Google &amp;definition</name>
        <url target="ascii_only">https://www.google.com/search?q=Define+{target}</url>
    </item>
    <item>
        <name>Google &amp;patent</name>
        <url target="ascii_only">https://www.google.com/search?q=Patent+{target}</url>
    </item>
    <item>
        <name>Google (&amp;ja)</name>
        <url target="both" encoding="default">https://www.google.com/search?q=%22{target}%22&amp;lr=lang_ja&amp;ie=UTF-8</url>
    </item>
</items>
    

• This plugin can call executables using command element. The default values of target and encoding attributes are both and none.
• The delimiter attribute for command element is used to define the delimiter for parameters. The default delimiter is |.

<?xml version="1.0" encoding="UTF-8" ?>
<items>
    <item>
        <name>Dictionary</name>
        <command encoding="default">/usr/bin/open|dict://{target}</command>
        <keystroke>ctrl shift K</keystroke>
    </item>
</items>