OK I followed your instructions with one exception.
When I ran sphinx, I have to point the root to my phoenix doc directory
Bacause of this, the make file was created there.
so when I ran the make, I used
M:\python\m-p\p\sphinx_env
λ pipenv --venv
C:\Users\CaptainKirk\.virtualenvs\sphinx_env-rCxgl-7y
M:\python\m-p\p\sphinx_env
λ which python
/c/Users/CaptainKirk/.virtualenvs/sphinx_env-rCxgl-7y/Scripts/python
M:\python\m-p\p\sphinx_env
λ M:\python\m-p\p\Phoenix\Phoenix-master\docs\make html > make.log 2> make.error
Ran OK, but a lot of warnings:
Error:
M:\python\m-p\p\sphinx_env
λ more make_error.log
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:1: WARNING: Problems with "include" directive path:
InputError: [Errno 2] No such file or directory: 'headings.inc'.
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:606: WARNING: Title underline too short.
:class:`wx.DC` Modifications
-------------------------
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:606: WARNING: Title underline too short.
:class:`wx.DC` Modifications
-------------------------
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:653: WARNING: Title underline too short.
:class:`wx.Window` Modifications
-----------------------------
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:653: WARNING: Title underline too short.
:class:`wx.Window` Modifications
-----------------------------
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:686: WARNING: Title underline too short.
:class:`wx.Sizer` Modifications
----------------------------
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:686: WARNING: Title underline too short.
:class:`wx.Sizer` Modifications
----------------------------
M:\python\m-p\p\Phoenix\Phoenix-master\docs\classic_vs_phoenix.rst:8: WARNING: Undefined substitution referenced: "phoenix_title".
M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\rest_substitutions\overviews\DocstringsGuidelines.rst:1: WARNING: Problems with "include" directive path:
InputError: [Errno 2] No such file or directory: 'sphinx/rest_substitutions/overviews/headings.inc'.
M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\rest_substitutions\overviews\DocstringsGuidelines.rst:10: WARNING: Undefined substitution referenced: "phoenix_title".
M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\rest_substitutions\overviews\Overviews.rst:1: WARNING: Problems with "include" directive path:
InputError: [Errno 2] No such file or directory: 'sphinx/rest_substitutions/overviews/headings.inc'.
M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\rest_substitutions\overviews\Overviews.rst:8: WARNING: Undefined substitution referenced: "phoenix_title".
M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\rest_substitutions\overviews\app_overview.rst:1: WARNING: Problems with "include" directive path:
InputError: [Errno 2] No such file or directory: 'sphinx/rest_substitutions/overviews/headings.inc'.
...
however the make log:
Output:
M:\python\m-p\p\sphinx_env
λ cat make.log
Running Sphinx v1.6.5
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 0 source files that are out of date
updating environment: 0 added, 42 changed, 0 removed
reading sources... [100%] sphinx/rest_substitutions/overviews/writing_non_english_applications
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] sphinx/rest_substitutions/overviews/writing_non_english_applications
generating indices... genindex
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, 552 warnings.
Build finished. The HTML pages are in _build\html.
The headings.inc (from warnings) file is referenced by a lot of folks on the web, but I couldn't find an answer
as to how to overcome this. I think there is something missing here (in the phoenix repository).
Were you actually able to build the phoenix doc without errors?
The html files are there:
M:\python\m-p\p\Phoenix\Phoenix-master\docs\_build\html
λ ls
MigrationGuide.html _sources/ _static/ classic_vs_phoenix.html genindex.html index.html objects.inv search.html searchindex.js sphinx/
M:\python\m-p\p\Phoenix\Phoenix-master\docs\_build\html\sphinx\rest_substitutions\overviews
λ ls
DocstringsGuidelines.html config_overview.html filesystem_overview.html internationalization.html sizers_overview.html validator_overview.html
Overviews.html dataobject_overview.html font_encodings.html listctrl_overview.html splitterwindow_overview.html window_deletion_overview.html
app_overview.html datetime_overview.html font_overview.html log_classes_overview.html standard_event_identifiers.html window_ids_overview.html
bitmap_overview.html dc_overview.html grid_overview.html printing_framework_overview.html stock_items.html window_sizing_overview.html
bookctrl_overview.html dialog_overview.html hello_world.html refcount_overview.html tipprovider_overview.html window_styles_overview.html
command_overview.html dnd_overview.html html_overview.html richtextctrl_overview.html toolbar_overview.html writing_non_english_applications.html
common_dialogs_overview.html events_overview.html index.html scrolling_overview.html treectrl_overview.html
and
M:\python\m-p\p\Phoenix\Phoenix-master\docs\_build\html\sphinx\rest_substitutions\tables
λ ls
wx.ArtProvider.1.html wx.ColourDatabase.1.html wx.Sizer.1.html wx.VScrolledWindow.1.html