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. Confirmation DialogsKomodo can be configured to monitor the status of files that are changed or deleted outside its environment. If the file is changed on disk, Komodo can prompt you to reload the latest version. If a file is deleted on disk, Komodo can prompt you to close the file. To enable or disable this detection, select Edit|Preferences, select Editor, and check or un-check Detect when file is changed outside the environment. You can then choose options from the following drop-down lists:
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. You can also set the horizontal scroll bar width by entering the desired size in pixels. 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 Commands list box. Refer to Configuring Custom Key Bindings for instructions on changing function keys using the Current Key Sequence and New Key Sequence features. ![]() 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. ![]() 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. An icon on the bottom border of the Komodo workspace indicates the status of background syntax checking (enabled or disabled). 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. ![]() 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. ![]() 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. ![]() Configuring Word CompletionThe Komodo editor maintains an index of words in the current file. Instead of re-entering words that already exist in the current file, you can use the Complete Word function to finish words. By default, you invoke this feature from the keyboard by pressing Ctrl+Space. To configure Komodo to invoke word-completion with the Tab key, select the check box labeled Use tab character to complete words like Ctrl+Space. ![]() 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. Configuring Edge LinesThe edge line is a vertical line that indicates a column marker.
Note - options set through the Preferences dialog are the default for all files open in Komodo. You may also customize editing features for the current file. ![]() Save OptionsYou can set Komodo to automatically fix whitespace errors when saving files.
Auto-Save is used to make an automatic back-up of your files as you work. Based on the Minutes between auto-save that you specify, Komodo will make backup copies of the files opened 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:
You can also configure Komodo to prompt you if a filename has no extension. If you select Ask me what to do, Komodo will suggest a suitable file extension. You can also select Add appropriate extension to have Komodo automatically add an extension. Select Leave filename alone if you want Komodo to do nothing when you attempt to save a file without an extension. ![]() 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:
Allow file characteristics to override file association: Select this check box if you want the file characteristics declared within the file (e.g., an XML declaration or a shebang line) to take priority over the File Associations settings in Preferences. ![]() 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. The Sample Text window at the top of the Fonts and Colors page offers a preview of the current scheme. If multiple schemes are configured, you can select them from the Scheme drop-down list. To create a new scheme:
Schemes are added to the Scheme drop-down list. You can remove the selected scheme by clicking the Delete button. System schemes appear in bold and cannot be deleted. FontsThe Fonts tab is used to configure the display characteristics for fixed-width and/or proportional fonts. Note that the default font characteristics configured on this tab will be overridden by any language-specific font configurations. If you want to create a scheme that requires special encoding, select the type of encoding from the Encoding drop-down list. If you do not specify the encoding, Komodo will use your system's default encoding. The Fonts tab contains two identical sets of font controls, one for fixed-width fonts, and the other for proportional fonts. Select the Prefer Fixed or Prefer Prop. option button to set the desired font type and associated settings.
ColorsUse the Color Choice drop-down list on the Colors tab to configure general color properties for the Editor Pane. After selecting a Color Choice from the list, click the box to the right of the drop-down list to choose a color from the color palette, or click the small arrow button to select a color from the system color palette.
The Override Text Color in Selection check box activates the "Selection Text Color" setting described above. The Highlight Current Line check box activates the coloring specified in the "Current Line Background Color" setting described above. The Cursor Width drop-down list allows you set the cursor to a width of 1-4 pixels. Common Syntax ColoringSome language elements are common to a number of programming languages. The element colors specified on the Common Syntax Coloring tab will apply to all languages that use these elements. Select an element from the Element Type drop-down list and use controls described below to set the font characteristics. Note that the font characteristics configured on this tab will be overridden by any language-specific font configurations.
Language-Specific ColoringThe colors configured on the Language-Specific Coloring tab will apply to elements that appear in a specific language. Select a language from the Language drop-down list and an element from the Element Type drop-down list, then use the controls described below to set the font characteristics.
![]() 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. To have Komodo prompt you for a language each time you create a new dialog, select Ask each time. Komodo communicates with the GUI Builder using the port indicated in the TCP/IP Port used field. If you want to use that port for another application, you can reassign the port that Komodo uses. ![]() Customizing International EncodingsLanguage encodings provide support for files containing content in languages other than English. Note: On Linux, by default, Komodo will use the encoding specified in the
environment. The following system variables are checked (in the order specified):
Configuring Encoding for Existing FilesTo configure encoding detection for existing files opened in Komodo:
Configuring Encoding for New FilesOn Windows, the preference specified in the regional settings determines the type of characters that can be entered in Komodo. This preference makes it possible to specify non-English characters. On Windows 98, ME, and NT, Select "Regional Settings" from the Control Panel to change this setting. Select "Regional Options" on Windows 2000 and "Regional and Language Options" on Windows XP. On Linux, the default language is determined via the LANG environment variable. On Komodo, to specify the encoding that will be used for new files:
You can select from variety of Date & Time formats by clicking the arrow button to the right of the Format field and selecting an option from the drop-down menu. ![]() Language Help SettingsUse the Language Help page in Komodo Preferences (Edit|Preferences|Language Help) to configure context-sensitive language look-up. Configuring Reference LocationsThe Language Lookup Commands section of the Language Help page displays the default browser and URL used to get help for languages in Komodo. If you press Shift+F1, Komodo will open a browser window and look up the address of the sites specified here. The site is selected according to 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 General 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 General Help field on the Language Help page. ![]() Language ConfigurationTo configure the languages supported by Komodo, select Edit|Preferences|Languages, then click the button for the language that you want to configure. Alternatively, select Edit|Preferences and click the desired language in the Category list. Customizing 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. If PHP is not configured for debugging or if you have changed your primary php.ini file, you can configure or reconfigure PHP quickly and easily by clicking Debugger Configuration Wizard. The PHP Configuration Wizard will guide you through the entire configuration process.You can also customize PHP using the options available in PHP Preferences. Select one of the PHP interpreters found on your system, or 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:
![]() New FilesWhen you create a new file using the New button, Komodo, by default, opens a text file in the Editor Pane. Select from the drop-down lists on the New Files page in Preferences to determine 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. Standard EOL characters vary according to the operating system. To view end-of-line (EOL) markers, select Edit|Preferences|Editor and check Show end-of-line characters. To set the type of file that opens when you open a new file, and the method by which line endings are indicated:
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. The Komodo templates used to create new files (File|New|New File) support the same Interpolation Shortcuts codes as snippets and commands. Prior to Komodo Version 2.5, a set of variables could be used to embed the current date and time in files created from custom templates. The Interpolation Shortcuts are more powerful but are backward-incompatible. If you select the first check box under Templates in New File Preferences, Komodo will display a warning prompt whenever you attempt to create a new file using a template containing the old type of template code. Enter a number in the Number of recent templates to remember check box to specify how many recent filenames appear on the submenu that is displayed when you select File|New. ![]() Printing
![]() Projects and WorkspaceSet Workspace and Default Project Preferences to change the way Komodo manages the workspace and your projects, and to specify how files are imported to projects. WorkspaceFrom the When starting Komodo drop-down list, choose how Komodo manages the opening of the workspace. Select Ask me what to do to always display a prompt asking if you want to open recent files and projects. Or, Restore last workspace to display the workspace exactly as it was when you last quit Komodo. You can also choose to Open no files or projects. Opening and Closing ProjectsWhen opening a project, you can set Komodo to:
When closing a project, you set Komodo to:
File Information Updates in Project ManagerWhen the Update file status automatically option is selected, Komodo will periodically refresh the information displayed on the Projects tab. Set the interval at which Komodo should check the file status in the field below. Import From DiskYou can specify which file types to import to projects and how they are imported.
![]() 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 page to configure FTP servers and accounts for remote file access. To access the Servers page, 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, enter details in the fields provided and then 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. Select Edit|Preferences|Source Code Control to access the general source control preferences.
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.
![]() Configuring Web Browser FeaturesTo 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 use Komodo's Web Browser Preview. Select the desired browser from the list, or use the Browse button to navigate to the desired browser. If you do not specify any browser, Komodo will use your system's default browser. Web Browser PreviewChoose the method Komodo will use to preview code in the selected Web browser. You can display the browser preview in a separate window, or in the Komodo Editor Pane.
![]() 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. For generated Web services proxies, you can choose to Save to Current Project Directory, or Save to custom directory. If you select the custom directory option, you must then specify a 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. ![]() Windows IntegrationUse the Windows Integration preferences to set system-wide file associations. By assigning file associations, you can make Komodo the default editor for specific file types. Once Komodo has been made the default editor for a specific file type, the file will launch within Komodo when you double-click it in a Windows directory. You can also choose which file types can opened for edit. If a specific file type has been given an "Edit with Komodo" association, you can right-click a file in a Windows directory and open it using the Windows pop-up menu. To configure file associations:
![]() 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. The file you want to customize must be open in the Editor Pane before you can access Current File Settings. Properties TabIf a file is read/write, you can change its attribute by selecting the read-only check box. If a file is read-only, a small padlock icon will appear next to the filename on the Projects tab. If you change and save a file with read-only status, you will be given the option to "force save" the changes. The language association for the current file is displayed in the Language drop-down list box. To change the language setting, select another language from the drop-down list. To restore the original language association, click Reset. When saving changes to the file, you will be prompted with a message asking if you want to "Save As" or "Force Save." Click Save As to save the changes to a new file. Click Force Save to force changes to the file. Encoding Preferences are described in Customizing International Encoding. Line Endings are described in New Files. If you select 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. Source Code ControlIf Komodo is configured to work in conjunction with Perforce or CVS, the Source Code Control tab displays the current SCC status and settings. EditingThe options on this tab are a subset of the Editor Preferences. See Customizing the Editor for information about each option. IndentationThe options on this tab are also found in the Indentation settings section of Editor Preferences. See Customizing Indentation for information about each option. PreviewIn most cases, you will want the file currently open in the Editor Pane to be displayed when you use the Preview in Browser feature. However, it is sometimes useful to preview a file that includes the current file. For example, you may want to use an HTML file to preview a CSS file. The file or URL used when previewing the current file is displayed on the Preview tab. To preview with a different file or URL:
![]()
|