Anatomía de un libro web
Formatos
mdBook está orientado principalmente a crear libros web en formato HTML, el estándar principal de las páginas que encontraremos en la red. Podemos obtener otros formatos, PDF, ePUB, etcétera, si descargamos e instalamos unos complementos llamados backends. Véase lista
Navegación
Un libro está formado por capítulos, y cada uno es una página web que se muestra por separado. El contenido de cada página suele estar formado por un párrafo que hace de título principal, con letra de mayor tamaño, títulos de secciones (en este cuaderno los mostramos subrayados) y párrafos de texto regular.
El panel lateral es la forma básica de acceder a cada capítulo. Podemos ajustar su tamaño arrastrando el borde con el ratón. El panel solo se muestra si la pantalla es suficientemente ancha. En particular, no se mostrará en dispositivos móviles de pantalla pequeña, siendo sustituido por un menú desplegable al pulsar sobre el icono de las tres barras
Al pie de página, o en los bordes laterales (dependiendo del ancho visualización) suele haber dos botones < > para ir al capítulo siguiente/anterior
Podemos pulsar sobre un párrafo de cabecera de sección para seleccionarla, desplazando el título a la parte superior de la pantalla. Ese párrafo de título será señalado con un símbolo », y en la barra de direcciones del navegador, veremos la URL completa, con el enlace a la sección.
La barra superior
La barra superior de cada página muestra el título del libro. Si desplazamos el contenido del capítulo hacia abajo, la barra se mantiene siempre visible, y pulsando sobre ella, se desplaza la página otra vez hacia el extremo superior.
La barra contiene unos botones de utilidad cuya presencia depende de la configuración de mdBook al generar el libro (podemos ocultar alguno de los botones). Pueden ser:
| Icono | Descripción |
|---|---|
| mostrar/ocultar el panel lateral | |
| selector de esquema de colores (el “tema”) | |
| abrir el cuadro de búsqueda de texto | |
| imprimir el libro completo | |
| enlace al repositorio donde se alojan los contenidos | |
| editar textos (si tenemos permiso para ello) |
Búsquedas
Pulsando en el icono de búsqueda en la barra superior, o usando las teclas / o S se abre una caja para introducir textos de búsqueda. A medida que tecleamos el texto a buscar, se va mostrando una lista de resultados.
Podemos pulsar con el ratón en alguna de las entradas de la lista para ir a esa página, o bien la tecla Esc para abandonar. También podemos usar las teclas de flecha ↑ ↓ para desplazarnos por la lista y pulsar enter para seleccionar el elemento resaltado.
Ayuda
Pulsando en la tecla ? se muestra un recuadro emergente con un resumen de teclas de atajo:
Press ← or → to navigate between chapters
Press S or / to search in the book
Press ? to show this help
Press Esc to hide this help
mdBook no cuenta con la opción de traducir este mensaje, pero en este cuaderno veremos como manipular el programa para que el texto se vea en español.