Read the Docs build information Build id: 13478 Project: deployed-controls-hed Version: latest Commit: 37ea6cd95dae9ad5df8922490abeec766ef22f57 Date: 2019-11-26T09:22:23.540394Z State: finished Success: False [rtd-command-info] start-time: 2019-11-26T15:23:25.299000Z, end-time: 2019-11-26T15:23:37.632000Z, duration: 12, exit-code: 0 python3 -mvirtualenv --system-site-packages --no-download /user_builds/deployed-controls-hed/envs/latest Using base prefix '/usr' New python executable in /user_builds/deployed-controls-hed/envs/latest/bin/python3 Not overwriting existing python script /user_builds/deployed-controls-hed/envs/latest/bin/python (you must use /user_builds/deployed-controls-hed/envs/latest/bin/python3) Installing setuptools, pip, wheel...done. [rtd-command-info] start-time: 2019-11-26T15:23:37.694000Z, end-time: 2019-11-26T15:24:45.719000Z, duration: 68, exit-code: 0 python /user_builds/deployed-controls-hed/envs/latest/bin/pip install --use-wheel -U --cache-dir /user_builds/deployed-controls-hed/.cache/pip -I sphinx==1.3.5 Pygments==2.1.3 setuptools==20.1.1 docutils==0.12 mkdocs==0.15.0 mock==1.0.1 pillow==2.6.1 git+https://github.com/rtfd/readthedocs-sphinx-ext.git@0.6-alpha#egg=readthedocs-sphinx-ext sphinx-rtd-theme==0.1.9 alabaster>=0.7,<0.8,!=0.7.5 commonmark==0.5.4 recommonmark==0.1.1 Collecting sphinx==1.3.5 Using cached https://files.pythonhosted.org/packages/ff/91/45883bc962bda1be7e78039b41cc15e1eb3327ec75679eedd067b5d07bd5/Sphinx-1.3.5-py2.py3-none-any.whl Collecting Pygments==2.1.3 Using cached https://files.pythonhosted.org/packages/9e/d0/d692085518c6a2dc875fe421c866fb6a08e0d9796ca507803c1e545fa116/Pygments-2.1.3-py2.py3-none-any.whl Collecting setuptools==20.1.1 Using cached https://files.pythonhosted.org/packages/e8/82/3b5455f74bf9ac0757d09c625b7741e6fc284d7519cffc3babb6c5173cf5/setuptools-20.1.1-py2.py3-none-any.whl Collecting docutils==0.12 Using cached https://files.pythonhosted.org/packages/c7/16/29d8de2404c5b90243b51f91315b3ce375169ceb48a68aeec0862e0143c4/docutils-0.12-py3-none-any.whl Collecting mkdocs==0.15.0 Using cached https://files.pythonhosted.org/packages/a7/10/c839adfd209aba3a5905d4a766ea354a1d03a414d6d437e10988574de70a/mkdocs-0.15.0-py2.py3-none-any.whl Collecting mock==1.0.1 Collecting pillow==2.6.1 Collecting readthedocs-sphinx-ext from git+https://github.com/rtfd/readthedocs-sphinx-ext.git@0.6-alpha#egg=readthedocs-sphinx-ext Cloning https://github.com/rtfd/readthedocs-sphinx-ext.git (to 0.6-alpha) to /tmp/pip-build-ss1i3alq/readthedocs-sphinx-ext Collecting sphinx-rtd-theme==0.1.9 Using cached https://files.pythonhosted.org/packages/97/d9/e27ef5a2b6b92d2cf29724c25daf0683adacc43ab5ad15dc0e9b69b464f8/sphinx_rtd_theme-0.1.9-py3-none-any.whl Collecting alabaster!=0.7.5,<0.8,>=0.7 Using cached https://files.pythonhosted.org/packages/10/ad/00b090d23a222943eb0eda509720a404f531a439e803f6538f35136cae9e/alabaster-0.7.12-py2.py3-none-any.whl Collecting commonmark==0.5.4 Collecting recommonmark==0.1.1 Using cached https://files.pythonhosted.org/packages/cb/65/0c893f1be31b8892ddd491ff05a9d539459ac07b9b1c9804034589ad7eb2/recommonmark-0.1.1-py2.py3-none-any.whl Collecting six>=1.4 (from sphinx==1.3.5) Using cached https://files.pythonhosted.org/packages/65/26/32b8464df2a97e6dd1b656ed26b2c194606c16fe163c695a992b36c11cdf/six-1.13.0-py2.py3-none-any.whl Collecting Jinja2>=2.3 (from sphinx==1.3.5) Using cached https://files.pythonhosted.org/packages/65/e0/eb35e762802015cab1ccee04e8a277b03f1d8e53da3ec3106882ec42558b/Jinja2-2.10.3-py2.py3-none-any.whl Collecting babel!=2.0,>=1.3 (from sphinx==1.3.5) Using cached https://files.pythonhosted.org/packages/2c/60/f2af68eb046c5de5b1fe6dd4743bf42c074f7141fe7b2737d3061533b093/Babel-2.7.0-py2.py3-none-any.whl Collecting snowballstemmer>=1.1 (from sphinx==1.3.5) Using cached https://files.pythonhosted.org/packages/7d/4b/cdf1113a0e88b641893b814e9c36f69a6fda28cd88b62c7f0d858cde3166/snowballstemmer-2.0.0-py2.py3-none-any.whl Collecting livereload>=2.3.2 (from mkdocs==0.15.0) Using cached https://files.pythonhosted.org/packages/12/4d/30cfe74402d2e962d66d35da29bf8850b0557b559ce84d09967c8ade859e/livereload-2.6.1-py2.py3-none-any.whl Collecting click>=4.0 (from mkdocs==0.15.0) Using cached https://files.pythonhosted.org/packages/fa/37/45185cb5abbc30d7257104c434fe0b07e5a195a6847506c074527aa599ec/Click-7.0-py2.py3-none-any.whl Collecting mkdocs-bootstrap>=0.1.1 (from mkdocs==0.15.0) Using cached https://files.pythonhosted.org/packages/e4/26/8823a7e45fad6ede3da31147514fb029dffb134e363bb0f64f7a2bd9448d/mkdocs_bootstrap-1.0.1-py2.py3-none-any.whl Collecting mkdocs-bootswatch>=0.1.0 (from mkdocs==0.15.0) Using cached https://files.pythonhosted.org/packages/42/06/1cdc2c3889c3c5803ae830bae3bf7c3fa5a0841109665d93bac81f287088/mkdocs_bootswatch-1.0-py2.py3-none-any.whl Collecting Markdown>=2.3.1 (from mkdocs==0.15.0) Using cached https://files.pythonhosted.org/packages/7a/6b/5600647404ba15545ec37d2f7f58844d690baf2f81f3a60b862e48f29287/Markdown-3.0.1-py2.py3-none-any.whl Collecting PyYAML>=3.10 (from mkdocs==0.15.0) Collecting tornado>=4.1 (from mkdocs==0.15.0) Collecting requests (from readthedocs-sphinx-ext) Using cached https://files.pythonhosted.org/packages/7d/e3/20f3d364d6c8e5d2353c72a67778eb189176f08e873c9900e10c0287b84b/requests-2.21.0-py2.py3-none-any.whl Collecting nilsimsa>=0.3.7 (from readthedocs-sphinx-ext) Collecting MarkupSafe>=0.23 (from Jinja2>=2.3->sphinx==1.3.5) Using cached https://files.pythonhosted.org/packages/99/c9/5d5dcf2aa90f1d4500e92467a04f63b3708ee6e5764b40b2445e767ab8dc/MarkupSafe-1.1.1-cp34-cp34m-manylinux1_x86_64.whl Collecting pytz>=2015.7 (from babel!=2.0,>=1.3->sphinx==1.3.5) Using cached https://files.pythonhosted.org/packages/e7/f9/f0b53f88060247251bf481fa6ea62cd0d25bf1b11a87888e53ce5b7c8ad2/pytz-2019.3-py2.py3-none-any.whl Collecting backports-abc>=0.4 (from tornado>=4.1->mkdocs==0.15.0) Using cached https://files.pythonhosted.org/packages/7d/56/6f3ac1b816d0cd8994e83d0c4e55bc64567532f7dc543378bd87f81cebc7/backports_abc-0.5-py2.py3-none-any.whl Collecting idna<2.9,>=2.5 (from requests->readthedocs-sphinx-ext) Using cached https://files.pythonhosted.org/packages/14/2c/cd551d81dbe15200be1cf41cd03869a46fe7226e7450af7a6545bfc474c9/idna-2.8-py2.py3-none-any.whl Collecting chardet<3.1.0,>=3.0.2 (from requests->readthedocs-sphinx-ext) Using cached https://files.pythonhosted.org/packages/bc/a9/01ffebfb562e4274b6487b4bb1ddec7ca55ec7510b22e4c51f14098443b8/chardet-3.0.4-py2.py3-none-any.whl Collecting urllib3<1.25,>=1.21.1 (from requests->readthedocs-sphinx-ext) Using cached https://files.pythonhosted.org/packages/01/11/525b02e4acc0c747de8b6ccdab376331597c569c42ea66ab0a1dbd36eca2/urllib3-1.24.3-py2.py3-none-any.whl Collecting certifi>=2017.4.17 (from requests->readthedocs-sphinx-ext) Using cached https://files.pythonhosted.org/packages/18/b0/8146a4f8dd402f60744fa380bc73ca47303cccf8b9190fd16a827281eac2/certifi-2019.9.11-py2.py3-none-any.whl Installing collected packages: six, docutils, alabaster, Pygments, sphinx-rtd-theme, MarkupSafe, Jinja2, pytz, babel, snowballstemmer, sphinx, setuptools, backports-abc, tornado, livereload, click, mkdocs-bootstrap, mkdocs-bootswatch, Markdown, PyYAML, mkdocs, mock, pillow, idna, chardet, urllib3, certifi, requests, nilsimsa, readthedocs-sphinx-ext, commonmark, recommonmark Running setup.py install for readthedocs-sphinx-ext: started Running setup.py install for readthedocs-sphinx-ext: finished with status 'done' Successfully installed Jinja2-2.10.3 Markdown-3.0.1 MarkupSafe-1.1.1 PyYAML-5.1.2 Pygments-2.1.3 alabaster-0.7.12 babel-2.7.0 backports-abc-0.5 certifi-2019.9.11 chardet-3.0.4 click-7.0 commonmark-0.5.4 docutils-0.12 idna-2.8 livereload-2.6.1 mkdocs-0.15.0 mkdocs-bootstrap-1.0.1 mkdocs-bootswatch-1.0 mock-1.0.1 nilsimsa-0.3.8 pillow-2.6.1 pytz-2019.3 readthedocs-sphinx-ext-0.5.4 recommonmark-0.1.1 requests-2.21.0 setuptools-28.8.0 six-1.13.0 snowballstemmer-2.0.0 sphinx-1.4.5 sphinx-rtd-theme-0.1.9 tornado-5.1.1 urllib3-1.24.3 You are using pip version 9.0.1, however version 19.3.1 is available. You should consider upgrading via the 'pip install --upgrade pip' command. [rtd-command-info] start-time: 2019-11-26T15:24:45.782000Z, end-time: 2019-11-26T15:24:52.270000Z, duration: 6, exit-code: 0 python /user_builds/deployed-controls-hed/envs/latest/bin/pip install --exists-action=w --cache-dir /user_builds/deployed-controls-hed/.cache/pip -rsource/requirements.txt Requirement already satisfied: gitpython in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from -r source/requirements.txt (line 1)) Obtaining sphinx_rtd_theme from git+https://haufs:cEMsag5QRLLDwfkFkWkL@git.xfel.eu/gitlab/detectors/rtfd_theme.git#egg=sphinx_rtd_theme (from -r source/requirements.txt (line 2)) Updating /user_builds/deployed-controls-hed/envs/latest/src/sphinx-rtd-theme clone Running setup.py (path:/user_builds/deployed-controls-hed/envs/latest/src/sphinx-rtd-theme/setup.py) egg_info for package sphinx-rtd-theme produced metadata for project name sphinx-rtd-theme-patched. Fix your #egg=sphinx-rtd-theme fragments. Requirement already satisfied: sphinx==1.4.5 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from -r source/requirements.txt (line 3)) Requirement already satisfied: gitdb2>=2.0.0 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from gitpython->-r source/requirements.txt (line 1)) Requirement already satisfied: snowballstemmer>=1.1 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: babel!=2.0,>=1.3 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: imagesize in /usr/local/lib/python3.4/dist-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: six>=1.4 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: Pygments>=2.0 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: docutils>=0.11 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: Jinja2>=2.3 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: alabaster<0.8,>=0.7 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: smmap2>=2.0.0 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from gitdb2>=2.0.0->gitpython->-r source/requirements.txt (line 1)) Requirement already satisfied: pytz>=2015.7 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from babel!=2.0,>=1.3->sphinx==1.4.5->-r source/requirements.txt (line 3)) Requirement already satisfied: MarkupSafe>=0.23 in /user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages (from Jinja2>=2.3->sphinx==1.4.5->-r source/requirements.txt (line 3)) Installing collected packages: sphinx-rtd-theme-patched Found existing installation: sphinx-rtd-theme-patched 0.1.9 Uninstalling sphinx-rtd-theme-patched-0.1.9: Successfully uninstalled sphinx-rtd-theme-patched-0.1.9 Running setup.py develop for sphinx-rtd-theme-patched Successfully installed sphinx-rtd-theme-patched You are using pip version 9.0.1, however version 19.3.1 is available. You should consider upgrading via the 'pip install --upgrade pip' command. [rtd-command-info] start-time: 2019-11-26T15:24:52.636000Z, end-time: 2019-11-26T15:24:52.659000Z, duration: 0, exit-code: 0 cat conf.py # -*- coding: utf-8 -*- # # Deployed Control Systems documentation build configuration file, created by # sphinx-quickstart on Thu Sep 12 12:36:47 2019. # # This file is execfile()d with the current directory set to its containing dir. # # Note that not all possible configuration values are present in this # autogenerated file. # # All configuration values have a default; values that are commented out # serve to show the default. import sys, os import subprocess # add our own toctree directive sys.path.append(os.path.abspath('./sphinx_ext/')) from subprocess import Popen, PIPE import os from datetime import datetime cwd = os.getcwd() # install a fixed theme which support proper math formatting # we need to do this explicitely and not via a requirements.txt as # it needs to go to a specific location depending on this build. os.makedirs("{}/userthemes".format(cwd), exist_ok=True) if os.path.exists("/rtd_root/readthedocs"): os.makedirs("/rtd_root/readthedocs/templates/sphinx/_static", exist_ok=True) #pcmd = ["pip", "install", "--user", "--upgrade", # "git+https://haufs:cEMsag5QRLLDwfkFkWkL@git.xfel.eu/gitlab/detectors" # "/rtfd_theme.git",] # noqa # #"{}/userthemes".format(cwd)] #Popen(pcmd).wait() pcmd = ["git", "clone", "https://haufs:cEMsag5QRLLDwfkFkWkL@git.xfel.eu/gitlab/detectors/rtfd_theme.git", # noqa "{}/userthemes".format(cwd)] Popen(pcmd).wait() try: os.rmdir("{}/../control-docs-generic".format(cwd)) except: pass pcmd = ["git", "clone", "https://haufs:cEMsag5QRLLDwfkFkWkL@git.xfel.eu/gitlab/control-docs/control-docs-generic.git", # noqa "{}/../control-docs-generic".format(cwd)] Popen(pcmd).wait() # This is a bit hacky, but it seems that with submodules file modification # times are sometime corrupted and set to dates in the 1970s. ZIP is not # happy with this an will fail the build. Thus we search for any affected files # here, and then set the mtime to the current time. pcmd = ["find", "..", "-mtime", "+13700", "-type", "f", "-exec", "touch", "-d", datetime.now().isoformat(), "{}", "+"] Popen(pcmd).wait() # If you nevertheless get a ZIP 1980 error, this command will output you # the files which are responsible for triggering it. Should be none if # our fix-up succeeded. pcmd = ["find", "..", "-mtime", "+13700", "-ls"] Popen(pcmd).wait() # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. #sys.path.insert(0, os.path.abspath('.')) # -- General configuration ----------------------------------------------------- # If your documentation needs a minimal Sphinx version, state it here. #needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.mathjax', 'sphinx.ext.ifconfig', 'include_if_present', 'silent_builder', 'include_from_generic', ] inc_gen_path = os.path.abspath("../control-docs-generic") inc_gen_imap = os.path.abspath("../control-docs-generic/instance_map.yaml") inc_gen_cmap = os.path.abspath("../control-docs-generic/class_map.yaml") mathjax_path="https://in.xfel.eu/readthedocs/media/MathJax-2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML" # noqa # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.rst' # The encoding of source files. #source_encoding = 'utf-8-sig' # The master toctree document. master_doc = 'index' # General information about the project. project = u'Deployed Control Systems' copyright = u'2019, Controls Group' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The short X.Y version. version = '0.1' # The full version, including alpha/beta/rc tags. release = '0.1' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. #language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. #today_fmt = '%B %d, %Y' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = [] # The reST default role (used for this markup: `text`) to use for all documents. #default_role = None # If true, '()' will be appended to :func: etc. cross-reference text. #add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). #add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. #show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. #modindex_common_prefix = [] # -- Options for HTML output --------------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme_path = ["{}/userthemes".format(cwd)] html_theme = "sphinx_rtd_theme_patched" # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. #html_theme_options = {} # Add any paths that contain custom themes here, relative to this directory. #html_theme_path = [] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". #html_title = None # A shorter title for the navigation bar. Default is the same as html_title. #html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. #html_logo = None # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. #html_favicon = None # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. #html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. #html_use_smartypants = True # Custom sidebar templates, maps document names to template names. #html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # template names. #html_additional_pages = {} # If false, no module index is generated. #html_domain_indices = True # If false, no index is generated. #html_use_index = True # If true, the index is split into individual pages for each letter. #html_split_index = False # If true, links to the reST sources are added to the pages. #html_show_sourcelink = True # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. #html_show_sphinx = True # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. #html_show_copyright = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. #html_use_opensearch = '' # This is the file name suffix for HTML files (e.g. ".xhtml"). #html_file_suffix = None # Output file base name for HTML help builder. # htmlhelp_basename = 'DeployedControlSystemsdoc' # -- Options for LaTeX output -------------------------------------------------- latex_elements = { # The paper size ('letterpaper' or 'a4paper'). #'papersize': 'letterpaper', # The font size ('10pt', '11pt' or '12pt'). #'pointsize': '10pt', # Additional stuff for the LaTeX preamble. #'preamble': '', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass [howto/manual]). latex_documents = [ ('index', 'DeployedControlSystems.tex', u'Deployed Control Systems Documentation', u'Controls Group', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of # the title page. #latex_logo = None # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. #latex_use_parts = False # If true, show page references after internal links. #latex_show_pagerefs = False # If true, show URL addresses after external links. #latex_show_urls = False # Documents to append as an appendix to all manuals. #latex_appendices = [] # If false, no module index is generated. #latex_domain_indices = True # -- Options for manual page output -------------------------------------------- # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ ('index', 'deployedcontrolsystems', u'Deployed Control Systems Documentation', [u'Controls Group'], 1) ] # If true, show URL addresses after external links. #man_show_urls = False # -- Options for Texinfo output ------------------------------------------------ # Grouping the document tree into Texinfo files. List of tuples # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ ('index', 'DeployedControlSystems', u'Deployed Control Systems Documentation', u'Controls Group', 'DeployedControlSystems', 'One line description of project.', 'Miscellaneous'), ] # Documents to append as an appendix to all manuals. #texinfo_appendices = [] # If false, no module index is generated. #texinfo_domain_indices = True # How to display URL addresses: 'footnote', 'no', or 'inline'. #texinfo_show_urls = 'footnote' # Example configuration for intersphinx: refer to the Python standard library. intersphinx_mapping = {'http://docs.python.org/': None} ########################################################################### # auto-created readthedocs.org specific configuration # ########################################################################### # # The following code was added during an automated build on readthedocs.org # It is auto created and injected for every build. The result is based on the # conf.py.tmpl file found in the readthedocs.org codebase: # https://github.com/rtfd/readthedocs.org/blob/master/readthedocs/doc_builder/templates/doc_builder/conf.py.tmpl # import sys import os.path from six import string_types from sphinx import version_info # Get suffix for proper linking to GitHub # This is deprecated in Sphinx 1.3+, # as each page can have its own suffix if globals().get('source_suffix', False): if isinstance(source_suffix, string_types): SUFFIX = source_suffix else: SUFFIX = source_suffix[0] else: SUFFIX = '.rst' # Add RTD Static Path. Add to the end because it overwrites previous files. if not 'html_static_path' in globals(): html_static_path = [] if os.path.exists('_static'): html_static_path.append('_static') html_static_path.append('/rtd_root/readthedocs/templates/sphinx/_static') # Add RTD Theme only if they aren't overriding it already using_rtd_theme = False if 'html_theme' in globals(): if html_theme in ['default']: # Allow people to bail with a hack of having an html_style if not 'html_style' in globals(): import sphinx_rtd_theme html_theme = 'sphinx_rtd_theme' html_style = None html_theme_options = {} if 'html_theme_path' in globals(): html_theme_path.append(sphinx_rtd_theme.get_html_theme_path()) else: html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] using_rtd_theme = True else: import sphinx_rtd_theme html_theme = 'sphinx_rtd_theme' html_style = None html_theme_options = {} if 'html_theme_path' in globals(): html_theme_path.append(sphinx_rtd_theme.get_html_theme_path()) else: html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] using_rtd_theme = True if globals().get('websupport2_base_url', False): websupport2_base_url = 'https://readthedocs.org/websupport' if 'http' not in settings.MEDIA_URL: websupport2_static_url = '/static/' else: websupport2_static_url = '/media//static' #Add project information to the template context. context = { 'using_theme': using_rtd_theme, 'html_theme': html_theme, 'current_version': "latest", 'MEDIA_URL': "/media/", 'PRODUCTION_DOMAIN': "exflrtd.desy.de", 'versions': [ ("latest", "/en/latest/"), ], 'downloads': [ ("htmlzip", "//exflrtd.desy.de/projects/deployed-controls-hed/downloads/htmlzip/latest/"), ], 'subprojects': [ ], 'slug': 'deployed-controls-hed', 'name': u'Deployed Controls - HED', 'rtd_language': u'en', 'canonical_url': 'http://exflrtd.desy.de/docs/deployed-controls-hed/en/latest/', 'analytics_code': '', 'single_version': False, 'conf_py_path': '/source/', 'api_host': 'https://readthedocs.org', 'github_user': 'None', 'github_repo': 'None', 'github_version': 'master', 'display_github': False, 'bitbucket_user': 'None', 'bitbucket_repo': 'None', 'bitbucket_version': 'master', 'display_bitbucket': False, 'READTHEDOCS': True, 'using_theme': (html_theme == "default"), 'new_theme': (html_theme == "sphinx_rtd_theme"), 'source_suffix': SUFFIX, 'user_analytics_code': '', 'global_analytics_code': 'UA-17997319-1', 'commit': '37ea6cd9', } if 'html_context' in globals(): html_context.update(context) else: html_context = context # Add custom RTD extension if 'extensions' in globals(): extensions.append("readthedocs_ext.readthedocs") else: extensions = ["readthedocs_ext.readthedocs"] [rtd-command-info] start-time: 2019-11-26T15:24:52.726000Z, end-time: 2019-11-26T15:30:08.340000Z, duration: 315, exit-code: 0 python /user_builds/deployed-controls-hed/envs/latest/bin/sphinx-build -T -E -b readthedocs -d _build/doctrees-readthedocs -D language=en . _build/html Running Sphinx v1.3.5 making output directory... Cloning into '/user_builds/deployed-controls-hed/checkouts/latest/source/userthemes'... fatal: destination path '/user_builds/deployed-controls-hed/checkouts/latest/source/../control-docs-generic' already exists and is not an empty directory. loading translations [en]... done loading intersphinx inventory from http://docs.python.org/objects.inv... building [mo]: targets for 0 po files that are out of date building [readthedocs]: targets for 1880 source files that are out of date updating environment: 1880 added, 0 changed, 0 removed /user_builds/deployed-controls-hed/checkouts/latest/source/sphinx_ext/include_from_generic.py:38: YAMLLoadWarning: calling yaml.load() without Loader=... is deprecated, as the default Loader is unsafe. Please read https://msg.pyyaml.org/load for full details. cmap = yaml.load(yf.read()) /user_builds/deployed-controls-hed/checkouts/latest/source/sphinx_ext/include_from_generic.py:55: YAMLLoadWarning: calling yaml.load() without Loader=... is deprecated, as the default Loader is unsafe. Please read https://msg.pyyaml.org/load for full details. imap = yaml.load(yf.read()) /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/VAC2/TPUMP/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/EXP/VAC2/TPUMP/IC_TP01' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/VAC2/TPUMP/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/EXP/VAC2/TPUMP/IC_TP02' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/HPLAS/HIVAC/TPUMP/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/HPLAS/HIVAC/TPUMP/HI_VPT_01' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/JNGFR-1/CAL/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/IA1/JNGFR-1/CAL/CORR_GAIN' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/JNGFR-1/CAL/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/IA1/JNGFR-1/CAL/CORR_OFFSET' /user_builds/deployed-controls-hed/checkouts/latest/source/index.rst:10: WARNING: toctree contains reference to nonexisting document 'index/index' /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: nonlocal image URI found: https://img.shields.io/pypi/v/sphinx_rtd_theme.svg /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: nonlocal image URI found: https://travis-ci.org/rtfd/sphinx_rtd_theme.svg?branch=master /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: nonlocal image URI found: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: image file not readable: userthemes/demo_docs/source/static/screen_mobile.png looking for now-outdated files... none found pickling environment... done checking consistency... /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/FDI/CAM/1.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/FDI/CAM/2.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-1/AVG/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-1/PROC/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-2/AVG/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-2/PROC/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA2/DAC/MOTOR/UP_X.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA2/DAC/MOTOR/UP_Y.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA2/DAC/MOTOR/UP_Z.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/LAS/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/OPT/VAC/PUMP/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/PLAS/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/1_PLCMON.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/2.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/3.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/3_PLCMON.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/4.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/SA2/XTD1/ATT/PNACT/A2.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/tests/roots/test-basic/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/tests/roots/test-empty/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/tests/roots/test-missing-toctree/index.rst:: WARNING: document isn't included in any toctree done preparing documents... done generating indices... genindex writing additional pages... search copying static files... done copying extra files... done dumping search index in English (code: en) ... done dumping object inventory... done build succeeded, 32 warnings. Copying readthedocs-dynamic-include.js_t... done Copying readthedocs-data.js_t... done Copying searchtools.js_t... done [rtd-command-info] start-time: 2019-11-26T15:33:56.920000Z, end-time: 2019-11-26T15:36:41.222000Z, duration: 164, exit-code: 1 python /user_builds/deployed-controls-hed/envs/latest/bin/sphinx-build -T -b json -d _build/doctrees-json -D language=en . _build/json Running Sphinx v1.3.5 making output directory... fatal: destination path '/user_builds/deployed-controls-hed/checkouts/latest/source/userthemes' already exists and is not an empty directory. fatal: destination path '/user_builds/deployed-controls-hed/checkouts/latest/source/../control-docs-generic' already exists and is not an empty directory. loading translations [en]... done loading pickled environment... not yet created loading intersphinx inventory from http://docs.python.org/objects.inv... building [mo]: targets for 0 po files that are out of date building [json]: targets for 1880 source files that are out of date updating environment: 1880 added, 0 changed, 0 removed /user_builds/deployed-controls-hed/checkouts/latest/source/sphinx_ext/include_from_generic.py:38: YAMLLoadWarning: calling yaml.load() without Loader=... is deprecated, as the default Loader is unsafe. Please read https://msg.pyyaml.org/load for full details. cmap = yaml.load(yf.read()) /user_builds/deployed-controls-hed/checkouts/latest/source/sphinx_ext/include_from_generic.py:55: YAMLLoadWarning: calling yaml.load() without Loader=... is deprecated, as the default Loader is unsafe. Please read https://msg.pyyaml.org/load for full details. imap = yaml.load(yf.read()) /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/VAC2/TPUMP/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/EXP/VAC2/TPUMP/IC_TP01' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/VAC2/TPUMP/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/EXP/VAC2/TPUMP/IC_TP02' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/HPLAS/HIVAC/TPUMP/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/HPLAS/HIVAC/TPUMP/HI_VPT_01' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/JNGFR-1/CAL/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/IA1/JNGFR-1/CAL/CORR_GAIN' /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/JNGFR-1/CAL/index.rst:10: WARNING: toctree contains reference to nonexisting document 'HED/IA1/JNGFR-1/CAL/CORR_OFFSET' /user_builds/deployed-controls-hed/checkouts/latest/source/index.rst:10: WARNING: toctree contains reference to nonexisting document 'index/index' /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: nonlocal image URI found: https://img.shields.io/pypi/v/sphinx_rtd_theme.svg /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: nonlocal image URI found: https://travis-ci.org/rtfd/sphinx_rtd_theme.svg?branch=master /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: nonlocal image URI found: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:None: WARNING: image file not readable: userthemes/demo_docs/source/static/screen_mobile.png looking for now-outdated files... none found pickling environment... done checking consistency... /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/FDI/CAM/1.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/EXP/FDI/CAM/2.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-1/AVG/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-1/PROC/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-2/AVG/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA1/EPX100-2/PROC/RECEIVER.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA2/DAC/MOTOR/UP_X.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA2/DAC/MOTOR/UP_Y.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/IA2/DAC/MOTOR/UP_Z.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/LAS/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/OPT/VAC/PUMP/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/PLAS/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/1_PLCMON.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/2.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/3.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/3_PLCMON.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/HED/RR/SYS/PLC/4.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/SA2/XTD1/ATT/PNACT/A2.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/README.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/tests/roots/test-basic/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/tests/roots/test-empty/index.rst:: WARNING: document isn't included in any toctree /user_builds/deployed-controls-hed/checkouts/latest/source/userthemes/tests/roots/test-missing-toctree/index.rst:: WARNING: document isn't included in any toctree done preparing documents... done Traceback (most recent call last): File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/cmdline.py", line 244, in main app.build(opts.force_all, filenames) File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/application.py", line 266, in build self.builder.build_update() File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/builders/__init__.py", line 251, in build_update 'out of date' % len(to_build)) File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/builders/__init__.py", line 322, in build self.write(docnames, list(updated_docnames), method) File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/builders/__init__.py", line 360, in write self._write_serial(sorted(docnames), warnings) File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/builders/__init__.py", line 366, in _write_serial doctree = self.env.get_and_resolve_doctree(docname, self) File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/environment.py", line 1295, in get_and_resolve_doctree doctree = self.get_doctree(docname) File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/environment.py", line 1279, in get_doctree f = open(doctree_filename, 'rb') FileNotFoundError: [Errno 2] No such file or directory: '/user_builds/deployed-controls-hed/checkouts/latest/source/_build/doctrees-json/HED/IA1/SAMP/MOTOR/CRL_HEX_X.doctree' Exception occurred: File "/user_builds/deployed-controls-hed/envs/latest/lib/python3.4/site-packages/sphinx/environment.py", line 1279, in get_doctree f = open(doctree_filename, 'rb') FileNotFoundError: [Errno 2] No such file or directory: '/user_builds/deployed-controls-hed/checkouts/latest/source/_build/doctrees-json/HED/IA1/SAMP/MOTOR/CRL_HEX_X.doctree' The full traceback has been saved in /tmp/sphinx-err-ysnv_css.log, if you want to report the issue to the developers. Please also report this if it was a user error, so that a better error message can be provided next time. A bug report can be filed in the tracker at . Thanks!