README.md

A Linguagem de Programação Rust

Este repositório contém o código-fonte do livro "A Linguagem de Programação Rust".

Este livro está disponível na forma de árvore morta pela No Starch Press.

Você também pode ler o livro gratuitamente online. Por favor veja o livro assim como incluído com as versões estável, beta e nightly de Rust. Esteja ciente de que problemas nessas versões podem já ter sido corrigidas neste repositório, dado que essas versões são atualizadas menos frequentemente.

Requisitos

Construir o livro requer o mdBook. Idealmente a mesma versão 0.3.x que rust-lang/rust usa nesse arquivo. Para obtê-lo:

$ cargo install mdbook --vers [version-num]

Construindo

Para construir o livro, entre:

$ mdbook build

O resultado estará na subpasta book. Para checá-lo, o abra no seu browser.

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 rodar os testes:

$ mdbook test

Contribuindo

Nós adoraríamos sua ajuda! Por favor veja o CONTRIBUTING.md para saber mais sobre o tipo de contribuições que nós procuramos.

Traduções

Nós adoraríamos ajuda na tradução deste livro! Veja os labels Translating para se ajuntar aos esforços que estão atualmente em progresso. Abra novas issues para começar a trabalhar numa nova linguagem! Nós estamos esperando pelo suporte do mdbook a múltiplas linguagens antes de juntá-las a esse repositório, mas sinta-se livre para começar!

Graphviz dot

Nós estamos usando o Graphviz para alguns dos diagramas no livro. Os arquivos-fonte estão no diretório dot. Para transformar um arquivo dot, por exemplo o dot/trpl04-01.dot, em svg, rode:

$ dot dot/trpl04-01.dot -Tsvg > src/img/trpl04-01.svg

No arquivo SVG gerado, remova os atributos width e height do elemento svg e dê 0.00 0.00 1000.00 1000.00, ou outros valores que não cortem a imagem, ao atributo viewBox.

Checagem de grafia

Para procurar erros de grafia nos arquivos, você pode usar o script spellcheck.sh. Ele precisa de um dicionário de palavras válidas, o qual é provido em dictionary.txt. Se o script produzir um falso positivo (por exemplo, se você usou a palavra BTreeMap, a qual o script considera inválida), você precisará adicionar essa palavra a dicitonary.txt (mantenha-o ordenado por consistência).