readthedocs.org: Build timed out for no apparent reason

Details

Expected Result

Build to happen and succeed.

Actual Result

Timed out after about 1500s but we do not even see the sphinx-build command being run. The logs ends at:

# User's Sphinx configurations
language_user = globals().get('language', None)
latex_engine_user = globals().get('latex_engine', None)
latex_elements_user = globals().get('latex_elements', None)

# Remove this once xindy gets installed in Docker image and XINDYOPS
# env variable is supported
# https://github.com/rtfd/readthedocs-docker-images/pull/98
latex_use_xindy = False

chinese = any([
    language_user in ('zh_CN', 'zh_TW'),
    project_language in ('zh_CN', 'zh_TW'),
])

japanese = any([
    language_user == 'ja',
    project_language == 'ja',
])

if chinese:
    latex_engine = latex_engine_user or 'xelatex'

    latex_elements_rtd = {
        'preamble': '\\usepackage[UTF8]{ctex}\n',
    }
    latex_elements = latex_elements_user or latex_elements_rtd
elif japanese:
    latex_engine = latex_engine_user or 'platex'

# Make sure our build directory is always excluded
exclude_patterns = globals().get('exclude_patterns', [])
exclude_patterns.extend(['_build'])

We are hoping perhaps you can inspect the server log and give us more clue on how to fix this. Thank you very much!

xref astropy/astropy#10998

cc @saimn

About this issue

  • Original URL
  • State: closed
  • Created 4 years ago
  • Reactions: 1
  • Comments: 15 (12 by maintainers)

Most upvoted comments

New issue opened at #7659

Maybe just one more thing, @humitos : the output of sphinx.ext.duration does not show on RTD, not sure why, but it would be great to have it.

@humitos , good guess, though astropy does not use autodoc_mock_imports.

I went ahead and increased the time limit for your project to 2000s and triggered a new build readthedocs.org/projects/astropy/builds/12295553 --let’s see if it passes

Oops. Super close!: “Build took 1928 seconds”

@astrojuanlu I know that Sphinx offers this extension, https://www.sphinx-doc.org/en/master/usage/extensions/duration.html that could be useful to understand what document is taking so much time. I never tried, tho.

I went ahead and increased the time limit for your project to 2000s and triggered a new build https://readthedocs.org/projects/astropy/builds/12295553/ --let’s see if it passes. My suggestion to understand why it takes too much time stands 😅