如何自己創建readthedoc

1. pip install sphinx

2. cd /path/to/project

3. mkdir docs

4. cd docs

5. sphinx-quickstart

6. create new source.rst file

7. edit index.rst:
   

8. make html

9. now we can find new title is added:
   

10. now we change the style:
    get into the source/conf.py

import sphinx_rtd_theme
html_theme = "sphinx_rtd_theme"
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

make html

11. now we have a new style:
    

12. done

if you want to use markdown:

create a markdown Start.md file
then use this to convert md into h5:
open the command line and input:

myst-docutils-html5 --stylesheet= Start.md

then you get a html file

then include this md into the index.rst

another way:

1. do this:

pip install recommonmark

2. 然后更改conf.py:

from recommonmark.parser import CommonMarkParser
source_parsers = {
    '.md': CommonMarkParser,
}
source_suffix = ['.rst', '.md']

3. make html