Add MkDocs documentation site

- Add mkdocs.yml with Material theme and purple color scheme
- Create docs/ pages: index, installation, usage, examples, about-rice
- Add GitHub Actions workflow for automatic deployment to GitHub Pages
- Integrate auto-generated API docs for Bmp, Rice, and Std namespaces
- Streamline README to link to full documentation site

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: cfis

.github/workflows/docs.yml

@@ -0,0 +1,52 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install MkDocs and dependencies
+        run: pip install mkdocs-material
+
+      - name: Build docs
+        run: mkdocs build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -6,18 +6,6 @@ Ruby bindings for [BitmapPlusPlus](https://github.com/baderouaich/BitmapPlusPlus
 
 This gem serves as both a useful library and a **practical example of using [Rice](https://github.com/ruby-rice/rice) to create Ruby bindings for C++ libraries**.
 
-Rice is a C++ header-only library that makes it easy to create Ruby extensions. This project demonstrates several Rice features:
-
-- **Module and class definitions** - Wrapping C++ namespaces and classes
-- **Constructor overloading** - Multiple constructors with different signatures
-- **Method binding** - Direct mapping of C++ methods to Ruby
-- **Operator overloading** - Exposing C++ operators (`==`, `!=`, `[]`, etc.)
-- **Attribute access** - Binding C++ struct members as Ruby attributes
-- **STL integration** - Using `rice/stl.hpp` for automatic type conversions
-- **Iterator support** - Making C++ iterators work with Ruby's `each`
-- **Exception handling** - C++ exceptions converted to Ruby exceptions
-- **Default arguments** - Supporting optional parameters with defaults
-
 The binding code in `ext/bitmap_plus_plus/bitmap_plus_plus.cpp` is well-commented and can serve as a reference for your own Rice projects.
 
 ## Features
@@ -31,55 +19,7 @@ The binding code in `ext/bitmap_plus_plus/bitmap_plus_plus.cpp` is well-commente
 - 32 predefined colors
 - Iterator support for pixel enumeration
 
-## Installation
-
-### Prerequisites
-
-- Ruby 3.0 or higher
-- A C++17 compatible compiler
-- Rice gem (automatically installed as a dependency)
-
-### Install from RubyGems
-
-```bash
-gem install bitmap_plus_plus
-```
-
-### Install from source
-
-```bash
-git clone https://github.com/cfis/bitmap_plus_plus-ruby.git
-cd bitmap_plus_plus-ruby
-bundle install
-rake compile
-rake install
-```
-
-### Build with CMake
-
-For development, you can also build using CMake with presets:
-
-```bash
-# Linux
-cmake --preset linux-release
-cmake --build --preset linux-release
-
-# macOS
-cmake --preset macos-release
-cmake --build --preset macos-release
-
-# Windows (MSVC)
-cmake --preset msvc-release
-cmake --build --preset msvc-release
-
-# Windows (MinGW)
-cmake --preset mingw-release
-cmake --build --preset mingw-release
-```
-
-## Usage
-
-### Basic Example
+## Quick Start
 
 ```ruby
 require 'bitmap_plus_plus'
@@ -100,182 +40,22 @@ image.fill_circle(200, 200, 50, Bmp::Blue)
 image.save("output.bmp")
 ```
 
-### Creating Pixels
-
-```ruby
-# Create a pixel from RGB values (0-255)
-pixel = Bmp::Pixel.new(255, 128, 0)  # Orange
-
-# Create a pixel from a hex value
-pixel = Bmp::Pixel.new(0xFF8000)     # Also orange
-
-# Access RGB components
-puts pixel.r  # => 255
-puts pixel.g  # => 128
-puts pixel.b  # => 0
-```
-
-### Drawing Primitives
-
-```ruby
-image = Bmp::Bitmap.new(512, 512)
-
-# Draw a line from (x1, y1) to (x2, y2)
-image.draw_line(0, 0, 511, 511, Bmp::Yellow)
-
-# Draw a rectangle (outline only)
-image.draw_rect(50, 50, 100, 75, Bmp::Red)
-
-# Draw a filled rectangle
-image.fill_rect(200, 50, 100, 75, Bmp::Green)
-
-# Draw a triangle (outline only)
-image.draw_triangle(300, 100, 250, 200, 350, 200, Bmp::Cyan)
-
-# Draw a filled triangle
-image.fill_triangle(400, 100, 350, 200, 450, 200, Bmp::Magenta)
-
-# Draw a circle (outline only)
-image.draw_circle(100, 300, 50, Bmp::Gray)
-
-# Draw a filled circle
-image.fill_circle(250, 300, 50, Bmp::Lime)
-```
-
-### Pixel Access
-
-```ruby
-image = Bmp::Bitmap.new(100, 100)
-
-# Set a pixel at (x, y)
-image.set(50, 50, Bmp::Red)
-
-# Get a pixel at (x, y)
-pixel = image.get(50, 50)
-
-# Access via index (row-major order)
-pixel = image[5050]  # Same as get(50, 50) for 100-width image
-image[5050] = Bmp::Blue
-```
-
-### Image Transformations
-
-```ruby
-image = Bmp::Bitmap.new("input.bmp")
-
-# Flip vertically (returns new bitmap)
-flipped_v = image.flip_v
-
-# Flip horizontally (returns new bitmap)
-flipped_h = image.flip_h
-
-# Rotate 90 degrees left (returns new bitmap)
-rotated_left = image.rotate_90_left
-
-# Rotate 90 degrees right (returns new bitmap)
-rotated_right = image.rotate_90_right
-```
-
-### Iterating Over Pixels
-
-```ruby
-image = Bmp::Bitmap.new(100, 100)
-
-# Iterate over all pixels
-image.each do |pixel|
-  pixel.r = 255  # Set red channel
-end
-
-# Reverse iteration
-image.each_reverse do |pixel|
-  # Process pixels in reverse order
-end
-```
-
-### Predefined Colors
-
-The following colors are available as constants under the `Bmp` module:
-
-```
-Aqua, Beige, Black, Blue, Brown, Chocolate, Coral, Crimson, Cyan,
-Firebrick, Gold, Gray, Green, Indigo, Lavender, Lime, Magenta, Maroon,
-Navy, Olive, Orange, Pink, Purple, Red, Salmon, Silver, Snow, Teal,
-Tomato, Turquoise, Violet, White, Wheat, Yellow
-```
-
-### Loading and Saving
-
-```ruby
-# Load from file
-image = Bmp::Bitmap.new("photo.bmp")
-
-# Or load into existing bitmap
-image = Bmp::Bitmap.new
-image.load("photo.bmp")
+## Installation
 
-# Save to file
-image.save("output.bmp")
+```bash
+gem install bitmap_plus_plus
 ```
 
-## API Reference
-
-### Bmp::Bitmap
-
-| Method | Description |
-|--------|-------------|
-| `new()` | Create an empty bitmap |
-| `new(width, height)` | Create a bitmap with dimensions |
-| `new(filename)` | Load a bitmap from file |
-| `new(other)` | Copy constructor |
-| `width` | Get image width |
-| `height` | Get image height |
-| `clear(color = Black)` | Fill entire image with color |
-| `get(x, y)` | Get pixel at coordinates |
-| `set(x, y, color)` | Set pixel at coordinates |
-| `[index]` | Get pixel by linear index |
-| `[index]=` | Set pixel by linear index |
-| `draw_line(x1, y1, x2, y2, color)` | Draw a line |
-| `draw_rect(x, y, w, h, color)` | Draw rectangle outline |
-| `fill_rect(x, y, w, h, color)` | Draw filled rectangle |
-| `draw_triangle(x1, y1, x2, y2, x3, y3, color)` | Draw triangle outline |
-| `fill_triangle(x1, y1, x2, y2, x3, y3, color)` | Draw filled triangle |
-| `draw_circle(cx, cy, radius, color)` | Draw circle outline |
-| `fill_circle(cx, cy, radius, color)` | Draw filled circle |
-| `flip_v` | Return vertically flipped copy |
-| `flip_h` | Return horizontally flipped copy |
-| `rotate_90_left` | Return 90-degree left rotated copy |
-| `rotate_90_right` | Return 90-degree right rotated copy |
-| `save(filename)` | Save to BMP file |
-| `load(filename)` | Load from BMP file |
-| `each` | Iterate over pixels |
-| `each_reverse` | Iterate in reverse |
+For detailed installation options including building from source and CMake builds, see the [Installation Guide](https://cfis.github.io/bitmap_plus_plus-ruby/installation/).
 
-### Bmp::Pixel
+## Documentation
 
-| Method | Description |
-|--------|-------------|
-| `new()` | Create black pixel (0, 0, 0) |
-| `new(rgb)` | Create from hex value (0xRRGGBB) |
-| `new(r, g, b)` | Create from RGB components |
-| `r`, `g`, `b` | Access color components |
-| `r=`, `g=`, `b=` | Set color components |
-| `==`, `!=` | Comparison operators |
+Full documentation is available at **[https://cfis.github.io/bitmap_plus_plus-ruby/](https://cfis.github.io/bitmap_plus_plus-ruby/)**
 
-## Examples
-
-See the `examples/` directory for runnable examples:
-
-- `draw_primitives.rb` - Drawing shapes (lines, rectangles, triangles, circles)
-- `mandelbrot.rb` - Mandelbrot set fractal generator
-- `julia.rb` - Julia set fractal generator
-- `random_colors.rb` - Random pixel colors using iterators
-- `transformations.rb` - Image flip and rotate operations
-
-Run an example:
-```bash
-cd examples
-ruby draw_primitives.rb
-```
+- [Usage Guide](https://cfis.github.io/bitmap_plus_plus-ruby/usage/) - Complete usage documentation
+- [Examples](https://cfis.github.io/bitmap_plus_plus-ruby/examples/) - Runnable example scripts
+- [API Reference](https://cfis.github.io/bitmap_plus_plus-ruby/api/Bmp/Bitmap/) - Detailed API documentation
+- [About Rice](https://cfis.github.io/bitmap_plus_plus-ruby/about-rice/) - Rice features demonstrated in this project
 
 ## License