[
https://issues.apache.org/jira/browse/CLIMATE-852?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15421713#comment-15421713
]
Lewis John McGibbney commented on CLIMATE-852:
----------------------------------------------
I get the following when I try to build the documentation
{code}
lmcgibbn@LMC-032857 /usr/local/climate/docs(master) $ make html
sphinx-build -b html -d build/doctrees source build/html
Running Sphinx v1.3.1
loading pickled environment... done
loading intersphinx inventory from http://docs.python.org/2/objects.inv...
loading intersphinx inventory from
http://docs.scipy.org/doc/scipy/reference/objects.inv...
loading intersphinx inventory from
http://docs.scipy.org/doc/numpy/objects.inv...
loading intersphinx inventory from
http://matplotlib.sourceforge.net/objects.inv...
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 2 source files that are out of date
updating environment: 1 added, 8 changed, 0 removed
reading sources... [100%] ocw/utils
/usr/local/climate/docs/source/config/config_writer.rst:4: WARNING: autodoc:
failed to import module u'ocw_config_runner.configuration_writer'; the
following exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
ImportError: No module named ocw_config_runner.configuration_writer
/usr/local/climate/docs/source/data_source/data_sources.rst:6: WARNING:
autodoc: failed to import module u'local'; the following exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/data_source/local.py", line 26, in <module>
from ocw.dataset import Dataset
ImportError: No module named ocw.dataset
/usr/local/climate/docs/source/data_source/data_sources.rst:11: WARNING:
autodoc: failed to import module u'rcmed'; the following exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/data_source/rcmed.py", line 32, in <module>
from ocw.dataset import Dataset
ImportError: No module named ocw.dataset
/usr/local/climate/docs/source/data_source/data_sources.rst:16: WARNING:
autodoc: failed to import module u'dap'; the following exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/data_source/dap.py", line 21, in <module>
from ocw.dataset import Dataset
ImportError: No module named ocw.dataset
/usr/local/climate/docs/source/data_source/data_sources.rst:21: WARNING:
autodoc: failed to import module u'esgf'; the following exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/data_source/esgf.py", line 23, in <module>
from ocw.esgf.constants import DEFAULT_ESGF_SEARCH
ImportError: No module named ocw.esgf.constants
/usr/local/climate/docs/source/ocw/dataset.rst:6: WARNING: autodoc: failed to
import class u'Bounds' from module u'dataset'; the following exception was
raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/dataset.py", line 32, in <module>
import ocw
ImportError: No module named ocw
/usr/local/climate/docs/source/ocw/dataset.rst:11: WARNING: autodoc: failed to
import class u'Dataset' from module u'dataset'; the following exception was
raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/dataset.py", line 32, in <module>
import ocw
ImportError: No module named ocw
/usr/local/climate/docs/source/ocw/dataset_loader.rst:2: WARNING: Title
underline too short.
Dataset Loader Module
**************
/usr/local/climate/docs/source/ocw/dataset_loader.rst:4: WARNING: autodoc:
failed to import module u'dataset_loader'; the following exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/dataset_loader.py", line 23, in <module>
import ocw.data_source.local as local
ImportError: No module named ocw.data_source.local
/usr/local/climate/docs/source/ocw/dataset_processor.rst:4: WARNING: autodoc:
failed to import module u'dataset_processor'; the following exception was
raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/dataset_processor.py", line 18, in <module>
from ocw import dataset as ds
ImportError: No module named ocw
/usr/local/climate/docs/source/ocw/evaluation.rst:4: WARNING: autodoc: failed
to import class u'Evaluation' from module u'evaluation'; the following
exception was raised:
Traceback (most recent call last):
File "/Library/Python/2.7/site-packages/sphinx/ext/autodoc.py", line 385, in
import_object
__import__(self.modname)
File "/usr/local/climate/ocw/evaluation.py", line 24, in <module>
from metrics import Metric, UnaryMetric, BinaryMetric
File "/usr/local/climate/ocw/metrics.py", line 24, in <module>
import ocw.utils as utils
ImportError: No module named ocw.utils
/usr/local/climate/ocw/utils.py:docstring of
utils.calc_subregion_area_mean_and_std:3: WARNING: Definition list ends without
a blank line; unexpected unindent.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] ocw/utils
generating indices... genindex http-routingtable py-modindex
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, 12 warnings.
Build finished. The HTML pages are in build/html.
{code}
> [OCW Documentation] Theme not found error
> ------------------------------------------
>
> Key: CLIMATE-852
> URL: https://issues.apache.org/jira/browse/CLIMATE-852
> Project: Apache Open Climate Workbench
> Issue Type: Bug
> Components: build process
> Affects Versions: 1.1.0
> Reporter: Omkar Reddy
> Fix For: 1.2.0
>
>
> When I try to build the documentation locally I get the following error,
> Theme error:
> no theme named 'alabaster' found (missing theme.conf?)
> make: *** [html] Error 1
> When I did some digging, I got to know that the above theme used to be the
> default theme for sphinx, but it has been outdated now, So I propose we
> change the theme to more non-default theme such as 'sphinx_rtd_theme' or we
> can add the latest default theme. I am more inclined to the first one,
> because it is a stable non-default theme which does not change on sphinx
> updation. Any suggestions are welcome.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
