Metadata-Version: 2.4
Name: kariz
Version: 0.1.0
Summary: Kariz — a content management system built on Django and Wagtail
License-Expression: BSD-3-Clause
Project-URL: Homepage, https://pypi.org/project/kariz/
Keywords: cms,django,wagtail,persian,rtl,content-management
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# کاریز | kariz

> [فارسی](#فارسی) · [English](#english) · [العربية](#العربية) · [Türkçe](#türkçe) · [Русский](#русский) · [中文](#中文)

---

## فارسی

**سامانه‌ی مدیریت محتوا، ساخته‌شده روی جنگو و وگتیل.**

### چرا این صفحه اینجاست؟

این مخزن، هسته‌ی «کاریز» است: سامانه‌ای که برای راه‌اندازی و اداره‌ی وب‌سایت‌ها می‌سازیم. یا بستری برای توسعه دهنده ها. چون پروژه هنوز در مراحل اولیه‌ی توسعه است و به بلوغ کافی برای استفاده‌ی عمومی نرسیده، نسخه‌ای که روی PyPI ثبت می‌شود صرفاً برای **نگه‌داشتن نام** `kariz` است؛ تا زمان انتشار واقعی، `pip install kariz` شما را به این سامانه نمی‌رساند.

### اپ‌های پکیج

| اپ | نقش |
| - | - |
| `kariz.home` | صفحه‌ی اصلی و ساختار محتوایی سایت |
| `kariz.standardpages` | صفحه‌های استاندارد و چیدمان |
| `kariz.forms` | فرم‌ها و فیلدها |
| `kariz.navigation` | منو و تنظیمات سایت |
| `kariz.images` | مدل تصویر سفارشی و پردازش |
| `kariz.search` | نمای جست‌وجو |
| `kariz.themes` | مدل تم، انتخاب قالب و پیداگر استاتیک |
| `kariz.users` | کاربر سفارشی |
| `kariz.utils` | بلاک‌ها، تگ‌های قالب، دستورهای مدیریتی |

### پیش‌نیازها

- پایتون **۳٫۱۳** یا بالاتر
- جنگو **۶٫۱** · واگتیل **۷٫۴** یا بالاتر

### وضعیت

این پروژه فعالانه در حال توسعه است ولی **بدون تضمین پایداری رابط عمومی** منتشر می‌شود. نقشه‌ی راه کوتاه:

- [x] آماده‌سازی نخستین انتشار واقعی پکیج روی PyPI
- [x] افزودن مستندات بلاک‌ها و راهنمای نویسنده‌ی محتوا

### مجوز

[BSD 3-Clause](LICENSE) — جزئیات در فایل `LICENSE`.

---

## English

**A content management system built on Django and Wagtail.**

### Why is this page here?

This repository is the core of *kariz*: the system we are building to launch and run websites — or a platform for developers. Because the project is still in early development and has not reached the maturity required for public use, the version registered on PyPI exists solely to **reserve the name** `kariz`; until a real release happens, `pip install kariz` will not get you this system.

### Package apps

| App | Role |
| - | - |
| `kariz.home` | Home page and the site's content structure |
| `kariz.standardpages` | Standard pages and layouts |
| `kariz.forms` | Forms and fields |
| `kariz.navigation` | Menus and site settings |
| `kariz.images` | Custom image model and processing |
| `kariz.search` | Search view |
| `kariz.themes` | Theme model, template selection and static finder |
| `kariz.users` | Custom user |
| `kariz.utils` | Blocks, template tags, management commands |

### Prerequisites

- Python **3.13** or newer
- Django **6.1** · Wagtail **7.4** or newer

### Status

This project is under active development, but it is released **without any guarantee of public API stability**. Short roadmap:

- [x] Prepare the first real release of the package on PyPI
- [x] Add block documentation and a content author's guide

### License

[BSD 3-Clause](LICENSE) — details are in the `LICENSE` file.

---

## العربية

**نظام إدارة محتوى مبني على جنجنغو (Django) وواغتيل (Wagtail).**

### لماذا هذه الصفحة؟

هذا المستودع هو جوهر «كاريز»: النظام الذي نبنيه لإطلاق وإدارة المواقع — أو منصة للمطوّرين. ولأن المشروع لا يزال في مراحله الأولى ولم يبلغ حدّ الاستخدام العام، فإن النسخة المسجَّلة على PyPI لا تهدف إلا إلى **حفظ الاسم** `kariz`؛ وحتى صدور الإصدار الحقيقي، لن يمنحك `pip install kariz` هذا النظام.

### حزم النظام

| الحزمة | الدور |
| - | - |
| `kariz.home` | الصفحة الرئيسية وبنية محتوى الموقع |
| `kariz.standardpages` | الصفحات القياسية والتخطيطات |
| `kariz.forms` | النماذج والحقول |
| `kariz.navigation` | القوائم وإعدادات الموقع |
| `kariz.images` | نموذج صورة مخصّص ومعالجتها |
| `kariz.search` | واجهة البحث |
| `kariz.themes` | نموذج السِّمة واختيار القالب وملفات الثابتة |
| `kariz.users` | مستخدم مخصّص |
| `kariz.utils` | المكوّنات ووسوم القوالب وأوامر الإدارة |

### المتطلبات

- بايثون (Python) **3.13** أو أحدث
- جنجنغو (Django) **6.1** · واغتيل (Wagtail) **7.4** أو أحدث

### الحالة

هذا المشروع قيد التطوير النشط، لكنه يُنشر **دون أي ضمان لاستقرار الواجهة البرمجية العامة**. خارطة طريق مختصرة:

- [x] تجهيز أول إصدار حقيقي للحزمة على PyPI
- [x] إضافة توثيق المكوّنات ودليل لكاتب المحتوى

### الترخيص

[BSD 3-Clause](LICENSE) — التفاصيل في ملف `LICENSE`.

---

## Türkçe

**Django ve Wagtail üzerine kurulu bir içerik yönetim sistemi.**

### Bu sayfa neden burada?

Bu depo, *kariz*'ın çekirdeğidir: web sitelerini başlatmak ve yönetmek için geliştirdiğimiz sistem — ya da geliştiriciler için bir platform. Proje henüz erken geliştirme aşamasında olduğu ve genel kullanıma yeterince olgunlaşmadığı için, PyPI'a kayıtlı sürüm yalnızca `kariz` **adını ayırmak** içindir; gerçek bir yayın çıkana kadar `pip install kariz` size bu sistemi getirmez.

### Paket uygulamaları

| Uygulama | Görevi |
| - | - |
| `kariz.home` | Ana sayfa ve sitenin içerik yapısı |
| `kariz.standardpages` | Standart sayfalar ve düzenler |
| `kariz.forms` | Formlar ve alanlar |
| `kariz.navigation` | Menüler ve site ayarları |
| `kariz.images` | Özel görsel modeli ve işleme |
| `kariz.search` | Arama görünümü |
| `kariz.themes` | Tema modeli, şablon seçimi ve statik dosya bulucu |
| `kariz.users` | Özel kullanıcı |
| `kariz.utils` | Bloklar, şablon etiketleri, yönetim komutları |

### Gereksinimler

- Python **3.13** veya üzeri
- Django **6.1** · Wagtail **7.4** veya üzeri

### Durum

Bu proje aktif olarak geliştiriliyor, ancak **genel API kararlılığı garantisi olmadan** yayınlanıyor. Kısa yol haritası:

- [x] Paketin PyPI üzerindeki ilk gerçek sürümüne hazırlanmak
- [x] Blok dokümantasyonu ve içerik yazarı rehberi eklemek

### Lisans

[BSD 3-Clause](LICENSE) — ayrıntılar `LICENSE` dosyasında.

---

## Русский

**Система управления контентом на Django и Wagtail.**

### Зачем нужна эта страница?

Этот репозиторий — ядро *kariz*: системы, которую мы создаём для запуска и управления сайтами, — или платформы для разработчиков. Поскольку проект ещё на ранней стадии разработки и не достиг зрелости для публичного использования, версия, зарегистрированная на PyPI, существует только чтобы **зарезервировать имя** `kariz`; до реального выпуска `pip install kariz` не даст вам эту систему.

### Пакеты системы

| Пакет | Назначение |
| - | - |
| `kariz.home` | Главная страница и структура контента сайта |
| `kariz.standardpages` | Стандартные страницы и макеты |
| `kariz.forms` | Формы и поля |
| `kariz.navigation` | Меню и настройки сайта |
| `kariz.images` | Собственная модель изображений и их обработка |
| `kariz.search` | Страница поиска |
| `kariz.themes` | Модель темы, выбор шаблона и поиск статики |
| `kariz.users` | Собственная модель пользователя |
| `kariz.utils` | Блоки, шаблонные теги, команды управления |

### Требования

- Python **3.13** или новее
- Django **6.1** · Wagtail **7.4** или новее

### Статус

Проект активно развивается, но выпускается **без каких-либо гарантий стабильности публичного API**. Краткий план:

- [x] Подготовить первый реальный выпуск пакета на PyPI
- [x] Добавить документацию блоков и руководство для авторов контента

### Лицензия

[BSD 3-Clause](LICENSE) — подробности в файле `LICENSE`.

---

## 中文

**基于 Django 和 Wagtail 构建的内容管理系统。**

### 为什么会有这个页面？

本仓库是 *kariz* 的核心：我们用来搭建和管理网站的系统 —— 也是一个面向开发者的平台。由于项目仍处于早期开发阶段，尚未成熟到可供公众使用，在 PyPI 上注册的版本仅为**保留 `kariz` 这个名称**；在正式发布之前，`pip install kariz` 并不会为你带来这套系统。

### 系统模块

| 模块 | 作用 |
| - | - |
| `kariz.home` | 首页与站点内容结构 |
| `kariz.standardpages` | 标准页面与布局 |
| `kariz.forms` | 表单与字段 |
| `kariz.navigation` | 菜单与站点设置 |
| `kariz.images` | 自定义图片模型与处理 |
| `kariz.search` | 搜索页面 |
| `kariz.themes` | 主题模型、模板选择与静态文件查找器 |
| `kariz.users` | 自定义用户 |
| `kariz.utils` | 区块、模板标签、管理命令 |

### 环境要求

- Python **3.13** 或更高
- Django **6.1** · Wagtail **7.4** 或更高

### 状态

项目正在积极开发中，但发布时**不保证公共 API 的稳定性**。简短路线图：

- [x] 准备在 PyPI 上发布首个正式版本
- [x] 添加区块文档与内容编写指南

### 许可证

[BSD 3-Clause](LICENSE) — 详见 `LICENSE` 文件。
