NAME
App::Codit - IDE for and in Perl
DESCRIPTION
Codit is a versatile text editor / integrated development environment aimed at the Perl programming language.
It is written in Perl/Tk and based on the Tk::AppWindow application framework.
It uses the Tk::CodeText text widget for editing.
Codit has been under development for about one year now. And even though it is considered alpha software, it already has gone quite some miles on our systems.
It features a multi document interface that can hold an unlimited number of documents, navigable through the tab bar at the top and a document list in the left side panel.
It has a plugin system designed to invite users to write their own plugins.
It is fully configurable through a configuration window, allowing you to set defaults for editing, the graphical user interface, syntax highlighting and (un)loading plugins.
Tk::CodeText offers syntax highlighting and code folding in plenty formats and languages. It has and advanced word based undo/redo stack that keeps track of selections and save points. It does auto indent, comment, uncomment, indent and unindent. Tab size and indent style are fully user configurable.
RUNNING CODIT
You can launch Codit from the command line as follows:
codit [options] [files]The following command line options are available:
- -c or -config
-
Specifies the configfolder to use. If the path does not exist it will be created.
- -h or -help
-
Displays a help message on the command line and exits.
- -i or -iconpath
-
Point to the folders where your icon libraries are located.*
- -t or -icontheme
-
Icon theme to load.
- -P or -noplugins
-
Launch without any plugins loaded. This supersedes the -plugins option.
- -p or -plugins
-
Launch with only these plugins .*
- -s or -session
-
Loads a session at launch. The plugin Sessions must be loaded for this to work.
- -y or -syntax
-
Specify the default syntax to use for syntax highlighting. Codit will determine the syntax of documents by their extension. This options comes in handy when the file you are loading does not have an extension.
- -v or -version
-
Displays the version number on the command line and exits.
* You can specify a list of items by separating them with a ':'.
TROUBLESHOOTING
Just hoping you never need this.
General troubleshooting
If you encounter problems and error messages using Codit here are some general troubleshooting steps:
- Use the -config command line option to point to a new, preferably fresh settingsfolder.
- Use the -noplugins command line option to launch Codit without any plugins loaded.
- Use the -plugins command line option to launch Codit with only the plugins loaded you specify here.
No icons
If Codit launches without any icons do one or more of the following:
- Check if your icon theme is based on scalable vectors. Install Icons::LibRSVG if so. See also the Readme.md that comes with this distribution.
- Locate where your icons are located on your system and use the -iconpath command line option to point there.
- Select an icon library by using the -icontheme command line option.
Session will not load
Sometimes it happens that a session file gets corrupted. You solve it like this:
- Launch the session manager. Menu->Session->Manage sessions.
- Remove the affected session.
- Rebuild it from scratch.
Sorry, that is all we have to offer.
Report a bug
If all fails you are welcome to open a ticket here: https://github.com/haje61/App-Codit/issues.
LICENSE
Same as Perl.
AUTHOR
Hans Jeuken (hanje at cpan dot org)
TODO
BUGS AND CAVEATS
If you find any bugs, please contact the author.