 | safe }})
+
+ {{ page.title }}
+ +
+
+
+
+ {{ page.content | safe }}
+
+# [Rustlings](https://rustlings.rust-lang.org) π¦
-# Rustlings π¦β€οΈ
+Small exercises to get you used to reading and writing [Rust](https://www.rust-lang.org) code - _Recommended in parallel to reading [the official Rust book](https://doc.rust-lang.org/book) ποΈ_
-
+Visit the **website** for a demo, info about setup and more:
-Greetings and welcome to Rustlings.
-This project contains small exercises to get you used to reading and writing Rust code.
-This includes reading and responding to compiler messages!
-
-It is recommended to do the Rustlings exercises in parallel to reading [the official Rust book](https://doc.rust-lang.org/book/), the most comprehensive resource for learning Rust ποΈ
-
-[Rust By Example](https://doc.rust-lang.org/rust-by-example/) is another recommended resource that you might find helpful.
-It contains code examples and exercises similar to Rustlings, but online.
-
-## Getting Started
-
-### Installing Rust
-
-Before installing Rustlings, you need to have the **latest version of Rust** installed.
-Visit [www.rust-lang.org/tools/install](https://www.rust-lang.org/tools/install) for further instructions on installing Rust.
-This will also install _Cargo_, Rust's package/project manager.
-
-> π§ If you're on Linux, make sure you've installed `gcc` (for a linker).
->
-> Deb: `sudo apt install gcc`.
-> Dnf: `sudo dnf install gcc`.
-
-> π If you're on MacOS, make sure you've installed Xcode and its developer tools by running `xcode-select --install`.
-
-### Installing Rustlings
-
-The following command will download and compile Rustlings:
-
-```bash
-cargo install rustlings
-```
-
-
-
-
-### Initialization
-
-After installing Rustlings, run the following command to initialize the `rustlings/` directory:
-
-```bash
-rustlings init
-```
-
-If the installation fails⦠(click to expand)
- -- Make sure you have the latest Rust version by running `rustup update` -- Try adding the `--locked` flag: `cargo install rustlings --locked` -- Otherwise, please [report the issue](https://github.com/rust-lang/rustlings/issues/new) - -
-If the command
-
-You are probably using Linux and installed Rust using your package manager.
-
-Cargo installs binaries to the directory `~/.cargo/bin`.
-Sadly, package managers often don't add `~/.cargo/bin` to your `PATH` environment variable.
-
-The solution is to β¦
-
-- either add `~/.cargo/bin` manually to `PATH`
-- or to uninstall Rust from the package manager and install it using the official way with `rustup`: https://www.rust-lang.org/tools/install
-
-
-
-Now, go into the newly initialized directory and launch Rustlings for further instructions on getting started with the exercises:
-
-```bash
-cd rustlings/
-rustlings
-```
-
-## Working environment
-
-### Editor
-
-Our general recommendation is [VS Code](https://code.visualstudio.com/) with the [rust-analyzer plugin](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer).
-But any editor that supports [rust-analyzer](https://rust-analyzer.github.io/) should be enough for working on the exercises.
-
-### Terminal
-
-While working with Rustlings, please use a modern terminal for the best user experience.
-The default terminal on Linux and Mac should be sufficient.
-On Windows, we recommend the [Windows Terminal](https://aka.ms/terminal).
-
-## Doing exercises
-
-The exercises are sorted by topic and can be found in the subdirectory `exercises/If the command rustlings can't be found⦠(click to expand)
-
-You are probably using Linux and installed Rust using your package manager.
-
-Cargo installs binaries to the directory `~/.cargo/bin`.
-Sadly, package managers often don't add `~/.cargo/bin` to your `PATH` environment variable.
-
-The solution is to β¦
-
-- either add `~/.cargo/bin` manually to `PATH`
-- or to uninstall Rust from the package manager and install it using the official way with `rustup`: https://www.rust-lang.org/tools/install
-
-
-If detecting file changes in the
-
-> You can add the **`--manual-run`** flag (`rustlings --manual-run`) to manually rerun the current exercise by entering `r` in the watch mode.
->
-> Please [report the issue](https://github.com/rust-lang/rustlings/issues/new) with some information about your operating system and whether you run Rustlings in a container or virtual machine (e.g. WSL).
-
-
-
-### Exercise List
-
-In the [watch mode](#watch-mode) (after launching `rustlings`), you can enter `l` to open the interactive exercise list.
-
-The list allows you toβ¦
-
-- See the status of all exercises (done or pending)
-- `c`: Continue at another exercise (temporarily skip some exercises or go back to a previous one)
-- `r`: Reset status and file of the selected exercise (you need to _reload/reopen_ its file in your editor afterwards)
-
-See the footer of the list for all possible keys.
-
-## Questions?
-
-If you need any help while doing the exercises and the builtin-hints aren't helpful, feel free to ask in the [_Q&A_ category of the discussions](https://github.com/rust-lang/rustlings/discussions/categories/q-a?discussions_q=) if your question wasn't asked yet π‘
-
-## Third-Party Exercises
-
-Third-party exercises are a set of exercises maintained by the community.
-You can use the same `rustlings` program that you installed with `cargo install rustlings` to run them:
-
-- [ζ₯ζ¬θͺη Rustlings](https://github.com/sotanengel/rustlings-jp)οΌA Japanese translation of the Rustlings exercises.
-
-Do you want to create your own set of Rustlings exercises to focus on some specific topic?
-Or do you want to translate the original Rustlings exercises?
-Then follow the the guide about [third-party exercises](https://github.com/rust-lang/rustlings/blob/main/THIRD_PARTY_EXERCISES.md)!
-
-## Continuing On
-
-Once you've completed Rustlings, put your new knowledge to good use!
-Continue practicing your Rust skills by building your own projects, contributing to Rustlings, or finding other open-source projects to contribute to.
-
-## Uninstalling Rustlings
-
-If you want to remove Rustlings from your system, run the following command:
-
-```bash
-cargo uninstall rustlings
-```
-
-## Contributing
-
-See [CONTRIBUTING.md](https://github.com/rust-lang/rustlings/blob/main/CONTRIBUTING.md) π
-
-## Contributors β¨
-
-Thanks to [all the wonderful contributors](https://github.com/rust-lang/rustlings/graphs/contributors) π
+## β‘οΈ [rustlings.rust-lang.org](https://rustlings.rust-lang.org) β¬
οΈ
diff --git a/THIRD_PARTY_EXERCISES.md b/THIRD_PARTY_EXERCISES.md
deleted file mode 100644
index 62646c5b..00000000
--- a/THIRD_PARTY_EXERCISES.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# Third-Party Exercises
-
-The support of Rustlings for third-party exercises allows you to create your own set of Rustlings exercises to focus on some specific topic.
-You could also offer a translation of the original Rustlings exercises as third-party exercises.
-
-## Getting started
-
-To create third-party exercises, install Rustlings and run `rustlings dev new PROJECT_NAME`.
-This command will, similar to `cargo new PROJECT_NAME`, create a template directory called `PROJECT_NAME` with all what you need to get started.
-
-Read the comments in the generated `info.toml` file to understand its format.
-It allows you to set a custom welcome and final message and specify the metadata of every exercise.
-
-## Create an exercise
-
-Here is an example of the metadata of one file:
-
-```toml
-[[exercises]]
-name = "intro1"
-hint = """
-To finish this exercise, you need to β¦
-This link might help you β¦"""
-```
-
-After entering this in `info.toml`, create the file `intro1.rs` in the `exercises/` directory.
-The exercise needs to contain a `main` function, but it can be empty.
-Adding tests is recommended.
-Look at the official Rustlings exercises for inspiration.
-
-You can optionally add a solution file `intro1.rs` to the `solutions/` directory.
-
-Now, run `rustlings dev check`.
-It will tell you about any issues with your exercises.
-For example, it will tell you to run `rustlings dev update` to update the `Cargo.toml` file to include the new exercise `intro1`.
-
-`rustlings dev check` will also run your solutions (if you have any) to make sure that they run successfully.
-
-That's it!
-You finished your first exercise π
-
-## Publish
-
-Now, add more exercises and publish them as a Git repository.
-
-Users just have to clone that repository and run `rustlings` in it to start working on your set of exercises just like the official ones.
-
-One difference to the official exercises is that the solution files will not be hidden until the user finishes an exercise.
-But you can trust the users to not look at the solution too early π
-
-## Share
-
-After publishing your set of exercises, open an issue or a pull request in the official Rustlings repository to link to your project in the README π
diff --git a/build.rs b/build.rs
new file mode 100644
index 00000000..56878641
--- /dev/null
+++ b/build.rs
@@ -0,0 +1,5 @@
+fn main() {
+ // Fix building from source on Windows because it can't handle file links.
+ #[cfg(windows)]
+ let _ = std::fs::copy("dev/Cargo.toml", "dev-Cargo.toml");
+}
diff --git a/clippy.toml b/clippy.toml
index afc9253a..89b0a886 100644
--- a/clippy.toml
+++ b/clippy.toml
@@ -1,15 +1,11 @@
disallowed-types = [
- # Inefficient. Use `.queue(β¦)` instead.
- "crossterm::style::Stylize",
- "crossterm::style::styled_content::StyledContent",
+ { path = "crossterm::style::Stylize", reason = "inefficient, use `.queue(β¦)` instead" },
+ { path = "crossterm::style::styled_content::StyledContent", reason = "inefficient, use `.queue(β¦)` instead" },
]
disallowed-methods = [
- # Inefficient. Use `.queue(β¦)` instead.
- "crossterm::style::style",
- # Use `thread::Builder::spawn` instead and handle the error.
- "std::thread::spawn",
- "std::thread::Scope::spawn",
- # Return `ExitCode` instead.
- "std::process::exit",
+ { path = "crossterm::style::style", reason = "inefficient, use `.queue(β¦)` instead" },
+ { path = "std::thread::spawn", replacement = "std::thread::Builder::spawn", reason = "handle the error" },
+ { path = "std::thread::Scope::spawn", replacement = "std::thread::Builder::spawn", reason = "handle the error" },
+ { path = "std::process::exit", replacement = "std::process::ExitCode" },
]
diff --git a/dev/Cargo.toml b/dev/Cargo.toml
index 29a557a0..66bc1dfe 100644
--- a/dev/Cargo.toml
+++ b/dev/Cargo.toml
@@ -1,4 +1,4 @@
-# Don't edit the `bin` list manually! It is updated by `cargo run -- dev update`. This comment line will be stripped in `rustlings init`.
+# Don't edit the `bin` list manually! It is updated by `cargo dev update`. This comment line will be stripped in `rustlings init`.
bin = [
{ name = "intro1", path = "../exercises/00_intro/intro1.rs" },
{ name = "intro1_sol", path = "../solutions/00_intro/intro1.rs" },
@@ -150,14 +150,14 @@ bin = [
{ name = "iterators4_sol", path = "../solutions/18_iterators/iterators4.rs" },
{ name = "iterators5", path = "../exercises/18_iterators/iterators5.rs" },
{ name = "iterators5_sol", path = "../solutions/18_iterators/iterators5.rs" },
- { name = "box1", path = "../exercises/19_smart_pointers/box1.rs" },
- { name = "box1_sol", path = "../solutions/19_smart_pointers/box1.rs" },
- { name = "rc1", path = "../exercises/19_smart_pointers/rc1.rs" },
- { name = "rc1_sol", path = "../solutions/19_smart_pointers/rc1.rs" },
- { name = "arc1", path = "../exercises/19_smart_pointers/arc1.rs" },
- { name = "arc1_sol", path = "../solutions/19_smart_pointers/arc1.rs" },
- { name = "cow1", path = "../exercises/19_smart_pointers/cow1.rs" },
- { name = "cow1_sol", path = "../solutions/19_smart_pointers/cow1.rs" },
+ { name = "smart_pointers1", path = "../exercises/19_smart_pointers/smart_pointers1.rs" },
+ { name = "smart_pointers1_sol", path = "../solutions/19_smart_pointers/smart_pointers1.rs" },
+ { name = "smart_pointers2", path = "../exercises/19_smart_pointers/smart_pointers2.rs" },
+ { name = "smart_pointers2_sol", path = "../solutions/19_smart_pointers/smart_pointers2.rs" },
+ { name = "smart_pointers3", path = "../exercises/19_smart_pointers/smart_pointers3.rs" },
+ { name = "smart_pointers3_sol", path = "../solutions/19_smart_pointers/smart_pointers3.rs" },
+ { name = "smart_pointers4", path = "../exercises/19_smart_pointers/smart_pointers4.rs" },
+ { name = "smart_pointers4_sol", path = "../solutions/19_smart_pointers/smart_pointers4.rs" },
{ name = "threads1", path = "../exercises/20_threads/threads1.rs" },
{ name = "threads1_sol", path = "../solutions/20_threads/threads1.rs" },
{ name = "threads2", path = "../exercises/20_threads/threads2.rs" },
@@ -178,21 +178,21 @@ bin = [
{ name = "clippy2_sol", path = "../solutions/22_clippy/clippy2.rs" },
{ name = "clippy3", path = "../exercises/22_clippy/clippy3.rs" },
{ name = "clippy3_sol", path = "../solutions/22_clippy/clippy3.rs" },
- { name = "using_as", path = "../exercises/23_conversions/using_as.rs" },
- { name = "using_as_sol", path = "../solutions/23_conversions/using_as.rs" },
- { name = "from_into", path = "../exercises/23_conversions/from_into.rs" },
- { name = "from_into_sol", path = "../solutions/23_conversions/from_into.rs" },
- { name = "from_str", path = "../exercises/23_conversions/from_str.rs" },
- { name = "from_str_sol", path = "../solutions/23_conversions/from_str.rs" },
- { name = "try_from_into", path = "../exercises/23_conversions/try_from_into.rs" },
- { name = "try_from_into_sol", path = "../solutions/23_conversions/try_from_into.rs" },
- { name = "as_ref_mut", path = "../exercises/23_conversions/as_ref_mut.rs" },
- { name = "as_ref_mut_sol", path = "../solutions/23_conversions/as_ref_mut.rs" },
+ { name = "conversions1", path = "../exercises/23_conversions/conversions1.rs" },
+ { name = "conversions1_sol", path = "../solutions/23_conversions/conversions1.rs" },
+ { name = "conversions2", path = "../exercises/23_conversions/conversions2.rs" },
+ { name = "conversions2_sol", path = "../solutions/23_conversions/conversions2.rs" },
+ { name = "conversions3", path = "../exercises/23_conversions/conversions3.rs" },
+ { name = "conversions3_sol", path = "../solutions/23_conversions/conversions3.rs" },
+ { name = "conversions4", path = "../exercises/23_conversions/conversions4.rs" },
+ { name = "conversions4_sol", path = "../solutions/23_conversions/conversions4.rs" },
+ { name = "conversions5", path = "../exercises/23_conversions/conversions5.rs" },
+ { name = "conversions5_sol", path = "../solutions/23_conversions/conversions5.rs" },
]
[package]
name = "exercises"
-edition = "2021"
+edition = "2024"
# Don't publish the exercises on crates.io!
publish = false
diff --git a/exercises/01_variables/README.md b/exercises/01_variables/README.md
index 7964ff29..5ba2efca 100644
--- a/exercises/01_variables/README.md
+++ b/exercises/01_variables/README.md
@@ -1,7 +1,7 @@
# Variables
In Rust, variables are immutable by default.
-When a variable is immutable, once a value is bound to a name, you canβt change that value.
+When a variable is immutable, once a value is bound to a name, you can't change that value.
You can make them mutable by adding `mut` in front of the variable name.
## Further information
diff --git a/exercises/01_variables/variables5.rs b/exercises/01_variables/variables5.rs
index 49db8e9e..cf5620da 100644
--- a/exercises/01_variables/variables5.rs
+++ b/exercises/01_variables/variables5.rs
@@ -1,6 +1,6 @@
fn main() {
let number = "T-H-R-E-E"; // Don't change this line
- println!("Spell a number: {}", number);
+ println!("Spell a number: {number}");
// TODO: Fix the compiler error by changing the line below without renaming the variable.
number = 3;
diff --git a/exercises/03_if/if2.rs b/exercises/03_if/if2.rs
index 10037f26..ca8493cc 100644
--- a/exercises/03_if/if2.rs
+++ b/exercises/03_if/if2.rs
@@ -19,7 +19,7 @@ mod tests {
#[test]
fn yummy_food() {
- // This means that calling `picky_eater` with the argument "food" should return "Yummy!".
+ // This means that calling `picky_eater` with the argument "strawberry" should return "Yummy!".
assert_eq!(picky_eater("strawberry"), "Yummy!");
}
diff --git a/exercises/05_vecs/vecs1.rs b/exercises/05_vecs/vecs1.rs
index 68e1affa..a015c40f 100644
--- a/exercises/05_vecs/vecs1.rs
+++ b/exercises/05_vecs/vecs1.rs
@@ -1,11 +1,6 @@
-fn array_and_vec() -> ([i32; 4], VecIf detecting file changes in the exercises/ directory fails⦠(click to expand)
-
-> You can add the **`--manual-run`** flag (`rustlings --manual-run`) to manually rerun the current exercise by entering `r` in the watch mode.
->
-> Please [report the issue](https://github.com/rust-lang/rustlings/issues/new) with some information about your operating system and whether you run Rustlings in a container or virtual machine (e.g. WSL).
-
-ending")?;
+ writer.write_ascii(b"/")?;
+ hotkey(&mut writer, b"p")?;
+ writer.write_ascii(b"ending")?;
}
Filter::Pending => {
- writer.write_ascii(b" ending")?;
+ writer.write_ascii(b"ending")?;
writer.stdout.queue(ResetColor)?;
}
- Filter::None => writer.write_ascii(b" ending")?,
+ Filter::None => {
+ hotkey(&mut writer, b"d")?;
+ writer.write_ascii(b"one/")?;
+ hotkey(&mut writer, b"p")?;
+ writer.write_ascii(b"ending")?;
+ }
}
- writer.write_ascii(b" | uit list")?;
+ writer.write_ascii(b" | ")?;
+ hotkey(&mut writer, b"q")?;
+ writer.write_ascii(b"uit list")?;
} else {
writer.stdout.queue(SetForegroundColor(Color::Magenta))?;
writer.write_str(&self.message)?;
@@ -311,7 +330,6 @@ impl<'a> ListState<'a> {
self.scroll_state.set_n_rows(n_rows);
}
- #[inline]
pub fn filter(&self) -> Filter {
self.filter
}
@@ -321,22 +339,18 @@ impl<'a> ListState<'a> {
self.update_rows();
}
- #[inline]
pub fn select_next(&mut self) {
self.scroll_state.select_next();
}
- #[inline]
pub fn select_previous(&mut self) {
self.scroll_state.select_previous();
}
- #[inline]
pub fn select_first(&mut self) {
self.scroll_state.select_first();
}
- #[inline]
pub fn select_last(&mut self) {
self.scroll_state.select_last();
}
@@ -373,11 +387,11 @@ impl<'a> ListState<'a> {
let exercise_ind = self.selected_to_exercise_ind(selected)?;
let exercise_name = self.app_state.reset_exercise_by_ind(exercise_ind)?;
- self.update_rows();
write!(
self.message,
"The exercise `{exercise_name}` has been reset",
)?;
+ self.update_rows();
Ok(())
}
@@ -422,3 +436,14 @@ impl<'a> ListState<'a> {
Ok(true)
}
}
+
+/// Draw an emphasized hotkey in the list footer.
+fn hotkey(writer: &mut MaxLenWriter, hotkey: &[u8]) -> io::Result<()> {
+ writer
+ .stdout
+ .queue(SetForegroundColor(Color::Yellow))?
+ .queue(SetAttribute(Attribute::Bold))?;
+ writer.write_ascii(hotkey)?;
+ writer.stdout.queue(ResetColor)?;
+ Ok(())
+}
diff --git a/src/main.rs b/src/main.rs
index a46f9fa1..d97a79f2 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -1,19 +1,27 @@
-use anyhow::{bail, Context, Result};
+use anyhow::{Context, Result, bail};
use app_state::StateFileStatus;
-use clap::{Parser, Subcommand};
+use clap::Parser;
use std::{
+ env,
io::{self, IsTerminal, Write},
path::Path,
process::ExitCode,
};
use term::{clear_terminal, press_enter_prompt};
-use self::{app_state::AppState, dev::DevCommands, info_file::InfoFile};
+use crate::{
+ app_state::AppState,
+ cli::{Args, Command},
+ editor::Editor,
+ info_file::InfoFile,
+};
mod app_state;
mod cargo_toml;
+mod cli;
mod cmd;
mod dev;
+mod editor;
mod embedded;
mod exercise;
mod info_file;
@@ -26,48 +34,6 @@ mod watch;
const CURRENT_FORMAT_VERSION: u8 = 1;
-/// Rustlings is a collection of small exercises to get you used to writing and reading Rust code
-#[derive(Parser)]
-#[command(version)]
-struct Args {
- #[command(subcommand)]
- command: Option
rustlings can't be foundβ¦") %}
+
+You are probably using Linux and installed Rust using your package manager.
+
+Cargo installs binaries to the directory `~/.cargo/bin`.
+Sadly, package managers often don't add `~/.cargo/bin` to your `PATH` environment variable.
+
+- Either add `~/.cargo/bin` manually to `PATH`
+- Or uninstall Rust from the package manager and [install it using the official way with `rustup`](https://www.rust-lang.org/tools/install)
+
+{% end %}
+
+Now, go into the newly initialized directory and launch Rustlings for further instructions on getting started with the exercises:
+
+```bash
+cd rustlings/
+rustlings
+```
+
+## Working environment
+
+### Editor
+
+Our general recommendation is [VS Code](https://code.visualstudio.com/) with the [rust-analyzer plugin](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer).
+But any editor that supports [rust-analyzer](https://rust-analyzer.github.io/) should be enough for working on the exercises.
+
+### Terminal
+
+While working with Rustlings, please use a modern terminal for the best user experience.
+The default terminal on Linux and Mac should be sufficient.
+On Windows, we recommend the [Windows Terminal](https://aka.ms/terminal).
+
+### Offline documentation
+
+Whenever you're working on Rustlings offline, you can access a local copy of the book or the standard library documentation by running `rustup doc --book` or `rustup doc --std`.
+
+## Usage
+
+After being done with the setup, visit the [**usage**](@/usage/index.md) page for some info about using Rustlings π
diff --git a/website/content/usage/index.md b/website/content/usage/index.md
new file mode 100644
index 00000000..88dabf4a
--- /dev/null
+++ b/website/content/usage/index.md
@@ -0,0 +1,55 @@
++++
+title = "Usage"
++++
+
+
+
+## Doing exercises
+
+The exercises are sorted by topic and can be found in the subdirectory `exercises/exercises/ directory failsβ¦") %}
+
+You can add the **`--manual-run`** flag (`rustlings --manual-run`) to manually rerun the current exercise by entering `r` in the watch mode.
+
+Please [report the issue](https://github.com/rust-lang/rustlings/issues/new) with some information about your operating system and whether you run Rustlings in a container or a virtual machine (e.g. WSL).
+
+{% end %}
+
+## Exercise List
+
+In the [watch mode](#watch-mode) (after launching `rustlings`), you can enter `l` to open the interactive exercise list.
+
+The list allows you toβ¦
+
+- See the status of all exercises (done or pending)
+- `c`: Continue at another exercise (temporarily skip some exercises or go back to a previous one)
+- `r`: Reset status and file of the selected exercise (you need to _reload/reopen_ its file in your editor afterwards)
+
+See the footer of the list for all possible keys.
+
+## Questions?
+
+If you need any help while doing the exercises and the builtin hints aren't helpful, feel free to ask in the [_Q&A_ discussions](https://github.com/rust-lang/rustlings/discussions/categories/q-a?discussions_q=) if your question isn't answered there π‘
+
+## Continuing On
+
+Once you've completed Rustlings, put your new knowledge to good use!
+Continue practicing your Rust skills by building your own projects, contributing to Rustlings, or finding other open-source projects to contribute to.
+
+> If you want to create your own Rustlings exercises, visit the [**community exercises**](@/community-exercises/index.md) page ποΈ
diff --git a/website/input.css b/website/input.css
new file mode 100644
index 00000000..01c956d6
--- /dev/null
+++ b/website/input.css
@@ -0,0 +1,50 @@
+@import 'tailwindcss';
+
+@layer base {
+ h1 {
+ @apply text-4xl mt-3 mb-3 font-bold;
+ }
+ h2 {
+ @apply text-3xl mt-4 mb-1.5 font-bold;
+ }
+ h3 {
+ @apply text-2xl mt-5 mb-1.5 font-bold;
+ }
+ h4 {
+ @apply text-xl mt-6 mb-1.5 font-bold;
+ }
+ p {
+ @apply mb-2;
+ }
+ a {
+ @apply text-[#FFC832] underline hover:decoration-orange-400 transition duration-300;
+ }
+ ul {
+ @apply mt-2 mb-3 ml-1 list-disc list-inside marker:text-sky-600;
+ }
+ ol {
+ @apply mt-2 mb-3 ml-1 list-decimal list-inside marker:text-sky-500;
+ }
+ li {
+ @apply my-0.5;
+ }
+ code {
+ @apply bg-white/10 px-1 pb-px pt-1 rounded-md;
+ }
+ pre code {
+ @apply bg-inherit p-0 text-inherit;
+ }
+ hr {
+ @apply my-5 rounded-full;
+ }
+ img {
+ @apply md:w-3/4 lg:w-3/5;
+ }
+ blockquote {
+ @apply px-3 pt-2 pb-px mb-4 mt-2 border-s-4 border-white/80 bg-white/7 rounded-sm;
+ }
+
+ pre {
+ @apply px-2 pt-2 pb-1.5 overflow-x-auto text-sm sm:text-base rounded-sm mt-2 mb-4 selection:bg-white/15;
+ }
+}
diff --git a/website/justfile b/website/justfile
new file mode 100644
index 00000000..7efc3ef9
--- /dev/null
+++ b/website/justfile
@@ -0,0 +1,5 @@
+zola:
+ zola serve --open
+
+tailwind:
+ npx @tailwindcss/cli -w -i input.css -o static/main.css
diff --git a/website/package.json b/website/package.json
new file mode 100644
index 00000000..80c84872
--- /dev/null
+++ b/website/package.json
@@ -0,0 +1,5 @@
+{
+ "dependencies": {
+ "@tailwindcss/cli": "^4"
+ }
+}
diff --git a/website/static/images/happy_ferris.svg b/website/static/images/happy_ferris.svg
new file mode 100644
index 00000000..c7f240dd
--- /dev/null
+++ b/website/static/images/happy_ferris.svg
@@ -0,0 +1,33 @@
+
+
+
diff --git a/website/static/images/panic.svg b/website/static/images/panic.svg
new file mode 100644
index 00000000..be55f5e0
--- /dev/null
+++ b/website/static/images/panic.svg
@@ -0,0 +1,70 @@
+
+
+
+
diff --git a/website/static/images/rust_logo.svg b/website/static/images/rust_logo.svg
new file mode 100644
index 00000000..3b42cfe0
--- /dev/null
+++ b/website/static/images/rust_logo.svg
@@ -0,0 +1,61 @@
+
diff --git a/website/templates/404.html b/website/templates/404.html
new file mode 100644
index 00000000..eb9d4691
--- /dev/null
+++ b/website/templates/404.html
@@ -0,0 +1,14 @@
+{% extends "base.html" %}
+
+{% block content %}
+
+{% endblock %}
diff --git a/website/templates/anchor-link.html b/website/templates/anchor-link.html
new file mode 100644
index 00000000..c8644d96
--- /dev/null
+++ b/website/templates/anchor-link.html
@@ -0,0 +1,2 @@
+
diff --git a/website/templates/base.html b/website/templates/base.html
new file mode 100644
index 00000000..1a55aebf
--- /dev/null
+++ b/website/templates/base.html
@@ -0,0 +1,92 @@
+
+
+
+
+
+
+ {%- set timestamp = now(timestamp=true) -%}
+
+ {%- if page.title -%}
+ {% set_global title = page.title %}
+ {%- elif section.title -%}
+ {% set_global title = section.title %}
+ {%- else -%}
+ {% set_global title = config.title %}
+ {%- endif -%}
+
+ {%- if page.description -%}
+ {% set_global description = page.description %}
+ {%- elif section.description -%}
+ {% set_global description = section.description %}
+ {%- else -%}
+ {% set_global description = config.description %}
+ {%- endif -%}
+
+ {%- if page.permalink -%}
+ {% set_global permalink = page.permalink %}
+ {%- elif section.permalink -%}
+ {% set_global permalink = section.permalink %}
+ {%- endif %}
+
+
+
+{% endblock %}
diff --git a/website/templates/page.html b/website/templates/page.html
new file mode 100644
index 00000000..b2f6c019
--- /dev/null
+++ b/website/templates/page.html
@@ -0,0 +1,39 @@
+{% extends "base.html" %}
+
+{% block content %}
+ Rustlings
+
+ {{ section.content | safe }}
+
+
+ {{ summary | safe }} (click to expand)
+
+
+
+ {{ body | markdown | safe }}
+
+