Customizing PreferencesThis section describes the customization of the Komodo environment. Set your preferences using the Preferences dialog and the Current File Settings dialog accessible from the Edit menu (or from the Properties and Settings right-mouse menu option in the editor pane). Customizing the AppearanceYou can customize how you want Komodo to look. The functions described below can also be changed using keyboard shortcuts; see Key Bindings for more information. To customize the Komodo workspace, select Edit | Preferences and select Appearance. Configure the following options: Toolbar Configuration
Initial Page Configuration
Most Recently Used
![]() Customizing the DebuggerTo customize general debugger functions, from the Edit menu, select Preferences, then click Debugger.
![]() Customizing the EditorCustomizing Editor FeaturesFrom the Edit menu, select Preferences, then click Editor. General PreferencesThe following options may be enabled or disabled by clicking the check boxes on the right side of the dialog:
Note - options set through the Preferences dialog are the default for all files opened in Komodo. You may also customize editing features for the current file; however, these file settings will not be saved after the current file is closed and re-opened. ScrollingThe value specified in this field determines the number of lines that will be displayed above or below the editing cursor. As you move the editing cursor, the number of lines specified here will be displayed between the cursor and the top or bottom of the editor pane. Incremental SearchConfigure the defaults for the Incremental Search function.
![]() Configuring Key BindingsMost Komodo functions can be assigned to custom key bindings. That is, you can invoke Komodo functions with default keyboard shortcuts, or configure your own preferred keyboard shortcuts. To configure custom key bindings, select Edit | Preferences | Editor | Key Bindings. Editor Configuration Scheme: You can create multiple key binding configurations, each with a unique name. Select the key binding to use in the current Komodo session from the drop down list. "Default Settings" will use the key bindings described in Key Bindings. Note that you cannot modify the default setting; if you try, you will be prompted to make a copy of the default before making changes. Select the command that you wish to configure from the list. Refer to Configuring Custom Key Bindings for instructions on changing function keys. ![]() Customizing IndentationFrom the Edit menu, select Preferences, then click Editor | Indentation.
Tab and indent widths are specified as follows:
Note - options set through the Preferences dialog are the default for all files opened in Komodo. You may also customize editing features for the current file; however, these file settings will not be saved after the current file is closed and re-opened. ![]() Smart EditingEnabling Background Syntax CheckingBackground syntax checking checks the validity of code as you type, and underlines syntax errors and warnings in the editor pane. See Background Syntax Checking for more information. The status of background syntax checking (enabled or disabled) is indicated by an icon on the bottom border of the Komodo workspace. To turn background syntax checking on or off:
Note - options set through the Preferences dialog are the default for all files opened in Komodo. You may also customize editing features for the current file; however, these file settings will not be saved after the current file is closed and re-opened. ![]() Enabling AutoCompleteAutoComplete presents a pop-up list of choices when it encounters functions, methods and properties for which there is a pre-defined set of options. For a complete description, see AutoComplete in the "Editing Files" section of the User Guide. To turn AutoComplete on or off:
Note - options set through the Preferences dialog are the default for all files opened in Komodo. You may also customize editing features for the current file; however, these file settings will not be saved after the current file is closed and re-opened. ![]() Enabling CallTipsCallTips present you with a reference list of the parameters or arguments for a given function or method. See CallTips in the Editing Files section of the Komodo User Guide for more information. To turn CallTips on or off:
Note - options set through the Preferences dialog are the default for all files opened in Komodo. You may also customize editing features for the current file; however, these file settings will not be saved after the current file is closed and re-opened. ![]() Configuring Word WrapWord wrapping is used to limit the horizontal display size of a line. To configure word wrap, from the Edit menu, select Preferences, then click Editor | Smart Editing. To enable word wrapping, check Word wrap long lines. To show the wrap line, and to highlight characters beyond the wrap column, check Show edge line / Highlight characters beyond edge line. Specify the wrap column in the Edge line column field. You may customize the color of the wrap column in the Fonts and Colors Preferences. Note - options set through the Preferences dialog are the default for all files opened in Komodo. You may also customize editing features for the current file; however, these file settings will not be saved after the current file is closed and re-opened. ![]() Configuring Edge LinesThe edge line is a vertical line that indicates a column marker.
![]() Configuring Auto-SaveAuto-Save is used to make an automatic back-up of your files as you work. Based on the number of minutes you specify, Komodo will make backup copies of the files open in the editor. When Komodo is shut down normally, the backup copies are deleted. However, if Komodo is shut down abnormally, such as through a system crash, the next time you use Komodo to open a file with a backup copy you will be asked if you want to restore the backup copy of the file. If you respond "Yes", the backup copy of the file, rather than the (older) disk copy, will be opened in the editor. To configure the number of minutes between auto-saves:
![]() Detect Changed FilesKomodo can be configured to monitor the status of files that are opened in the editor. If the file is changed on disk, you will be prompted to re-load the latest version under the following circumstances:
To enable or disable this detection, select Edit|Preferences, select Smart Editing, and check or un-check Detect when file is changed outside the environment. ![]() Customizing File AssociationsKomodo's file associations determine the editing features (such as autocomplete, colorization, etc) that are available when you edit files in Komodo. For a reference of language-based editor features, see Editor Features. To customize Komodo's file association, from the Edit menu, select Preferences|File Associations. You can configure custom file associations for use with Komodo. You can use the File Associations dialog to edit the language associated with a file pattern, to edit the file pattern associated with a language, to add a new file association, and to remove an association. To allow the characteristics of the file to determine the file association, check the box at the bottom of the dialog. Editing the Language Associated with a File PatternTo edit the language associated with a file pattern:
![]() Editing the File Pattern Associated with a LanguageTo edit the file pattern associated with a language:
![]() Adding a New File AssociationTo add a new file association:
![]() Removing a File AssociationTo remove a file association:
![]() Customizing File SettingsWhen you create a new file using the New button, Komodo, by default, opens a text file in the editor pane. Use the Preferences dialog to change the default file type, and the method by which line endings are indicated. Line Endings determine the embedded character that indicates the end of a line. To view end-of-line (EOL) markers, select Edit| Preferences|Editor and check "Show end-of-line characters". Standard end-of-line characters vary according to the operating system; select the desired end-of-line character from the drop-down list. If you open a file in the Komodo editor that has no line endings, Komodo will use the value specified in this preference for subsequent line endings. Otherwise, it will use the line ending already in use in the file. To set the type of file that opens when you open a new file:
File StatusFiles displayed in the Project Manager pane have small icons that indicate their file status (such as read-only status). To automatically update the file status icons, check Enable Automatic Update. Set the interval at which Komodo should check the file status in the field below. GUI BuilderWhen you use the GUI Builder to create graphical dialogs, you may choose from several supported languages. To set the default language, select it from the drop-down list. ![]() Customizing Fonts and ColorsKomodo's Fonts and Colors Preference is used to customize the display of text in the editor pane. To modify the font and color preferences, from the Edit menu, select Preferences, then click Fonts and Colors. On Linux, before specifying font and color preferences, select the desired encoding from the drop-down list. Fixed-width fonts are enabled by checking the Use Fixed Width as default box below, or by setting the "Prefer fixed width fonts" option in the Editor preferences. If these options are not set, proportional-width fonts will be used. Configure the display characteristics for fixed-width and / or proportional-width fonts as described below. Note that the default font characteristics will be over-ridden by any language-specific font configurations.
Use the Reset button to return the font and color preferences to the Komodo's original, default settings. Additional Color SettingsUse the Colors section of the Fonts and Colors preference page to configure the following options:
Language SettingsTo configure font and color preferences for language-specific terms, from the Edit menu, select Preferences, then click Fonts and Colors | Language Settings. Each language supported by Komodo has a unique set of keywords. To configure the font and color display for language keywords, select the desired language from the "Language" drop down list. Click the language keyword you want to configure, then set the preferences for the term's font, font size, bold and italic characteristics, and color. To reset the characteristics to their original value, click Reset. ![]() Customizing International EncodingsLanguage encodings provide support for files containing content in languages other than English. Encodings on LinuxOn Linux, by default, Komodo will use the encoding specified in the
environment. The following system variables are checked (in the order specified):
To configure encoding detection for existing files opened in Komodo:
To specify the encoding that will be used for new files:
Encodings on WindowsTo specify the encoding that will be used for new files:
To configure encoding detection for existing files:
![]() Language Help SettingsUse the Language Help page in the Komodo Preferences (Edit | Preferences | Language Help) to configure context-sensitive language look-up. Configuring Reference LocationKomodo will open a browser window and look up the address of the sites specified here. The site is selected according the the type of file currently active in the editor pane. (To configure file association, see File Associations.) On Windows systems, the "start" command invokes the default browser. Therefore, language reference URLs are prefaced by "start". The Alternate Help field is used to specify a help location that does not specifically apply to a language (or applies to a language not available in the above list). To reset any of the help settings to their original value, click Reset beside the pertinent field. Using Language HelpIn the editor pane, double-click to select the keyword that you want to look up. Then, press Shift+F1 to invoke a browser window and look up the keyword on the site configured in the Preferences. Press Ctrl+F1 to perform the lookup using the site configured in the Alternate Help field of the Preferences. ![]() Language ConfigurationCustomizing PerlUse the Preferences dialog to specify the Perl interpreter Komodo uses to debug and run Perl programs. From the Edit menu, select Preferences, then click Perl. You can select one of the Perl interpreters found on your system, or you may specify an alternate interpreter. If you do not specify an interpreter, Komodo will use the system's default interpreter. To specify a default Perl interpreter:
To specify a Perl interpreter that does not appear on the list:
![]() Customizing PHPUse the Preferences dialog to specify the PHP interpreter Komodo uses to debug and run PHP programs. You can also specify where Komodo can find the PHP.INI configuration file, used for local PHP debugging. From the Edit menu, select Preferences, then click PHP. You can select one of the PHP interpreters found on your system, or you may specify an alternate interpreter. If you do not specify an interpreter, Komodo will use the system's default interpreter. To specify a default PHP interpreter:
To specify a PHP interpreter that does not appear on the list:
To specify the folder containing the PHP INI configuration file:
Note - Ensure your php.ini configuration file is located in your operating system directory. If you used the PHP Windows installer, your php.ini file should be in the correct location. To verify, on Windows 2000/NT your php.ini file should be in \winnt; on Windows 98/Me your php.ini file should be in \windows. On Windows XP, the system directory will be either \winnt or \windows, depending on whether XP was a native installation or was an upgrade from a previous Windows version. ![]() Customizing PythonUse the Preferences dialog to specify the Python interpreter Komodo uses to debug and run Python programs. From the Edit menu, select Preferences, then click Python. You can select one of the Python interpreters found on your system, or you may specify an alternate interpreter. If you do not specify an interpreter, Komodo will use the system's default interpreter. To specify a default Python interpreter:
To specify a Python interpreter that does not appear on the list:
![]() Customizing TclKomodo provides the ability to interact with both the standard Tcl interpreter ("Tclsh") and the Tcl interpreter that supports the Tk widget library ("Wish"). Extended Tcl editing support and the Tcl debugging libraries are included with a subscription to ASPN Tcl. Use the Preferences dialog to specify the Tcl interpreters used by Komodo to debug and run Tcl programs. From the Edit menu, select Preferences, then click Tcl. Select one of the Tcl interpreters found on your system, or specify an alternate interpreter. To specify Wish and Tclsh interpreters:
To specify a Tclsh or Wish interpreter that does not appear on the list:
![]() Printing
![]() Configuring a ProxyThe Komodo Help system accesses content from the internet. If your system is behind a proxy, you must configure the proxy's IP address and port number in order to access this content.
![]() Configuring ServersUse the Servers pane to configure FTP servers and accounts for remote file access. To access the Servers pane, select Edit|Preferences|Servers. Note that you can also manually connect to a server when opening or saving remote files. For information about opening remote files, see Opening Remote Files. To add a new FTP server configuration:To add a new FTP configuration, click the Add button to the right of the Account Name field.
To alter an existing FTP server configuration:
To delete an existing FTP server configuration:
![]() Configuring Source Code ControlUsing Komodo's Source Code Control integration, you can perform the most common SCC repository tasks from within Komodo, including checking files out, comparing them to the repository version, and checking files back in. See Source Code Control for information about using SCC functions within Komodo. In order to use SCC integration, you must configure the following options: CVS IntegrationIf you are using CVS as your SCC repository, configure this section.
Perforce IntegrationIf you are using Perforce as your SCC repository, configure this section.
Diff Display StyleSelect whether the output from the diff command should be displayed in a separate window, or within the Komodo editor pane. ![]() Configuring Web Access and ASPN LoginTo configure the default web browser, or to delete your ASPN login information, select Edit | Preferences | Web. Web BrowserSpecify the browser that Komodo should launch when you invoke a web-based language query, or when you connect to ASPN to Share a Recipe. Select the desired browser from the list, or use the Browse button to navigate to the desired browser. ASPN Login InformationWhen you log in to ASPN in order to submit a recipe to one of the ASPN Cookbooks, you have the option of storing your ASPN user name and password. If you subsequently wish to remove the user name and password from Komodo, select Edit|Preferences|ASPN, and click Forget ASPN Login Information. If the button is not active, you have not stored your ASPN account information in Komodo. ![]() Configuring Web ServicesPerl Web Services ModuleSpecify the Perl package you wish to use for Web service support. WebService is an optional package that can be downloaded using ActivePerl's Package Manager. Soap::Lite is included in the ActivePerl distribution. Web Services Proxy ConfigurationWhen using Web services with Perl, you can create Web service "proxies" from the Web service WSDL. This causes the Web service to run more quickly. Specify whether Web service proxies should be created in the directory where the current active project is stored, or whether it should be created in the specified custom directory. Check Add to Current Project to automatically add the Web service proxy to the current active project. Web Services SetupThe Web Services Setup Wizard installs the required Web service modules for the selected language (Perl, Python, or PHP). To install Web service support modules, click the button labeled with the language of your choice.
After the modules are installed, a confirmation message and the setup log will be displayed in a dialog. Click Finish to exit. ![]() Editing the Current File SettingsTo customize options for individual files, select Current File Settings from the Edit menu, or right-click in the Editor pane and select Properties and Settings from the Context Menu. Settings TabThe options on this tab are a subset of the Editor Preferences. See Customizing the Editor for information about each option. Properties TabEncoding Preferences are described in Customizing International Encoding. Line Endings are described in Customizing File Settings. If you check Preserve existing line endings, new lines will be assigned the end-of-line character selected in the drop-down list, but existing lines will not be altered. Note: The Preserve existing line endings setting applies only to the current file and the current editor session, and will be abandoned when you close the file or close Komodo. To change these preferences permanently, use the Preferences dialog. ![]()
|