Instalar mdBook

Descarga

mdBook es un programa que se puede descargar desde la página:

https://github.com/rust-lang/mdBook/releases

Tenemos opciones para:

• Windows x86_64
• Apple, en versión x86_64 y aarch64
• Linux, en versión x86_64 y aarch64

La descarga consiste en un archivo empaquetado en otro. Podemos extraer el contenido haciendo doble clic en el fichero descargado. Con esto obtenemos un ejecutable llamado mdbook que podemos mover a nuestra carpeta de proyectos.

En la carpeta de proyectos vamos a crear una subcarpeta llamada herramientas, donde colocaremos el archivo descargado. La organización será la siguiente:

proyectos/
  ├── libro1/
  ├── libro2/
  ├── libro3/
  │
  └── herramientas/
        └── mdbook

Verificar instalación

Abrimos el Terminal de comandos y nos situamos en la carpeta donde hemos dejado el programa, algo así como:

$ cd /Users/usuario/Documentos/Proyectos/herramientas

Ejecutamos mdBook preguntándole cual es la versión instalada:

$ mdbook --version

y deberíamos obtener un número de versión:

mdbook v0.5.2

¡Ojo! En sistemas tipo Linux o Mac, para ejecutar un programa, es necesario que su nombre vaya precedido por la carpeta donde se aloja. Tratándose de la carpeta actual, usamos el alias “.”

$ ./mdbook --version

Nota:

---

Como ya indiqué en la primera página, este cuaderno está orientado a usuarios que quieren desarrollar documentación en general, no a programadores Rust, para cuya documentación fue concebido mdBook originalmente.

Un programador de Rust haría la instalación descargando los programas originales (texto fuente) y compilándolos para obtener el programa final. Véase instrucciones en el manual de mdBook