rustic-ssg

Crates.iorustic-ssg
lib.rsrustic-ssg
version0.0.3
sourcesrc
created_at2024-11-12 09:08:17.333082
updated_at2024-11-29 17:03:06.415722
descriptionA simple, efficient static site generator written with Rust.
homepage
repositoryhttps://github.com/BersisSe/Rustic
max_upload_size
id1444684
size94,490
Bersis Sevimli (BersisSe)

documentation

README

Rustic 🌲

Rustic is a fast and minimalistic static site generator built with Rust. Create stunning websites with simplicity, flexibility, and lightning-fast performance.


🚀 Features

  • Dynamic Markdown to HTML conversion with templating support.
  • Lightning-fast builds leveraging Rust's performance.
  • Live preview server with hot reload.
  • Customizable themes and templates.
  • Simple CLI for seamless workflows.

📥 Installation

1. Install via Cargo

Ensure you have Rust installed, then run:

cargo install rustic-ssg

2. Download Prebuilt Binaries

Download prebuilt binaries from the Releases Page.
Add the binary to your system PATH to use it globally.

3. Build from Source

Clone the repository and build using Cargo:

git clone https://github.com/your-username/rustic-core.git
cd rustic-core
cargo build --release

Move the resulting binary (target/release/rustic) to a directory in your PATH.


🛠️ Usage

Commands

Command Description
rustic init Initialize a new Rustic project.
rustic build Generate the static site in the output/ folder.
rustic serve Start a local server with hot reload.
rustic clean Remove the output/ directory.
rustic help Display command usage and options.

Example Workflow

  1. Initialize a project:
    rustic init
    cd my-rustic-site
    
  2. Build the site:
    rustic build
    
  3. Preview locally:
    rustic serve
    
  4. Clean the build:
    rustic clean
    

✨ Documentation

Detailed guides and examples are available in the Documentation.


🌍 Community


📜 License

Rustic is open-source software, licensed under the Apache-2.0 License.

Commit count: 38

cargo fmt