# WittyJokes

> A curated collection of witty, clever jokes with explanations, humor analysis, use cases, and downloadable social images. Every joke page is a standalone reference: it includes the full joke text, a plain-English explanation, a structural breakdown, why it's funny, who it suits, and when to use it.

## Site Purpose

WittyJokes publishes jokes as rich, citable content — not bare one-liners. The goal is for each page to be a complete answer to "tell me a joke and explain it." Content is human-curated and AI-assisted, covering dozens of joke categories with 100,000+ individual joke pages.

## Key Pages

- `/`: Homepage — featured jokes and category browser
- `/{category-slug}`: Category archive — all jokes in a category, paginated
- `/{category-slug}/{joke-slug}`: Individual joke — full content, schema markup, downloadable image
- `/about`: About WittyJokes — editorial policy and content overview
- `/random`: Redirect to a random published joke
- `/feed.xml`: RSS feed of the 20 most recent jokes
- `/sitemap.xml`: XML sitemap index (chunked, 10,000 URLs per file)
- `/llms-full.txt`: Full plain-text dump of jokes for LLM ingestion (paginated — append `?page=2`, `?page=3`, etc.)

## Content Fields Per Joke Page

Each individual joke page contains clearly labelled sections mapped to the following data fields:

- **Title**: The joke title (used as H1 and page title)
- **The Joke**: Full joke text — setup and punchline separated by a double line break
- **Witty's Word**: Short witty editorial commentary on the joke
- **Explain the Joke**: Plain-language explanation of the humour mechanism
- **Why People Love This Joke**: Emotional and social analysis of the joke's appeal
- **Joke Breakdown**: Line-by-line or structural breakdown of why each part works
- **When to Use This Joke**: Practical use cases, social contexts, and occasions
- **Quick Summary**: One-sentence summary of the joke and its appeal
- **Audience Fit**: Who this joke works best for (age, setting, relationship context)

## Structured Data

- All joke pages: `Article` + `FAQPage` (5–6 Q&A pairs) + `BreadcrumbList` schema (JSON-LD)
- Joke pages with votes: `AggregateRating` inside the Article schema
- All joke pages: `speakable` pointing at the joke text and explanation
- Category pages: `CollectionPage` + `BreadcrumbList` + `ItemList` schema
- Homepage: `WebSite` + `ItemList` (categories) schema
- All pages: `Organization` schema

## Crawling Notes

- All public content is freely crawlable — no paywalls, no login required
- Admin area is at `/admin/` — login-protected, not relevant for indexing
- Generated joke images are at `/generated/{category-slug}/{joke-slug}-{hash}.webp`
- Category images are at `/uploads/categories/{filename}`
- Background images used for image generation are at `/uploads/backgrounds/{filename}`
- Sitemap: `/sitemap.xml`
- RSS feed: `/feed.xml`
- Full text dump: `/llms-full.txt` (500 jokes per page)

## Example Joke Page Content

The following is a representative example of a WittyJokes joke page structure:

**Title**: Why don't scientists trust atoms?

**The Joke**:
Why don't scientists trust atoms?
Because they make up everything.

**Explanation**: The humour comes from the double meaning of "make up" — atoms literally compose all matter, but "make up" also means to fabricate or lie, creating a pun that reframes science as untrustworthy.

**Why It's Funny**: It uses wordplay to subvert the authority of science in a self-aware, absurdist way. The punchline lands because it takes a true scientific fact and twists its meaning.

**Audience Fit**: Works for adults and older teens; especially popular in science, education, and workplace settings. Safe for all audiences.

**When to Use It**: Ice-breakers, classroom settings, office environments, science events, or any situation where a clean, clever pun is appropriate.