Servidor de cambios

Introducir contenidos con el editor y tener que esperar al proceso de conversión para ver los resultados finales puede ser algo frustrante. Pero existe un recurso alternativo, ejecutar mdBook en modo servidor. En el escritorio tendremos tres ventanas:

• la del editor de textos, donde estamos introduciendo los contenidos
• la ventana del Terminal de comandos, donde dejamos mdBook en ejecución permanente, atento a los cambios en los ficheros fuente
• la ventana del navegador web, donde mdBook va refrescando la futura página web a medida que guardamos los archivos.

Vamos a crear un script en la carpeta acciones para dejar a mdbook ejecutándose en modo servidor:

cd /Users/usuario/Documentos/Proyectos/miProyecto
../herramientas/mdbook serve --dest-dir temporal --open

Esto nos situa en la carpeta de proyecto (comando cd) y ejecuta mdbook con el comando serve. Le pasamos dos argumentos adicionales:

• temporal es el nombre de la carpeta de trabajo que vamos a crear con los contenidos provisionales ( dest-dir significa directorio de destino).

• el argumento --open abre la visualización de resultados en el navegador web, en una pestaña nueva.

Al ejecutarse este script, se abre la ventana de Terminal con los siguientes mensajes:

INFO Book building has started
INFO Running the html backend
INFO HTML book written to `/Users/usuario/Documentos/Proyectos/miProyecto/temporal`
INFO Serving on: http://localhost:3000
INFO Opening web browser
INFO Watching for changes...

… y seguidamente se abre el navegador web. Cada vez que modifiquemos un archivo fuente, mdBook actualizará el navegador. El proceso se detiene cerrando la ventana de Terminal (o seleccionándola y pulsando control+C)