2014-01-03 21:18:18 +00:00
|
|
|
Single Version Documentation
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
Single Version Documentation lets you serve your docs at a root domain.
|
2014-01-04 19:47:50 +00:00
|
|
|
By default, all documentation served by Read the Docs has a root of ``/<language>/<version>/``.
|
|
|
|
But, if you enable the "Single Version" option for a project, its documentation will instead be served at ``/``.
|
2014-01-03 21:18:18 +00:00
|
|
|
|
|
|
|
.. warning:: This means you can't have translations or multiple versions for your documentation.
|
|
|
|
|
2014-01-06 17:58:07 +00:00
|
|
|
You can see a live example of this at http://www.contribution-guide.org
|
2014-01-06 17:55:35 +00:00
|
|
|
|
2014-01-03 21:18:18 +00:00
|
|
|
Enabling
|
2014-01-18 14:10:25 +00:00
|
|
|
~~~~~~~~
|
2014-01-03 21:18:18 +00:00
|
|
|
|
2019-01-23 12:03:21 +00:00
|
|
|
You can toggle the "Single Version" option on or off for your project in the Project Admin page.
|
|
|
|
Check your :guilabel:`dashboard` for a list of your projects.
|
2014-01-03 21:18:18 +00:00
|
|
|
|
|
|
|
Effects
|
2014-01-18 14:10:25 +00:00
|
|
|
~~~~~~~
|
2014-01-03 21:18:18 +00:00
|
|
|
|
2019-01-23 12:03:21 +00:00
|
|
|
Links generated on Read the Docs will now point to the proper URL. For example,
|
|
|
|
if pip was set as a "Single Version" project, then links to its documentation would point to
|
|
|
|
``http://pip.readthedocs.io/`` rather than the default ``http://pip.readthedocs.io/en/latest/``.
|
2014-01-03 21:18:18 +00:00
|
|
|
|
2019-01-23 12:03:21 +00:00
|
|
|
Documentation at ``/<language>/<default_version>/`` will still be served for backwards compatibility reasons.
|
|
|
|
However, our usage of :doc:`canonical` should stop these from being indexed by Google.
|
2014-01-03 21:18:18 +00:00
|
|
|
|
|
|
|
.. _dashboard: https://readthedocs.org/dashboard/
|