% Растономикон
Перевод "Rustonomicon"
Растономикон - это игра слов Rust и Некрономикон - вымышленная книга, придуманная Говардом Лавкрафтом и часто упоминаемая в литературных произведениях, основанных на мифах Ктулху, ее название можно перевести как "Книга законов Мёртвых"
https://github.com/rust-lang/nomicon
Переведено всё, что есть в оригинале. В данный момент книга не публикуется в виде веб-страниц, но её можно читать прямо на GitHub.
Внимание: Это сырой документ, поэтому может содержать серьезные ошибки.
Вместо писания программ, что было моей мечтой, мной овладела тоска и невыразимое одиночество; и наконец я увидел страшную правду, в сторону которой остальные боялись даже дышать — непроизносимая тайна тайн открылась мне: этот язык камня и режущих звуков не способен сохранить в себе черт старого языка как Лондон старого Лондона, а Париж старого Парижа, и что на самом деле он довольно небезопасный, а его распростертые внутренности дурно набальзамированы и заселены странными существами, в действительности не имеющими ничего общего с тем, как все выглядит на этапе компиляции.
Эта книга зарывается в ужасающие подробности, которые нужно понять для правильного написания небезопасных программ на Rust. В связи с характером проблем, все может привести к высвобождению невыразимого ужаса, который разорвет вашу душу на миллиард бесконечно малых фрагментов отчаяния.
Хотите иметь долгую и счастливую карьеру программиста на Rust? Закройте и никогда не вспоминайте, что видели эту книгу. Она вам не нужна. Но если вы все же захотите написать небезопасный код - или просто покопаться во внутренностях языка - здесь содержится бесценная информация.
В отличие от книги мы предполагаем, что у вас есть обширные базовые знания. По крайней мере вы должны быть знакомы с системным программированием и Rust. Если это не так, то сначала почитайте книгу. Хотя мы не предполагаем, что вы знаете все вообще, и будем время от времени освежать основы там, где это нужно. Вы можете пропустить чтение той книги, если хотите; просто знайте, что мы не будем объяснять все, начиная с основ.
Для ясности, эта книга погрузит вас в глубокие детали. Мы нырнем в безопасность во время исключительных ситуаций, псевдонимы указателей, модели памяти и даже теорию типов. Мы будем много рассказывать о различных типах безопасности и гарантий.
Этот репозиторий подключён к системе перевода и вся работа ведётся там. Сама система перевода нужна для отслеживания изменений в оригинале книги и за счёт этого становится более удобной поддержка перевода, так как не надо самому переводчику искать что изменилось - система сама это показывает.
Проект на GitLocalize: https://gitlocalize.com/repo/8098