A Linguagem de Programação Rust

Esse repositório é uma tradução do livro "A linguagem de programação Rust". Você pode encontrar versão impressa (em inglês) em No Starch Press.

Você pode ler o livro de forma grátis online. Atenção, o livro pode ser entregue com a última versão estável, beta, ou instavel das versões do Rust. Os erros dessa versão já pode ter sido corrigida no repositório online.

Veja os lançamentos.

Requisitos

Esse livro também precisa do mdBook, preferencialmente a mesma versão usada pela linguagem Rust nesse arquivo. Use esse comando:

$ cargo install mdbook --locked --version <version_num>

Este livro também utiliza dois plugins mdbook que faz parte desse repositório. Se você não instalar, você irá receber avisos durante o build e o resultado do build não estara formatado conforme o esperado, mas você ainda poderá fazer o build. Para usar os plugins, utilize o comando:

$ cargo install --locked --path packages/mdbook-trpl --force

Inicializar e build

Para inicializar o mdbook execute

$ mdbook init

Para realizar o build, utilize o comando:

$ mdbook build

O arquivo será salvo na sub pasta book. Para conferir abra no seu navegador.

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 realizar teste:

$ cd packages/trpl
$ mdbook test --library-path packages/trpl/target/debug/deps

Contribuição

Adoraríamos receber a sua ajuda. Dê uma olhada em CONTRIBUTING.md para entender as formas de contribuição que estamos procurando.

Por esse livro ser impresso, e por querermos manter a versão online do livro o mais próximo da versão do livro, possa ser que a sua solicitação de issue ou pull request demore para ser aceita.

Além disso, nós temos feito uma extensão revisão para correção de erros. Se a sua issue ou pull request não está relacionada à correção de erros, talvez ela fique para a próxima grande revisão esperada para meses ou anos. Obrigado pela paciência! Confira, Edições do Rust.

Traduções

Gostamos da ajuda que recebemos para a tradução desse livro. Veja a etiqueta Translations para participar de uma tradução que está ocorrendo. Abra uma issue para começar uma nova tradução. Nós estamos aguardando mdbook support para multiplas linguagens antes de unir, mas sinta-se livre para começar!

Gramática

Para procurar nos arquivos erros de gramática, você pode usar o comando spellcheck.sh disponível na pasta ci. É preciso um dicionário válido que pode ser encontrado em ci/dictionary.txt. Se o script produzir um falso - positivo você precisa usar BTreeMap no script considerado inválido e precisa adicionar a palavra ao ci/dictionary.txt (mantenha ordenado por consistencia).