We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Revise the documentation TOC subsection handling
<!-- ⚠️ If you do not respect this template, your issue will be closed -->
<!-- ⚠️ Make sure to browse the opened and closed issues to confirm this idea does not exist. -->

### What is the expected enhancement?

An issue raised during #1254:

> Also Is it possible in the template to show the subsection when that section is viewed.

The new fancy design currently does not show subsections in the left-side TOC pane (except for the autodocs). Ideally it should show the subsections, allowing collapsing with sensible defaults and usability.


--- END ISSUE ---

Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
--- BEGIN FILES ---
Path: `doc/conf.py`
Content:
```
1 #!/usr/bin/env python3
2 # -*- coding: utf-8 -*-
3 #
4 # Qiskit documentation build configuration file, created by
5 # sphinx-quickstart on Tue Jul 25 18:13:28 2017.
6 #
7 # This file is execfile()d with the current directory set to its
8 # containing dir.
9 #
10 # Note that not all possible configuration values are present in this
11 # autogenerated file.
12 #
13 # All configuration values have a default; values that are commented out
14 # serve to show the default.
15 
16 # If extensions (or modules to document with autodoc) are in another directory,
17 # add these directories to sys.path here. If the directory is relative to the
18 # documentation root, use os.path.abspath to make it absolute, like shown here.
19 #
20 import os
21 import sys
22 from qiskit import __version__
23 sys.path.insert(0, os.path.abspath('.'))
24 
25 # Imported manually, as otherwise it will not be fully imported.
26 import qiskit.extensions.simulator
27 
28 # -- General configuration ------------------------------------------------
29 
30 # If your documentation needs a minimal Sphinx version, state it here.
31 #
32 # needs_sphinx = '1.0'
33 
34 # Add any Sphinx extension module names here, as strings. They can be
35 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
36 # ones.
37 extensions = ['sphinx.ext.autodoc',
38               'sphinx.ext.autosummary',
39               'sphinx.ext.napoleon',
40               'sphinx.ext.doctest',
41               'sphinx.ext.coverage',
42               'sphinx.ext.mathjax',
43               'sphinx.ext.viewcode',
44               'sphinx.ext.githubpages']
45 # Napoleon settings
46 napoleon_google_docstring = True
47 napoleon_numpy_docstring = False
48 napoleon_include_init_with_doc = True
49 napoleon_include_private_with_doc = False
50 napoleon_include_special_with_doc = False
51 napoleon_use_admonition_for_examples = False
52 napoleon_use_admonition_for_notes = False
53 napoleon_use_admonition_for_references = False
54 napoleon_use_ivar = False
55 napoleon_use_param = True
56 napoleon_use_rtype = True
57 
58 autoclass_content = 'both'
59 
60 # Add any paths that contain templates here, relative to this directory.
61 templates_path = ['_templates']
62 
63 # The suffix(es) of source filenames.
64 # You can specify multiple suffix as a list of string:
65 #
66 # source_suffix = ['.rst', '.md']
67 source_suffix = '.rst'
68 
69 # The master toctree document.
70 master_doc = 'index'
71 
72 # General information about the project.
73 project = 'Qiskit Terra'
74 copyright = '2017-2018 IBM'
75 author = 'IBM'
76 
77 # Add description
78 html_context = {
79     'description': 'Qiskit Terra'
80 }
81 
82 # The version info for the project you're documenting, acts as replacement for
83 # |version| and |release|, also used in various other places throughout the
84 # built documents.
85 #
86 # The short X.Y version.
87 version = __version__
88 # The full version, including alpha/beta/rc tags.
89 release = version
90 
91 # The language for content autogenerated by Sphinx. Refer to documentation
92 # for a list of supported languages.
93 #
94 # This is also used if you do content translation via gettext catalogs.
95 # Usually you set "language" from the command line for these cases.
96 language = None
97 
98 # List of patterns, relative to source directory, that match files and
99 # directories to ignore when looking for source files.
100 # This patterns also effect to html_static_path and html_extra_path
101 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store',
102                     '_autodoc/modules.rst', 'de', 'ja']
103 
104 # The name of the Pygments (syntax highlighting) style to use.
105 pygments_style = 'sphinx'
106 
107 # If true, `todo` and `todoList` produce output, else they produce nothing.
108 todo_include_todos = False
109 
110 
111 # -- Options for HTML output ----------------------------------------------
112 
113 # The theme to use for HTML and HTML Help pages.  See the documentation for
114 # a list of builtin themes.
115 #
116 # html_theme = 'alabaster'
117 # html_theme = 'bizstyle'
118 # html_theme = agogo
119 
120 html_theme = 'sphinx_materialdesign_theme' # use the theme in subdir 'theme'
121 html_theme_path = ['./']  # make sphinx search for themes in current dir
122 
123 
124 # Theme options are theme-specific and customize the look and feel of a theme
125 # further.  For a list of options available for each theme, see the
126 # documentation.
127 #
128 html_theme_options = {
129     # Specify a list of menu in Header.
130     # Tuples forms:
131     #  ('Name', 'external url or path of pages in the document', boolean, 'icon name')
132     #
133     # Third argument:
134     # True indicates an external link.
135     # False indicates path of pages in the document.
136     #
137     # Fourth argument:
138     # Specify the icon name.
139     # For details see link.
140     # https://material.io/icons/
141     'header_links' : [
142         ('Home', 'index', False, 'home'),
143         ("ExternalLink", "http://example.com", True, 'launch'),
144         ("NoIconLink", "http://example.com", True, ''),
145         ("GitHub", "https://github.com/myyasuda/sphinx_materialdesign_theme", True, 'link')
146     ],
147 
148     # Customize css colors.
149     # For details see link.
150     # https://getmdl.io/customize/index.html
151     #
152     # Values: amber, blue, brown, cyan deep_orange, deep_purple, green, grey, indigo, light_blue,
153     #         light_green, lime, orange, pink, purple, red, teal, yellow(Default: indigo)
154     'primary_color': 'blue',
155     # Values: Same as primary_color. (Default: pink)
156     'accent_color': 'indigo',
157 
158     # Customize layout.
159     # For details see link.
160     # https://getmdl.io/components/index.html#layout-section
161     'fixed_drawer': True,
162     'fixed_header': False,
163     'header_waterfall': True,
164     'header_scroll': False,
165 
166     # Render title in header.
167     # Values: True, False (Default: False)
168     'show_header_title': False,
169     # Render title in drawer.
170     # Values: True, False (Default: True)
171     'show_drawer_title': True,
172     # Render footer.
173 }
174 # Add any paths that contain custom static files (such as style sheets) here,
175 # relative to this directory. They are copied after the builtin static files,
176 # so a file named "default.css" will overwrite the builtin "default.css".
177 html_static_path = ['./theme/static/']
178 
179 # The name of an image file (relative to this directory) to place at the top
180 # of the sidebar.
181 html_logo = 'theme/static/qiskit-terra-logo.png'
182 
183 html_favicon = 'theme/static/favicon.ico'
184 
185 html_last_updated_fmt = '%Y/%m/%d'
186 
187 # -- Options for HTMLHelp output ------------------------------------------
188 
189 # Output file base name for HTML help builder.
190 htmlhelp_basename = 'Qiskitdoc'
191 
192 
193 # -- Options for LaTeX output ---------------------------------------------
194 
195 latex_elements = {
196     # The paper size ('letterpaper' or 'a4paper').
197     #
198     # 'papersize': 'letterpaper',
199 
200     # The font size ('10pt', '11pt' or '12pt').
201     #
202     # 'pointsize': '10pt',
203 
204     # Additional stuff for the LaTeX preamble.
205     #
206     # 'preamble': '',
207 
208     # Latex figure (float) alignment
209     #
210     # 'figure_align': 'htbp',
211 }
212 
213 # Grouping the document tree into LaTeX files. List of tuples
214 # (source start file, target name, title,
215 #  author, documentclass [howto, manual, or own class]).
216 latex_documents = [
217     (master_doc, 'Qiskit.tex', 'Qiskit Documentation',
218      '''Jim Challenger, Andrew Cross, Ismael Faro, Jay Gambetta''', 'manual'),
219 ]
220 
221 
222 # -- Options for manual page output ---------------------------------------
223 
224 # One entry per manual page. List of tuples
225 # (source start file, name, description, authors, manual section).
226 man_pages = [
227     (master_doc, 'qiskit', 'Qiskit Documentation',
228      [author], 1)
229 ]
230 
231 
232 # -- Options for Texinfo output -------------------------------------------
233 
234 # Grouping the document tree into Texinfo files. List of tuples
235 # (source start file, target name, title, author,
236 #  dir menu entry, description, category)
237 texinfo_documents = [
238     (master_doc, 'Qiskit Terra', 'Qiskit Terra Documentation',
239      author, 'Qiskit', 'One line description of project.',
240      'Miscellaneous'),
241 ]
242 
243 
244 # Avoid a warning and treat the docstrings of the QasmLexer tokens as verbatim,
245 # as PLY uses docstring as a way to define the patterns the token matches.
246 def remove_module_docstring(app, what, name, obj, options, lines):
247     if name.startswith('qiskit.qasm._qasmlexer.QasmLexer.t_') and lines:
248         lines[0] = u'Token matching: ``%s``' % lines[0]
249 
250 
251 def setup(app):
252     app.connect('autodoc-process-docstring', remove_module_docstring)
253
```
--- END FILES ---

Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.

