CKSource

Scripts Compression

The editor scripts source code can be found in the package at the "editor/_source/" directory. It is "human readable" as well as commented. There are a lot of files there, organized by groups.

To maximize loading and execution performance, the production distribution code in compressed to fewer and smaller files, as described in "Performance". These files are found at the "editor/js/" directory.

Using the "_source" files

It is possible to run the editor using the original scripts in the "_source" directory. It is useful when developing or debugging the editor. It is quite easy to do that.

Using a special URL parameter

The first way is the easiest on, but it depends on the integration files you are using. For now, only the JavaScript integration can do this.

Just add the "fcksource=true" parameter (QueryString) to the URL of the page where the editor is loaded.

Using the "original" file

There is also a definitive way to tell the editor to use the "_source" files.

Just go the "editor" directory and overwrite fckeditor.html with fckeditor.original.html (remember to backup the first one).

To restart using the "compressed" files again, just recover the backed-up "fckeditor.html" file.

Generating the compressed scripts

An application has been developed to make it easy to update the compressed file in the "js" directory with the changes you may do in the "_source" files. Since version 2.4 there's a new version created in PHP, named FCKpackager and available at:
http://svn.fckeditor.net/FCKpackager/trunk

Using FCKpackager

FCKpackager is a simple command line application. Here's a step by step instruction of how to use it:

1. Make the changes you want in the "_source" files.
2. Copy the FCKpackager executable or PHP file into the FCKeditor main directory.
3. Run the program "fckpackager.exe" or "php fckpackager.php".
   You will see that the application is running and adding the code from the "_source" files to the "js" files.

TIP: When working on Windows, if you simply run fckpackager.exe from Windows Explorer, the program will run in a command prompt window and close immediately. If you want to view the information about the compressing process statistics (number of file processed, original size, output file size) run the program from the command prompt manually (cmd.exe).