Estoy tratando de configurar sphinx_js pero sigo recibiendo este error:
~/test_sphinx_js$ sphinx-build -b html docs/source/ docs/build/html/ Running Sphinx v4.4.0 building [mo]: targets for 0 po files that are out of date building [html]: targets for 1 source files that are out of date updating environment: [new config] 1 added, 0 changed, 0 removed reading sources... [100%] index Sphinx error: No documentation was found for object "SomeClass" or any path ending with that.esta es la estructura de mi proyecto de prueba:
. ├── docs │ ├── build │ │ └── html │ ├── make.bat │ ├── Makefile │ └── source │ ├── conf.py │ ├── index.rst │ ├── _static │ └── _templates └── src └── SomeClass.jsy estas son las configuraciones y el código relevantes:
conf.py
[...] extensions = ['sphinx_js'] js_source_path = '../../src' primary_domain = 'js' [...]index.rst:
Welcome to SomeDocs's documentation! ==================================== .. toctree:: :maxdepth: 2 :caption: Contents: Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` .. js:autoclass:: SomeClassAlgunaClase.js:
/** Class representing something. */ export default class SomeClass { /** * Create class. * @param {string} name - The name of the object. * @param {string} type - The type of object. */ constructor(name, type) { this.name = name; this.type = type; } }Debo estar perdiendo algo obvio, pero no puedo entenderlo.