slidev-theme-arthistory/README.md

A specialized Slidev theme for art history presentations with RTL support and flexible image management

# Slidev Theme: Art History

[![NPM version](https://img.shields.io/npm/v/slidev-theme-arthistory?color=3AB9D4&label=)](https://www.npmjs.com/package/slidev-theme-arthistory)

A specialized Slidev theme designed for art history presentations with flexible image dataset management and RTL language support.

## Features

- 🎨 **Art-focused layouts** - Specialized layouts for image-heavy presentations
- 🌐 **RTL Support** - Automatic detection and support for Arabic/Persian content
- 📊 **Timeline layouts** - Interactive historical timelines with smooth navigation
- 🖼️ **Flexible Image Management** - Multiple data sources with centralized management
- 📱 **Responsive design** - Works beautifully on all screen sizes
- ✨ **Professional styling** - Academic presentation focus

## Installation

```bash
npm install slidev-theme-arthistory
# or
pnpm add slidev-theme-arthistory
```

## Basic Usage

```yaml
---
theme: slidev-theme-arthistory
---

# Your Art History Presentation
```

## Install

Add the following frontmatter to your `slides.md`. Start Slidev then it will prompt you to install the theme automatically.

<pre><code>---
theme: <b>arthistory</b>
---</code></pre>

Learn more about [how to use a theme](https://sli.dev/guide/theme-addon#use-theme).

## Layouts

This theme provides the following layouts:

### `image-grid`

Displays images in a responsive grid layout with optional captions and RTL support.

#### Basic Usage
```yaml
---
layout: image-grid
ids:
- image1
- image2
---
```

#### Props

- **`ids`** - Array of image IDs (legacy support)
- **`image`** - Array of image configurations (string IDs or objects with presets)
- **`preset`** - Default preset for all images: `thumbnail`, `default`, `hero`, `fullscreen`, `medium`, `detail`, `custom`
- **`customOptions`** - Custom Cloudinary transformation options when using `preset: custom`
- **`showCaptions`** - Show/hide captions (default: `true`)
- **`rtl`** - RTL text direction: `true`, `false`, or `'auto'` (default: `'auto'`)

#### Examples

**Hide Captions:**
```yaml
---
layout: image-grid
ids: [image1, image2]
showCaptions: false
---
```

**Force RTL Layout:**
```yaml
---
layout: image-grid
ids: [image1, image2]
rtl: true
---
```

**Mixed Image Presets:**
```yaml
---
layout: image-grid
image:
- id: image1
  preset: hero
- id: image2
  preset: thumbnail
---
```

### `timeline`

Interactive timeline layout with RTL support for historical presentations.

### `cover` and `intro`

Standard title and introduction layouts with theme styling.

## Components

This theme provides the following components:

> TODO:

## Contributing

- `npm install`
- `npm run dev` to start theme preview of `example.md`
- Edit the `example.md` and style to see the changes
- `npm run export` to generate the preview PDF
- `npm run screenshot` to generate the preview PNG