Acceso al repositorio GitHub

Si acudamos al manual oficial de mdBook, veremos que en la barra superior, en la esquina derecha, tenemos dos iconos que todavía no hemos examinado:

• es un enlace al repositorio donde se alojan los contenidos
• permite acceso para editar textos (si tenemos permiso para ello)

Considerando que no vamos a editar los archivos en remoto, podemos de todas formas permitir el acceso al repositorio si lo activamos en el archivo de configuración book.toml, indicando la URL:

[output.html]

git-repository-url = "https://github.com/usuario/repositorio"
git-repository-icon = "fab-github"

Ya hemos visto que los iconos se toman de Fontawesome. Haciendo una búsqueda en su página web, se muestra la forma de insertar el icono en una página HTML. Por ejemplo:

  <i class="fa-brands fa-github"></i>

Si no indicamos nada, se toma por defecto fab-github, lo que muestra el icono de GitHub. ¿Que pasa si no usamos GitHub? Otra opción es fas-code-fork que muestra el icono .

Nota: el nombre de la clase debe comenzar por fa- para iconos estándar, fas- para iconos sólidos, o fab- para iconos brand.