Este repositorio contiene la fuente del libro "El Lenguaje de Programación Rust".

El libro está disponible en forma de árbol muerto de No Starch Press.

También puedes leer el libro gratis en línea. Por favor, vea el libro como se envía con la última versión estable, beta o nightly de Rust. Tenga en cuenta que los problemas en esas versiones pueden haber sido corregidos en este repositorio ya, ya que esas versiones se actualizan con menos frecuencia.

Ver las versiones para descargar solo el código de todos los listados de código que aparecen en el libro.

Construir el libro requiere mdBook, idealmente la misma versión que rust-lang/rust usa en este archivo. Para obtenerlo:

$ cargo install mdbook --version <version_num>

Para construir el libro, escriba:

$ mdbook build

La salida estará en el subdirectorio book. Para comprobarlo, ábralo en su navegador web.

Firefox:

$ firefox book/index.html                       # Linux
$ open -a "Firefox" book/index.html             # OS X
$ Start-Process "firefox.exe" .\book\index.html # Windows (PowerShell)
$ start firefox.exe .\book\index.html           # Windows (Cmd)

Chrome:

$ google-chrome book/index.html                 # Linux
$ open -a "Google Chrome" book/index.html       # OS X
$ Start-Process "chrome.exe" .\book\index.html  # Windows (PowerShell)
$ start chrome.exe .\book\index.html            # Windows (Cmd)

Para ejecutar las pruebas:

$ mdbook test

¡Nos encantaría tu ayuda! Por favor, vea CONTRIBUTING.md para aprender sobre los tipos de contribuciones que estamos buscando.

Siendo el libro impreso, y porque queremos mantener la versión en línea del libro cerca de la versión impresa cuando sea posible, puede tomar más tiempo del que está acostumbrado para que abordemos su problema o solicitud de extracción.

Hasta ahora, hemos estado haciendo una revisión más grande para coincidir con Rust Editions. Entre esas revisiones más grandes, solo corregiremos errores. Si su problema o solicitud de extracción no está estrictamente corrigiendo un error, podría sentarse hasta la próxima vez que estemos trabajando en una revisión grande: espere en el orden de meses o años. ¡Gracias por su paciencia!

¡Nos encantaría ayudar a traducir el libro! Consulte la etiqueta Translations para unirse a los esfuerzos que actualmente están en progreso. ¡Abra un nuevo problema para comenzar a trabajar en un nuevo idioma! Estamos esperando el [soporte mdbook] para múltiples idiomas antes de fusionar cualquiera, ¡pero siéntase libre de comenzar!

Para escanear los archivos fuente en busca de errores ortográficos, puede usar el script spellcheck.sh disponible en el directorio ci. Necesita un diccionario de palabras válidas, que se proporciona en ci/dictionary.txt. Si el script produce un falso positivo (digamos, usó la palabra BTreeMap que el script considera inválida), debe agregar esta palabra a ci/dictionary.txt (mantenga el orden ordenado para la consistencia).