2 years ago
#66078

Willy
Sphinx: "man_pages" config value references unknown document <filename>
I am a beginner so maybe this question sounds stupid.
Anyway, I have a make.bat file which you can pass in the builder name to use and it invokes below command:
set SPHINXBUILD=sphinx-build
set SOURCEDIR=source
set BUILDDIR=build
%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
So when I type:
make.bat man
...it is executed and at the end it says:
The manual pages are in build\man.
...but it seems it is not working properly since build\man folder is empty. Also a lot of warning messages are comming up:
WARNING: "man_pages" config value references unknown document man\filename
I have a directory called man which contains a lot of filename.rst files.
So why man pages are not being generated within build\man folder?
Additional info:
In conf.py I have set man_pages as below:
man_pages = [
(str(fn.parent / fn.stem), fn.stem, '', '', '1')
for fn in pathlib.Path('man').glob('*.rst')
]
Note: If I type make.bat html it works ok and all the content is generated within build\html folder.
python
python-sphinx
pathlib
0 Answers
Your Answer