sciserver / poseidon-viewer

The Poseidon viewer, a visualization tool and web interface on ocean datasets
https://web.idies.jhu.edu/poseidon-viewer/viewer/index.html
Apache License 2.0
4 stars 3 forks source link

`make docs-build` fails #17

Open ThomasHaine opened 3 months ago

ThomasHaine commented 3 months ago

I forked the repo and try to make docs-build on SciServer (py39 environment). It errors like this:

(py39) idies@ac031b7558ed:~/workspace/Storage/Thomas.Haine/persistent/Poseidon testing/Poseidon-viewer/poseidon-viewer$ make docs-build
jupyter-book build docs/ -W --keep-going
Running Jupyter-Book v1.0.2
Source Folder: /home/idies/workspace/Storage/Thomas.Haine/persistent/Poseidon testing/Poseidon-viewer/poseidon-viewer/docs
Config Path: /home/idies/workspace/Storage/Thomas.Haine/persistent/Poseidon testing/Poseidon-viewer/poseidon-viewer/docs/_config.yml
Output Path: /home/idies/workspace/Storage/Thomas.Haine/persistent/Poseidon testing/Poseidon-viewer/poseidon-viewer/docs/_build/html
Running Sphinx v7.4.7
loading translations [en]... done
[etoc] Changing master_doc to 'intro'
loading pickled environment... done
myst v2.0.0: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions={'substitution', 'linkify', 'tasklist', 'colon_fence', 'dollarmath'}, disable_syntax=[], all_links_external=False, url_schemes=('mailto', 'http', 'https'), ref_domains=None, fence_as_directive=set(), number_code_blocks=[], title_to_header=False, heading_anchors=0, heading_slug_func=None, html_meta={}, footnote_transition=True, words_per_minute=200, substitutions={}, linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=True, mathjax_classes='tex2jax_process|mathjax_process|math|output_area', enable_checkboxes=False, suppress_warnings=[], highlight_code_blocks=True)
myst-nb v1.1.1: NbParserConfig(custom_formats={}, metadata_key='mystnb', cell_metadata_key='mystnb', kernel_rgx_aliases={}, eval_name_regex='^[a-zA-Z_][a-zA-Z0-9_]*$', execution_mode='off', execution_cache_path='', execution_excludepatterns=[], execution_timeout=30, execution_in_temp=False, execution_allow_errors=False, execution_raise_on_error=False, execution_show_tb=False, merge_streams=False, render_plugin='default', remove_code_source=False, remove_code_outputs=False, code_prompt_show='Show code cell {type}', code_prompt_hide='Hide code cell {type}', number_source_lines=False, output_stderr='show', render_text_lexer='myst-ansi', render_error_lexer='ipythontb', render_image_options={}, render_figure_options={}, render_markdown_format='commonmark', output_folder='build', append_css=True, metadata_to_fm=False)
Using jupyter-cache at: /home/idies/workspace/Storage/Thomas.Haine/persistent/Poseidon testing/Poseidon-viewer/poseidon-viewer/docs/_build/.jupyter_cache
sphinx-multitoc-numbering v0.1.3: Loaded
building [mo]: targets for 0 po files that are out of date
writing output... 
building [html]: targets for 0 source files that are out of date
updating environment: 0 added, 2 changed, 0 removed
reading sources... [100%] api_ref/apiref_grid_subsample
WARNING: autodoc: failed to import module 'gen_interp' from module 'precalc'; the following exception was raised:
No module named 'precalc'
WARNING: autodoc: failed to import module 'grid_subsample' from module 'precalc'; the following exception was raised:
No module named 'precalc'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
copying assets... 
copying static files... done
copying extra files... done
copying assets: done
writing output... [100%] intro
generating indices... genindex done
writing additional pages... search done
dumping search index in English (code: en)... done
dumping object inventory... done
build finished with problems, 2 warnings.

===============================================================================

Building your book, returns a non-zero exit code (1). Look above for the cause.

===============================================================================

make: *** [Makefile:18: docs-build] Error 1
ThomasHaine commented 1 month ago

I tried this again today, and it works fine. I don't know what the issue was, but I'm closing for now.

ThomasHaine commented 1 month ago

To double-check, I tried to make docs-build from a fresh environment on my laptop. I get the same

WARNING: autodoc: failed to import module 'gen_interp' from module 'precalc'; the following exception was raised:
No module named 'precalc'

error as above.