JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
vanilla ckeditor-3.5.3
[ckeditor.git] / _source / core / ckeditor_base.js
index 3a71283..419ee44 100644 (file)
@@ -9,10 +9,10 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
  */\r
 \r
 // #### Compressed Code\r
-// Must be updated on changes in the script, as well as updated in the\r
+// Must be updated on changes in the script as well as updated in the\r
 // ckeditor_source.js and ckeditor_basic_source.js files.\r
 \r
-// if(!window.CKEDITOR)window.CKEDITOR=(function(){var a={timestamp:'',version:'3.5.2',rev:'6450',_:{},status:'unloaded',basePath:(function(){var d=window.CKEDITOR_BASEPATH||'';if(!d){var e=document.getElementsByTagName('script');for(var f=0;f<e.length;f++){var g=e[f].src.match(/(^|.*[\\\/])ckeditor(?:_basic)?(?:_source)?.js(?:\?.*)?$/i);if(g){d=g[1];break;}}}if(d.indexOf(':/')==-1)if(d.indexOf('/')===0)d=location.href.match(/^.*?:\/\/[^\/]*/)[0]+d;else d=location.href.match(/^[^\?]*\/(?:)/)[0]+d;return d;})(),getUrl:function(d){if(d.indexOf(':/')==-1&&d.indexOf('/')!==0)d=this.basePath+d;if(this.timestamp&&d.charAt(d.length-1)!='/')d+=(d.indexOf('?')>=0?'&':'?')+('t=')+this.timestamp;return d;}},b=window.CKEDITOR_GETURL;if(b){var c=a.getUrl;a.getUrl=function(d){return b.call(a,d)||c.call(a,d);};}return a;})();\r
+// if(!window.CKEDITOR)window.CKEDITOR=(function(){var a={timestamp:'',version:'3.5.3',rev:'6655',_:{},status:'unloaded',basePath:(function(){var d=window.CKEDITOR_BASEPATH||'';if(!d){var e=document.getElementsByTagName('script');for(var f=0;f<e.length;f++){var g=e[f].src.match(/(^|.*[\\\/])ckeditor(?:_basic)?(?:_source)?.js(?:\?.*)?$/i);if(g){d=g[1];break;}}}if(d.indexOf(':/')==-1)if(d.indexOf('/')===0)d=location.href.match(/^.*?:\/\/[^\/]*/)[0]+d;else d=location.href.match(/^[^\?]*\/(?:)/)[0]+d;return d;})(),getUrl:function(d){if(d.indexOf(':/')==-1&&d.indexOf('/')!==0)d=this.basePath+d;if(this.timestamp&&d.charAt(d.length-1)!='/')d+=(d.indexOf('?')>=0?'&':'?')+('t=')+this.timestamp;return d;}},b=window.CKEDITOR_GETURL;if(b){var c=a.getUrl;a.getUrl=function(d){return b.call(a,d)||c.call(a,d);};}return a;})();\r
 \r
 // #### Raw code\r
 // ATTENTION: read the above "Compressed Code" notes when changing this code.\r
@@ -33,16 +33,16 @@ if ( !window.CKEDITOR )
                        /**\r
                         * A constant string unique for each release of CKEditor. Its value\r
                         * is used, by default, to build the URL for all resources loaded\r
-                        * by the editor code, guaranteing clean cache results when\r
+                        * by the editor code, guaranteeing clean cache results when\r
                         * upgrading.\r
                         * @type String\r
                         * @example\r
                         * alert( CKEDITOR.timestamp );  // e.g. '87dm'\r
                         */\r
                        // The production implementation contains a fixed timestamp, unique\r
-                       // for each release, generated by the releaser.\r
+                       // for each release and generated by the releaser.\r
                        // (Base 36 value of each component of YYMMDDHH - 4 chars total - e.g. 87bm == 08071122)\r
-                       timestamp : 'B1GG4Z6',\r
+                       timestamp : 'B37D54V',\r
 \r
                        /**\r
                         * Contains the CKEditor version number.\r
@@ -50,7 +50,7 @@ if ( !window.CKEDITOR )
                         * @example\r
                         * alert( CKEDITOR.version );  // e.g. 'CKEditor 3.4.1'\r
                         */\r
-                       version : '3.5.2',\r
+                       version : '3.5.3',\r
 \r
                        /**\r
                         * Contains the CKEditor revision number.\r
@@ -60,10 +60,10 @@ if ( !window.CKEDITOR )
                         * @example\r
                         * alert( CKEDITOR.revision );  // e.g. '3975'\r
                         */\r
