diff --git a/TODO.md b/TODO.md index 899e2fd8..f7f97142 100644 --- a/TODO.md +++ b/TODO.md @@ -12,42 +12,12 @@ ## Markdown - [ ] review each .md file in turn -- [ ] add explanation text for language pages -- [ ] [Introduction](src/index.md) polish the intro -- [ ] [Contributing](src/contributing/index.md) -- [ ] [Rust installation and first steps](src/lang/rust_install.md) polish -- [ ] [Main function](src/lang/main.md) add description -- [ ] [Simple data types](src/lang/simple_data_types.md) add description -- [ ] [Variables and constants](src/lang/variables_and_constants.md) add description -- [ ] [Ownership and borrowing](src/lang/ownership_borrowing.md) add description -- [ ] [Slices](src/lang/slices.md) add description -- [ ] [Functions](src/lang/functions.md) add description -- [ ] [Control flow](src/lang/control_flow.md) add description -- [ ] [Structs](src/lang/structs.md) -- [ ] [Enums](src/lang/enums.md) -- [ ] [Traits](src/lang/traits.md) -- [ ] [Trait objects](src/lang/trait_objects.md) -- [ ] [Attributes](src/lang/attributes.md) -- [ ] [Generics](src/lang/generics.md) -- [ ] [Lifetimes](src/lang/lifetimes.md) -- [ ] [Modules and `use` keyword](src/lang/modules.md) -- [ ] [Pattern matching, if / while let](src/lang/match.md) -- [ ] [Closures](src/lang/closures.md) -- [ ] [Iterators](src/lang/iterators.md) -- [ ] [Macros](src/lang/macros.md) -- [ ] [Standard library](src/standard_library/index.md) -- [ ] [Option](src/standard_library/option.md) finish Option page map, unwrap_or -- [ ] [Smart pointers](src/standard_library/smart_pointers.md) -- [ ] [Crates (by category)](src/categories.md) -- [ ] [About](src/about.md) rewrite -- [ ] finish links: -- [ ] create badge refdefs for links to crates.io, lib.rs, RBE book, etc +- [ ] create badge refdefs for links to RBE book - [ ] pull request to little book of rust books - [ ] Consider adding project to - [ ] review GA / GSC - issues with redirects?? - [ ] incorporate cwd.rs example + any other new examples - [ ] finish word index -- [ ] reenable [Index of Examples](src/examples_index.md) - [ ] finish cd_ci.md - [ ] finish improve_speed - [ ] finish to review ignore / no_run examples diff --git a/src/categories.md b/src/categories.md index 4968c104..3d1be4a0 100644 --- a/src/categories.md +++ b/src/categories.md @@ -92,3 +92,6 @@ [All Valid Categories]( https://crates.io/category_slugs ) {{#include refs/link-refs.md}} + diff --git a/src/categories/algorithms/randomness.md b/src/categories/algorithms/randomness.md index c15c3245..f6e5b02e 100644 --- a/src/categories/algorithms/randomness.md +++ b/src/categories/algorithms/randomness.md @@ -70,3 +70,6 @@ Randomly generates a string of given length ASCII characters with custom user-de {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/algorithms/sorting.md b/src/categories/algorithms/sorting.md index a647d326..94ddf73a 100644 --- a/src/categories/algorithms/sorting.md +++ b/src/categories/algorithms/sorting.md @@ -34,3 +34,6 @@ Sorts a vector{{hi:Vector}} of Person structs with properties `name` and `age` b {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/api-bindings/index.md b/src/categories/api-bindings/index.md index 98dfdeb3..e77598ea 100644 --- a/src/categories/api-bindings/index.md +++ b/src/categories/api-bindings/index.md @@ -24,3 +24,6 @@ Idiomatic wrappers of specific APIs{{hi:APIs}} for convenient access from Rust. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/async.md b/src/categories/asynchronous/async.md index 9b54aa5d..257c6bc1 100644 --- a/src/categories/asynchronous/async.md +++ b/src/categories/asynchronous/async.md @@ -53,3 +53,6 @@ Alternatives to the Tokio async ecosystem include: {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/async_and_blocking.md b/src/categories/asynchronous/async_and_blocking.md index 1a957128..7f391ee7 100644 --- a/src/categories/asynchronous/async_and_blocking.md +++ b/src/categories/asynchronous/async_and_blocking.md @@ -64,3 +64,6 @@ In other cases, it may be easier to structure the application as largely synchro {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/async_channels.incl.md b/src/categories/asynchronous/async_channels.incl.md index 8b0539a7..ae1bc46c 100644 --- a/src/categories/asynchronous/async_channels.incl.md +++ b/src/categories/asynchronous/async_channels.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-asynchronous][cat-asynchronous-badge]][cat-asynchronous] | + diff --git a/src/categories/asynchronous/async_channels.md b/src/categories/asynchronous/async_channels.md index e130629f..6063bc09 100644 --- a/src/categories/asynchronous/async_channels.md +++ b/src/categories/asynchronous/async_channels.md @@ -38,3 +38,6 @@ Another example: {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/async_traits.md b/src/categories/asynchronous/async_traits.md index ea1597df..89fb8edc 100644 --- a/src/categories/asynchronous/async_traits.md +++ b/src/categories/asynchronous/async_traits.md @@ -28,3 +28,6 @@ In addition, traits that use `-> impl Trait` and `async fn` are not object-safe{ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/futures.incl.md b/src/categories/asynchronous/futures.incl.md index 8b0539a7..ae1bc46c 100644 --- a/src/categories/asynchronous/futures.incl.md +++ b/src/categories/asynchronous/futures.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-asynchronous][cat-asynchronous-badge]][cat-asynchronous] | + diff --git a/src/categories/asynchronous/futures.md b/src/categories/asynchronous/futures.md index 31da8b50..de07f3b4 100644 --- a/src/categories/asynchronous/futures.md +++ b/src/categories/asynchronous/futures.md @@ -42,3 +42,6 @@ The [`futures`][c-futures]{{hi:futures}}⮳ crate provides an extension trait th {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/index.md b/src/categories/asynchronous/index.md index a9e225da..02db6403 100644 --- a/src/categories/asynchronous/index.md +++ b/src/categories/asynchronous/index.md @@ -67,3 +67,6 @@ Alternatives to the Tokio async ecosystem include: {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/streams.incl.md b/src/categories/asynchronous/streams.incl.md index 8b0539a7..ae1bc46c 100644 --- a/src/categories/asynchronous/streams.incl.md +++ b/src/categories/asynchronous/streams.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-asynchronous][cat-asynchronous-badge]][cat-asynchronous] | + diff --git a/src/categories/asynchronous/streams.md b/src/categories/asynchronous/streams.md index d2a0b1cc..ac509a3f 100644 --- a/src/categories/asynchronous/streams.md +++ b/src/categories/asynchronous/streams.md @@ -26,3 +26,6 @@ See also Tokio `async_stream`{{hi:async_stream}}. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/asynchronous/tokio.md b/src/categories/asynchronous/tokio.md index 07801ba1..559b7c72 100644 --- a/src/categories/asynchronous/tokio.md +++ b/src/categories/asynchronous/tokio.md @@ -31,3 +31,6 @@ Example from [c-tokio_graceful_shutdown][c-tokio_graceful_shutdown]⮳: {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/caching/index.md b/src/categories/caching/index.md index bba3a738..04c9cb40 100644 --- a/src/categories/caching/index.md +++ b/src/categories/caching/index.md @@ -12,3 +12,6 @@ Store the results of previous computations in order to reuse the results. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/caching/lru.md b/src/categories/caching/lru.md index 888c851b..34395c7c 100644 --- a/src/categories/caching/lru.md +++ b/src/categories/caching/lru.md @@ -2,3 +2,7 @@ ```rust,editable,no_run {{#include ../../../deps/tests/lru.rs}} ``` + + diff --git a/src/categories/command-line-interface/ansi_terminal.md b/src/categories/command-line-interface/ansi_terminal.md index 77346f0d..82406c7b 100644 --- a/src/categories/command-line-interface/ansi_terminal.md +++ b/src/categories/command-line-interface/ansi_terminal.md @@ -38,3 +38,6 @@ For anything more complex than plain foreground color changes, the code needs to {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/command-line-interface/arguments.md b/src/categories/command-line-interface/arguments.md index 43584d9b..e8fb24f0 100644 --- a/src/categories/command-line-interface/arguments.md +++ b/src/categories/command-line-interface/arguments.md @@ -56,3 +56,6 @@ Your favorite number must be 256. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/command-line-interface/index.md b/src/categories/command-line-interface/index.md index a4a55f29..a75515fa 100644 --- a/src/categories/command-line-interface/index.md +++ b/src/categories/command-line-interface/index.md @@ -18,3 +18,6 @@ Techniques to help create command line interfaces{{hi:Command line interfaces}}, {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/command-line-utilities/index.md b/src/categories/command-line-utilities/index.md index 7e07e5fd..c2871d73 100644 --- a/src/categories/command-line-utilities/index.md +++ b/src/categories/command-line-utilities/index.md @@ -53,3 +53,6 @@ apt install gping {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/compilers/cross_compilation.md b/src/categories/compilers/cross_compilation.md index ccad3cbf..5bda8d93 100644 --- a/src/categories/compilers/cross_compilation.md +++ b/src/categories/compilers/cross_compilation.md @@ -31,3 +31,6 @@ Examples: [![cross-toml-example][c-cross-toml-example-badge]][c-cross-toml-examp {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/compilers/faster_linking.md b/src/categories/compilers/faster_linking.md index ec6470fb..70a6a25b 100644 --- a/src/categories/compilers/faster_linking.md +++ b/src/categories/compilers/faster_linking.md @@ -60,3 +60,6 @@ rustflags = ["-C", "link-arg=-fuse-ld=/usr/bin/mold"] {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/compilers/index.md b/src/categories/compilers/index.md index c822fae3..a5462ffe 100644 --- a/src/categories/compilers/index.md +++ b/src/categories/compilers/index.md @@ -18,3 +18,6 @@ Compiler{{hi:Compiler}} implementations, including interpreters{{hi:Interpreters {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/compilers/reduce_compilation_duration.md b/src/categories/compilers/reduce_compilation_duration.md index cf592a67..6c299f0e 100644 --- a/src/categories/compilers/reduce_compilation_duration.md +++ b/src/categories/compilers/reduce_compilation_duration.md @@ -56,3 +56,6 @@ From-scratch builds with incremental compilation{{hi:Incremental compilation}} e {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/compression/index.md b/src/categories/compression/index.md index 06245246..53807603 100644 --- a/src/categories/compression/index.md +++ b/src/categories/compression/index.md @@ -6,3 +6,6 @@ Algorithms for making data smaller. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/compression/tar.md b/src/categories/compression/tar.md index 9ea035f7..a4af7f54 100644 --- a/src/categories/compression/tar.md +++ b/src/categories/compression/tar.md @@ -38,3 +38,6 @@ Iterate over the [`tar::Archive::entries`][c-tar::Archive::entries]{{hi:tar::Arc {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/computer-vision/index.incl.md b/src/categories/computer-vision/index.incl.md index ded16cc8..400ce83d 100644 --- a/src/categories/computer-vision/index.incl.md +++ b/src/categories/computer-vision/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |---|---|---| | [Open CV][ex-open-cv] | | [![cat-computer-vision][cat-computer-vision-badge]][cat-computer-vision] | + diff --git a/src/categories/concurrency/__actors.md b/src/categories/concurrency/__actors.md index 794d865c..18258d8b 100644 --- a/src/categories/concurrency/__actors.md +++ b/src/categories/concurrency/__actors.md @@ -27,3 +27,6 @@ [Actors with `Tokio`][blog-actors-with-tokio]{{hi:Actors}}⮳ {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/index.md b/src/categories/concurrency/index.md index eda0be04..ba11b68d 100644 --- a/src/categories/concurrency/index.md +++ b/src/categories/concurrency/index.md @@ -41,3 +41,6 @@ Here are the topics we’ll cover: {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/message_passing.md b/src/categories/concurrency/message_passing.md index 43a07404..efc5450f 100644 --- a/src/categories/concurrency/message_passing.md +++ b/src/categories/concurrency/message_passing.md @@ -42,3 +42,6 @@ Example using specialized channels for tickers{{hi:Tickers}} and timeout{{hi:Tim {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/multithreading.md b/src/categories/concurrency/multithreading.md index 1aaf9030..804d911b 100644 --- a/src/categories/concurrency/multithreading.md +++ b/src/categories/concurrency/multithreading.md @@ -58,3 +58,6 @@ Rayon implements [`rayon::join`][c-rayon::join]{{hi:rayon::join}}⮳, [`rayon::j {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/parallel.md b/src/categories/concurrency/parallel.md index 99512891..f45322c9 100644 --- a/src/categories/concurrency/parallel.md +++ b/src/categories/concurrency/parallel.md @@ -76,3 +76,6 @@ This example generates thumbnails for all `jpg`{{hi:JPEG}} files in the current {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/shared_state/concurrent_data_structures.incl.md b/src/categories/concurrency/shared_state/concurrent_data_structures.incl.md index 901323ad..a38c352e 100644 --- a/src/categories/concurrency/shared_state/concurrent_data_structures.incl.md +++ b/src/categories/concurrency/shared_state/concurrent_data_structures.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |---|---|---| | | | [![cat-concurrency][cat-concurrency-badge]][cat-concurrency] | + diff --git a/src/categories/concurrency/shared_state/concurrent_data_structures.md b/src/categories/concurrency/shared_state/concurrent_data_structures.md index db9de706..75df5926 100644 --- a/src/categories/concurrency/shared_state/concurrent_data_structures.md +++ b/src/categories/concurrency/shared_state/concurrent_data_structures.md @@ -24,3 +24,6 @@ {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/shared_state/index.md b/src/categories/concurrency/shared_state/index.md index c7832375..59f6dd7f 100644 --- a/src/categories/concurrency/shared_state/index.md +++ b/src/categories/concurrency/shared_state/index.md @@ -54,3 +54,6 @@ The most common way to share an atomic variable is to put it into an [`std::sync {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/concurrency/threads.md b/src/categories/concurrency/threads.md index 00934b76..21791407 100644 --- a/src/categories/concurrency/threads.md +++ b/src/categories/concurrency/threads.md @@ -83,3 +83,6 @@ Allocate memory for output image of given width and height with [`image::ImageBu {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/config/configuration.md b/src/categories/config/configuration.md index 8b03a5a6..d51b0068 100644 --- a/src/categories/config/configuration.md +++ b/src/categories/config/configuration.md @@ -18,3 +18,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/config/environment_variables.md b/src/categories/config/environment_variables.md index 20791764..936f7068 100644 --- a/src/categories/config/environment_variables.md +++ b/src/categories/config/environment_variables.md @@ -46,3 +46,6 @@ serde = { version = "1.0", features = ["derive"] } {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/config/index.md b/src/categories/config/index.md index 6390b0c4..96034486 100644 --- a/src/categories/config/index.md +++ b/src/categories/config/index.md @@ -12,3 +12,6 @@ Facilitate configuration management{{hi:configuration management}} for applicati {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/cryptography/encryption.md b/src/categories/cryptography/encryption.md index 8e7f5f24..29640cf9 100644 --- a/src/categories/cryptography/encryption.md +++ b/src/categories/cryptography/encryption.md @@ -18,3 +18,6 @@ The salt is generated using [`ring::rand::SecureRandom::fill`][c-ring::rand::Sec {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/cryptography/hashing.md b/src/categories/cryptography/hashing.md index 039cad78..e0ff891f 100644 --- a/src/categories/cryptography/hashing.md +++ b/src/categories/cryptography/hashing.md @@ -24,3 +24,6 @@ Uses [`ring::hmac`][c-ring::hmac]{{hi:ring::hmac}}⮳ to creates a [`ring::signa {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/cryptography/index.md b/src/categories/cryptography/index.md index cc7cca92..0a714ca6 100644 --- a/src/categories/cryptography/index.md +++ b/src/categories/cryptography/index.md @@ -12,3 +12,6 @@ Securing data. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/data-structures/bitfield.md b/src/categories/data-structures/bitfield.md index d5481ea4..86776c94 100644 --- a/src/categories/data-structures/bitfield.md +++ b/src/categories/data-structures/bitfield.md @@ -14,3 +14,6 @@ Creates type-safe bitfield{{hi:bitfield}} type `MyFlags` with help of [`bitflags {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/data-structures/index.md b/src/categories/data-structures/index.md index 1e408262..862dab2e 100644 --- a/src/categories/data-structures/index.md +++ b/src/categories/data-structures/index.md @@ -6,3 +6,6 @@ Rust implementations of ways of organizing data suited for specific purposes. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/database-implementations/index.md b/src/categories/database-implementations/index.md index d2d4b137..1e95e1f3 100644 --- a/src/categories/database-implementations/index.md +++ b/src/categories/database-implementations/index.md @@ -8,3 +8,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/database/index.md b/src/categories/database/index.md index d8eb30ac..d4cfd181 100644 --- a/src/categories/database/index.md +++ b/src/categories/database/index.md @@ -16,3 +16,6 @@ Interface with database management systems{{hi:Database management systems}}. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/database/postgres.md b/src/categories/database/postgres.md index 7ada79ba..dd23c645 100644 --- a/src/categories/database/postgres.md +++ b/src/categories/database/postgres.md @@ -36,3 +36,6 @@ This recipe lists the nationalities of the first 7999 artists in the database of {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/database/query_builders_orms.md b/src/categories/database/query_builders_orms.md index a62c1174..1a9858e3 100644 --- a/src/categories/database/query_builders_orms.md +++ b/src/categories/database/query_builders_orms.md @@ -20,3 +20,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/database/sqlite.md b/src/categories/database/sqlite.md index 4fb00b56..88960d5a 100644 --- a/src/categories/database/sqlite.md +++ b/src/categories/database/sqlite.md @@ -41,3 +41,6 @@ In the following example, colors add to a table having a unique constraint on th {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/date-and-time/duration.md b/src/categories/date-and-time/duration.md index 11cfab62..8bb2fb5b 100644 --- a/src/categories/date-and-time/duration.md +++ b/src/categories/date-and-time/duration.md @@ -41,3 +41,6 @@ Gets the local time{{hi:Time}} and displays it using [`chrono::offset::Local::no {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/date-and-time/index.md b/src/categories/date-and-time/index.md index 9c698c8e..56038369 100644 --- a/src/categories/date-and-time/index.md +++ b/src/categories/date-and-time/index.md @@ -12,3 +12,6 @@ Manage the complexity of dealing with the fourth dimension. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/date-and-time/parse.md b/src/categories/date-and-time/parse.md index 4e123587..b0c8e538 100644 --- a/src/categories/date-and-time/parse.md +++ b/src/categories/date-and-time/parse.md @@ -53,3 +53,6 @@ Escape sequences that are available for the [`chrono::DateTime::parse_from_str`] {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/cargo/crates.md b/src/categories/development-tools/cargo/crates.md index 1750f753..663770ef 100644 --- a/src/categories/development-tools/cargo/crates.md +++ b/src/categories/development-tools/cargo/crates.md @@ -11,3 +11,6 @@ The Rust community’s crate registry: [`crates.io`][crates.io]{{hi:crates.io}} Alternative to `crates.io`: [`lib.rs`][lib-rs]{{hi:lib.rs}}⮳ {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/cargo/index.md b/src/categories/development-tools/cargo/index.md index 2096da3b..64d229b7 100644 --- a/src/categories/development-tools/cargo/index.md +++ b/src/categories/development-tools/cargo/index.md @@ -93,3 +93,6 @@ cargo add actix-web@4.0.0 {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/cargo/package_layout.md b/src/categories/development-tools/cargo/package_layout.md index c565c298..6907931d 100644 --- a/src/categories/development-tools/cargo/package_layout.md +++ b/src/categories/development-tools/cargo/package_layout.md @@ -39,3 +39,6 @@ If you’re building a non-end product, such as a rust library that other rust p - If a package contains `src/main.rs`{{hi:src/main.rs}} and `src/lib.rs`{{hi:src/lib.rs}}, it has two crates: a binary and a library, both with the same name as the package. {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/cargo/refs.incl.md b/src/categories/development-tools/cargo/refs.incl.md index afabeb4f..0828419e 100644 --- a/src/categories/development-tools/cargo/refs.incl.md +++ b/src/categories/development-tools/cargo/refs.incl.md @@ -1,3 +1,6 @@ [ex-basic-cargo-usage]: index.md#basic-cargo-usage [ex-cargo-toml]: index.md#cargotoml-and-lock-files [ex-crates.io]: crates.md + diff --git a/src/categories/development-tools/documentation/badges.md b/src/categories/development-tools/documentation/badges.md index c98cc4d7..8d7d2e7c 100644 --- a/src/categories/development-tools/documentation/badges.md +++ b/src/categories/development-tools/documentation/badges.md @@ -7,3 +7,6 @@ A badge{{hi:Badges}} is a small image that displays status information about a c [Shield.io][shield-io-website]⮳ {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/documentation/index.md b/src/categories/development-tools/documentation/index.md index 6b383e5f..fe9999ed 100644 --- a/src/categories/development-tools/documentation/index.md +++ b/src/categories/development-tools/documentation/index.md @@ -57,3 +57,6 @@ The first lines within `lib.rs`{{hi:lib.rs}} will compose the crate-level docume {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/documentation/mdbook.md b/src/categories/development-tools/documentation/mdbook.md index 7f21b2d7..e4f6b889 100644 --- a/src/categories/development-tools/documentation/mdbook.md +++ b/src/categories/development-tools/documentation/mdbook.md @@ -20,3 +20,6 @@ mdbook serve --open [![mdbook_hide-github][c-mdbook_hide-github-badge]][c-mdbook_hide-github] [![cat-development-tools][cat-development-tools-badge]][cat-development-tools] {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/documentation/playground.md b/src/categories/development-tools/documentation/playground.md index daf3e8f3..6233c7ee 100644 --- a/src/categories/development-tools/documentation/playground.md +++ b/src/categories/development-tools/documentation/playground.md @@ -3,3 +3,6 @@ [Playground (Rust by example)][book-rust-by-example-playground]⮳ [![cat-development-tools][cat-development-tools-badge]][cat-development-tools] {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/formatting/index.md b/src/categories/development-tools/formatting/index.md index cc151045..45d07f82 100644 --- a/src/categories/development-tools/formatting/index.md +++ b/src/categories/development-tools/formatting/index.md @@ -75,3 +75,6 @@ For things you do not want rustfmt to mangle, use `#[rustfmt::skip]` , `#[rustfm {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/index.md b/src/categories/development-tools/index.md index 7e91c250..aa2c4722 100644 --- a/src/categories/development-tools/index.md +++ b/src/categories/development-tools/index.md @@ -30,3 +30,6 @@ Tools that provide developer-facing features such as testing, debugging, linting {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/installation/index.md b/src/categories/development-tools/installation/index.md index 44aa8a74..028f6002 100644 --- a/src/categories/development-tools/installation/index.md +++ b/src/categories/development-tools/installation/index.md @@ -22,3 +22,6 @@ Binstall works by fetching the crate information from crates.io and searching th {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/installation/rustup.md b/src/categories/development-tools/installation/rustup.md index 0b192ae8..fd5ea040 100644 --- a/src/categories/development-tools/installation/rustup.md +++ b/src/categories/development-tools/installation/rustup.md @@ -41,3 +41,6 @@ rustup component list {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/other/index.md b/src/categories/development-tools/other/index.md index 512c77d3..e7ecd556 100644 --- a/src/categories/development-tools/other/index.md +++ b/src/categories/development-tools/other/index.md @@ -12,3 +12,6 @@ {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/other/just.md b/src/categories/development-tools/other/just.md index 999e9590..42abeb6d 100644 --- a/src/categories/development-tools/other/just.md +++ b/src/categories/development-tools/other/just.md @@ -69,3 +69,6 @@ foo: {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/other/miri.md b/src/categories/development-tools/other/miri.md index 8f1d1667..f1583145 100644 --- a/src/categories/development-tools/other/miri.md +++ b/src/categories/development-tools/other/miri.md @@ -16,3 +16,6 @@ cargo miri run {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools/versioning/index.md b/src/categories/development-tools/versioning/index.md index 80dbb472..d610d6c1 100644 --- a/src/categories/development-tools/versioning/index.md +++ b/src/categories/development-tools/versioning/index.md @@ -61,3 +61,6 @@ Runs `git --version` using [`std::process::Command`][c-std::process::Command]{{h {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_build-utils/index.md b/src/categories/development-tools_build-utils/index.md index 8340cb82..f8b09716 100644 --- a/src/categories/development-tools_build-utils/index.md +++ b/src/categories/development-tools_build-utils/index.md @@ -146,3 +146,6 @@ void print_app_info() { {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_cargo-plugins/index.md b/src/categories/development-tools_cargo-plugins/index.md index 89f7cbe5..1b9b013c 100644 --- a/src/categories/development-tools_cargo-plugins/index.md +++ b/src/categories/development-tools_cargo-plugins/index.md @@ -105,3 +105,6 @@ cargo machete {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_debugging/config_log.md b/src/categories/development-tools_debugging/config_log.md index b739ca80..9f279f6d 100644 --- a/src/categories/development-tools_debugging/config_log.md +++ b/src/categories/development-tools_debugging/config_log.md @@ -78,3 +78,6 @@ Create the log configuration{{hi:log configuration}} with [`log4rs::append::file {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_debugging/index.md b/src/categories/development-tools_debugging/index.md index 578d504f..758ff56d 100644 --- a/src/categories/development-tools_debugging/index.md +++ b/src/categories/development-tools_debugging/index.md @@ -10,3 +10,6 @@ Help you figure out what is going on with your code such as logging{{hi:Logging} {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_debugging/log.md b/src/categories/development-tools_debugging/log.md index 2f7519a5..f2866e50 100644 --- a/src/categories/development-tools_debugging/log.md +++ b/src/categories/development-tools_debugging/log.md @@ -69,3 +69,6 @@ Logs messages to [UNIX `syslog`][unix-syslog-website]⮳. Initializes logger bac {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_debugging/tracing.md b/src/categories/development-tools_debugging/tracing.md index 4778d2cc..b0322cad 100644 --- a/src/categories/development-tools_debugging/tracing.md +++ b/src/categories/development-tools_debugging/tracing.md @@ -88,3 +88,6 @@ Holding the drop guard returned by `Span::enter`{{hi:Span::enter}} across `.awai {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_ffi/index.incl.md b/src/categories/development-tools_ffi/index.incl.md index c1c08eb7..3cfb3706 100644 --- a/src/categories/development-tools_ffi/index.incl.md +++ b/src/categories/development-tools_ffi/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-ffi][cat-ffi-badge]][cat-ffi] | + diff --git a/src/categories/development-tools_ffi/index.md b/src/categories/development-tools_ffi/index.md index 14a9fcce..09d226f1 100644 --- a/src/categories/development-tools_ffi/index.md +++ b/src/categories/development-tools_ffi/index.md @@ -8,3 +8,6 @@ Tools to help you better interface with other languages. This includes binding g {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_procedural-macro-helpers/index.incl.md b/src/categories/development-tools_procedural-macro-helpers/index.incl.md index 595568ed..f920b043 100644 --- a/src/categories/development-tools_procedural-macro-helpers/index.incl.md +++ b/src/categories/development-tools_procedural-macro-helpers/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-procedural-macro-helpers][cat-procedural-macro-helpers-badge]][cat-procedural-macro-helpers] | + diff --git a/src/categories/development-tools_procedural-macro-helpers/index.md b/src/categories/development-tools_procedural-macro-helpers/index.md index e01215c0..669abf8c 100644 --- a/src/categories/development-tools_procedural-macro-helpers/index.md +++ b/src/categories/development-tools_procedural-macro-helpers/index.md @@ -6,3 +6,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_profiling/index.md b/src/categories/development-tools_profiling/index.md index f5fd29ca..5afe7e11 100644 --- a/src/categories/development-tools_profiling/index.md +++ b/src/categories/development-tools_profiling/index.md @@ -15,3 +15,6 @@ Development tools to help you figure out the performance of your code. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/development-tools_testing/index.md b/src/categories/development-tools_testing/index.md index 2b587bb0..ccd1939b 100644 --- a/src/categories/development-tools_testing/index.md +++ b/src/categories/development-tools_testing/index.md @@ -32,3 +32,6 @@ Tools to help you verify the correctness{{hi:Correctness}} of your code. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/email/index.incl.md b/src/categories/email/index.incl.md index 70bfc493..d36d468e 100644 --- a/src/categories/email/index.incl.md +++ b/src/categories/email/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-email][cat-email-badge]][cat-email] | + diff --git a/src/categories/email/index.md b/src/categories/email/index.md index 26a7fc48..74a99d5d 100644 --- a/src/categories/email/index.md +++ b/src/categories/email/index.md @@ -8,3 +8,6 @@ Crates to help with sending, receiving, formatting, and parsing email. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/embedded/index.incl.md b/src/categories/embedded/index.incl.md index ecb0f87a..bfcfa81d 100644 --- a/src/categories/embedded/index.incl.md +++ b/src/categories/embedded/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-embedded][cat-embedded-badge]][cat-embedded] | + diff --git a/src/categories/embedded/index.md b/src/categories/embedded/index.md index be8bb059..4bf7a693 100644 --- a/src/categories/embedded/index.md +++ b/src/categories/embedded/index.md @@ -8,3 +8,6 @@ Crates that are primarily useful on embedded devices or without an operating sys {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/encoding/complex.md b/src/categories/encoding/complex.md index 8544167f..8edae2c8 100644 --- a/src/categories/encoding/complex.md +++ b/src/categories/encoding/complex.md @@ -44,3 +44,6 @@ Parse TOML into your own structs using [`serde`][c-serde]{{hi:serde}}⮳. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/encoding/csv.md b/src/categories/encoding/csv.md index 2f5d598c..c6d01525 100644 --- a/src/categories/encoding/csv.md +++ b/src/categories/encoding/csv.md @@ -85,3 +85,6 @@ See [`csv::Reader::deserialize`][c-csv::Reader::deserialize]{{hi:csv::Reader::de {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/encoding/index.md b/src/categories/encoding/index.md index cb17436b..8ca214bb 100644 --- a/src/categories/encoding/index.md +++ b/src/categories/encoding/index.md @@ -20,3 +20,6 @@ Encoding and/or decoding{{hi:Decoding}} data from one data format to another. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/encoding/serde.incl.md b/src/categories/encoding/serde.incl.md index 8b59abfa..e5ac8bea 100644 --- a/src/categories/encoding/serde.incl.md +++ b/src/categories/encoding/serde.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-encoding][cat-encoding-badge]][cat-encoding] | + diff --git a/src/categories/encoding/serde.md b/src/categories/encoding/serde.md index e4f5888e..d80f332d 100644 --- a/src/categories/encoding/serde.md +++ b/src/categories/encoding/serde.md @@ -14,3 +14,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/encoding/strings.md b/src/categories/encoding/strings.md index 73124df1..07eff651 100644 --- a/src/categories/encoding/strings.md +++ b/src/categories/encoding/strings.md @@ -52,3 +52,6 @@ Encodes byte slice into `base64`{{hi:base64}} String using [`base64::encode`][c- {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/filesystem/dir.md b/src/categories/filesystem/dir.md index 72900a13..0b9ca5cf 100644 --- a/src/categories/filesystem/dir.md +++ b/src/categories/filesystem/dir.md @@ -99,3 +99,6 @@ A custom [`glob::MatchOptions`][c-glob::MatchOptions]{{hi:glob::MatchOptions}} {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/filesystem/index.md b/src/categories/filesystem/index.md index a030be8a..2398d6b0 100644 --- a/src/categories/filesystem/index.md +++ b/src/categories/filesystem/index.md @@ -8,3 +8,6 @@ Dealing with files{{hi:Files}} and file systems{{hi:File systems}}. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/filesystem/read-write.md b/src/categories/filesystem/read-write.md index cc7a7436..cbf7c746 100644 --- a/src/categories/filesystem/read-write.md +++ b/src/categories/filesystem/read-write.md @@ -49,3 +49,6 @@ The [`memmap::Mmap::map`][c-memmap::Mmap::map]{{hi:memmap::Mmap::map}}⮳ functi {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/finance/index.md b/src/categories/finance/index.md index b3c9190d..8cc6c370 100644 --- a/src/categories/finance/index.md +++ b/src/categories/finance/index.md @@ -8,3 +8,6 @@ Dealing with money: accounting, trading, investments, taxes, banking and payment {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/game-engines/index.md b/src/categories/game-engines/index.md index da562998..fe9082a8 100644 --- a/src/categories/game-engines/index.md +++ b/src/categories/game-engines/index.md @@ -10,3 +10,6 @@ Crates that try to provide a "one-stop-shop" for all of your game development ne {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/graphics/index.incl.md b/src/categories/graphics/index.incl.md index 01175afb..8a86c37e 100644 --- a/src/categories/graphics/index.incl.md +++ b/src/categories/graphics/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-graphics][cat-graphics-badge]][cat-graphics] | + diff --git a/src/categories/graphics/index.md b/src/categories/graphics/index.md index c2864e26..bc2a855a 100644 --- a/src/categories/graphics/index.md +++ b/src/categories/graphics/index.md @@ -10,3 +10,6 @@ Crates for graphics libraries and applications, including raster and vector grap {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/gui/index.md b/src/categories/gui/index.md index 375237c2..fca94d48 100644 --- a/src/categories/gui/index.md +++ b/src/categories/gui/index.md @@ -34,3 +34,6 @@ See the relevant section in [blessed.rs][blessed-rs-website]⮳ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/hardware-support/index.md b/src/categories/hardware-support/index.md index 9c045e47..59962585 100644 --- a/src/categories/hardware-support/index.md +++ b/src/categories/hardware-support/index.md @@ -6,3 +6,6 @@ Interface with specific CPU{{hi:CPU}} or other hardware{{hi:Hardware}} features. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/hardware-support/processor.md b/src/categories/hardware-support/processor.md index afd810d2..8509ac89 100644 --- a/src/categories/hardware-support/processor.md +++ b/src/categories/hardware-support/processor.md @@ -14,3 +14,6 @@ Shows the number of logical CPU cores{{hi:CPU cores}} in current machine using [ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/internationalization/index.incl.md b/src/categories/internationalization/index.incl.md index fa1d9980..60dd0e58 100644 --- a/src/categories/internationalization/index.incl.md +++ b/src/categories/internationalization/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-internationalization][cat-internationalization-badge]][cat-internationalization] | + diff --git a/src/categories/internationalization/index.md b/src/categories/internationalization/index.md index b2bfac2d..cda14ab7 100644 --- a/src/categories/internationalization/index.md +++ b/src/categories/internationalization/index.md @@ -8,3 +8,6 @@ Tools to help develop software capable of adapting to various languages and regi {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/localization/_index.md b/src/categories/localization/_index.md index fe9094d5..cec8f1e0 100644 --- a/src/categories/localization/_index.md +++ b/src/categories/localization/_index.md @@ -8,3 +8,6 @@ Tooling to help adapting internationalized software to specific languages and re {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/localization/index.incl.md b/src/categories/localization/index.incl.md index 72fa8334..4e808ff5 100644 --- a/src/categories/localization/index.incl.md +++ b/src/categories/localization/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-localization][cat-localization-badge]][cat-localization] | + diff --git a/src/categories/mathematics/complex_numbers.md b/src/categories/mathematics/complex_numbers.md index eda009c0..6a1d9173 100644 --- a/src/categories/mathematics/complex_numbers.md +++ b/src/categories/mathematics/complex_numbers.md @@ -34,3 +34,6 @@ Complex numbers have a range of interesting properties when it comes to how they {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/mathematics/index.md b/src/categories/mathematics/index.md index 4debb6b9..98554a32 100644 --- a/src/categories/mathematics/index.md +++ b/src/categories/mathematics/index.md @@ -22,3 +22,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/mathematics/linear_algebra.md b/src/categories/mathematics/linear_algebra.md index 0cfdc342..b2c17ce7 100644 --- a/src/categories/mathematics/linear_algebra.md +++ b/src/categories/mathematics/linear_algebra.md @@ -98,3 +98,6 @@ Note that serialization followed by deserialization gives back the original matr {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/mathematics/miscellaneous.md b/src/categories/mathematics/miscellaneous.md index c3e942c4..b32360bb 100644 --- a/src/categories/mathematics/miscellaneous.md +++ b/src/categories/mathematics/miscellaneous.md @@ -14,3 +14,6 @@ Calculation for integers exceeding 128 bits are possible with [`num::BigInt`][c- {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/mathematics/statistics.md b/src/categories/mathematics/statistics.md index 39a843de..8ee2ea2a 100644 --- a/src/categories/mathematics/statistics.md +++ b/src/categories/mathematics/statistics.md @@ -42,3 +42,6 @@ The z-score is the number of standard deviations a single measurement spans away {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/mathematics/trigonometry.md b/src/categories/mathematics/trigonometry.md index f1e73309..e87b1712 100644 --- a/src/categories/mathematics/trigonometry.md +++ b/src/categories/mathematics/trigonometry.md @@ -36,3 +36,6 @@ The following example computes the distance in kilometers between two points on {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/memory-management/global_static.md b/src/categories/memory-management/global_static.md index ddb88412..6adfccfd 100644 --- a/src/categories/memory-management/global_static.md +++ b/src/categories/memory-management/global_static.md @@ -14,3 +14,6 @@ Declares a lazily evaluated constant [`std::collections::HashMap`][c-std::collec {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/memory-management/index.md b/src/categories/memory-management/index.md index 1d8d1627..09aef9d2 100644 --- a/src/categories/memory-management/index.md +++ b/src/categories/memory-management/index.md @@ -8,3 +8,6 @@ Deal with allocation, memory mapping, garbage collection, reference counting, or {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/memory-management/lazy_initialization.incl.md b/src/categories/memory-management/lazy_initialization.incl.md index 77389762..a890dac0 100644 --- a/src/categories/memory-management/lazy_initialization.incl.md +++ b/src/categories/memory-management/lazy_initialization.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-memory-management][cat-memory-management-badge]][cat-memory-management] | + diff --git a/src/categories/memory-management/lazy_initialization.md b/src/categories/memory-management/lazy_initialization.md index 6f2a388c..a7ad8298 100644 --- a/src/categories/memory-management/lazy_initialization.md +++ b/src/categories/memory-management/lazy_initialization.md @@ -30,3 +30,6 @@ The corresponding Sync version of `OnceCell` is `OnceLock`. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/multimedia/index.incl.md b/src/categories/multimedia/index.incl.md index c99f4979..6fdf4bc9 100644 --- a/src/categories/multimedia/index.incl.md +++ b/src/categories/multimedia/index.incl.md @@ -5,3 +5,6 @@ | | | [![cat-images][cat-images-badge]][cat-images] | | | | [![cat-audio][cat-audio-badge]][cat-audio] | | | | [![cat-multimedia-encoding][cat-multimedia-encoding-badge]][cat-multimedia-encoding] | + diff --git a/src/categories/multimedia/index.md b/src/categories/multimedia/index.md index 00d3b082..a7e486b5 100644 --- a/src/categories/multimedia/index.md +++ b/src/categories/multimedia/index.md @@ -30,3 +30,6 @@ Crates that process or build images. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/network-programming/index.md b/src/categories/network-programming/index.md index 52fe56eb..dd9dd29d 100644 --- a/src/categories/network-programming/index.md +++ b/src/categories/network-programming/index.md @@ -6,3 +6,6 @@ Deal with higher-level network protocols{{hi:Network protocols}} such as FTP{{hi {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/network-programming/server.md b/src/categories/network-programming/server.md index 4e6ac82c..e5ae1505 100644 --- a/src/categories/network-programming/server.md +++ b/src/categories/network-programming/server.md @@ -14,3 +14,6 @@ In this example, the port{{hi:Port}} is displayed on the console, and the progra {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/no-std/index.incl.md b/src/categories/no-std/index.incl.md index 7be82c96..db96eeaf 100644 --- a/src/categories/no-std/index.incl.md +++ b/src/categories/no-std/index.incl.md @@ -2,3 +2,6 @@ |--------|--------|------------| | | | [![cat-no-std][cat-no-std-badge]][cat-no-std] | | | | [![cat-no-alloc][cat-no-alloc-badge]][cat-no-alloc] | + diff --git a/src/categories/no-std/index.md b/src/categories/no-std/index.md index a1cd6e68..f73af091 100644 --- a/src/categories/no-std/index.md +++ b/src/categories/no-std/index.md @@ -14,3 +14,6 @@ Crates that are able to function without the Rust alloc crate. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/os/external.md b/src/categories/os/external.md index 9163a8de..2a4e14a2 100644 --- a/src/categories/os/external.md +++ b/src/categories/os/external.md @@ -73,3 +73,6 @@ Reads an environment variable{{hi:environment variable}} via [`std::env::var`][c {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/os/index.md b/src/categories/os/index.md index b6450d56..a40f9374 100644 --- a/src/categories/os/index.md +++ b/src/categories/os/index.md @@ -6,3 +6,6 @@ Bindings to operating system-specific APIs{{hi:Operating system-specific APIs}}. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/os_windows-apis/index.md b/src/categories/os_windows-apis/index.md index e1c9b520..d4736d80 100644 --- a/src/categories/os_windows-apis/index.md +++ b/src/categories/os_windows-apis/index.md @@ -10,3 +10,6 @@ Native Windows GUI: [![native_windows_gui-github][c-native_windows_gui-github-ba {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/parsing/index.incl.md b/src/categories/parsing/index.incl.md index a69e6466..e61c6997 100644 --- a/src/categories/parsing/index.incl.md +++ b/src/categories/parsing/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-parsing][cat-parsing-badge]][cat-parsing] | + diff --git a/src/categories/parsing/index.md b/src/categories/parsing/index.md index 1f4b3ac1..23c8c388 100644 --- a/src/categories/parsing/index.md +++ b/src/categories/parsing/index.md @@ -16,3 +16,6 @@ Crates to help create parsers of binary and text formats. Format-specific parser {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/rendering/index.incl.md b/src/categories/rendering/index.incl.md index 8d5cb550..e10aed4d 100644 --- a/src/categories/rendering/index.incl.md +++ b/src/categories/rendering/index.incl.md @@ -4,3 +4,6 @@ | | | [![cat-rendering-engine][cat-rendering-engine-badge]][cat-rendering-engine] | | | | [![cat-rendering-data-formats][cat-rendering-data-formats-badge]][cat-rendering-data-formats] | | | | [![cat-rendering-graphics-api][cat-rendering-graphics-api-badge]][cat-rendering-graphics-api] | + diff --git a/src/categories/rendering/index.md b/src/categories/rendering/index.md index 02eb7f45..7794fdc3 100644 --- a/src/categories/rendering/index.md +++ b/src/categories/rendering/index.md @@ -26,3 +26,6 @@ Crates that provide direct access to the hardware's or the operating system's re {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/rust-patterns/errors/error_handling.incl.md b/src/categories/rust-patterns/errors/error_handling.incl.md index 4126d2a6..6ba985a6 100644 --- a/src/categories/rust-patterns/errors/error_handling.incl.md +++ b/src/categories/rust-patterns/errors/error_handling.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-rust-patterns][cat-rust-patterns-badge]][cat-rust-patterns] | + diff --git a/src/categories/rust-patterns/errors/error_handling.md b/src/categories/rust-patterns/errors/error_handling.md index 8be2e881..e27b41d2 100644 --- a/src/categories/rust-patterns/errors/error_handling.md +++ b/src/categories/rust-patterns/errors/error_handling.md @@ -50,3 +50,6 @@ Another example: {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/rust-patterns/errors/handle.md b/src/categories/rust-patterns/errors/handle.md index a05be338..921614a0 100644 --- a/src/categories/rust-patterns/errors/handle.md +++ b/src/categories/rust-patterns/errors/handle.md @@ -58,3 +58,6 @@ Run the recipe with `RUST_BACKTRACE=1` to display a detailed [`error_chain::Chai {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/rust-patterns/errors/index.md b/src/categories/rust-patterns/errors/index.md index 6fd7b303..739e988e 100644 --- a/src/categories/rust-patterns/errors/index.md +++ b/src/categories/rust-patterns/errors/index.md @@ -8,3 +8,6 @@ {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/rust-patterns/index.md b/src/categories/rust-patterns/index.md index db635869..4c047a16 100644 --- a/src/categories/rust-patterns/index.md +++ b/src/categories/rust-patterns/index.md @@ -10,3 +10,6 @@ Shared solutions for particular situations specific to programming in Rust. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/science/index.md b/src/categories/science/index.md index 471c7844..31897b94 100644 --- a/src/categories/science/index.md +++ b/src/categories/science/index.md @@ -20,3 +20,6 @@ Crates for research tools and processing of data related to the brain and nervou {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/science/machine_learning/index.md b/src/categories/science/machine_learning/index.md index c7d63b9f..38253b7a 100644 --- a/src/categories/science/machine_learning/index.md +++ b/src/categories/science/machine_learning/index.md @@ -12,3 +12,6 @@ {{#include refs.incl.md}} {{#include ../../../refs/link-refs.md}} + diff --git a/src/categories/science_robotics/index.md b/src/categories/science_robotics/index.md index e3d4d320..919e6b53 100644 --- a/src/categories/science_robotics/index.md +++ b/src/categories/science_robotics/index.md @@ -27,3 +27,6 @@ Open Rust Robotics: [![openrr-github][c-openrr-github-badge]][c-openrr-github] {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/simulation/index.incl.md b/src/categories/simulation/index.incl.md index 29798bd3..b76fc646 100644 --- a/src/categories/simulation/index.incl.md +++ b/src/categories/simulation/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-simulation][cat-simulation-badge]][cat-simulation] | + diff --git a/src/categories/simulation/index.md b/src/categories/simulation/index.md index 15e9c35a..8129c087 100644 --- a/src/categories/simulation/index.md +++ b/src/categories/simulation/index.md @@ -8,3 +8,6 @@ Crates used to model or construct models for some activity, e.g. to.simulate a n {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/template-engine/index.incl.md b/src/categories/template-engine/index.incl.md index 1d5bdc3e..daf79b2c 100644 --- a/src/categories/template-engine/index.incl.md +++ b/src/categories/template-engine/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-template-engine][cat-template-engine-badge]][cat-template-engine] | + diff --git a/src/categories/template-engine/index.md b/src/categories/template-engine/index.md index 1cfd72f8..cba7a7c4 100644 --- a/src/categories/template-engine/index.md +++ b/src/categories/template-engine/index.md @@ -8,3 +8,6 @@ Crates designed to combine templates with data to produce result documents, usua {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/text-editors/index.md b/src/categories/text-editors/index.md index 4647f043..8ee55de5 100644 --- a/src/categories/text-editors/index.md +++ b/src/categories/text-editors/index.md @@ -24,3 +24,6 @@ If you have a JetBrains license, CLion is your go-to editor for Rust in JetBrain {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/text-processing/index.md b/src/categories/text-processing/index.md index 989ea103..9bf3d8e0 100644 --- a/src/categories/text-processing/index.md +++ b/src/categories/text-processing/index.md @@ -10,3 +10,6 @@ Deal with the complexities of human language when expressed in textual form. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/text-processing/regex.md b/src/categories/text-processing/regex.md index 084d6e4e..3011df7e 100644 --- a/src/categories/text-processing/regex.md +++ b/src/categories/text-processing/regex.md @@ -61,3 +61,6 @@ The method [`regex::Regex::replace_all`][c-regex::Regex::replace_all]{{hi:regex: {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/text-processing/regex2.md b/src/categories/text-processing/regex2.md index 4dec26cb..754523d0 100644 --- a/src/categories/text-processing/regex2.md +++ b/src/categories/text-processing/regex2.md @@ -10,3 +10,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/text-processing/string_parsing.md b/src/categories/text-processing/string_parsing.md index a697b7aa..5600c07f 100644 --- a/src/categories/text-processing/string_parsing.md +++ b/src/categories/text-processing/string_parsing.md @@ -24,3 +24,6 @@ Creates a custom struct `RGB` and implements the `FromStr`{{hi:FromStr}} trait t {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/virtualization/index.incl.md b/src/categories/virtualization/index.incl.md index 8fdbff2d..f3b88f13 100644 --- a/src/categories/virtualization/index.incl.md +++ b/src/categories/virtualization/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-virtualization][cat-virtualization-badge]][cat-virtualization] | + diff --git a/src/categories/virtualization/index.md b/src/categories/virtualization/index.md index 61a05706..0d81af0d 100644 --- a/src/categories/virtualization/index.md +++ b/src/categories/virtualization/index.md @@ -8,3 +8,6 @@ Creation and management of virtual environments and resources of any form, inclu {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/visualization/index.incl.md b/src/categories/visualization/index.incl.md index 26e6a6a3..5304fb4e 100644 --- a/src/categories/visualization/index.incl.md +++ b/src/categories/visualization/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-visualization][cat-visualization-badge]][cat-visualization] | + diff --git a/src/categories/visualization/index.md b/src/categories/visualization/index.md index 242a393c..af6f0058 100644 --- a/src/categories/visualization/index.md +++ b/src/categories/visualization/index.md @@ -8,3 +8,6 @@ Ways to view data, such as plotting or graphing. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/wasm/index.md b/src/categories/wasm/index.md index a31385e2..fabdefcf 100644 --- a/src/categories/wasm/index.md +++ b/src/categories/wasm/index.md @@ -16,3 +16,6 @@ Tooling targeting WebAssembly or manipulating WebAssembly. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming/index.md b/src/categories/web-programming/index.md index 70d31f2a..c29197db 100644 --- a/src/categories/web-programming/index.md +++ b/src/categories/web-programming/index.md @@ -24,3 +24,6 @@ Create applications for the web{{hi:Web}}. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming/mime.md b/src/categories/web-programming/mime.md index f77f9e0f..a9b7dbae 100644 --- a/src/categories/web-programming/mime.md +++ b/src/categories/web-programming/mime.md @@ -38,3 +38,6 @@ Note that the [`reqwest::header`][c-reqwest::header]{{hi:reqwest::header}}⮳ mo {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming/scraping.md b/src/categories/web-programming/scraping.md index 28f42bf7..6c56315c 100644 --- a/src/categories/web-programming/scraping.md +++ b/src/categories/web-programming/scraping.md @@ -39,3 +39,6 @@ MediaWiki link syntax is described [here][mediawiki-link-syntax]⮳. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming/url.md b/src/categories/web-programming/url.md index 01fac8c0..b4659f54 100644 --- a/src/categories/web-programming/url.md +++ b/src/categories/web-programming/url.md @@ -64,3 +64,6 @@ Parses [`url::Url`][c-url::Url]{{hi:url::Url}}⮳ and slices it with [`url::Posi {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-client/apis.md b/src/categories/web-programming_http-client/apis.md index 6d2420eb..a6124ec6 100644 --- a/src/categories/web-programming_http-client/apis.md +++ b/src/categories/web-programming_http-client/apis.md @@ -62,3 +62,6 @@ This example uses the [`GitHub API - rate limiting`][github-api-rate-limiting]{{ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-client/download.md b/src/categories/web-programming_http-client/download.md index 38330873..6ca35477 100644 --- a/src/categories/web-programming_http-client/download.md +++ b/src/categories/web-programming_http-client/download.md @@ -41,3 +41,6 @@ The Range header is defined in [`RFC7233`][http-range-rfc7233]{{hi:RFC-7233}}⮳ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-client/index.md b/src/categories/web-programming_http-client/index.md index f6c01add..5b100cfa 100644 --- a/src/categories/web-programming_http-client/index.md +++ b/src/categories/web-programming_http-client/index.md @@ -16,3 +16,6 @@ Make HTTP network requests. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-client/requests.md b/src/categories/web-programming_http-client/requests.md index 9d57da86..d34d3c98 100644 --- a/src/categories/web-programming_http-client/requests.md +++ b/src/categories/web-programming_http-client/requests.md @@ -43,3 +43,6 @@ The request targets service which responds with a J {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/actix.md b/src/categories/web-programming_http-server/actix.md index 932616af..8ae5f29c 100644 --- a/src/categories/web-programming_http-server/actix.md +++ b/src/categories/web-programming_http-server/actix.md @@ -13,3 +13,6 @@ Actix examples: [![Actix examples][c-actix-examples-github-badge]][c-actix-examp [Practical Rust Web Development - API Rest][blog-practical-rust]⮳ {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/axum.md b/src/categories/web-programming_http-server/axum.md index 535d08cc..1cfe55fb 100644 --- a/src/categories/web-programming_http-server/axum.md +++ b/src/categories/web-programming_http-server/axum.md @@ -7,3 +7,6 @@ [Crates.io example source code (using Axum)][crates.io-example-source-code]⮳ {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/cors.md b/src/categories/web-programming_http-server/cors.md index 2da17728..3d04f61a 100644 --- a/src/categories/web-programming_http-server/cors.md +++ b/src/categories/web-programming_http-server/cors.md @@ -11,3 +11,6 @@ Using the Tower ecosystem: ``` {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/index.md b/src/categories/web-programming_http-server/index.md index 0409f4fa..7392ee08 100644 --- a/src/categories/web-programming_http-server/index.md +++ b/src/categories/web-programming_http-server/index.md @@ -10,3 +10,6 @@ Serve data over HTTP. {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/middleware.md b/src/categories/web-programming_http-server/middleware.md index 01773336..011c8bf3 100644 --- a/src/categories/web-programming_http-server/middleware.md +++ b/src/categories/web-programming_http-server/middleware.md @@ -34,3 +34,6 @@ A number of third-party libraries support [`tower`][c-tower]{{hi:tower}}⮳ and {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/other_frameworks.md b/src/categories/web-programming_http-server/other_frameworks.md index 0047f6e3..8d25b2f7 100644 --- a/src/categories/web-programming_http-server/other_frameworks.md +++ b/src/categories/web-programming_http-server/other_frameworks.md @@ -23,3 +23,6 @@ [Building a SaaS with Rust and Next.js][blog-building-a-saas-with-rust]⮳ {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_http-server/refs.incl.md b/src/categories/web-programming_http-server/refs.incl.md index 4dce7342..7293c81b 100644 --- a/src/categories/web-programming_http-server/refs.incl.md +++ b/src/categories/web-programming_http-server/refs.incl.md @@ -5,5 +5,5 @@ [ex-cors]: cors.md [ex-static-website-generators]: static_website_generators.md [ex-tower]: middleware.md#tower -[ex-tower_http]: middleware.md#tower_http +[ex-tower_http]: middleware.md#tower-http [ex-alternatives]: middleware.md#alternatives diff --git a/src/categories/web-programming_http-server/static_website_generators.md b/src/categories/web-programming_http-server/static_website_generators.md index c843c468..50c49ba5 100644 --- a/src/categories/web-programming_http-server/static_website_generators.md +++ b/src/categories/web-programming_http-server/static_website_generators.md @@ -5,3 +5,6 @@ [Zola][c-zola-website]⮳ {{#include ../../refs/link-refs.md}} + diff --git a/src/categories/web-programming_websocket/index.incl.md b/src/categories/web-programming_websocket/index.incl.md index 4828dd0d..21bc64a6 100644 --- a/src/categories/web-programming_websocket/index.incl.md +++ b/src/categories/web-programming_websocket/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | | | [![cat-websocket][cat-websocket-badge]][cat-websocket] | + diff --git a/src/categories/web-programming_websocket/index.md b/src/categories/web-programming_websocket/index.md index 8adec9c6..01de3519 100644 --- a/src/categories/web-programming_websocket/index.md +++ b/src/categories/web-programming_websocket/index.md @@ -8,3 +8,6 @@ Communicate over the WebSocket protocol {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/contributing/api_documentation.md b/src/contributing/api_documentation.md index 3406c5e1..908812cf 100644 --- a/src/contributing/api_documentation.md +++ b/src/contributing/api_documentation.md @@ -51,3 +51,6 @@ xdg-open /cargo-target-rust_howto/target/doc/deps/index.html - Or install the `Live Server` or MS `Live Preview` VS Code extensions. {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/dev_container_docker.md b/src/contributing/dev_container_docker.md index 6b7669c0..8f704aca 100644 --- a/src/contributing/dev_container_docker.md +++ b/src/contributing/dev_container_docker.md @@ -79,3 +79,6 @@ docker push johncd/rust_howto_ci:latest ``` {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/dev_environment_setup.md b/src/contributing/dev_environment_setup.md index 4af137c5..b8bbc395 100644 --- a/src/contributing/dev_environment_setup.md +++ b/src/contributing/dev_environment_setup.md @@ -34,3 +34,6 @@ You may need `sudo apt-get install libsqlite3-dev` on WSL. Review `.devcontainer/Dockerfile` for other dependencies. {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/development_editing.md b/src/contributing/development_editing.md index 7580fd4f..dc457436 100644 --- a/src/contributing/development_editing.md +++ b/src/contributing/development_editing.md @@ -17,3 +17,6 @@ To add or edit the book, simply update or add a `.md` file in the appropriate [` Verify the markdown is properly rendered using `just serve` or `mdbook serve --open`. Pushing a commit to the `main` branch on GitHub will trigger a GitHub Action workflow that checks formatting / linting, builds / tests all examples, then deploys the book to GitHub Pages. {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/index.md b/src/contributing/index.md index 53eac996..d774c544 100644 --- a/src/contributing/index.md +++ b/src/contributing/index.md @@ -25,3 +25,6 @@ Please read [CONTRIBUTING.md][rust-howto-contributing] for more details. [![rust-howto-github][rust-howto-github-badge]][rust-howto-github] {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/optional_preprocessors.md b/src/contributing/optional_preprocessors.md index 58c95bbf..3e890e18 100644 --- a/src/contributing/optional_preprocessors.md +++ b/src/contributing/optional_preprocessors.md @@ -14,3 +14,6 @@ cargo install mdbook_keeper --git ``` {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/publication.md b/src/contributing/publication.md index a77d88cb..e5fa80da 100644 --- a/src/contributing/publication.md +++ b/src/contributing/publication.md @@ -9,3 +9,6 @@ The `publish` folder contains a placeholder crate, so that the book could be loc - When ready, `cargo publish --dry-run; cargo publish` {{#include ../refs/link-refs.md}} + diff --git a/src/contributing/repo_structure.md b/src/contributing/repo_structure.md index 7f1b21b4..fd8ec861 100644 --- a/src/contributing/repo_structure.md +++ b/src/contributing/repo_structure.md @@ -10,3 +10,6 @@ - The Dev Container and Docker (Compose) configuration files are found in `.devcontainer`. {{#include ../refs/link-refs.md}} + diff --git a/src/crates.md b/src/crates.md index edd7a2a7..22d9cd9f 100644 --- a/src/crates.md +++ b/src/crates.md @@ -67,3 +67,6 @@ Crates mentioned in this book, by alphabetic order. [![walkdir][c-walkdir-badge]][c-walkdir] [![watt][c-watt-badge]][c-watt] [![yew][c-yew-badge]][c-yew] {{#include refs/link-refs.md}} + diff --git a/src/key_crates.md b/src/key_crates.md index 5a9cbc82..84f93f49 100644 --- a/src/key_crates.md +++ b/src/key_crates.md @@ -14,3 +14,6 @@ or older resources, such as: - [![stdx][c-stdx-github-badge]][c-stdx-github] {{#include refs/link-refs.md}} + diff --git a/src/lang/attributes.md b/src/lang/attributes.md index a4ceb112..757e2166 100644 --- a/src/lang/attributes.md +++ b/src/lang/attributes.md @@ -64,3 +64,6 @@ See [Automatic derivation](../standard_library/derive.md). [Rust by example - attributes][book-rust-by-example-attributes]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/lang/closures.md b/src/lang/closures.md index 895181b4..56953dac 100644 --- a/src/lang/closures.md +++ b/src/lang/closures.md @@ -37,3 +37,6 @@ To force a move: Functions may also be used as arguments. {{#include ../refs/link-refs.md}} + diff --git a/src/lang/control_flow.md b/src/lang/control_flow.md index 21bad759..f63179c2 100644 --- a/src/lang/control_flow.md +++ b/src/lang/control_flow.md @@ -27,3 +27,6 @@ Also `else if { ... }` ``` {{#include ../refs/link-refs.md}} + diff --git a/src/lang/enums.md b/src/lang/enums.md index b51c7ad2..44aa9ba1 100644 --- a/src/lang/enums.md +++ b/src/lang/enums.md @@ -7,3 +7,6 @@ If we make an enum{{hi:Enums}} public, all of its variants{{hi:Variants}} are then public. We only need [`pub`][book-rust-reference-visibility-and-privacy]{{hi:pub}}⮳ before the [`enum`][book-rust-reference-enum]⮳ keyword. {{#include ../refs/link-refs.md}} + diff --git a/src/lang/functions.md b/src/lang/functions.md index 82670046..995a7d37 100644 --- a/src/lang/functions.md +++ b/src/lang/functions.md @@ -31,3 +31,6 @@ Diverging functions never return. ``` {{#include ../refs/link-refs.md}} + diff --git a/src/lang/generics.md b/src/lang/generics.md index a557420d..8458d5a4 100644 --- a/src/lang/generics.md +++ b/src/lang/generics.md @@ -7,3 +7,6 @@ ``` {{#include ../refs/link-refs.md}} + diff --git a/src/lang/index.md b/src/lang/index.md index e9ca823b..2a7ba774 100644 --- a/src/lang/index.md +++ b/src/lang/index.md @@ -8,3 +8,6 @@ Rust prefers snake case for variables and functions, so a method would be called {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/lang/iterators.md b/src/lang/iterators.md index 56e0bd6d..659c03e0 100644 --- a/src/lang/iterators.md +++ b/src/lang/iterators.md @@ -9,3 +9,6 @@ [Iterators][book-rust-iterators]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/lang/lifetimes.md b/src/lang/lifetimes.md index 55dee25e..99b2b6fb 100644 --- a/src/lang/lifetimes.md +++ b/src/lang/lifetimes.md @@ -25,3 +25,6 @@ The generic lifetime{{hi:Lifetime}} `'a` will get the concrete lifetime that is ``` {{#include ../refs/link-refs.md}} + diff --git a/src/lang/macros.md b/src/lang/macros.md index ae7b67b7..505784cd 100644 --- a/src/lang/macros.md +++ b/src/lang/macros.md @@ -39,3 +39,6 @@ The [Little Book of Rust Macros][book-rust-macros]⮳ [![watt][c-watt-badge]][c-watt] [![watt-github][c-watt-github-badge]][c-watt-github] {{#include ../refs/link-refs.md}} + diff --git a/src/lang/match.md b/src/lang/match.md index 2a630201..f89393eb 100644 --- a/src/lang/match.md +++ b/src/lang/match.md @@ -23,3 +23,6 @@ Patterns accept `1 | 2` for or, `1..=5` for inclusive range, `if x % 2 == 0` gua [Pattern matching][book-rust-pattern-matching]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/lang/modules.md b/src/lang/modules.md index bb39fa98..6fe0b2a2 100644 --- a/src/lang/modules.md +++ b/src/lang/modules.md @@ -45,3 +45,6 @@ On the other hand, when bringing in structs, enums, and other items with use, it ``` {{#include ../refs/link-refs.md}} + diff --git a/src/lang/rust_install.md b/src/lang/rust_install.md index 0656916a..c5687001 100644 --- a/src/lang/rust_install.md +++ b/src/lang/rust_install.md @@ -47,3 +47,6 @@ cargo run # run the executable `cargo run` builds the code if `cargo build` has not been invoked before or the code has changed. {{#include ../refs/link-refs.md}} + diff --git a/src/lang/structs.md b/src/lang/structs.md index 3c9ab86a..b178619e 100644 --- a/src/lang/structs.md +++ b/src/lang/structs.md @@ -19,3 +19,6 @@ Struct fields{{hi:Fields}} follow the general rule of everything being private b ``` {{#include ../refs/link-refs.md}} + diff --git a/src/lang/trait_objects.md b/src/lang/trait_objects.md index 8a49eb4a..9435a20f 100644 --- a/src/lang/trait_objects.md +++ b/src/lang/trait_objects.md @@ -22,3 +22,6 @@ dyn Trait + 'static [Trait Objects (docs)][book-rust-trait-objects]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/lang/traits.md b/src/lang/traits.md index 9b23f285..2b634d23 100644 --- a/src/lang/traits.md +++ b/src/lang/traits.md @@ -83,3 +83,6 @@ See [Async](../categories/asynchronous/index.md) [Traits (blog)][blog-traits]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/links/blogs.md b/src/links/blogs.md index f17419d1..419e621f 100644 --- a/src/links/blogs.md +++ b/src/links/blogs.md @@ -5,3 +5,6 @@ [LukeMathWalker/zero-to-production: Code for \"Zero To Production In Rust\", a book on API development using Rust][book-zero-to-production]⮳ [![zero-to-production-github][book-zero-to-production-github-badge]][book-zero-to-production-github] {{#include ../refs/link-refs.md}} + diff --git a/src/links/books.md b/src/links/books.md index 43a037be..7ae6d791 100644 --- a/src/links/books.md +++ b/src/links/books.md @@ -9,3 +9,6 @@ [The Rust Programming Language, 2nd Edition][book-rust-programming-language]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/links/companies.md b/src/links/companies.md index 42c7b8b3..c5a7426b 100644 --- a/src/links/companies.md +++ b/src/links/companies.md @@ -9,3 +9,6 @@ [Freiheit][freiheit-website]⮳ {{#include ../refs/company-refs.md}} + diff --git a/src/links/example_code.md b/src/links/example_code.md index 83afeda7..4421790c 100644 --- a/src/links/example_code.md +++ b/src/links/example_code.md @@ -7,3 +7,6 @@ [Zero To Production In Rust (code)][book-zero-to-production-github]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/links/index.md b/src/links/index.md index 0406f85b..0408beef 100644 --- a/src/links/index.md +++ b/src/links/index.md @@ -24,3 +24,6 @@ {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/links/rust_cheatsheets.md b/src/links/rust_cheatsheets.md index 42860b90..370293c7 100644 --- a/src/links/rust_cheatsheets.md +++ b/src/links/rust_cheatsheets.md @@ -9,3 +9,6 @@ [Rust for C# developers][book-rust-for-C#-developers]⮳ {{#include ../refs/link-refs.md}} + diff --git a/src/other/cloud/index.md b/src/other/cloud/index.md index ee9b5fef..c892a141 100644 --- a/src/other/cloud/index.md +++ b/src/other/cloud/index.md @@ -22,3 +22,6 @@ Dapr Rust SDK example: [![dapr-rust-examples][dapr-rust-examples-badge]][dapr-ru {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/other/cross_platform/index.md b/src/other/cross_platform/index.md index 06d174be..f6367724 100644 --- a/src/other/cross_platform/index.md +++ b/src/other/cross_platform/index.md @@ -16,3 +16,6 @@ The user interface{{hi:User interface}} layer is built natively, with modern dec {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/other/data_processing/index.md b/src/other/data_processing/index.md index 4ab2e71c..d4732e23 100644 --- a/src/other/data_processing/index.md +++ b/src/other/data_processing/index.md @@ -22,3 +22,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/other/gpu/index.incl.md b/src/other/gpu/index.incl.md index 8648f474..2e4f9b67 100644 --- a/src/other/gpu/index.incl.md +++ b/src/other/gpu/index.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |--------|--------|------------| | [rust_gpu][ex-rust_gpu] | [![rust_gpu-github][c-rust_gpu-github-badge]][c-rust_gpu-github] | | + diff --git a/src/other/gpu/index.md b/src/other/gpu/index.md index 944ba716..690b255b 100644 --- a/src/other/gpu/index.md +++ b/src/other/gpu/index.md @@ -8,3 +8,6 @@ {{#include refs.incl.md}} {{#include ../../refs/link-refs.md}} + diff --git a/src/other/index.md b/src/other/index.md index 51f2bd0a..5b88cbfb 100644 --- a/src/other/index.md +++ b/src/other/index.md @@ -18,3 +18,6 @@ {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/cow.md b/src/standard_library/cow.md index 740afe74..a2483323 100644 --- a/src/standard_library/cow.md +++ b/src/standard_library/cow.md @@ -59,3 +59,6 @@ Adapted from this [StackOverflow discussion](https://stackoverflow.com/questions {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/derive.md b/src/standard_library/derive.md index a94dcff4..6439cb75 100644 --- a/src/standard_library/derive.md +++ b/src/standard_library/derive.md @@ -22,3 +22,6 @@ You can use the `cargo_expand`{{hi:cargo-expand}} utility to see the exact code {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/hashmaps.md b/src/standard_library/hashmaps.md index 5e375787..10918132 100644 --- a/src/standard_library/hashmaps.md +++ b/src/standard_library/hashmaps.md @@ -12,3 +12,6 @@ All of the hashmap{{hi:Hashmap}} keys{{hi:Keys}} must have the same type as each {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/index.incl.md b/src/standard_library/index.incl.md index bffa1121..7866a272 100644 --- a/src/standard_library/index.incl.md +++ b/src/standard_library/index.incl.md @@ -25,3 +25,6 @@ ## Automatic Trait Derivation {{#include derive.incl.md}} + diff --git a/src/standard_library/index.md b/src/standard_library/index.md index e396dd92..cfcf1682 100644 --- a/src/standard_library/index.md +++ b/src/standard_library/index.md @@ -4,3 +4,6 @@ {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/option.md b/src/standard_library/option.md index 1c4817ce..c72a96bf 100644 --- a/src/standard_library/option.md +++ b/src/standard_library/option.md @@ -52,3 +52,6 @@ These methods extract the contained value in an [`std::option::Option`][c-std::o {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/smart_pointers.incl.md b/src/standard_library/smart_pointers.incl.md index 1842c8e8..a35ad371 100644 --- a/src/standard_library/smart_pointers.incl.md +++ b/src/standard_library/smart_pointers.incl.md @@ -3,3 +3,6 @@ | [Box][ex-box] | [![std][c-std-badge]][c-std] | | | [Rc][ex-rc] | [![std][c-std-badge]][c-std] | | | [RefCell][ex-refcell] | [![std][c-std-badge]][c-std] | | + diff --git a/src/standard_library/smart_pointers.md b/src/standard_library/smart_pointers.md index 0b9c543b..afac618c 100644 --- a/src/standard_library/smart_pointers.md +++ b/src/standard_library/smart_pointers.md @@ -33,3 +33,6 @@ The `RefCell` type with its interior mutability{{hi:interior mutability}} giv {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/strings.incl.md b/src/standard_library/strings.incl.md index 9564516b..cb03c9e2 100644 --- a/src/standard_library/strings.incl.md +++ b/src/standard_library/strings.incl.md @@ -3,3 +3,6 @@ | [String type][ex-string-type] | [![std][c-std-badge]][c-std] | | | [Placeholders][ex-string-placeholders] | [![std][c-std-badge]][c-std] | | | [String concatenation][ex-string-concatenation] | [![std][c-std-badge]][c-std] | | + diff --git a/src/standard_library/strings.md b/src/standard_library/strings.md index 607fb799..923472f8 100644 --- a/src/standard_library/strings.md +++ b/src/standard_library/strings.md @@ -32,3 +32,6 @@ Examples from [concatenation_benchmarks-rs]( https://github.com/hoodie/concatena {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/standard_library/vectors.incl.md b/src/standard_library/vectors.incl.md index 67a716c5..583b0f14 100644 --- a/src/standard_library/vectors.incl.md +++ b/src/standard_library/vectors.incl.md @@ -1,3 +1,6 @@ | Recipe | Crates | Categories | |---|---|---| | [Vec][ex-vec] | [![std][c-std-badge]][c-std] | | + diff --git a/src/standard_library/vectors.md b/src/standard_library/vectors.md index 0b94874d..1cbfc66f 100644 --- a/src/standard_library/vectors.md +++ b/src/standard_library/vectors.md @@ -14,3 +14,6 @@ Vectors can only store values that are the same type. {{#include refs.incl.md}} {{#include ../refs/link-refs.md}} + diff --git a/src/thanks.md b/src/thanks.md index 897aa421..263fddfa 100644 --- a/src/thanks.md +++ b/src/thanks.md @@ -23,3 +23,6 @@ It is also inspired from online websites, blogs, and documentation, including: This site is not affiliated with the [Rust Foundation][rust-foundation]⮳. {{#include refs/link-refs.md}} +