Read the Docs build information Build id: 19722 Project: pnccd-test Version: latest Commit: ffedf518eaa2b5a1b1cef59fbc933c68906d8895 Date: 2020-10-09T04:25:23.410418Z State: finished Success: False [rtd-command-info] start-time: 2020-10-09T09:25:37.239000Z, end-time: 2020-10-09T09:25:52.901000Z, duration: 15, exit-code: 0 python3 -mvirtualenv --no-site-packages --no-download /user_builds/pnccd-test/envs/latest Using base prefix '/usr' New python executable in /user_builds/pnccd-test/envs/latest/bin/python3 Not overwriting existing python script /user_builds/pnccd-test/envs/latest/bin/python (you must use /user_builds/pnccd-test/envs/latest/bin/python3) Installing setuptools, pip, wheel...done. [rtd-command-info] start-time: 2020-10-09T09:25:52.963000Z, end-time: 2020-10-09T09:27:21.941000Z, duration: 88, exit-code: 0 python /user_builds/pnccd-test/envs/latest/bin/pip install --use-wheel -U --cache-dir /user_builds/pnccd-test/.cache/pip sphinx==1.3.5 Pygments==2.1.3 setuptools==20.1.1 docutils==0.12 mkdocs==0.15.0 PyYAML==5.2 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 Requirement already up-to-date: sphinx==1.3.5 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Requirement already up-to-date: Pygments==2.1.3 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Collecting setuptools==20.1.1 Using cached https://files.pythonhosted.org/packages/e8/82/3b5455f74bf9ac0757d09c625b7741e6fc284d7519cffc3babb6c5173cf5/setuptools-20.1.1-py2.py3-none-any.whl Requirement already up-to-date: docutils==0.12 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Requirement already up-to-date: mkdocs==0.15.0 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Collecting PyYAML==5.2 Downloading https://files.pythonhosted.org/packages/8d/c9/e5be955a117a1ac548cdd31e37e8fd7b02ce987f9655f5c7563c656d5dcb/PyYAML-5.2.tar.gz (265kB) Requirement already up-to-date: mock==1.0.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Requirement already up-to-date: pillow==2.6.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages 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-ujdva_fq/readthedocs-sphinx-ext Requirement already up-to-date: sphinx-rtd-theme==0.1.9 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Requirement already up-to-date: alabaster!=0.7.5,<0.8,>=0.7 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Requirement already up-to-date: commonmark==0.5.4 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Requirement already up-to-date: recommonmark==0.1.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages Collecting Jinja2>=2.3 (from sphinx==1.3.5) Downloading https://files.pythonhosted.org/packages/65/e0/eb35e762802015cab1ccee04e8a277b03f1d8e53da3ec3106882ec42558b/Jinja2-2.10.3-py2.py3-none-any.whl (125kB) Collecting snowballstemmer>=1.1 (from sphinx==1.3.5) Downloading https://files.pythonhosted.org/packages/7d/4b/cdf1113a0e88b641893b814e9c36f69a6fda28cd88b62c7f0d858cde3166/snowballstemmer-2.0.0-py2.py3-none-any.whl (97kB) Collecting six>=1.4 (from sphinx==1.3.5) Downloading https://files.pythonhosted.org/packages/ee/ff/48bde5c0f013094d729fe4b0316ba2a24774b3ff1c52d924a8a4cb04078a/six-1.15.0-py2.py3-none-any.whl Collecting babel!=2.0,>=1.3 (from sphinx==1.3.5) Downloading https://files.pythonhosted.org/packages/15/a1/522dccd23e5d2e47aed4b6a16795b8213e3272c7506e625f2425ad025a19/Babel-2.8.0-py2.py3-none-any.whl (8.6MB) Requirement already up-to-date: mkdocs-bootswatch>=0.1.0 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from mkdocs==0.15.0) Collecting livereload>=2.3.2 (from mkdocs==0.15.0) Downloading https://files.pythonhosted.org/packages/bd/60/6640b819e858562ef6684abac60593b7369fe0a8a064df426d3ab0ab894d/livereload-2.6.3.tar.gz Ignoring tornado: markers 'python_version == "2.7"' don't match your environment Requirement already up-to-date: mkdocs-bootstrap>=0.1.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from mkdocs==0.15.0) Requirement already up-to-date: click>=4.0 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from mkdocs==0.15.0) Requirement already up-to-date: tornado>=4.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from mkdocs==0.15.0) Requirement already up-to-date: Markdown>=2.3.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from mkdocs==0.15.0) Requirement already up-to-date: requests in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from readthedocs-sphinx-ext) Requirement already up-to-date: nilsimsa>=0.3.7 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from readthedocs-sphinx-ext) Requirement already up-to-date: MarkupSafe>=0.23 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from Jinja2>=2.3->sphinx==1.3.5) Collecting pytz>=2015.7 (from babel!=2.0,>=1.3->sphinx==1.3.5) Downloading https://files.pythonhosted.org/packages/4f/a4/879454d49688e2fad93e59d7d4efda580b783c745fd2ec2a3adf87b0808d/pytz-2020.1-py2.py3-none-any.whl (510kB) Requirement already up-to-date: backports-abc>=0.4 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from tornado>=4.1->mkdocs==0.15.0) Requirement already up-to-date: chardet<3.1.0,>=3.0.2 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->readthedocs-sphinx-ext) Requirement already up-to-date: idna<2.9,>=2.5 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->readthedocs-sphinx-ext) Requirement already up-to-date: urllib3<1.25,>=1.21.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->readthedocs-sphinx-ext) Collecting certifi>=2017.4.17 (from requests->readthedocs-sphinx-ext) Downloading https://files.pythonhosted.org/packages/5e/c4/6c4fe722df5343c33226f0b4e0bb042e4dc13483228b4718baf286f86d87/certifi-2020.6.20-py2.py3-none-any.whl (156kB) Building wheels for collected packages: PyYAML, livereload Running setup.py bdist_wheel for PyYAML: started Running setup.py bdist_wheel for PyYAML: finished with status 'done' Stored in directory: /user_builds/pnccd-test/.cache/pip/wheels/54/b7/c7/2ada654ee54483c9329871665aaf4a6056c3ce36f29cf66e67 Running setup.py bdist_wheel for livereload: started Running setup.py bdist_wheel for livereload: finished with status 'done' Stored in directory: /user_builds/pnccd-test/.cache/pip/wheels/f2/a1/fa/00775311351a48f78b4a0e40588eefdd6f2731cc8115d6957d Successfully built PyYAML livereload Installing collected packages: setuptools, PyYAML, readthedocs-sphinx-ext, Jinja2, snowballstemmer, six, pytz, babel, livereload, certifi Found existing installation: setuptools 28.8.0 Uninstalling setuptools-28.8.0: Successfully uninstalled setuptools-28.8.0 Found existing installation: PyYAML 5.1.1 Uninstalling PyYAML-5.1.1: Successfully uninstalled PyYAML-5.1.1 Found existing installation: readthedocs-sphinx-ext 0.5.4 Uninstalling readthedocs-sphinx-ext-0.5.4: Successfully uninstalled readthedocs-sphinx-ext-0.5.4 Running setup.py install for readthedocs-sphinx-ext: started Running setup.py install for readthedocs-sphinx-ext: finished with status 'done' Found existing installation: Jinja2 2.10.1 Uninstalling Jinja2-2.10.1: Successfully uninstalled Jinja2-2.10.1 Found existing installation: snowballstemmer 1.9.0 Uninstalling snowballstemmer-1.9.0: Successfully uninstalled snowballstemmer-1.9.0 Found existing installation: six 1.12.0 Uninstalling six-1.12.0: Successfully uninstalled six-1.12.0 Found existing installation: pytz 2019.1 Uninstalling pytz-2019.1: Successfully uninstalled pytz-2019.1 Found existing installation: Babel 2.7.0 Uninstalling Babel-2.7.0: Successfully uninstalled Babel-2.7.0 Found existing installation: livereload 2.6.1 Uninstalling livereload-2.6.1: Successfully uninstalled livereload-2.6.1 Found existing installation: certifi 2019.6.16 Uninstalling certifi-2019.6.16: Successfully uninstalled certifi-2019.6.16 Successfully installed Jinja2-2.10.3 PyYAML-5.2 babel-2.8.0 certifi-2020.6.20 livereload-2.6.3 pytz-2020.1 readthedocs-sphinx-ext-0.5.4 setuptools-20.1.1 six-1.15.0 snowballstemmer-2.0.0 You are using pip version 9.0.1, however version 20.2.3 is available. You should consider upgrading via the 'pip install --upgrade pip' command. [rtd-command-info] start-time: 2020-10-09T09:27:22.208000Z, end-time: 2020-10-09T09:28:02.950000Z, duration: 40, exit-code: 0 python /user_builds/pnccd-test/envs/latest/bin/pip install --exists-action=w --cache-dir /user_builds/pnccd-test/.cache/pip -r/user_builds/pnccd-test/checkouts/latest/requirements.txt Collecting git+https://git.xfel.eu/gitlab/xfel-rtd/rtd-conf.git (from -r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 3)) Cloning https://git.xfel.eu/gitlab/xfel-rtd/rtd-conf.git to /tmp/pip-jfit0u6b-build Collecting sphinx==1.4.5 (from -r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Downloading https://files.pythonhosted.org/packages/d1/ad/9fe56e099e0bd288f1fdc037c2146b0698e2cba1d9a48636660f39a0e791/Sphinx-1.4.5-py2.py3-none-any.whl (1.6MB) Collecting breathe==4.7.3 (from -r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 5)) Downloading https://files.pythonhosted.org/packages/1c/7a/7a0f6c8367c96542d01fc1de8cedce8d93c8e3d9ded4e5b03eaefdcbcc82/breathe-4.7.3-py2.py3-none-any.whl (73kB) Collecting slumber==0.7.1 (from -r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 6)) Downloading https://files.pythonhosted.org/packages/17/3a/6d42c6a5909207aa2487fda0c6f09c7dac259e5154d6ad74ec160db69660/slumber-0.7.1.tar.gz Collecting sphinxcontrib-bibtex (from -r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Downloading https://files.pythonhosted.org/packages/60/de/831ec5de791ba30b842a26e27c479ed34259fb1823aa681d8028c551f4d0/sphinxcontrib_bibtex-1.0.0-py3-none-any.whl Collecting sphinxcontrib-contentui (from -r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 8)) Downloading https://files.pythonhosted.org/packages/de/9d/12d92cd1b37c9da35a53b56802025f6aa7826934c7cf0df6e4cfe0b90f8e/sphinxcontrib_contentui-0.2.5-py3-none-any.whl Requirement already satisfied: Pygments>=2.0 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: six>=1.4 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: babel!=2.0,>=1.3 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: alabaster<0.8,>=0.7 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: snowballstemmer>=1.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: Jinja2>=2.3 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: docutils>=0.11 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Collecting imagesize (from sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Downloading https://files.pythonhosted.org/packages/31/b2/b5522a0c8d11e4aff83f8342f3f0dea68c2fb25aa44403e420587f0ce204/imagesize-1.2.0-py2.py3-none-any.whl Requirement already satisfied: requests in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from slumber==0.7.1->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 6)) Collecting oset>=0.1.3 (from sphinxcontrib-bibtex->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Downloading https://files.pythonhosted.org/packages/d6/b1/a49498c699a3fda5d635cc1fa222ffc686ea3b5d04b84a3166c4cab0c57b/oset-0.1.3.tar.gz Collecting pybtex-docutils>=0.2.0 (from sphinxcontrib-bibtex->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Downloading https://files.pythonhosted.org/packages/e9/97/066aa09efc1a1f969ffc6ca0e697787a3b8eb9e847a9b5973c0f73119318/pybtex_docutils-0.2.2-py2.py3-none-any.whl Collecting pybtex>=0.20 (from sphinxcontrib-bibtex->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Downloading https://files.pythonhosted.org/packages/94/2a/11039970561f1bbc74fbaca89b59c26b398a0a70bba8caad553ac779b4f7/pybtex-0.22.2-py2.py3-none-any.whl (279kB) Requirement already satisfied: pytz>=2015.7 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from babel!=2.0,>=1.3->sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: MarkupSafe>=0.23 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from Jinja2>=2.3->sphinx==1.4.5->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 4)) Requirement already satisfied: idna<2.9,>=2.5 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->slumber==0.7.1->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 6)) Requirement already satisfied: urllib3<1.25,>=1.21.1 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->slumber==0.7.1->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 6)) Requirement already satisfied: chardet<3.1.0,>=3.0.2 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->slumber==0.7.1->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 6)) Requirement already satisfied: certifi>=2017.4.17 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from requests->slumber==0.7.1->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 6)) Requirement already satisfied: setuptools in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from oset>=0.1.3->sphinxcontrib-bibtex->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Requirement already satisfied: PyYAML>=3.01 in /user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages (from pybtex>=0.20->sphinxcontrib-bibtex->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Collecting latexcodec>=1.0.4 (from pybtex>=0.20->sphinxcontrib-bibtex->-r /user_builds/pnccd-test/checkouts/latest/requirements.txt (line 7)) Downloading https://files.pythonhosted.org/packages/0a/76/9552dfc6b74c2d6c3f199e927d41998dc1e561b7cbe4af7e7247388e17e8/latexcodec-2.0.1-py2.py3-none-any.whl Building wheels for collected packages: slumber, oset Running setup.py bdist_wheel for slumber: started Running setup.py bdist_wheel for slumber: finished with status 'done' Stored in directory: /user_builds/pnccd-test/.cache/pip/wheels/48/ae/95/28defa1956124d566c55e105d5e8ecacc63c4ad0b6e15d08bd Running setup.py bdist_wheel for oset: started Running setup.py bdist_wheel for oset: finished with status 'done' Stored in directory: /user_builds/pnccd-test/.cache/pip/wheels/4e/87/c8/3dad2dca279f64fb68af5d9908c380fee2f16488a1b1da3499 Successfully built slumber oset Installing collected packages: imagesize, sphinx, breathe, slumber, oset, latexcodec, pybtex, pybtex-docutils, sphinxcontrib-bibtex, sphinxcontrib-contentui, RTDConf Found existing installation: Sphinx 1.3.5 Uninstalling Sphinx-1.3.5: Successfully uninstalled Sphinx-1.3.5 Running setup.py install for RTDConf: started Running setup.py install for RTDConf: finished with status 'done' Successfully installed RTDConf-0.1 breathe-4.7.3 imagesize-1.2.0 latexcodec-2.0.1 oset-0.1.3 pybtex-0.22.2 pybtex-docutils-0.2.2 slumber-0.7.1 sphinx-1.4.5 sphinxcontrib-bibtex-1.0.0 sphinxcontrib-contentui-0.2.5 You are using pip version 9.0.1, however version 20.2.3 is available. You should consider upgrading via the 'pip install --upgrade pip' command. [rtd-command-info] start-time: 2020-10-09T09:28:03.555000Z, end-time: 2020-10-09T09:28:03.576000Z, duration: 0, exit-code: 0 cat conf.py #!/usr/bin/env python3 # -*- coding: utf-8 -*- # # pnCCD documentation build configuration file, created by # sphinx-quickstart on Tuesday January 28, 2020 at 11:25:48. # # This file is execfile()d with the current directory set to its # containing directory. # # 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. # 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. # # import os # import sys # 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.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.mathjax', 'sphinx.ext.ifconfig', 'sphinx.ext.viewcode', 'sphinx.ext.graphviz', 'sphinxcontrib.bibtex', 'sphinxcontrib.contentui' ] # Add any paths that contain templates here, relative to this directory. templates_path = ['.templates'] # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: # # source_suffix = ['.rst', '.md'] 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 = 'pnCCD' copyright = '2020, XFEL Detector Operation Group' #author = 'XFEL Detector Group' author = u'Kiana Setoodehnia, David Lomidze' # 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 = '1.2' # The full version, including alpha/beta/rc tags. release = ': Version 1.2' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. # # This is also used if you do content translation via gettext catalogs. # Usually you set "language" from the command line for these cases. 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' # If True, figures, tables and code-blocks are automatically numbered if they # have a caption. The numref role is enabled. Obeyed so far only by HTML and # LaTeX builders. Default is False. numfig = True # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This patterns also effect to html_static_path and html_extra_path 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 = [] # If true, keep warnings as "system message" paragraphs in the built documents. # keep_warnings = False # If true, `todo` and `todoList` produce output, else they produce nothing. todo_include_todos = True # -- 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 = 'alabaster' # 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. # " v documentation" by default. # html_title = 'The pnCCD Detector Manual' # A shorter title for the navigation bar. Default is the same as html_title. # html_short_title = "pnCCD Manual" # 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 (relative to this directory) to use as a 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'] html_static_path = [] # ['_static'] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied # directly to the root of the documentation. # # html_extra_path = [] # If not None, a 'Last updated on:' timestamp is inserted at every page # bottom, using the given strftime format. # The empty string is equivalent to '%b %d, %Y'. # # html_last_updated_fmt = None # 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 # Language to be used for generating the HTML full-text search index. # Sphinx supports the following languages: # 'da', 'de', 'en', 'es', 'fi', 'fr', 'h', 'it', 'ja' # 'nl', 'no', 'pt', 'ro', 'r', 'sv', 'tr', 'zh' # # html_search_language = 'en' # A dictionary with options for the search language support, empty by default. # 'ja' uses this config value. # 'zh' user can custom change `jieba` dictionary path. # # html_search_options = {'type': 'default'} # The name of a javascript file (relative to the configuration directory) that # implements a search results scorer. If empty, the default will be used. # # html_search_scorer = 'scorer.js' # Output file base name for HTML help builder. htmlhelp_basename = 'pnCCDdoc' # -- 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': # To get rid of blank pages after each chapter: 'extraclassoptions': 'openany,oneside,dvipsnames', 'preamble': r'''\newcommand{\docutilsrolemybold}{\bfseries} \newcommand{\DUrolered}[1]{{\color{Red}#1}} \newcommand{\DUroleblue}[1]{{\color{Blue}#1}} \newcommand{\DUrolegreen}[1]{{\color{Green}#1}} \newcommand{\DUroleyellow}[1]{{\color{Yellow}#1}} ''' # Latex figure (float) alignment # # 'figure_align': 'htbp', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ (master_doc, 'pnCCD.tex', 'The pnCCD Detector Manual', 'Kiana Setoodehnia, David Lomidze', '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 = [] # It false, will not define \strong, \code, itleref, \crossref ... but only # \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added # packages. # # latex_keep_old_macro_names = True # 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 = [ (master_doc, 'pnccd', 'The pnCCD Detector Manual', [author], 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 = [ (master_doc, 'pnCCD', 'The pnCCD Detector Manual', author, 'pnCCD', 'This is the pnCCD detector manual.', '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' # If true, do not generate a @detailmenu in the "Top" node's menu. # # texinfo_no_detailmenu = False # Example configuration for intersphinx: refer to the Python standard library. # intersphinx_mapping = {'https://docs.python.org/': None} #we add a custum function to work with intersphinx import slumber import json # the RTDHOST should be set to localhost if you only compile on RTD # otherwise it needs to be set to the server hosting the internal RTD RTDHOST = 'https://in.xfel.eu/readthedocs' api = slumber.API(base_url='{}/api/v1/'.format(RTDHOST)) projects = api.project.get()['objects'] isphinx = {'python': ('http://python.readthedocs.io/en/latest/', None), 'numpy': ('http://numpy.readthedocs.io/en/latest/', None), 'scipy': ('http://scipy.readthedocs.io/en/latest/', None)} for proj in projects: isphinx[proj['slug'].replace('-', '')] = \ ('{}/docs/{}/en/latest'.format(RTDHOST, proj['slug']), None) #intersphinx_mapping = isphinx intersphinx_mapping = {'https://docs.python.org/': None} def setup(app): app.add_config_value('includeDevInfo', 'false', 'env') ########################################################################### # 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': [ ], 'subprojects': [ ], 'slug': 'pnccd-test', 'name': u'PnCCD_test', 'rtd_language': u'en', 'canonical_url': 'http://exflrtd.desy.de/docs/pnccd-test/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': 'ffedf518', } 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: 2020-10-09T09:28:03.674000Z, end-time: 2020-10-09T09:28:14.253000Z, duration: 10, exit-code: 1 python /user_builds/pnccd-test/envs/latest/bin/sphinx-build -T -E -b readthedocs -d _build/doctrees-readthedocs -D language=en . _build/html Running Sphinx v1.4.5 making output directory... Traceback (most recent call last): File "/user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages/sphinx/cmdline.py", line 243, in main opts.warningiserror, opts.tags, opts.verbosity, opts.jobs) File "/user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages/sphinx/application.py", line 163, in __init__ self.setup_extension(extension) File "/user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages/sphinx/application.py", line 473, in setup_extension mod = __import__(extension, None, None, ['setup']) File "/user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages/sphinxcontrib/bibtex/__init__.py", line 20, in from sphinxcontrib.bibtex.directives import BibliographyDirective File "/user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages/sphinxcontrib/bibtex/directives.py", line 29, in logger = sphinx.util.logging.getLogger(__name__) AttributeError: 'module' object has no attribute 'getLogger' Exception occurred: File "/user_builds/pnccd-test/envs/latest/lib/python3.4/site-packages/sphinxcontrib/bibtex/directives.py", line 29, in logger = sphinx.util.logging.getLogger(__name__) AttributeError: 'module' object has no attribute 'getLogger' The full traceback has been saved in /tmp/sphinx-err-994ahd43.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!