This article shows what dependencies are required by different features.
Install Python for Most Features¶
reStructuredText is a technology created by Python community, so most of the toolchain is built upon Python. It is very important to install Python in advance.
Download python version 3.5 or above (old versions might work, but no guarantee).
You can refer to Python official page to learn which versions should not be used.
Latest steps on how to install Python and Sphinx, please refer to this article.
Once Python is installed, make it available to this extension via either option,
Option 1: Add Python to system path.
If you are installing on Windows, ensure both the Python install directory and the Python scripts directory have been added to your
PATHenvironment variable. For example, if you install Python into the
c:\python34directory, you can add
Option 2: Use VSCode setting
python.pythonPathto tell where to locate Python.
It is recommended that you install the Python extension by Microsoft. It really makes configuring Python environment easier for users in this approach.
Once you have that Python extension installed, open
conf.pyin VSCode. The Python extension shows an extra button in the status bar from where you can select which Python installation to use.
Python virtualenv is supported, but its setup is complex and not documented here yet.
Install DocUtils or Sphinx as Live Previewer¶
Live preview requires either DocUtils or Sphinx to be installed in advance, as
rendering engine to generate the HTML page for preview. The selection of
rendering engine and Sphinx
conf.py files can be made by clicking the
status button. Please refer to Configuration for details.
Install DocUtls by opening a command prompt and running the following Python command,
pip install docutils
If you prefer Sphinx based preview, then this step is optional.
Install Sphinx by opening a command prompt and running the following Python command,
pip install sphinx sphinx-autobuild
This operation might take a few minutes to complete.
If you prefer DocUtils based preview, then this step is optional.
Some Sphinx themes require their own Python packages to be installed. You should check the documentation of the themes you use so as to know which packages to install, or the preview error page contains the actual package name which is missing.
Install Doc8 or RstCheck as Linter¶
Linting support can use the doc8 or rstcheck engine.
doc8to enable linter support.
pip install doc8
If you prefer not to use doc8, then this step is optional.
rstcheckto enable linter support.
pip install rstcheck
If you prefer not to use rstcheck, then this step is optional.