-                       revision : '6450',\r
+                       revision : '6655',\r
 \r
                        /**\r
-                        * Private object used to hold core stuff. It should not be used out of\r
+                        * Private object used to hold core stuff. It should not be used outside of\r
                         * the API code as properties defined here may change at any time\r
                         * without notice.\r
                         * @private\r
@@ -71,7 +71,7 @@ if ( !window.CKEDITOR )
                        _ : {},\r
 \r
                        /**\r
-                        * Indicates the API loading status. The following status are available:\r
+                        * Indicates the API loading status. The following statuses are available:\r
                         *              <ul>\r
                         *                      <li><b>unloaded</b>: the API is not yet loaded.</li>\r
                         *                      <li><b>basic_loaded</b>: the basic API features are available.</li>\r
@@ -90,16 +90,16 @@ if ( !window.CKEDITOR )
 \r
                        /**\r
                         * Contains the full URL for the CKEditor installation directory.\r
-                        * It's possible to manually provide the base path by setting a\r
+                        * It is possible to manually provide the base path by setting a\r
                         * global variable named CKEDITOR_BASEPATH. This global variable\r
-                        * must be set "before" the editor script loading.\r
+                        * must be set <strong>before</strong> the editor script loading.\r
                         * @type String\r
                         * @example\r
                         * alert( <b>CKEDITOR.basePath</b> );  // "http://www.example.com/ckeditor/" (e.g.)\r
                         */\r
                        basePath : (function()\r
                        {\r
-                               // ATTENTION: fixes on this code must be ported to\r
+                               // ATTENTION: fixes to this code must be ported to\r
                                // var basePath in "core/loader.js".\r
 \r
                                // Find out the editor directory path, based on its <script> tag.\r
@@ -121,8 +121,8 @@ if ( !window.CKEDITOR )
                                        }\r
                                }\r
 \r
-                               // In IE (only) the script.src string is the raw valued entered in the\r
-                               // HTML. Other browsers return the full resolved URL instead.\r
+                               // In IE (only) the script.src string is the raw value entered in the\r
+                               // HTML source. Other browsers return the full resolved URL instead.\r
                                if ( path.indexOf(':/') == -1 )\r
                                {\r
                                        // Absolute path.\r
@@ -141,16 +141,16 @@ if ( !window.CKEDITOR )
 \r
                        /**\r
                         * Gets the full URL for CKEditor resources. By default, URLs\r
-                        * returned by this function contains a querystring parameter ("t")\r
+                        * returned by this function contain a querystring parameter ("t")\r
                         * set to the {@link CKEDITOR.timestamp} value.<br />\r
                         * <br />\r
-                        * It's possible to provide a custom implementation to this\r
+                        * It is possible to provide a custom implementation of this\r
                         * function by setting a global variable named CKEDITOR_GETURL.\r
-                        * This global variable must be set "before" the editor script\r
+                        * This global variable must be set <strong>before</strong> the editor script\r
                         * loading. If the custom implementation returns nothing (==null), the\r
                         * default implementation is used.\r
-                        * @param {String} resource The resource to which get the full URL.\r
-                        *              It may be a full, absolute or relative URL.\r
+                        * @param {String} resource The resource whose full URL we want to get.\r
+                        *              It may be a full, absolute, or relative URL.\r
                         * @returns {String} The full URL.\r
                         * @example\r
                         * // e.g. http://www.example.com/ckeditor/skins/default/editor.css?t=87dm\r
@@ -193,4 +193,26 @@ if ( !window.CKEDITOR )
        })();\r
 }\r
 \r
+/**\r
+ * Function called upon loading a custom configuration file that can\r
+ * modify the editor instance configuration ({@link CKEDITOR.editor#config }).\r
+ * It is usually defined inside the custom configuration files that can\r
+ * include developer defined settings.\r
+ * @name CKEDITOR.editorConfig\r
+ * @function\r
+ * @param {CKEDITOR.config} config A configuration object containing the\r
+ *             settings defined for a {@link CKEDITOR.editor} instance up to this\r
+ *             function call. Note that not all settings may still be available. See\r
+ *             <a href="http://docs.cksource.com/CKEditor_3.x/Developers_Guide/Setting_Configurations#Configuration_Loading_Order">Configuration Loading Order</a>\r
+ *             for details.\r
+ * @example\r
+ * // This is supposed to be placed in the config.js file.\r
+ * CKEDITOR.editorConfig = function( config )\r
+ * {\r
+ *     // Define changes to default configuration here. For example:\r
+ *     config.language = 'fr';\r
+ *     config.uiColor = '#AADC6E';\r
+ * };\r
+ */\r
+\r
 // PACKAGER_RENAME( CKEDITOR )\r