Programovací jazyk Rust

Tento repozitář obsahuje zdrojové soubory knihy o programovacím jazyce Rust „The Rust Programming Language“.

Kniha je k dispozici v tištěné podobě od vydavatelství No Starch Press.

Knihu si můžete také přečíst zdarma online. Podívejte se na verzi knihy, která odpovídá nejnovějším stabilním, beta nebo nočním vydáním Rustu. Mějte na paměti, že problémy v těchto verzích mohly být v tomto repozitáři již opraveny, protože tato vydání jsou aktualizována méně často.

Podívejte se na releases, kde si můžete stáhnout pouze zdrojové kódy všech ukázek, které se v knize objevují.

Požadavky

Pro sestavení knihy je potřeba mdBook, ideálně ve stejné verzi, jakou používá rust-lang/rust v tomto souboru. Chcete-li jej získat:

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

Kniha také používá dva pluginy pro mdbook, které jsou součástí tohoto repozitáře. Pokud je nenainstalujete, při sestavování se zobrazí varování a výstup nebude vypadat správně, ale knihu přesto budete schopni sestavit. Pro použití těchto pluginů byste měli spustit:

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

Sestavení

Pro sestavení knihy zadejte:

$ mdbook build

Výstup bude ve podadresáři book. Pro jeho zobrazení jej otevřete ve svém webovém prohlížeči.

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)

Pro spuštění testů:

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

Jak přispět

Rádi uvítáme vaši pomoc! Podívejte se na CONTRIBUTING.md, abyste se dozvěděli, jaké typy výpomoci hledáme.

Protože je kniha také v tištěné verzi a snažíme se, aby online verze byla co nejblíže té papírové, může nám vyřízení vašeho issue nebo pull requestu trvat déle, než jste zvyklí.

Dosud jsme prováděli větší revize v souvislosti s Rust edicemi. Mezi těmito většími revizemi opravujeme pouze chyby. Pokud vaše issue nebo pull request není čistě opravou chyby, může čekat až do další velké revize – počítejte s tím, že to může být otázka měsíců nebo let. Děkujeme za vaši trpělivost!

Překlady

Rádi uvítáme pomoc s překladem knihy! Podívejte se na štítek Překlady, abyste se zapojili do probíhajících překladatelských prací. Otevřete nový problém (issue), pokud chcete začít pracovat na novém jazyce! Čekáme na podporu mdbooku pro více jazyků, než některý z překladů začleníme, ale klidně můžete začít hned!

Kontrola pravopisu

Pro kontrolu zdrojových souborů na pravopisné chyby můžete použít skript spellcheck.sh, který je k dispozici v adresáři ci. Skript potřebuje slovník platných slov, který je poskytnut v ci/dictionary.txt. Pokud skript vykáže falešně pozitivní výsledek (například použijete slovo BTreeMap, které skript považuje za neplatné), je třeba toto slovo přidat do ci/dictionary.txt (dodržujte řazení slov pro konzistenci).