Buildtools installation on python 3.6.4

[snippsat]

Messing it up
Now you run pipenv inside a virtual environment.
pipenv is doing it all,so do not use it with build in venv.

Make a folder the normal way no use of venv,cd into that folder.

pipenv install Sphinx

Now activate folder.
You now inside the virtual environment,that was created with first command.

pipenv shell

Test with pip -V

Now test that that Sphinx work,before taking in Phoenix.

sphinx-quickstart 
make html

[Larz60+]

I am really starting to feel stupid, and don't see where I am going wrong:

M:\python\m-p\p\Phoenix
(Phoenix) λ pipenv install Sphinx
Creating a Pipfile for this project…
Installing Sphinx…
Collecting Sphinx
  Using cached Sphinx-1.6.5-py2.py3-none-any.whl
Collecting six>=1.5 (from Sphinx)
  Using cached six-1.11.0-py2.py3-none-any.whl
Requirement already satisfied: setuptools in m:\python\m-p\p\phoenix\lib\site-packages (from Sphinx)
Collecting requests>=2.0.0 (from Sphinx)
  Using cached requests-2.18.4-py2.py3-none-any.whl
Collecting sphinxcontrib-websupport (from Sphinx)
  Using cached sphinxcontrib_websupport-1.0.1-py2.py3-none-any.whl
Collecting imagesize (from Sphinx)
  Using cached imagesize-0.7.1-py2.py3-none-any.whl
Collecting docutils>=0.11 (from Sphinx)
  Using cached docutils-0.14-py3-none-any.whl
Collecting colorama>=0.3.5; sys_platform == "win32" (from Sphinx)
  Using cached colorama-0.3.9-py2.py3-none-any.whl
Collecting Pygments>=2.0 (from Sphinx)
  Using cached Pygments-2.2.0-py2.py3-none-any.whl
Collecting snowballstemmer>=1.1 (from Sphinx)
  Using cached snowballstemmer-1.2.1-py2.py3-none-any.whl
Collecting alabaster<0.8,>=0.7 (from Sphinx)
  Using cached alabaster-0.7.10-py2.py3-none-any.whl
Collecting Jinja2>=2.3 (from Sphinx)
  Using cached Jinja2-2.10-py2.py3-none-any.whl
Collecting babel!=2.0,>=1.3 (from Sphinx)
  Using cached Babel-2.5.1-py2.py3-none-any.whl
Collecting idna<2.7,>=2.5 (from requests>=2.0.0->Sphinx)
  Using cached idna-2.6-py2.py3-none-any.whl
Collecting certifi>=2017.4.17 (from requests>=2.0.0->Sphinx)
  Using cached certifi-2017.11.5-py2.py3-none-any.whl
Collecting urllib3<1.23,>=1.21.1 (from requests>=2.0.0->Sphinx)
  Using cached urllib3-1.22-py2.py3-none-any.whl
Collecting chardet<3.1.0,>=3.0.2 (from requests>=2.0.0->Sphinx)
  Using cached chardet-3.0.4-py2.py3-none-any.whl
Collecting MarkupSafe>=0.23 (from Jinja2>=2.3->Sphinx)
Collecting pytz>=0a (from babel!=2.0,>=1.3->Sphinx)
  Using cached pytz-2017.3-py2.py3-none-any.whl
Installing collected packages: six, idna, certifi, urllib3, chardet, requests, sphinxcontrib-websupport, imagesize, docutils, colorama, Pygments, snowballstemmer, alabaster, MarkupSafe, Jinja2, pytz, babel, Sphinx
Successfully installed Jinja2-2.10 MarkupSafe-1.0 Pygments-2.2.0 Sphinx-1.6.5 alabaster-0.7.10 babel-2.5.1 certifi-2017.11.5 chardet-3.0.4 colorama-0.3.9 docutils-0.14 idna-2.6 imagesize-0.7.1 pytz-2017.3 requests-2.18.4 six-1.11.0 snowballstemmer-1.2.1 sphinxcontrib-websupport-1.0.1 urllib3-1.22

Adding Sphinx to Pipfile's [packages]…
Locking [dev-packages] dependencies…
Locking [packages] dependencies…
Updated Pipfile.lock (e6231b)!

M:\python\m-p\p\Phoenix
(Phoenix) λ ls
Include/  Lib/  Phoenix-master/  Pipfile  Pipfile.lock  pip-selfcheck.json  pyvenv.cfg  Scripts/

M:\python\m-p\p\Phoenix
(Phoenix) λ cd Phoenix-master\

M:\python\m-p\p\Phoenix\Phoenix-master
(Phoenix) λ cd docs

M:\python\m-p\p\Phoenix\Phoenix-master\docs
(Phoenix) λ cd sphinx\

M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx
(Phoenix) λ ls
_downloads/  _templates/      conf.py               make.bat  phoenix_theme/
_static/     availability.py  itemToModuleMap.json  Makefile  rest_substitutions/

M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx
(Phoenix) λ sphinx-quickstart
Welcome to the Sphinx 1.6.5 quickstart utility.

Please enter values for the following settings (just press Enter to
accept a default value, if one is given in brackets).

Enter the root path for documentation.
> Root path for the documentation [.]: html

You have two options for placing the build directory for Sphinx output.
Either, you use a directory "_build" within the root path, or you separate
"source" and "build" directories within the root path.
> Separate source and build directories (y/n) [n]:

