README.md

Rust-edu

Rust Edu is an organization dedicated to supporting Rust education in the academic environment. This website is built using Zola, a blazing-fast static site generator in Rust.

🚀 Setting Up on Local Machine

To contribute or run this website locally, follow the steps below.

✅ Requirements

• Rust installed
• Zola (cargo install zola) installed

📦 Installation Steps

1. Clone the Repository

git clone https://github.com/rust-edu/rust-edu.github.io.git
cd rust-edu.github.io

2. Install Zola

Install Zola using Cargo:

cargo install zola

If that fails, download a binary from Zola Releases.

3. Initialize Submodules

To load the external CSS themes (Bulma & Bulmaswatch):

git submodule update --init --recursive

💻 Run Locally

Start a local development server:

zola serve

Your site will be live at: http://127.0.0.1:1111

Zola will auto-reload when changes are made.

🐛 Common Issues

❌ Can't find stylesheet to import error?

Ensure submodules are initialized:

git submodule update --init --recursive

❌ Variable config.extra.navbar not found?

Ensure your config.toml includes a [extra] section:

[extra]
navbar = [
  { name = "Home", url = "/" },
  { name = "News", url = "/news" },,
  { name = "Resources", url = "/resources" }
]

📬 Get Involved

Interested in contributing or learning more?

• 🌐 Visit: https://rust-edu.org/
• 📧 Email: contact@rust-edu.org Let’s build the future of Rust education together!