sphinx
sphinx copied to clipboard
sphinx-doc
make html not working
Describe the bug
I was able to create all the rst files, changed the conf file, added modules in index file . But when I do .\make.bat html nothing happens. Doesn't give any error or produces any file in build. I am vscode 1.90, python 3.11.
How to Reproduce
Environment Information
vscode 1.90, python 3.11. terminal: window powershell
Sphinx extensions
No response
Additional context
No response
I advise not using PowerShell terminal. Try CMD as that's what make.bat was originally written for. There has been a pull request to convert the makefile to a PowerShell script but the PR was never completed.
Also, those error messages should be posted as text so they can be found using search, just posting screenshots stops future readers from finding this thread. I think triagers should close this issue for that reason alone, see Why should I not upload images of code/data/errors?
@DarureTej if using PowerShell, could you try running:
> Set-Item env:SPHINXOPTS "-D language=de"
> .\make.bat html
We mention the Set-Item step for PowerShell in some of our 'advanced usage' documentation, but not elsewhere as far as I can tell. That might be something we can improve.
In rapid hindsight: that probably shouldn't make a difference at all - there should be a default language configuration, so Set-Item shouldn't be needed.
Unfortunately I don't have access to a system with PowerShell on it at the moment, so my ability to help here may be limited. One thing that I would be curious about is what kind of output running the sphinx-build command from the shell (without any arguments) does.
We'd need more information to be able to figure out what happened in this case; if you still believe there's a bug that we should investigate, please let us know. Information about available sources of help for Sphinx can be found on the project's website here: https://www.sphinx-doc.org/en/master/internals/contributing.html#get-help