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 opened in the editor. If the file is changed on disk, you will be prompted to reload the latest version under the following circumstances:
To enable or disable this detection, select Edit|Preferences, select Editor, and check or un-check Detect when file is changed outside the environment. If this first check box is selected, you also have the option of selecting additional check boxes to specify whether Komodo will Automatically reload changed files and Automatically reload changed projects. 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. ![]() 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. 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. ![]() 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 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 opened 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 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:
![]() 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 File SettingsNew FileWhen 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 File Settings pane 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. To view end-of-line (EOL) markers, select Edit| Preferences|Editor and check Show end-of-line characters. Standard EOL characters vary according to the operating system; select the desired EOL character from the drop-down list. 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. Update File Information in Project ManagerFiles displayed in the Projects 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. 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 Fonts drop-down list. Configure the display characteristics for fixed-width and / or proportional-width fonts as described below. Note that the default font characteristics will be overridden by any language-specific font configurations.
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. Use the Reset button to return the font and color preferences to 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 in the Select as element to change list box,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. ![]() 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):
To configure encoding detection for existing files opened in 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 the Komodo Preferences (Edit|Preferences|Language Help) to configure context-sensitive language look-up. Configuring Reference LocationThe Language Lookup Commands section of the Language Help pane 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 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 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:
![]() 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:
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 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, 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 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. If you do not specify any browser, Komodo will use your system's default 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 available, 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. 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:
![]() 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. The file you want to customize must be open in the Editor Pane before you can access Current File Settings. Properties TabThe 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. If 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 in the Projects Pane. If you change and save a file with read-only status, you will be given the option to "force save" the changes. 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 Customizing File Settings. 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. GeneralThe 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. Smart EditingThe options on this tab are a subset of the Smart Editing Preferences. See Smart Editing for information about each option. ![]()
|