Как перенаправить веб-страницы readthedocs на другой сайт

Question

Мы начали работу с документами нашего проекта на сайте readthedocs (скажем http://abc.readthedocs.org). По разным причинам мы перешли на наши собственные веб-серверы с новым доменом (http://abc.io).

Мы хотим свести http://abc.readthedocs.org изящно, чтобы наша проектная документация не была разбита по всему Интернету.

Один из способов, по нашему мнению, состоит в том, чтобы иметь «переадресацию» со всех страниц с префиксом (http://abc.readthedocs.org) до (http://abc.io).

Но я не вижу никаких параметров перенаправления на сайте readthedocs, который перенаправляет на совершенно новый домен. Readthedocs разрешает перенаправление только на разных страницах в одном домене.

Любые указатели на то, как я могу продолжить, были бы очень полезными.

Answer 1

Я добавил следующий раздел моей index.rst:

.. raw:: html 

    <script type="text/javascript"> 
    if (String(window.location).indexOf("readthedocs") !== -1) { 
     window.alert('The documentation has moved. I will redirect you to the new location.'); 
     window.location.replace('http://cosmo-docs.phys.ethz.ch/cosmoHammer'); 
    } 
    </script> 

Answer 2

На ReadTheDocs странице администратора, то «Точная Перенаправление» форма перенаправления позволяет другие домены в поле «в URL». Но это только, кажется, перенаправляет одну страницу за правило. То есть для этого требуется «Точное» совпадение. Я надеялся на some mod_rewrite магию, используя (.*) и $1. Но это не настроено.

Другая идея, которая работает (но неуклюжая), заключается в создании временного репозитория с папкой документов, в которой используется уценка. Index.md файл может состоять из обновления:

<meta http-equiv="refresh" content="0; URL=https://new.location">` 

Вы также можете добавить HTML с прямой ссылкой на случай, если обновление не работает.
conf.py файл может быть:

from recommonmark.parser import CommonMarkParser 

source_parsers = {'.md': CommonMarkParser} 

source_suffix = ['.md'] 
master_doc = 'index' 

Зафиксируйте этот репозиторий в GitHub (или другой хост) и изменить URL проекта для вашего проекта РТД на этот временный репозиторий. Вы можете создавать теги для временных репозиториев. в соответствии с данными вашего фактического хранилища. Затем убедитесь, что ReadTheDocs строит каждую версию. Если все пойдет хорошо, домашние страницы каждой версии будут перенаправлены туда, где их обновление отправляет.

Было бы неплохо, если бы перенаправления, доступные на странице администратора проекта, позволяли перенаправлять префиксы другим доменам.