Read the Docs   &&  reStructuredText (.rst)  && markdown

1. github master 分支，创建 docs/index.rst

2. 使用 .rst 语法，设置索引的 title,index,links,url(html..)

Home Page of Blogs Docs

Original Authors

* xgqfrms

/home/docs/checkouts/readthedocs.org/user_builds/xgqfrms-blogs/checkouts/latest/index.rst

******

Welcome to Read the Docs

This is an autogenerated index file.

Please create a
/home/docs/checkouts/readthedocs.org/user_builds/xgqfrms-blogs/checkouts/latest/index.rst
or
/home/docs/checkouts/readthedocs.org/user_builds/xgqfrms-blogs/checkouts/latest/README.rst file with your own content.

If you want to use another markup, choose a different builder in your settings.

Contents:

.. toctree::
:maxdepth: 2
:caption: User Documentation

getting-started
howitworks
websecurity

.. toctree::
:maxdepth: 2
:caption: Configuration

config-examples
authenticators
spawners
troubleshooting

.. toctree::
:maxdepth: 1
:caption: Developer Documentation

api/index

.. toctree::
:maxdepth: 1
:caption: Community documentation

.. toctree::
:maxdepth: 2
:caption: About JupyterHub

changelog

.. toctree::
:maxdepth: 1
:caption: Questions? Suggestions?

xgqfrms mailing list https://groups.google.com/forum/#!forum/xgqfrms
xgqfrms website https://xgqfrms.xyz
Stack Overflow - xgqfrms https://stackoverflow.com/questions/tagged/xgqfrms
Stack Overflow - xgqfrms-notebook https://stackoverflow.com/questions/tagged/xgqfrms-notebook

3. coming soon…

1

1

1

readme

• [Edit it on GitHub](https://github.com/xgqfrms/blogs/blob/master/index.rst)
• [Share URL](https://readthedocs.org/projects/xgqfrms-blogs/)
• [Read it on Read the Docs](http://xgqfrms-blogs.readthedocs.io/en/latest/)

[reStructuredText(.rst)语法规则快速入门](http://blog.useasp.net/archive/2014/09/05/rst-file-restructuredtext-markup-syntax-quikstart.aspx)

./master/docs/index.rst 优先级高于 ./master/index.rst

https://readthedocs.org/dashboard/

https://github.com/xgqfrms/blogs/tree/master/docs

1

1

1

1