[NaCl SDK Docs] Remove table-of-contents from generated pages.

native_client_sdk/src/doc/_sphinxext/chromesite_builder.py

 # Copyright 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 #
 # This is a Sphinx extension.
 #
 
 from __future__ import print_function
 import codecs
@@ skipping 35 matching lines @@
       SmartyPantsHTMLTranslator to use its quote and dash-formatting
       capabilities. It's a subclass of the HTMLTranslator provided by docutils,
       with Sphinx-specific features added. Here we provide chromesite-specific
       behavior by overriding some of the visiting methods.
   """
   def __init__(self, builder, *args, **kwds):
     # HTMLTranslator is an old-style Python class, so 'super' doesn't work: use
     # direct parent invocation.
     HTMLTranslator.__init__(self, builder, *args, **kwds)
 
+    self.within_toc = False
+
   def visit_bullet_list(self, node):
     # Use our own class attribute for <ul>. Don't care about compacted lists.
     self.body.append(self.starttag(node, 'ul', **{'class': 'small-gap'}))
 
   def depart_bullet_list(self, node):
     # Override to not pop anything from context
     self.body.append('</ul>\n')
 
   def visit_literal(self, node):
     # Don't insert "smart" quotes here
@@ skipping 55 matching lines @@
       pass
     else:
       HTMLTranslator.visit_reference(self, node)
 
   def depart_reference(self, node):
     if self.builder.chromesite_kill_internal_links and node.get('internal'):
       pass
     else:
       HTMLTranslator.depart_reference(self, node)
 
+  def visit_topic(self, node):
+    if 'contents' in node['classes']:
+      # TODO(binji):
+      # Detect a TOC: we want to hide these from chromesite, but still keep
+      # them in devsite. An easy hack is to add display: none to the element
+      # here.
+      # When we remove devsite support, we can remove this hack.
+      self.within_toc = True
+      attrs = {'style': 'display: none'}
+      self.body.append(self.starttag(node, 'div', **attrs))
+    else:
+      HTMLTranslator.visit_topic(self, node)
+
+  def depart_topic(self, node):
+    if self.within_toc:
+      self.body.append('\n</div>')
+    else:
+      HTMLTranslator.visit_topic(self, node)
+
   def write_colspecs(self):
     # Override this method from docutils to do nothing. We don't need those
     # pesky <col width=NN /> tags in our markup.
     pass
 
   def visit_admonition(self, node, name=''):
     self.body.append(self.starttag(node, 'aside', CLASS=node.get('class', '')))
 
   def depart_admonition(self, node=''):
     self.body.append('\n</aside>\n')
@@ skipping 126 matching lines @@
   from sphinx.builders import linkcheck
   import urllib2
   linkcheck.HeadRequest = urllib2.Request
 
   app.add_directive('naclcode', NaclCodeDirective)
   app.add_builder(ChromesiteBuilder)
 
   # "Production mode" for local testing vs. on-server documentation.
   app.add_config_value('chromesite_kill_internal_links', default='0',
                        rebuild='html')