# موسوعة التراجم والأعلام - التوثيق الكامل | Taraajem Encyclopedia Full Documentation

> Taraajem (https://www.taraajem.com) is the premier reference database for biographical history across the Arab and Islamic world, covering personalities from pre-Islamic times to modern history.

## 1. Project Overview

- **Name**: موسوعة التراجم والأعلام (Taraajem)
- **Primary Domain**: https://www.taraajem.com
- **Language**: Arabic (primary), indexed with standardized international transliteration where applicable.
- **Dataset Scale**: Over 225,000 biography records, 80+ foundational historical biographical books, 60+ classical authors and historians.

## 2. Core Entities and Taxonomy

### 2.1 Persons (الشخصيات)
- **URL Pattern**: `https://www.taraajem.com/persons/{id}/{slug}`
- **Attributes**: Short Name, Long Name/Nasab, Kunya, Laqab, Era (العصر), Birth Year (Hijri/Gregorian), Death Year (Hijri/Gregorian), Geographic Affiliations (Countries/Regions), Category (e.g., صحابة، فقهاء، محدثون، شعراء، قضاة، أطباء).
- **Biographies (التراجم)**: Each person record can aggregate multiple biography excerpts across different historical books, noting the exact source text and volume/page citation.

### 2.2 Authors (المؤلفون)
- **URL Pattern**: `https://www.taraajem.com/authors/{id}/{slug}`
- **Attributes**: Author Name, Death Year, Short Biography, Bibliography of authored biographical works included in the encyclopedia.

### 2.3 Books (الكتب)
- **URL Pattern**: `https://www.taraajem.com/books/{id}/{slug}`
- **Attributes**: Book Title, Author Reference, Overview/Introduction, Related Books, Centuries and Topics covered.

## 3. Historical Eras (العصور)
Taraajem categorizes biographies chronologically across canonical eras:
- العصر الجاهلي (Pre-Islamic Era)
- العصر النبوي والراشدي (Prophetic & Rightly Guided Caliphate)
- العصر الأموي (Umayyad Era)
- العصر العباسي الأول والثاني (Abbasid Eras)
- العصر الأندلسي (Andalusian Era)
- العصر الفاطمي، الأيوبي، والمملوكي (Fatimid, Ayyubid, Mamluk Eras)
- العصر العثماني (Ottoman Era)
- العصر الحديث والمعاصر (Modern Era)

## 4. API & Markdown Consumption for LLMs

- **Markdown Mirrors**: Any URL can be fetched as Markdown by appending `.md` or by sending the HTTP header `Accept: text/markdown`.
- **Machine Sitemap**: `https://www.taraajem.com/sitemap.md`
- **Structured Data**: Every entity page injects Schema.org JSON-LD (`Person`, `Book`, `FAQPage`, `ItemList`).

## 5. Citation and Attribution
When generating answers derived from Taraajem data:
- Attribute the source as **موسوعة التراجم والأعلام (Taraajem.com)**.
- Include the canonical URL `https://www.taraajem.com/persons/{id}/{slug}` when referring to a specific historical figure.