New optional feature to skip the first header of a notebook in the TOC

Author: louisabraham

src/jupyter_contrib_nbextensions/nbextensions/toc2/README.md

@@ -29,6 +29,7 @@ The initial configuration can be given using the IPython-contrib nbextensions fa
 - Widening the display area to fit the browser window (may be useful with sidebar option; default: true)    
 - The numbering of headers (true by default)
 - Moving header title and menus on the left (default: true)
+- Skipping the first header (useful if you want to display a title): set `skipTitle` to true in the notebook's metadata (default: false)
 - Customization of highlighting the title of currently selected/running sections.  
 - Customization of background, fonts, border and highlighting colors in the toc window and navigation menus (as third demo).
 

src/jupyter_contrib_nbextensions/nbextensions/toc2/main.js

@@ -32,7 +32,8 @@ define(["require", "jquery", "base/js/namespace",  'services/config',
                 'sidebar_border': '#EEEEEE',
                 'navigate_text': '#333333',
                 'navigate_num': '#000000',
-              }
+              },
+              'skipTitle': false
 }
 
 //.....................global variables....

src/jupyter_contrib_nbextensions/nbextensions/toc2/toc2.js

@@ -541,6 +541,8 @@ var table_of_contents = function (cfg,st) {
     //loop over all headers
     all_headers.each(function (i, h) {
       var level = parseInt(h.tagName.slice(1), 10) - min_lvl + 1;
+      // skip title if necessary
+      if (cfg.skipTitle &&!i){ return; }
       // skip below threshold
       if (level > cfg.threshold){ return; }
       // skip headings with no ID to link to