심오하고 불안전한 러스트 프로그래밍의 흑마법들
짧게 "노미콘"이라고 부릅니다.
내가 바랐던 프로그램들 대신, 살떨리는 어둠과 표현할 수 없는 외로움만이 있었다. 그리고 난 마침내 보고야 말았다. 아무도 그 앞에서 감히 숨도 쉬지 못한 두려운 진실, 속삭일 수조차 없는 비밀들 중의 비밀을 보고야 만 것이다. 이 돌과 끼긱거리는 소리로 이루어진 언어가 러스트의 의식적인 후계가 아니라는 것이었다. 런던은 옛날 정겨운 런던이었고 파리도 그랬지만, 이 언어는 아니었다. 이것은 꽤나 불안전했고, 그 뻗어있는 몸은 거의 미라가 되어 있었고 컴파일할 때는 없었던, 움직이는 요상한 것들로 들끓고 있었다.
이 책은 올바른 "불안전한" 러스트 프로그램을 작성하기 위해 이해해야 하는 온갖 자질구레한 하나하나를 다 다룹니다. 이러한 문제의 특성 때문에, 이는 이루 다 말할 수 없는 공포스러운 것들을 해방시켜 당신의 정신을 무수한 절망의 조각들로 박살낼 수도 있습니다.
노미콘을 빌드하기 위해서는 mdBook이 필요합니다. 설치하려면 다음과 같이 입력하세요:
cargo install mdbook
노미콘을 빌드하려면 build
서브커맨드를 사용하세요:
mdbook build
결과물은 book
디렉토리에 위치할 것입니다. 이 결과물을 보려면, index.html
파일을 웹 브라우저에서 여세요.
--open
플래그를 mdbook build
에 사용하면 (성공한다면) 기본 브라우저에서 인덱스 페이지를 엽니다. 마치 cargo doc --open
처럼요:
mdbook build --open
책에 담겨있는 모든 코드 예제를 테스트하는 test
서브커맨드도 있습니다:
mdbook test
linkcheck
툴을 사용하여 유효하지 않은 링크를 검증합니다.
로컬에서 실행하려면 다음과 같이 입력하세요:
curl -sSLo linkcheck.sh https://raw.githubusercontent.com/rust-lang/rust/master/src/tools/linkchecker/linkcheck.sh
sh linkcheck.sh --all nomicon
노미콘은 아직 미완성 상태이기 때문에, 당신의 도움이 필요합니다! 아무 주제라도 좋으니 자유롭게 이슈를 열어 주시고, 고치거나 바꾸고 싶은 것들이 있다면 PR도 환영합니다. 만약 변경사항이 많다면 PR로 고생하시기 전에, 수락할 변경사항인지 확실하게 하기 위해 먼저 이슈를 열어 주세요.