|
1 |
| -# The Rustonomicon |
| 1 | +# Rust 裏本 |
2 | 2 |
|
3 |
| -The Dark Arts of Advanced and Unsafe Rust Programming |
| 3 | +高度で危険な Rust Programming のための闇の技法 |
4 | 4 |
|
5 |
| -Nicknamed "the Nomicon." |
| 5 | +[原文][https://github.com/rust-lang-nursery/nomicon |
6 | 6 |
|
7 |
| -## NOTE: This is a draft document, and may contain serious errors |
8 |
| - |
9 |
| -> Instead of the programs I had hoped for, there came only a shuddering blackness |
10 |
| -and ineffable loneliness; and I saw at last a fearful truth which no one had |
11 |
| -ever dared to breathe before — the unwhisperable secret of secrets — The fact |
12 |
| -that this language of stone and stridor is not a sentient perpetuation of Rust |
13 |
| -as London is of Old London and Paris of Old Paris, but that it is in fact |
14 |
| -quite unsafe, its sprawling body imperfectly embalmed and infested with queer |
15 |
| -animate things which have nothing to do with it as it was in compilation. |
16 |
| - |
17 |
| -This book digs into all the awful details that are necessary to understand in |
18 |
| -order to write correct Unsafe Rust programs. Due to the nature of this problem, |
19 |
| -it may lead to unleashing untold horrors that shatter your psyche into a billion |
20 |
| -infinitesimal fragments of despair. |
21 |
| - |
22 |
| -### Requirements |
23 |
| - |
24 |
| -Building the Nomicon requires [mdBook]. To get it: |
25 |
| - |
26 |
| -[mdBook]: https://github.com/azerupi/mdBook |
27 |
| - |
28 |
| -```bash |
29 |
| -$ cargo install mdbook |
30 |
| -``` |
31 |
| - |
32 |
| -### Building |
33 |
| - |
34 |
| -To build the Nomicon: |
35 |
| - |
36 |
| -```bash |
37 |
| -$ mdbook build |
38 |
| -``` |
39 |
| - |
40 |
| -The output will be in the `book` subdirectory. To check it out, open it in |
41 |
| -your web browser. |
42 |
| - |
43 |
| -_Firefox:_ |
44 |
| -```bash |
45 |
| -$ firefox book/index.html # Linux |
46 |
| -$ open -a "Firefox" book/index.html # OS X |
47 |
| -$ Start-Process "firefox.exe" .\book\index.html # Windows (PowerShell) |
48 |
| -$ start firefox.exe .\book\index.html # Windows (Cmd) |
49 |
| -``` |
50 |
| - |
51 |
| -_Chrome:_ |
52 |
| -```bash |
53 |
| -$ google-chrome book/index.html # Linux |
54 |
| -$ open -a "Google Chrome" book/index.html # OS X |
55 |
| -$ Start-Process "chrome.exe" .\book\index.html # Windows (PowerShell) |
56 |
| -$ start chrome.exe .\book\index.html # Windows (Cmd) |
57 |
| -``` |
58 |
| - |
59 |
| -To run the tests: |
60 |
| - |
61 |
| -```bash |
62 |
| -$ mdbook test |
63 |
| -``` |
64 |
| - |
65 |
| -## Contributing |
66 |
| - |
67 |
| -Given that the Nomicon is still in a draft state, we'd love your help! Please feel free to open |
68 |
| -issues about anything, and send in PRs for things you'd like to fix or change. If your change is |
69 |
| -large, please open an issue first, so we can make sure that it's something we'd accept before you |
70 |
| -go through the work of getting a PR together. |
| 7 | +616b98444ff4eb5260deee95ee3e090dfd98b947 を翻訳中です。 |
0 commit comments