Here is an example:

```diff
diff --git a/examples/server_async.py b/examples/server_async.py
--- a/examples/server_async.py
+++ b/examples/server_async.py
@@ -313,4 +313,4 @@
 
 
 if __name__ == "__main__":
-    asyncio.run(run_async_server("."), debug=True)
+    asyncio.run(run_async_server(), debug=True)
diff --git a/examples/server_sync.py b/examples/server_sync.py
--- a/examples/server_sync.py
+++ b/examples/server_sync.py
@@ -313,5 +313,5 @@
 
 
 if __name__ == "__main__":
-    server = run_sync_server(".")
+    server = run_sync_server()
     server.shutdown()

```

diff --git a/doc/conf.py b/doc/conf.py
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -117,6 +117,11 @@
 # html_theme = 'bizstyle'
 # html_theme = agogo
 
+html_sidebars = {
+   '**': ['globaltoc.html']
+}
+
+
 html_theme = 'sphinx_materialdesign_theme' # use the theme in subdir 'theme'
 html_theme_path = ['./']  # make sphinx search for themes in current dir

{"golden_diff": "diff --git a/doc/conf.py b/doc/conf.py\n--- a/doc/conf.py\n+++ b/doc/conf.py\n@@ -117,6 +117,11 @@\n # html_theme = 'bizstyle'\n # html_theme = agogo\n \n+html_sidebars = {\n+   '**': ['globaltoc.html']\n+}\n+\n+\n html_theme = 'sphinx_materialdesign_theme' # use the theme in subdir 'theme'\n html_theme_path = ['./']  # make sphinx search for themes in current dir\n", "issue": "Revise the documentation TOC subsection handling\n<!-- \u26a0\ufe0f If you do not respect this template, your issue will be closed -->\r\n<!-- \u26a0\ufe0f Make sure to browse the opened and closed issues to confirm this idea does not exist. -->\r\n\r\n### What is the expected enhancement?\r\n\r\nAn issue raised during #1254:\r\n\r\n> Also Is it possible in the template to show the subsection when that section is viewed.\r\n\r\nThe new fancy design currently does not show subsections in the left-side TOC pane (except for the autodocs). Ideally it should show the subsections, allowing collapsing with sensible defaults and usability.\r\n\n", "before_files": [{"content": "#!/usr/bin/env python3\n# -*- coding: utf-8 -*-\n#\n# Qiskit documentation build configuration file, created by\n# sphinx-quickstart on Tue Jul 25 18:13:28 2017.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport os\nimport sys\nfrom qiskit import __version__\nsys.path.insert(0, os.path.abspath('.'))\n\n# Imported manually, as otherwise it will not be fully imported.\nimport qiskit.extensions.simulator\n\n# -- General configuration ------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#\n# needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = ['sphinx.ext.autodoc',\n              'sphinx.ext.autosummary',\n              'sphinx.ext.napoleon',\n              'sphinx.ext.doctest',\n              'sphinx.ext.coverage',\n              'sphinx.ext.mathjax',\n              'sphinx.ext.viewcode',\n              'sphinx.ext.githubpages']\n# Napoleon settings\nnapoleon_google_docstring = True\nnapoleon_numpy_docstring = False\nnapoleon_include_init_with_doc = True\nnapoleon_include_private_with_doc = False\nnapoleon_include_special_with_doc = False\nnapoleon_use_admonition_for_examples = False\nnapoleon_use_admonition_for_notes = False\nnapoleon_use_admonition_for_references = False\nnapoleon_use_ivar = False\nnapoleon_use_param = True\nnapoleon_use_rtype = True\n\nautoclass_content = 'both'\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = ['_templates']\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\n# source_suffix = ['.rst', '.md']\nsource_suffix = '.rst'\n\n# The master toctree document.\nmaster_doc = 'index'\n\n# General information about the project.\nproject = 'Qiskit Terra'\ncopyright = '2017-2018 IBM'\nauthor = 'IBM'\n\n# Add description\nhtml_context = {\n    'description': 'Qiskit Terra'\n}\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = __version__\n# The full version, including alpha/beta/rc tags.\nrelease = version\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = None\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store',\n                    '_autodoc/modules.rst', 'de', 'ja']\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = 'sphinx'\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = False\n\n\n# -- Options for HTML output ----------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\n# html_theme = 'alabaster'\n# html_theme = 'bizstyle'\n# html_theme = agogo\n\nhtml_theme = 'sphinx_materialdesign_theme' # use the theme in subdir 'theme'\nhtml_theme_path = ['./']  # make sphinx search for themes in current dir\n\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\nhtml_theme_options = {\n    # Specify a list of menu in Header.\n    # Tuples forms:\n    #  ('Name', 'external url or path of pages in the document', boolean, 'icon name')\n    #\n    # Third argument:\n    # True indicates an external link.\n    # False indicates path of pages in the document.\n    #\n    # Fourth argument:\n    # Specify the icon name.\n    # For details see link.\n    # https://material.io/icons/\n    'header_links' : [\n        ('Home', 'index', False, 'home'),\n        (\"ExternalLink\", \"http://example.com\", True, 'launch'),\n        (\"NoIconLink\", \"http://example.com\", True, ''),\n        (\"GitHub\", \"https://github.com/myyasuda/sphinx_materialdesign_theme\", True, 'link')\n    ],\n\n    # Customize css colors.\n    # For details see link.\n    # https://getmdl.io/customize/index.html\n    #\n    # Values: amber, blue, brown, cyan deep_orange, deep_purple, green, grey, indigo, light_blue,\n    #         light_green, lime, orange, pink, purple, red, teal, yellow(Default: indigo)\n    'primary_color': 'blue',\n    # Values: Same as primary_color. (Default: pink)\n    'accent_color': 'indigo',\n\n    # Customize layout.\n    # For details see link.\n    # https://getmdl.io/components/index.html#layout-section\n    'fixed_drawer': True,\n    'fixed_header': False,\n    'header_waterfall': True,\n    'header_scroll': False,\n\n    # Render title in header.\n    # Values: True, False (Default: False)\n    'show_header_title': False,\n    # Render title in drawer.\n    # Values: True, False (Default: True)\n    'show_drawer_title': True,\n    # Render footer.\n}\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = ['./theme/static/']\n\n# The name of an image file (relative to this directory) to place at the top\n# of the sidebar.\nhtml_logo = 'theme/static/qiskit-terra-logo.png'\n\nhtml_favicon = 'theme/static/favicon.ico'\n\nhtml_last_updated_fmt = '%Y/%m/%d'\n\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = 'Qiskitdoc'\n\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    #\n    # 'papersize': 'letterpaper',\n\n    # The font size ('10pt', '11pt' or '12pt').\n    #\n    # 'pointsize': '10pt',\n\n    # Additional stuff for the LaTeX preamble.\n    #\n    # 'preamble': '',\n\n    # Latex figure (float) alignment\n    #\n    # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n    (master_doc, 'Qiskit.tex', 'Qiskit Documentation',\n     '''Jim Challenger, Andrew Cross, Ismael Faro, Jay Gambetta''', 'manual'),\n]\n\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [\n    (master_doc, 'qiskit', 'Qiskit Documentation',\n     [author], 1)\n]\n\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [\n    (master_doc, 'Qiskit Terra', 'Qiskit Terra Documentation',\n     author, 'Qiskit', 'One line description of project.',\n     'Miscellaneous'),\n]\n\n\n# Avoid a warning and treat the docstrings of the QasmLexer tokens as verbatim,\n# as PLY uses docstring as a way to define the patterns the token matches.\ndef remove_module_docstring(app, what, name, obj, options, lines):\n    if name.startswith('qiskit.qasm._qasmlexer.QasmLexer.t_') and lines:\n        lines[0] = u'Token matching: ``%s``' % lines[0]\n\n\ndef setup(app):\n    app.connect('autodoc-process-docstring', remove_module_docstring)\n", "path": "doc/conf.py"}], "after_files": [{"content": "#!/usr/bin/env python3\n# -*- coding: utf-8 -*-\n#\n# Qiskit documentation build configuration file, created by\n# sphinx-quickstart on Tue Jul 25 18:13:28 2017.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport os\nimport sys\nfrom qiskit import __version__\nsys.path.insert(0, os.path.abspath('.'))\n\n# Imported manually, as otherwise it will not be fully imported.\nimport qiskit.extensions.simulator\n\n# -- General configuration ------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#\n# needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = ['sphinx.ext.autodoc',\n              'sphinx.ext.autosummary',\n              'sphinx.ext.napoleon',\n              'sphinx.ext.doctest',\n              'sphinx.ext.coverage',\n              'sphinx.ext.mathjax',\n              'sphinx.ext.viewcode',\n              'sphinx.ext.githubpages']\n# Napoleon settings\nnapoleon_google_docstring = True\nnapoleon_numpy_docstring = False\nnapoleon_include_init_with_doc = True\nnapoleon_include_private_with_doc = False\nnapoleon_include_special_with_doc = False\nnapoleon_use_admonition_for_examples = False\nnapoleon_use_admonition_for_notes = False\nnapoleon_use_admonition_for_references = False\nnapoleon_use_ivar = False\nnapoleon_use_param = True\nnapoleon_use_rtype = True\n\nautoclass_content = 'both'\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = ['_templates']\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\n# source_suffix = ['.rst', '.md']\nsource_suffix = '.rst'\n\n# The master toctree document.\nmaster_doc = 'index'\n\n# General information about the project.\nproject = 'Qiskit Terra'\ncopyright = '2017-2018 IBM'\nauthor = 'IBM'\n\n# Add description\nhtml_context = {\n    'description': 'Qiskit Terra'\n}\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The short X.Y version.\nversion = __version__\n# The full version, including alpha/beta/rc tags.\nrelease = version\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = None\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store',\n                    '_autodoc/modules.rst', 'de', 'ja']\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = 'sphinx'\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = False\n\n\n# -- Options for HTML output ----------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n#\n# html_theme = 'alabaster'\n# html_theme = 'bizstyle'\n# html_theme = agogo\n\nhtml_sidebars = {\n   '**': ['globaltoc.html']\n}\n\n\nhtml_theme = 'sphinx_materialdesign_theme' # use the theme in subdir 'theme'\nhtml_theme_path = ['./']  # make sphinx search for themes in current dir\n\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\nhtml_theme_options = {\n    # Specify a list of menu in Header.\n    # Tuples forms:\n    #  ('Name', 'external url or path of pages in the document', boolean, 'icon name')\n    #\n    # Third argument:\n    # True indicates an external link.\n    # False indicates path of pages in the document.\n    #\n    # Fourth argument:\n    # Specify the icon name.\n    # For details see link.\n    # https://material.io/icons/\n    'header_links' : [\n        ('Home', 'index', False, 'home'),\n        (\"ExternalLink\", \"http://example.com\", True, 'launch'),\n        (\"NoIconLink\", \"http://example.com\", True, ''),\n        (\"GitHub\", \"https://github.com/myyasuda/sphinx_materialdesign_theme\", True, 'link')\n    ],\n\n    # Customize css colors.\n    # For details see link.\n    # https://getmdl.io/customize/index.html\n    #\n    # Values: amber, blue, brown, cyan deep_orange, deep_purple, green, grey, indigo, light_blue,\n    #         light_green, lime, orange, pink, purple, red, teal, yellow(Default: indigo)\n    'primary_color': 'blue',\n    # Values: Same as primary_color. (Default: pink)\n    'accent_color': 'indigo',\n\n    # Customize layout.\n    # For details see link.\n    # https://getmdl.io/components/index.html#layout-section\n    'fixed_drawer': True,\n    'fixed_header': False,\n    'header_waterfall': True,\n    'header_scroll': False,\n\n    # Render title in header.\n    # Values: True, False (Default: False)\n    'show_header_title': False,\n    # Render title in drawer.\n    # Values: True, False (Default: True)\n    'show_drawer_title': True,\n    # Render footer.\n}\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = ['./theme/static/']\n\n# The name of an image file (relative to this directory) to place at the top\n# of the sidebar.\nhtml_logo = 'theme/static/qiskit-terra-logo.png'\n\nhtml_favicon = 'theme/static/favicon.ico'\n\nhtml_last_updated_fmt = '%Y/%m/%d'\n\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = 'Qiskitdoc'\n\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    #\n    # 'papersize': 'letterpaper',\n\n    # The font size ('10pt', '11pt' or '12pt').\n    #\n    # 'pointsize': '10pt',\n\n    # Additional stuff for the LaTeX preamble.\n    #\n    # 'preamble': '',\n\n    # Latex figure (float) alignment\n    #\n    # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n    (master_doc, 'Qiskit.tex', 'Qiskit Documentation',\n     '''Jim Challenger, Andrew Cross, Ismael Faro, Jay Gambetta''', 'manual'),\n]\n\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [\n    (master_doc, 'qiskit', 'Qiskit Documentation',\n     [author], 1)\n]\n\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [\n    (master_doc, 'Qiskit Terra', 'Qiskit Terra Documentation',\n     author, 'Qiskit', 'One line description of project.',\n     'Miscellaneous'),\n]\n\n\n# Avoid a warning and treat the docstrings of the QasmLexer tokens as verbatim,\n# as PLY uses docstring as a way to define the patterns the token matches.\ndef remove_module_docstring(app, what, name, obj, options, lines):\n    if name.startswith('qiskit.qasm._qasmlexer.QasmLexer.t_') and lines:\n        lines[0] = u'Token matching: ``%s``' % lines[0]\n\n\ndef setup(app):\n    app.connect('autodoc-process-docstring', remove_module_docstring)\n", "path": "doc/conf.py"}]}