Creating an entry point for notebook manager extensions

- Firing app_initialized.DashboardApp event when loaded the notebook manager
- Updating tree.html template to load nbextensions through custom.js

IPython/html/static/custom/custom.js

@@ -1,49 +1,58 b''
 // leave at least 2 line with only a star on it below, or doc generation fails
 /**
  *
  *
  * Placeholder for custom user javascript
  * mainly to be overridden in profile/static/custom/custom.js
  * This will always be an empty file in IPython
  *
  * User could add any javascript in the `profile/static/custom/custom.js` file
  * (and should create it if it does not exist).
  * It will be executed by the ipython notebook at load time.
  *
  * Same thing with `profile/static/custom/custom.css` to inject custom css into the notebook.
  *
- * Example :
+ * __Example 1:__
  *
  * Create a custom button in toolbar that execute `%qtconsole` in kernel
  * and hence open a qtconsole attached to the same kernel as the current notebook
  *
  *    $([IPython.events]).on('app_initialized.NotebookApp', function(){
  *        IPython.toolbar.add_buttons_group([
  *            {
  *                 'label'   : 'run qtconsole',
  *                 'icon'    : 'icon-terminal', // select your icon from http://fortawesome.github.io/Font-Awesome/icons
  *                 'callback': function () {
  *                     IPython.notebook.kernel.execute('%qtconsole')
  *                 }
  *            }
  *            // add more button here if needed.
  *            ]);
  *    });
  *
- * Example :
+ * __Example 2:__
+ *
+ * At the completion of the dashboard loading, load an unofficial javascript extension
+ * that is installed in profile/static/custom/ 
+ *
+ *    $([IPython.events]).on('app_initialized.DashboardApp', function(){
+ *        require(['custom/unofficial_extension.js'])
+ *    });
+ *
+ * __Example 3:__
  *
  *  Use `jQuery.getScript(url [, success(script, textStatus, jqXHR)] );`
  *  to load custom script into the notebook.
  *
  *    // to load the metadata ui extension example.
  *    $.getScript('/static/notebook/js/celltoolbarpresets/example.js');
  *    // or
  *    // to load the metadata ui extension to control slideshow mode / reveal js for nbconvert
  *    $.getScript('/static/notebook/js/celltoolbarpresets/slideshow.js');
  *
  *
  * @module IPython
  * @namespace IPython
  * @class customjs
  * @static
  */

IPython/html/static/tree/js/main.js

@@ -1,91 +1,92 b''
 //----------------------------------------------------------------------------
 //  Copyright (C) 2008-2011  The IPython Development Team
 //
 //  Distributed under the terms of the BSD License.  The full license is in
 //  the file COPYING, distributed as part of this software.
 //----------------------------------------------------------------------------
 
 //============================================================================
 // On document ready
 //============================================================================
 
 
 $(document).ready(function () {
 
     IPython.page = new IPython.Page();
 
     $('#new_notebook').button().click(function (e) {
         IPython.notebook_list.new_notebook()
     });
     
     var opts = {
         base_url : IPython.utils.get_body_data("baseUrl"),
         notebook_path : IPython.utils.get_body_data("notebookPath"),
     };
     IPython.session_list = new IPython.SesssionList(opts);
     IPython.notebook_list = new IPython.NotebookList('#notebook_list', opts);
     IPython.cluster_list = new IPython.ClusterList('#cluster_list', opts);
     IPython.kernel_list = new IPython.KernelList('#running_list', opts);
     IPython.login_widget = new IPython.LoginWidget('#login_widget', opts);
 
     var interval_id=0;
     // auto refresh every xx secondes, no need to be fast,
     //  update is done at least when page get focus
     var time_refresh = 60; // in sec
 
     var enable_autorefresh = function(){
         //refresh immediately , then start interval
         if($('.upload_button').length == 0)
         {
             IPython.session_list.load_sessions();
             IPython.cluster_list.load_list();
         }
         if (!interval_id){
             interval_id = setInterval(function(){
                     if($('.upload_button').length == 0)
                     {
                         IPython.session_list.load_sessions();
                         IPython.cluster_list.load_list();
                     }
                 }, time_refresh*1000);
             }
     }
 
     var disable_autorefresh = function(){
         clearInterval(interval_id);
         interval_id = 0;
     }
 
     // stop autorefresh when page lose focus
     $(window).blur(function() {
         disable_autorefresh();
     })
 
     //re-enable when page get focus back
     $(window).focus(function() {
         enable_autorefresh();
     });
 
     // finally start it, it will refresh immediately
     enable_autorefresh();
 
     IPython.page.show();
-    
+    $([IPython.events]).trigger('app_initialized.DashboardApp');
+
     // bound the upload method to the on change of the file select list
     $("#alternate_upload").change(function (event){
         IPython.notebook_list.handleFilesUpload(event,'form');
     });
     
     // set hash on tab click
     $("#tabs").find("a").click(function() {
         window.location.hash = $(this).attr("href");
     })
     
     // load tab if url hash
     if (window.location.hash) {
         $("#tabs").find("a[href=" + window.location.hash + "]").click();
     }
 
 
 });