mirror of
https://github.com/google/comprehensive-rust.git
synced 2024-12-15 14:27:50 +02:00
6d19292f16
I've taken some work by @fw-immunant and others on the new organization of the course and condensed it into a form amenable to a text editor and some computational analysis. You can see the inputs in `course.py` but the interesting bits are the output: `outline.md` and `slides.md`. The idea is to break the course into more, smaller segments with exercises at the ends and breaks in between. So `outline.md` lists the segments, their duration, and sums those durations up per-day. It shows we're about an hour too long right now! There are more details of the segments in `slides.md`, or you can see mostly the same stuff in `course.py`. This now contains all of the content from the v1 course, ensuring both that we've covered everything and that we'll have somewhere to redirect every page. Fixes #1082. Fixes #1465. --------- Co-authored-by: Nicole LeGare <dlegare.1001@gmail.com> Co-authored-by: Martin Geisler <mgeisler@google.com>
229 lines
12 KiB
TOML
229 lines
12 KiB
TOML
[book]
|
|
authors = ["Martin Geisler"]
|
|
language = "en"
|
|
multilingual = false
|
|
src = "src"
|
|
title = "Comprehensive Rust 🦀"
|
|
|
|
[rust]
|
|
edition = "2021"
|
|
|
|
[build]
|
|
extra-watch-dirs = ["po", "third_party"]
|
|
|
|
[preprocessor.gettext]
|
|
after = ["links"]
|
|
|
|
[preprocessor.svgbob]
|
|
renderers = ["html"]
|
|
after = ["gettext"]
|
|
class = "bob"
|
|
|
|
[preprocessor.course]
|
|
# Enable this preprocessor to overlay a large red rectangle on the
|
|
# pages. This will show you an estimate of what the course
|
|
# participants can see during the presentation.
|
|
#
|
|
# [preprocessor.aspect-ratio-helper]
|
|
# command = "./aspect-ratio-helper.py"
|
|
|
|
[output.html]
|
|
curly-quotes = true
|
|
additional-js = ["theme/speaker-notes.js"]
|
|
additional-css = [
|
|
"theme/css/svgbob.css",
|
|
"theme/css/speaker-notes.css",
|
|
"theme/css/language-picker.css",
|
|
"theme/css/rtl.css",
|
|
]
|
|
site-url = "/comprehensive-rust/"
|
|
git-repository-url = "https://github.com/google/comprehensive-rust"
|
|
edit-url-template = "https://github.com/google/comprehensive-rust/edit/main/{path}"
|
|
|
|
[output.html.fold]
|
|
enable = true
|
|
level = 0
|
|
|
|
[output.html.playground]
|
|
editable = true
|
|
line-numbers = true
|
|
|
|
[output.html.redirect]
|
|
# Redirects in the form of "old-path" = "new-path", where the new path
|
|
# is relative to the old path.
|
|
"async/concurrency/channels.html" = "../channels.html"
|
|
"async/pitfall/async-traits.html" = "../pitfalls/async-traits.html"
|
|
"control-flow/while-let-expression.html" = "while-let-expressions.html"
|
|
"exercises/day-1/soluções-tarde.html" = "solutions-afternoon.html"
|
|
"exercises/day-2/soluções-tarde.html" = "solutions-afternoon.html"
|
|
"exercises/day-3/soluções-tarde.html" = "solutions-afternoon.html"
|
|
"exercises/day-3/simples-gui.html" = "simple-gui.html"
|
|
"exercises/day-4/afternoon.html" = "../android/morning.html"
|
|
"exercises/day-4/android.html" = "../android/morning.html"
|
|
"exercises/day-4/dining-philosophers.html" = "../concurrency/dining-philosophers.html"
|
|
"exercises/day-4/elevator.html" = "../concurrency/elevator.html"
|
|
"exercises/day-4/link-checker.html" = "../concurrency/link-checker.html"
|
|
"exercises/day-4/morning.html" = "../concurrency/morning.html"
|
|
"exercises/day-4/solutions-morning.html" = "../concurrency/solutions-morning.html"
|
|
"exercises/concurrency/elevator.html" = "chat-app.html"
|
|
"generics/closures.html" = "../traits/closures.html"
|
|
"generics/trait-objects.html" = "../traits/trait-objects.html"
|
|
"outros-recursos.html" = "other-resources.html"
|
|
"running-the-course/day-4.html" = "course-structure.html"
|
|
"sintaxe-básica/funções-interlude.html" = "../basic-syntax/functions-interlude.html"
|
|
"structure.html" = "running-the-course/course-structure.html"
|
|
"unsafe/mutable-static-variables.md" = "mutable-static-variables.html"
|
|
"unsafe/unsafe-functions.html" = "calling-unsafe-functions.html"
|
|
"welcome-bare-metal.html" = "bare-metal.html"
|
|
# Moving exercises between days
|
|
"exercises/day-2/luhn.html" = "../day-1/luhn.html"
|
|
"exercises/day-2/points-polygons.html" = "../day-3/points-polygons.html"
|
|
"exercises/day-1/book-library.html" = "../day-2/book-library.html"
|
|
"exercises/day-1/iterators-and-ownership.html" = "../day-2/iterators-and-ownership.html"
|
|
# Send people to canonical URL instead of index.html
|
|
"welcome.html" = "./"
|
|
|
|
[output.html.search]
|
|
use-boolean-and = true
|
|
|
|
# redirects from course v1 to v2
|
|
'welcome-day-1.html' = 'hello-world/welcome.html'
|
|
'welcome-day-1/what-is-rust.html' = '../hello-world/what-is-rust.html'
|
|
'hello-world/small-example.html' = '../hello-world/hello-world.html'
|
|
'why-rust.html' = 'hello-world/benefits.html'
|
|
'why-rust/compile-time.html' = '../hello-world/benefits.html'
|
|
'why-rust/runtime.html' = '../hello-world/benefits.html'
|
|
'why-rust/modern.html' = '../hello-world/benefits.html'
|
|
'why-rust/an-example-in-c.html' = '../hello-world/example.html'
|
|
'basic-syntax/variables.html' = '../types-and-values/variables.html'
|
|
'basic-syntax/scalar-types.html' = '../types-and-values/values.html'
|
|
'basic-syntax/type-inference.html' = '../types-and-values/inference.html'
|
|
'basic-syntax.html' = 'control-flow-basics.html'
|
|
'control-flow.html' = 'control-flow-basics.html'
|
|
'control-flow/if-expressions.html' = '../control-flow-basics/conditionals.html'
|
|
'control-flow/while-expressions.html' = '../control-flow-basics/loops.html'
|
|
'control-flow/for-expressions.html' = '../control-flow-basics/loops.html'
|
|
'control-flow/break-continue.html' = '../control-flow-basics/break-continue.html'
|
|
'control-flow/loop-expressions.html' = '../control-flow-basics/loops.html'
|
|
'basic-syntax/scopes-shadowing.html' = '../control-flow-basics/blocks-and-scopes.html'
|
|
'control-flow/blocks.html' = '../control-flow-basics/blocks-and-scopes.html'
|
|
'basic-syntax/functions.html' = '../control-flow-basics/functions.html'
|
|
'basic-syntax/rustdoc.html' = '../std-types/docs.html'
|
|
'basic-syntax/methods.html' = '../control-flow-basics/functions.html'
|
|
'basic-syntax/functions-interlude.html' = '../control-flow-basics/functions.html'
|
|
'exercises/day-1/morning.html' = '../../control-flow-basics/exercise.html'
|
|
'exercises/day-1/afternoon.html' = '../../control-flow-basics/exercise.html'
|
|
'exercises/day-2/morning.html' = '../../control-flow-basics/exercise.html'
|
|
'exercises/day-2/afternoon.html' = '../../control-flow-basics/exercise.html'
|
|
'exercises/day-3/morning.html' = '../../control-flow-basics/exercise.html'
|
|
'exercises/day-3/afternoon.html' = '../../control-flow-basics/exercise.html'
|
|
'basic-syntax/compound-types.html' = '../tuples-and-arrays/tuples-and-arrays.html'
|
|
'control-flow/match-expressions.html' = '../tuples-and-arrays/match.html'
|
|
'pattern-matching.html' = 'tuples-and-arrays/match.html'
|
|
'pattern-matching/match-guards.html' = '../tuples-and-arrays/match.html'
|
|
'pattern-matching/destructuring-arrays.html' = '../tuples-and-arrays/destructuring.html'
|
|
'exercises/day-1/for-loops.html' = '../../tuples-and-arrays/exercise.html'
|
|
'basic-syntax/references.html' = '../references/shared.html'
|
|
'basic-syntax/references-dangling.html' = '../references/shared.html'
|
|
'exercises/day-3/points-polygons.html' = '../../references/exercise.html'
|
|
'structs.html' = 'user-defined-types/named-structs.html'
|
|
'structs/field-shorthand.html' = '../user-defined-types/named-structs.html'
|
|
'structs/tuple-structs.html' = '../user-defined-types/tuple-structs.html'
|
|
'enums.html' = 'user-defined-types/enums.html'
|
|
'enums/variant-payloads.html' = '../user-defined-types/enums.html'
|
|
'enums/sizes.html' = '../user-defined-types/enums.html'
|
|
'traits/deriving-traits.html' = '../methods-and-traits/deriving.html'
|
|
'pattern-matching/destructuring-structs.html' = '../pattern-matching/destructuring.html'
|
|
'pattern-matching/destructuring-enums.html' = '../pattern-matching/destructuring.html'
|
|
'control-flow/novel.html' = '../pattern-matching/let-control-flow.html'
|
|
'control-flow/if-let-expressions.html' = '../pattern-matching/let-control-flow.html'
|
|
'control-flow/while-let-expressions.html' = '../pattern-matching/let-control-flow.html'
|
|
'exercises/day-1/pattern-matching.html' = '../../user-defined-types/exercise.html'
|
|
'welcome-day-2.html' = 'methods-and-traits/welcome.html'
|
|
'methods.html' = 'methods-and-traits/methods.html'
|
|
'methods/receiver.html' = '../methods-and-traits/methods.html'
|
|
'methods/example.html' = '../methods-and-traits/methods.html'
|
|
'traits.html' = 'methods-and-traits/traits.html'
|
|
'traits/default-methods.html' = '../methods-and-traits/traits.html'
|
|
'traits/trait-objects.html' = '../methods-and-traits/trait-objects.html'
|
|
'exercises/day-3/simple-gui.html' = '../../methods-and-traits/exercise.html'
|
|
'generics.html' = 'generics/generic-functions.html'
|
|
'generics/monomorphization.html' = '../generics/generic-functions.html'
|
|
'generics/data-types.html' = '../generics/generic-data.html'
|
|
'generics/methods.html' = '../generics/generic-data.html'
|
|
'traits/trait-bounds.html' = '../generics/trait-bounds.html'
|
|
'traits/impl-trait.html' = '../generics/impl-trait.html'
|
|
'std.html' = 'std-types/std.html'
|
|
'std/option-result.html' = '../std-types/option.html'
|
|
'error-handling/result.html' = '../std-types/result.html'
|
|
'std/string.html' = '../std-types/string.html'
|
|
'std/vec.html' = '../std-types/vec.html'
|
|
'std/hashmap.html' = '../std-types/hashmap.html'
|
|
'exercises/day-2/book-library.html' = '../../std-types/exercise.html'
|
|
'traits/important-traits.html' = '../std-traits/comparisons.html'
|
|
'traits/operators.html' = '../std-traits/operators.html'
|
|
'traits/from-into.html' = '../std-traits/from-and-into.html'
|
|
'traits/read-write.html' = '../std-traits/read-and-write.html'
|
|
'traits/default.html' = '../std-traits/default.html'
|
|
'traits/closures.html' = '../std-traits/closures.html'
|
|
'exercises/day-1/implicit-conversions.html' = '../../std-traits/exercise.html'
|
|
'traits/iterator.html' = '../iterators/iterators.html'
|
|
'exercises/day-2/iterators-and-ownership.html' = '../../iterators/intoiterator.html'
|
|
'traits/from-iterator.html' = '../iterators/fromiterator.html'
|
|
'exercises/day-2/strings-iterators.html' = '../../iterators/exercise.html'
|
|
'modules.html' = 'modules/modules.html'
|
|
'testing.html' = 'testing/unit-tests.html'
|
|
'testing/unit-tests.html' = '../testing/unit-tests.html'
|
|
'testing/integration-tests.html' = '../testing/other.html'
|
|
'testing/doc-tests.html' = '../testing/other.html'
|
|
'exercises/day-1/luhn.html' = '../../testing/exercise.html'
|
|
'welcome-day-3.html' = 'memory-management/welcome.html'
|
|
'memory-management/stack-vs-heap.html' = '../memory-management/review.html'
|
|
'memory-management/stack.html' = '../memory-management/review.html'
|
|
'memory-management.html' = 'memory-management/approaches.html'
|
|
'memory-management/manual.html' = '../memory-management/approaches.html'
|
|
'memory-management/scope-based.html' = '../memory-management/approaches.html'
|
|
'memory-management/garbage-collection.html' = '../memory-management/approaches.html'
|
|
'ownership.html' = 'memory-management/ownership.html'
|
|
'memory-management/rust.html' = '../memory-management/ownership.html'
|
|
'ownership/move-semantics.html' = '../memory-management/move.html'
|
|
'ownership/moved-strings-rust.html' = '../memory-management/move.html'
|
|
'ownership/double-free-modern-cpp.html' = '../memory-management/move.html'
|
|
'ownership/moves-function-calls.html' = '../memory-management/move.html'
|
|
'ownership/copy-clone.html' = '../memory-management/copy-types.html'
|
|
'traits/drop.html' = '../memory-management/drop.html'
|
|
'std/box.html' = '../smart-pointers/box.html'
|
|
'std/box-recursive.html' = '../smart-pointers/box.html'
|
|
'std/box-niche.html' = '../smart-pointers/box.html'
|
|
'std/rc.html' = '../smart-pointers/rc.html'
|
|
'ownership/borrowing.html' = '../borrowing/shared.html'
|
|
'ownership/shared-unique-borrows.html' = '../borrowing/shared.html'
|
|
'std/cell.html' = '../borrowing/interior-mutability.html'
|
|
'exercises/day-2/health-statistics.html' = '../../borrowing/exercise.html'
|
|
'error-handling.html' = 'error-handling/panics.html'
|
|
'error-handling/panic-unwind.html' = '../error-handling/panics.html'
|
|
'error-handling/try-operator.html' = '../error-handling/try.html'
|
|
'error-handling/converting-error-types.html' = '../error-handling/try-conversions.html'
|
|
'error-handling/converting-error-types-example.html' = '../error-handling/try-conversions.html'
|
|
'error-handling/deriving-error-enums.html' = '../error-handling/error.html'
|
|
'error-handling/error-contexts.html' = '../error-handling/thiserror-and-anyhow.html'
|
|
'error-handling/dynamic-errors.html' = '../error-handling/thiserror-and-anyhow.html'
|
|
'basic-syntax/slices.html' = '../slices-and-lifetimes/slices.html'
|
|
'basic-syntax/string-slices.html' = '../slices-and-lifetimes/str.html'
|
|
'ownership/lifetimes.html' = '../slices-and-lifetimes/lifetime-annotations.html'
|
|
'ownership/lifetimes-function-calls.html' = '../slices-and-lifetimes/lifetime-elision.html'
|
|
'ownership/lifetimes-data-structures.html' = '../slices-and-lifetimes/struct-lifetimes.html'
|
|
'unsafe.html' = 'unsafe-rust/unsafe.html'
|
|
'unsafe/raw-pointers.html' = '../unsafe-rust/dereferencing.html'
|
|
'basic-syntax/static-and-const.html' = '../unsafe-rust/static-and-const.html'
|
|
'unsafe/mutable-static-variables.html' = '../unsafe-rust/mutable-static.html'
|
|
'unsafe/unions.html' = '../unsafe-rust/unions.html'
|
|
'unsafe/calling-unsafe-functions.html' = '../unsafe-rust/unsafe-functions.html'
|
|
'unsafe/writing-unsafe-functions.html' = '../unsafe-rust/unsafe-functions.html'
|
|
'unsafe/extern-functions.html' = '../unsafe-rust/unsafe-functions.html'
|
|
'unsafe/unsafe-traits.html' = '../unsafe-rust/unsafe-traits.html'
|
|
'exercises/day-3/safe-ffi-wrapper.html' = '../../unsafe-rust/exercise.html'
|
|
|
|
[output.exerciser]
|
|
output-directory = "comprehensive-rust-exercises"
|