Personalizando dominio para libro en Read The Docs
Publicado: 2021-06-13Para esta guía necesitas tres cosas:
- Un dominio en Internet.
- Un libro escrito en Sphinx.
- Un repositorio público en GitHub donde resida el libro del punto 2.
Suponiendo que tienes todos los ingredientes, podemos seguir la guía de Read The Docs para la presonalización del dominio.
En el caso de querer agregar un subdominio, como http://rst.ramoscarlos.com, hacemos lo siguiente:
- Configurar un nuevo registro
CNAME
en tu DNS que apunte areadthedocs.io
. Es decir:- Tipo: CNAME
- Nombre: rst
- Destino: readthedocs.io
- Luego, ir a la administración de tu proyecto en Read The Docs, en el boton
Admin
. - De ahí, escoger
Domains
. - Agregar la URL a utilizar para la documentación. En este caso, http://rst.ramoscarlos.com. Posteriormente, dar clic en
Add
.
Y listo. Algunas veces, se tarda en propagar la información y en resolver la página. No obstante, después de pasado un tiempo tu subdominio apuntará a tu libro. Por ejemplo, el subdominio registrado de http://rst.ramoscarlos.com resuelve a https://guia-de-restructuredtext.readthedocs.io/es/latest/.