Getting 404 on Module Index page

[mertyildiran]

Details

• Read the Docs project URL: https://readthedocs.org/projects/dragonfire/
• Build URL (if applicable): https://readthedocs.org/projects/dragonfire/builds/
• Read the Docs username (if applicable): mertyildiran
• GitHub Sphinx documentation source: https://github.com/DragonComputer/Dragonfire/tree/master/docs/source

Expected Result

On my local machine, I'm building the documentation with:

sphinx-quickstart
sphinx-apidoc -f -o source/ ../dragonfire/
make html

and Module Index page is working perfectly fine:

Actual Result

But when I build the documentation on Read the Docs side, I get 404 on Module Index page: https://dragonfire.readthedocs.io/en/latest/py-modindex.html

I tried to remove non-ASCII characters with:
DragonComputer/Dragonfire@e45a11e
DragonComputer/Dragonfire@b1818c4
and removed Markdown support with:
DragonComputer/Dragonfire@2a31dc1

but none of them solved the issue.

[stsewd]

Sorry but I don't see the file in your repo https://github.com/DragonComputer/Dragonfire/tree/master/docs/source

[stsewd]

Sorry but I don't see the file in your repo https://github.com/DragonComputer/Dragonfire/tree/master/docs/source

[mertyildiran]

make html generates it by looking up for docstrings in the whole project:

I did what you said in here but did not change anything.

[mertyildiran]

make html generates it by looking up for docstrings in the whole project:

I did what you said in here but did not change anything.

[stsewd]

RTD execute the sphinx-build command only, it doesn't execute the make file nor the sphinx-apidodc command. See #1139

[stsewd]

RTD execute the sphinx-build command only, it doesn't execute the make file nor the sphinx-apidodc command. See #1139

[mertyildiran]

@stsewd I removed the build directory with rm -rf build/ and ran:

sphinx-build -b html source/ build/

It gave me exactly the same result with make html. I don't understand your point?

[mertyildiran]

@stsewd I removed the build directory with rm -rf build/ and ran:

sphinx-build -b html source/ build/

It gave me exactly the same result with make html. I don't understand your point?

[stsewd]

You executed this command sphinx-apidoc -f -o source/ ../dragonfire/, which places the output inside the source/ dir

[stsewd]

You executed this command sphinx-apidoc -f -o source/ ../dragonfire/, which places the output inside the source/ dir

[mertyildiran]

@stsewd sphinx-apidoc -f -o source/ ../dragonfire/ generates the .rst files according to my module structure right? So what's the relevance of sphinx-apidoc to generating .html documents from those .rst files?

[mertyildiran]

@stsewd sphinx-apidoc -f -o source/ ../dragonfire/ generates the .rst files according to my module structure right? So what's the relevance of sphinx-apidoc to generating .html documents from those .rst files?

[stsewd]

The modindex or py-modindex is still missing there, not sure how apidoc works here, can you check if this happens in a new virtualenv executing the same steps that rtd does?

[stsewd]

The modindex or py-modindex is still missing there, not sure how apidoc works here, can you check if this happens in a new virtualenv executing the same steps that rtd does?

[mertyildiran]

@stsewd please look at this repository for example: https://github.com/goldsmith/Wikipedia/tree/master/docs/source

It does not have any modindex.rst file, py-modindex.rst file or anything like that but it has http://wikipedia.readthedocs.io/en/latest/py-modindex.html available in its documentation.

[mertyildiran]

@stsewd please look at this repository for example: https://github.com/goldsmith/Wikipedia/tree/master/docs/source

It does not have any modindex.rst file, py-modindex.rst file or anything like that but it has http://wikipedia.readthedocs.io/en/latest/py-modindex.html available in its documentation.

[mertyildiran]

@stsewd I realized that the build was actually failing due to some missing dependencies and/or post-install scripts(when I noticed the "View raw" link on Read the Docs):

WARNING: autodoc: failed to import module 'dragonfire.api'; the following exception was raised:
No module named 'nltk'
WARNING: autodoc: failed to import module 'dragonfire.arithmetic'; the following exception was raised:
No module named 'nltk'
WARNING: autodoc: failed to import module 'dragonfire.config'; the following exception was raised:
No module named 'nltk'
...

So after dealing some problems like excessive memory consumption, mocking out Python C extension, including Markdown into reStructuredText, etc. and after 23 commits/builds I finally achieved what I want:

DragonComputer/Dragonfire@67068f1

https://dragonfire.readthedocs.io/en/latest/py-modindex.html (Working 👍 )

Thanks for the help! 🏆

[mertyildiran]

@stsewd I realized that the build was actually failing due to some missing dependencies and/or post-install scripts(when I noticed the "View raw" link on Read the Docs):

WARNING: autodoc: failed to import module 'dragonfire.api'; the following exception was raised:
No module named 'nltk'
WARNING: autodoc: failed to import module 'dragonfire.arithmetic'; the following exception was raised:
No module named 'nltk'
WARNING: autodoc: failed to import module 'dragonfire.config'; the following exception was raised:
No module named 'nltk'
...

So after dealing some problems like excessive memory consumption, mocking out Python C extension, including Markdown into reStructuredText, etc. and after 23 commits/builds I finally achieved what I want:

DragonComputer/Dragonfire@67068f1

https://dragonfire.readthedocs.io/en/latest/py-modindex.html (Working 👍 )

Thanks for the help! 🏆