User tools are external programs that can be setup to run using custom parameters. If console programs are used (including perl scripts), you can also send and receive to standard input & output.

 

Parameters used can be changed dynamically, by replacing special tags listed in the next section.

 

You can also move your tools to toolbars or the menu, assign shortcuts and even a corresponding graphic.

 

 

icon_idea For more advanced manipulating of optiperl read about plug-ins instead.

 

Why you would want to use tools - Some examples

 

Examples of non perl tools:

 

icon_arrow Opening an explorer window to c:\perl

 

Program: Explorer.exe

Parameters: c:\perl

 

icon_arrow Opening perl's main help file:

 

Program: Explorer.exe

Parameters: c:\perl\html\index.html

 

icon_arrow Starting and stopping apache

 

Program: c:\perl\bin\apache.exe

Parameters: -f "c:/perl/conf/httpd.conf"

 

icon_arrow Opening a console window at the folder of the active script in the editor

 

Program: cd

Parameters: "%folder%"

 

icon_arrow Creating a new email in Microsoft (r) Outlook (this will need MS-Office (r) installed) with the active file in the editor as an attachment.

 

Program: c:\program files\Microsoft Office\Office\Outlook.exe

Parameters: /a "%pathsn%"

 

icon_arrow Using pod2html

 

Program: c:\perl\bin\pod2html.bat

 

a) First method

 

Parameters: --infile=%PathSn% --outfile="%folder%\%FileNoExt%.html"

 

Notice the use of double quotes to make sure that paths with spaces are not interpreted from windows as multiple parameters.

 

The above will extract the pod text in your script in an html file. The file will be created in the same folder.

 

You could also set the above up so that the name of the output file is queried first:

 

-infile=%Pathsn% -outfile="%Querybox%"

 

b) Second method

 

Parameters: -infile=%PathSn% %n<pod - %filenoext%.html>%%getfile%

 

If you don't specify the -outfile in pod2html then the output is sent to standard output. The parameters %n<pod - %filenoext%.html>% and %getfile% are "magic" which are deleted when running. They command optiperl:

 

%n<pod - %fileNoExt%>%

To open a new file in the editor named "pod - filename" (without the extension)

 

%getfile%

To get all output and insert in the editor. This will capture all the output from pod2html.

 

Examples of perl tools:

 

icon_arrow Adding a tab character if front of each selected line

 

Program: TabIndentSelection.pl

Parameters: %SENDSELECTION%%GETSELECTION%

 

Enter the following for TabIndentSelection.pl:

 

# Get input from OptiPerl

@lines = <STDIN>;

 

# Do now what you want with @lines and the rest of the variables

foreach (@lines) {

$_ = "\t" . $_;

}

 

#Send it back

print @lines;

 

 

icon_arrow Also see an implementation for CVS.

 

Top  Previous  Next