2018-01-09 01:23:15 +00:00
|
|
|
Welcome to Read the Docs
|
2011-06-30 03:20:13 +00:00
|
|
|
========================
|
|
|
|
|
2014-08-14 22:09:51 +00:00
|
|
|
|build-status| |docs|
|
2014-04-14 18:10:58 +00:00
|
|
|
|
2014-04-14 16:29:47 +00:00
|
|
|
Purpose
|
|
|
|
-------
|
|
|
|
|
2013-04-22 06:08:30 +00:00
|
|
|
`Read the Docs`_ hosts documentation for the open source community. It supports
|
|
|
|
Sphinx_ docs written with reStructuredText_, and can pull from your Subversion_,
|
|
|
|
Bazaar_, Git_, and Mercurial_ repositories.
|
2017-03-27 21:58:37 +00:00
|
|
|
Then we build documentation and host it for you.
|
|
|
|
Think of it as *Continuous Documentation*.
|
2011-06-30 03:20:13 +00:00
|
|
|
|
|
|
|
.. _Read the docs: http://readthedocs.org/
|
|
|
|
.. _Sphinx: http://sphinx.pocoo.org/
|
|
|
|
.. _reStructuredText: http://sphinx.pocoo.org/rest.html
|
|
|
|
.. _Subversion: http://subversion.tigris.org/
|
|
|
|
.. _Bazaar: http://bazaar.canonical.com/
|
|
|
|
.. _Git: http://git-scm.com/
|
2017-02-28 11:36:03 +00:00
|
|
|
.. _Mercurial: https://www.mercurial-scm.org/
|
2011-06-30 03:20:13 +00:00
|
|
|
|
2014-06-01 23:08:37 +00:00
|
|
|
Documentation for RTD
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
You will find complete documentation for setting up your project at `the Read
|
|
|
|
the Docs site`_.
|
|
|
|
|
2016-04-27 23:14:36 +00:00
|
|
|
.. _the Read the Docs site: https://docs.readthedocs.io/
|
2014-06-01 23:08:37 +00:00
|
|
|
|
2016-02-22 15:10:00 +00:00
|
|
|
Contributing
|
|
|
|
------------
|
|
|
|
|
2017-09-28 20:47:26 +00:00
|
|
|
You can find information about contributing to Read the Docs at our `Contribution page <http://docs.readthedocs.io/en/latest/contribute.html>`_.
|
2016-02-22 15:10:00 +00:00
|
|
|
|
2014-12-08 01:38:13 +00:00
|
|
|
Quickstart for GitHub-Hosted Projects
|
|
|
|
-------------------------------------
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2014-12-08 01:38:13 +00:00
|
|
|
By the end of this quickstart, you will have a new project automatically updated
|
|
|
|
when you push to GitHub.
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2014-12-08 01:38:13 +00:00
|
|
|
#. Create an account on `Read the Docs`_. You will get an email verifying your
|
2014-04-14 16:29:47 +00:00
|
|
|
email address which you should accept within 7 days.
|
|
|
|
|
2018-03-25 02:39:41 +00:00
|
|
|
#. Log in and click on "Import a Project".
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2018-03-25 02:39:41 +00:00
|
|
|
#. Click "Connect to GitHub" in order to connect your account's repositories to GitHub.
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2018-03-25 02:39:41 +00:00
|
|
|
#. When prompted on GitHub, give access to your account.
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2018-03-25 02:39:41 +00:00
|
|
|
#. Click "Import a Repository" and select any desired repository.
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2018-03-25 02:39:41 +00:00
|
|
|
#. Change any information if desired and click "Next".
|
2014-04-14 16:29:47 +00:00
|
|
|
|
2014-12-08 01:38:13 +00:00
|
|
|
#. All done. Commit away and your project will auto-update.
|
2014-04-14 16:29:47 +00:00
|
|
|
|
|
|
|
|
2014-10-24 12:01:14 +00:00
|
|
|
.. |build-status| image:: https://img.shields.io/travis/rtfd/readthedocs.org.svg?style=flat
|
2014-08-08 15:23:14 +00:00
|
|
|
:alt: build status
|
2014-08-08 15:16:27 +00:00
|
|
|
:scale: 100%
|
|
|
|
:target: https://travis-ci.org/rtfd/readthedocs.org
|
|
|
|
|
|
|
|
.. |docs| image:: https://readthedocs.org/projects/docs/badge/?version=latest
|
2014-08-14 22:11:03 +00:00
|
|
|
:alt: Documentation Status
|
2014-08-08 15:16:27 +00:00
|
|
|
:scale: 100%
|
2016-04-27 23:14:36 +00:00
|
|
|
:target: https://docs.readthedocs.io/en/latest/?badge=latest
|
2016-05-03 21:16:59 +00:00
|
|
|
|
2017-09-07 20:41:05 +00:00
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
2017-09-28 20:47:26 +00:00
|
|
|
`MIT`_ © 2010-2017 Read the Docs, Inc & contributors
|
|
|
|
|
2018-01-09 01:23:15 +00:00
|
|
|
.. _MIT: LICENSE
|