 | safe }})
+
+ {{ page.title }}
+ +
+
+
+
+ {{ page.content | safe }}
+
-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:
-
-- π―π΅ [Japanese Rustlings](https://github.com/sotanengel/rustlings-jp)οΌA Japanese translation of the Rustlings exercises.
-- π¨π³ [Simplified Chinese Rustlings](https://github.com/SandmeyerX/rustlings-zh-cn): A simplified Chinese 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) π
-
-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 62646c5bed..0000000000
--- 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/oranda.json b/oranda.json
deleted file mode 100644
index ecc490b20f..0000000000
--- a/oranda.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "project": {
- "homepage": "https://rustlings.cool",
- "repository": "https://github.com/rust-lang/rustlings"
- },
- "marketing": {
- "analytics": {
- "plausible": {
- "domain": "rustlings.cool"
- }
- }
- }
-}
diff --git a/src/app_state.rs b/src/app_state.rs
index d1c45d4963..f3f348133e 100644
--- a/src/app_state.rs
+++ b/src/app_state.rs
@@ -315,7 +315,7 @@ impl AppState {
}
// Official exercises: Dump the original file from the binary.
- // Third-party exercises: Reset the exercise file with `git stash`.
+ // Community exercises: Reset the exercise file with `git stash`.
fn reset(&self, exercise_ind: usize, path: &str) -> Result<()> {
if self.official_exercises {
return EMBEDDED_FILES
@@ -385,7 +385,7 @@ impl AppState {
}
/// Official exercises: Dump the solution file from the binary and return its path.
- /// Third-party exercises: Check if a solution file exists and return its path in that case.
+ /// Community exercises: Check if a solution file exists and return its path in that case.
pub fn current_solution_path(&self) -> ResultIf 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).
-
-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).
+
+## 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 0000000000..88dabf4ae4
--- /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 0000000000..af0675d8b7
--- /dev/null
+++ b/website/input.css
@@ -0,0 +1,54 @@
+@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-0.5 mb-4 mt-2 border-s-4 border-white/80 bg-white/7 rounded-sm;
+ }
+
+ pre {
+ @apply px-2 pt-2 pb-px overflow-x-auto text-sm sm:text-base rounded-sm mt-2 mb-4 after:content-[attr(data-lang)] after:text-[8px] after:opacity-40 selection:bg-white/15;
+ }
+ pre code mark {
+ @apply pb-0.5 pt-1 pr-px text-inherit rounded-xs;
+ }
+}
+
diff --git a/website/justfile b/website/justfile
new file mode 100644
index 0000000000..6d41913827
--- /dev/null
+++ b/website/justfile
@@ -0,0 +1,5 @@
+zola:
+ zola serve --open
+
+tailwind:
+ fnm exec --using latest 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 0000000000..f502431748
--- /dev/null
+++ b/website/package.json
@@ -0,0 +1,8 @@
+{
+ "dependencies": {
+ "@tailwindcss/cli": "^4.1"
+ },
+ "devDependencies": {
+ "rustywind": "^0.24"
+ }
+}
diff --git a/website/static/images/happy_ferris.svg b/website/static/images/happy_ferris.svg
new file mode 100644
index 0000000000..c7f240dd97
--- /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 0000000000..be55f5e09b
--- /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 0000000000..3b42cfe034
--- /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 0000000000..eb9d4691a7
--- /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 0000000000..c8644d96f7
--- /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 0000000000..1a55aebf67
--- /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 0000000000..b2f6c019c6
--- /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 }} ++