Inside the root directory, two more directories will be created; "_templates"
for custom HTML templates and "_static" for custom stylesheets and other static
files. You can enter another prefix (such as ".") to replace the underscore.
> Name prefix for templates and static dir [_]:

The project name will occur in several places in the built documentation.
> Project name: Phoenix 4.0.0b2
> Author name(s): Phoenix 4.0.0b2

Sphinx has the notion of a "version" and a "release" for the
software. Each version can have multiple releases. For example, for
Python the version is something like 2.5 or 3.0, while the release is
something like 2.5.1 or 3.0a1.  If you don't need this dual structure,
just set both to the same value.
> Project version []: 4.0.0b2
> Project release [4.0.0b2]: 4.0.0b2

If the documents are to be written in a language other than English,
you can select a language here by its language code. Sphinx will then
translate text that it generates into that language.

For a list of supported codes, see
http://sphinx-doc.org/config.html#confval-language.
> Project language [en]:

The file name suffix for source files. Commonly, this is either ".txt"
or ".rst".  Only files with this suffix are considered documents.
> Source file suffix [.rst]:

One document is special in that it is considered the top node of the
"contents tree", that is, it is the root of the hierarchical structure
of the documents. Normally, this is "index", but if your "index"
document is a custom template, you can also set this to another filename.
> Name of your master document (without suffix) [index]:

Sphinx can also add configuration for epub output:
> Do you want to use the epub builder (y/n) [n]:

Please indicate if you want to use one of the following Sphinx extensions:
> autodoc: automatically insert docstrings from modules (y/n) [n]:
> doctest: automatically test code snippets in doctest blocks (y/n) [n]:
> intersphinx: link between Sphinx documentation of different projects (y/n) [n]:
> todo: write "todo" entries that can be shown or hidden on build (y/n) [n]:
> coverage: checks for documentation coverage (y/n) [n]:
> imgmath: include math, rendered as PNG or SVG images (y/n) [n]:
> mathjax: include math, rendered in the browser by MathJax (y/n) [n]:
> ifconfig: conditional inclusion of content based on config values (y/n) [n]:
> viewcode: include links to the source code of documented Python objects (y/n) [n]:
> githubpages: create .nojekyll file to publish the document on GitHub pages (y/n) [n]:

A Makefile and a Windows command file can be generated for you so that you
only have to run e.g. `make html' instead of invoking sphinx-build
directly.
> Create Makefile? (y/n) [y]:
> Create Windows command file? (y/n) [y]:

Creating file html\conf.py.
Creating file html\index.rst.
Creating file html\Makefile.
Creating file html\make.bat.

Finished: An initial directory structure has been created.

You should now populate your master file html\index.rst and create other documentation
source files. Use the Makefile to build the docs, like so:
   make builder
where "builder" is one of the supported builders, e.g. html, latex or linkcheck.


M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx
(Phoenix) λ make html
Running Sphinx v1.6.5
making output directory...

Exception occurred:
  File "conf.py", line 60, in <module>
    from buildtools.config  import Config
ModuleNotFoundError: No module named 'buildtools'
The full traceback has been saved in C:\Users\CAPTAI~1\AppData\Local\Temp\sphinx-err-p0yr2trk.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx
(Phoenix) λ

[Larz60+]

hold on a minute, I forgot to edit conf.py...
The step I was missing was to cd to html after running sphinx

M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\html
(Phoenix) λ make html
Running Sphinx v1.6.5
making output directory...
loading pickled environment... not yet created
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: 1 added, 0 changed, 0 removed
reading sources... [100%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] index
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.

Build finished. The HTML pages are in _build\html.

M:\python\m-p\p\Phoenix\Phoenix-master\docs\sphinx\html
(Phoenix) λ

Thank you for the very dedicated (and annoying (for you)) walkthrough!

[snippsat]

Still doing it wrong.
There should be no (Phoenix) then you using is build in venv.
Here from start in cmder.

C:\1
# Make a folder
λ mkdir sphinx_env
C:\1
λ cd sphinx_env

# Now install and create virtualenv
C:\1\sphinx_env
λ pipenv install Sphinx
Creating a virtualenv for this project…
Using base prefix 'c:\\python36'
.........

Adding Sphinx to Pipfile's [packages]…
Locking [dev-packages] dependencies…
Locking [packages] dependencies…
Updated Pipfile.lock (0b3f5f)!

# Now Activate folder
C:\1\sphinx_env
λ pipenv shell
Launching subshell in virtual environment. Type 'exit' to return.

# Can now test that folder is active
C:\1\sphinx_env
λ pipenv --venv
C:\Users\Tom\.virtualenvs\sphinx_env-VX9zYBMK
λ which python
/c/Users/Tom/.virtualenvs/sphinx_env-VX9zYBMK/Scripts/python

# Now run sphinx
C:\1\sphinx_env
λ sphinx-quickstart
Welcome to the Sphinx 1.6.5 quickstart utility.
..............

C:\1\sphinx_env
λ make html
Running Sphinx v1.6.5
making output directory...
loading pickled environment... not yet created
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: 1 added, 0 changed, 0 removed
reading sources... [100%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] index
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.

Build finished. The HTML pages are in _build\html.

C:\1\sphinx_env
λ

[Larz60+]

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