Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 1 | # Configuration file for the Sphinx documentation builder. |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 2 | # |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 3 | # This file only contains a selection of the most common options. For a full |
| 4 | # list see the documentation: |
| 5 | # https://www.sphinx-doc.org/en/master/usage/configuration.html |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 6 | |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 7 | # -- Path setup -------------------------------------------------------------- |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 8 | |
| 9 | # If extensions (or modules to document with autodoc) are in another directory, |
| 10 | # add these directories to sys.path here. If the directory is relative to the |
| 11 | # documentation root, use os.path.abspath to make it absolute, like shown here. |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 12 | # |
| 13 | # import os |
| 14 | # import sys |
| 15 | # sys.path.insert(0, os.path.abspath('.')) |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 16 | |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 17 | |
| 18 | # -- Project information ----------------------------------------------------- |
| 19 | |
| 20 | project = 'NDN Packet Format Specification' |
| 21 | copyright = '2013-2020, Named Data Networking Project' |
| 22 | |
| 23 | # The short X.Y version. |
| 24 | version = '0.3' |
| 25 | |
| 26 | # The full version, including alpha/beta/rc tags. |
| 27 | release = '0.3' |
| 28 | |
| 29 | |
| 30 | # -- General configuration --------------------------------------------------- |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 31 | |
| 32 | # If your documentation needs a minimal Sphinx version, state it here. |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 33 | # |
| 34 | needs_sphinx = '1.3' |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 35 | |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 36 | # Add any Sphinx extension module names here, as strings. They can be |
| 37 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
| 38 | # ones. |
| 39 | extensions = [ |
| 40 | 'sphinxcontrib.bibtex', |
| 41 | 'sphinxcontrib.fulltoc', |
| 42 | ] |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 43 | |
| 44 | # The master toctree document. |
| 45 | master_doc = 'index' |
| 46 | |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 47 | # Add any paths that contain templates here, relative to this directory. |
| 48 | templates_path = ['_templates'] |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 49 | |
| 50 | # List of patterns, relative to source directory, that match files and |
| 51 | # directories to ignore when looking for source files. |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 52 | # This pattern also affects html_static_path and html_extra_path. |
| 53 | exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 54 | |
| 55 | |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 56 | # -- Options for HTML output ------------------------------------------------- |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 57 | |
| 58 | # The theme to use for HTML and HTML Help pages. See the documentation for |
| 59 | # a list of builtin themes. |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 60 | # |
Alexander Afanasyev | e2ef9d0 | 2013-11-27 02:24:13 +0000 | [diff] [blame] | 61 | html_theme = 'named_data_theme' |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 62 | |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 63 | # Add any paths that contain custom themes here, relative to this directory. |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 64 | html_theme_path = ['.'] |
Alexander Afanasyev | 772662a | 2013-11-21 23:22:40 +0000 | [diff] [blame] | 65 | |
| 66 | # Add any paths that contain custom static files (such as style sheets) here, |
| 67 | # relative to this directory. They are copied after the builtin static files, |
| 68 | # so a file named "default.css" will overwrite the builtin "default.css". |
| 69 | html_static_path = ['_static'] |
| 70 | |
Davide Pesavento | 04af5f2 | 2020-06-21 22:02:47 -0400 | [diff] [blame^] | 71 | # Disable syntax highlighting. |
| 72 | highlight_language = 'none' |