Personalizando dominio para libro en Read The Docs

Publicado: 2021-06-13

Para esta guía necesitas tres cosas:

  1. Un dominio en Internet.
  2. Un libro escrito en Sphinx.
  3. 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:

  1. Configurar un nuevo registro CNAME en tu DNS que apunte a readthedocs.io. Es decir:
    • Tipo: CNAME
    • Nombre: rst
    • Destino: readthedocs.io
  2. Luego, ir a la administración de tu proyecto en Read The Docs, en el boton Admin.
  3. De ahí, escoger Domains.
  4. 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/.

¿Tienes algún comentario?

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *