diff --git a/book.toml b/book.toml index e05acfb..a2011c6 100644 --- a/book.toml +++ b/book.toml @@ -4,6 +4,7 @@ title = "The Rustonomicon" description = "The Dark Arts of Advanced and Unsafe Rust Programming" [output.html] +additional-css = ["theme/nomicon.css"] git-repository-url = "https://github.com/rust-lang/nomicon" [output.html.redirect] diff --git a/src/intro.md b/src/intro.md index 7c1a25b..5ada80e 100644 --- a/src/intro.md +++ b/src/intro.md @@ -1,5 +1,16 @@ # The Rustonomicon +
+ +Warning: +This book is incomplete. +Documenting everything and rewriting outdated parts take a while. +See the [issue tracker] to check what's missing/outdated, and if there are any mistakes or ideas that haven't been reported, feel free to open a new issue there. + +
+ +[issue tracker]: https://github.com/rust-lang/nomicon/issues + ## The Dark Arts of Unsafe Rust > THE KNOWLEDGE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF UNLEASHING INDESCRIBABLE HORRORS THAT SHATTER YOUR PSYCHE AND SET YOUR MIND ADRIFT IN THE UNKNOWABLY INFINITE COSMOS. diff --git a/theme/nomicon.css b/theme/nomicon.css new file mode 100644 index 0000000..1b8c77f --- /dev/null +++ b/theme/nomicon.css @@ -0,0 +1,40 @@ +/* +Taken from the reference. +Warnings and notes: +Write the
s on their own line. E.g. +
+Warning: This is bad! +
+*/ +main .warning p { + padding: 10px 20px; + margin: 20px 0; +} + +main .warning p::before { + content: "⚠️ "; +} + +.light main .warning p, +.rust main .warning p { + border: 2px solid red; + background: #ffcece; +} + +.rust main .warning p { + /* overrides previous declaration */ + border-color: #961717; +} + +.coal main .warning p, +.navy main .warning p, +.ayu main .warning p { + background: #542626 +} + +/* Make the links higher contrast on dark themes */ +.coal main .warning p a, +.navy main .warning p a, +.ayu main .warning p a { + color: #80d0d0 +}