kariz 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
kariz-0.1.0/LICENSE ADDED
@@ -0,0 +1,27 @@
1
+ Copyright (c) 2026-present, no-name contributors
2
+ All rights reserved.
3
+
4
+ Redistribution and use in source and binary forms, with or without
5
+ modification, are permitted provided that the following conditions are met:
6
+
7
+ 1. Redistributions of source code must retain the above copyright notice, this
8
+ list of conditions and the following disclaimer.
9
+
10
+ 2. Redistributions in binary form must reproduce the above copyright notice,
11
+ this list of conditions and the following disclaimer in the documentation
12
+ and/or other materials provided with the distribution.
13
+
14
+ 3. Neither the name of the copyright holder nor the names of its
15
+ contributors may be used to endorse or promote products derived from
16
+ this software without specific prior written permission.
17
+
18
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
22
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
25
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
kariz-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,263 @@
1
+ Metadata-Version: 2.4
2
+ Name: kariz
3
+ Version: 0.1.0
4
+ Summary: Kariz — a content management system built on Django and Wagtail
5
+ License-Expression: BSD-3-Clause
6
+ Project-URL: Homepage, https://pypi.org/project/kariz/
7
+ Keywords: cms,django,wagtail,persian,rtl,content-management
8
+ Classifier: Development Status :: 2 - Pre-Alpha
9
+ Classifier: Environment :: Web Environment
10
+ Classifier: Framework :: Django
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: Operating System :: OS Independent
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.13
15
+ Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
16
+ Requires-Python: >=3.13
17
+ Description-Content-Type: text/markdown
18
+ License-File: LICENSE
19
+ Dynamic: license-file
20
+
21
+ # کاریز | kariz
22
+
23
+ > [فارسی](#فارسی) · [English](#english) · [العربية](#العربية) · [Türkçe](#türkçe) · [Русский](#русский) · [中文](#中文)
24
+
25
+ ---
26
+
27
+ ## فارسی
28
+
29
+ **سامانه‌ی مدیریت محتوا، ساخته‌شده روی جنگو و وگتیل.**
30
+
31
+ ### چرا این صفحه اینجاست؟
32
+
33
+ این مخزن، هسته‌ی «کاریز» است: سامانه‌ای که برای راه‌اندازی و اداره‌ی وب‌سایت‌ها می‌سازیم. یا بستری برای توسعه دهنده ها. چون پروژه هنوز در مراحل اولیه‌ی توسعه است و به بلوغ کافی برای استفاده‌ی عمومی نرسیده، نسخه‌ای که روی PyPI ثبت می‌شود صرفاً برای **نگه‌داشتن نام** `kariz` است؛ تا زمان انتشار واقعی، `pip install kariz` شما را به این سامانه نمی‌رساند.
34
+
35
+ ### اپ‌های پکیج
36
+
37
+ | اپ | نقش |
38
+ | - | - |
39
+ | `kariz.home` | صفحه‌ی اصلی و ساختار محتوایی سایت |
40
+ | `kariz.standardpages` | صفحه‌های استاندارد و چیدمان |
41
+ | `kariz.forms` | فرم‌ها و فیلدها |
42
+ | `kariz.navigation` | منو و تنظیمات سایت |
43
+ | `kariz.images` | مدل تصویر سفارشی و پردازش |
44
+ | `kariz.search` | نمای جست‌وجو |
45
+ | `kariz.themes` | مدل تم، انتخاب قالب و پیداگر استاتیک |
46
+ | `kariz.users` | کاربر سفارشی |
47
+ | `kariz.utils` | بلاک‌ها، تگ‌های قالب، دستورهای مدیریتی |
48
+
49
+ ### پیش‌نیازها
50
+
51
+ - پایتون **۳٫۱۳** یا بالاتر
52
+ - جنگو **۶٫۱** · واگتیل **۷٫۴** یا بالاتر
53
+
54
+ ### وضعیت
55
+
56
+ این پروژه فعالانه در حال توسعه است ولی **بدون تضمین پایداری رابط عمومی** منتشر می‌شود. نقشه‌ی راه کوتاه:
57
+
58
+ - [x] آماده‌سازی نخستین انتشار واقعی پکیج روی PyPI
59
+ - [x] افزودن مستندات بلاک‌ها و راهنمای نویسنده‌ی محتوا
60
+
61
+ ### مجوز
62
+
63
+ [BSD 3-Clause](LICENSE) — جزئیات در فایل `LICENSE`.
64
+
65
+ ---
66
+
67
+ ## English
68
+
69
+ **A content management system built on Django and Wagtail.**
70
+
71
+ ### Why is this page here?
72
+
73
+ 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.
74
+
75
+ ### Package apps
76
+
77
+ | App | Role |
78
+ | - | - |
79
+ | `kariz.home` | Home page and the site's content structure |
80
+ | `kariz.standardpages` | Standard pages and layouts |
81
+ | `kariz.forms` | Forms and fields |
82
+ | `kariz.navigation` | Menus and site settings |
83
+ | `kariz.images` | Custom image model and processing |
84
+ | `kariz.search` | Search view |
85
+ | `kariz.themes` | Theme model, template selection and static finder |
86
+ | `kariz.users` | Custom user |
87
+ | `kariz.utils` | Blocks, template tags, management commands |
88
+
89
+ ### Prerequisites
90
+
91
+ - Python **3.13** or newer
92
+ - Django **6.1** · Wagtail **7.4** or newer
93
+
94
+ ### Status
95
+
96
+ This project is under active development, but it is released **without any guarantee of public API stability**. Short roadmap:
97
+
98
+ - [x] Prepare the first real release of the package on PyPI
99
+ - [x] Add block documentation and a content author's guide
100
+
101
+ ### License
102
+
103
+ [BSD 3-Clause](LICENSE) — details are in the `LICENSE` file.
104
+
105
+ ---
106
+
107
+ ## العربية
108
+
109
+ **نظام إدارة محتوى مبني على جنجنغو (Django) وواغتيل (Wagtail).**
110
+
111
+ ### لماذا هذه الصفحة؟
112
+
113
+ هذا المستودع هو جوهر «كاريز»: النظام الذي نبنيه لإطلاق وإدارة المواقع — أو منصة للمطوّرين. ولأن المشروع لا يزال في مراحله الأولى ولم يبلغ حدّ الاستخدام العام، فإن النسخة المسجَّلة على PyPI لا تهدف إلا إلى **حفظ الاسم** `kariz`؛ وحتى صدور الإصدار الحقيقي، لن يمنحك `pip install kariz` هذا النظام.
114
+
115
+ ### حزم النظام
116
+
117
+ | الحزمة | الدور |
118
+ | - | - |
119
+ | `kariz.home` | الصفحة الرئيسية وبنية محتوى الموقع |
120
+ | `kariz.standardpages` | الصفحات القياسية والتخطيطات |
121
+ | `kariz.forms` | النماذج والحقول |
122
+ | `kariz.navigation` | القوائم وإعدادات الموقع |
123
+ | `kariz.images` | نموذج صورة مخصّص ومعالجتها |
124
+ | `kariz.search` | واجهة البحث |
125
+ | `kariz.themes` | نموذج السِّمة واختيار القالب وملفات الثابتة |
126
+ | `kariz.users` | مستخدم مخصّص |
127
+ | `kariz.utils` | المكوّنات ووسوم القوالب وأوامر الإدارة |
128
+
129
+ ### المتطلبات
130
+
131
+ - بايثون (Python) **3.13** أو أحدث
132
+ - جنجنغو (Django) **6.1** · واغتيل (Wagtail) **7.4** أو أحدث
133
+
134
+ ### الحالة
135
+
136
+ هذا المشروع قيد التطوير النشط، لكنه يُنشر **دون أي ضمان لاستقرار الواجهة البرمجية العامة**. خارطة طريق مختصرة:
137
+
138
+ - [x] تجهيز أول إصدار حقيقي للحزمة على PyPI
139
+ - [x] إضافة توثيق المكوّنات ودليل لكاتب المحتوى
140
+
141
+ ### الترخيص
142
+
143
+ [BSD 3-Clause](LICENSE) — التفاصيل في ملف `LICENSE`.
144
+
145
+ ---
146
+
147
+ ## Türkçe
148
+
149
+ **Django ve Wagtail üzerine kurulu bir içerik yönetim sistemi.**
150
+
151
+ ### Bu sayfa neden burada?
152
+
153
+ 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.
154
+
155
+ ### Paket uygulamaları
156
+
157
+ | Uygulama | Görevi |
158
+ | - | - |
159
+ | `kariz.home` | Ana sayfa ve sitenin içerik yapısı |
160
+ | `kariz.standardpages` | Standart sayfalar ve düzenler |
161
+ | `kariz.forms` | Formlar ve alanlar |
162
+ | `kariz.navigation` | Menüler ve site ayarları |
163
+ | `kariz.images` | Özel görsel modeli ve işleme |
164
+ | `kariz.search` | Arama görünümü |
165
+ | `kariz.themes` | Tema modeli, şablon seçimi ve statik dosya bulucu |
166
+ | `kariz.users` | Özel kullanıcı |
167
+ | `kariz.utils` | Bloklar, şablon etiketleri, yönetim komutları |
168
+
169
+ ### Gereksinimler
170
+
171
+ - Python **3.13** veya üzeri
172
+ - Django **6.1** · Wagtail **7.4** veya üzeri
173
+
174
+ ### Durum
175
+
176
+ Bu proje aktif olarak geliştiriliyor, ancak **genel API kararlılığı garantisi olmadan** yayınlanıyor. Kısa yol haritası:
177
+
178
+ - [x] Paketin PyPI üzerindeki ilk gerçek sürümüne hazırlanmak
179
+ - [x] Blok dokümantasyonu ve içerik yazarı rehberi eklemek
180
+
181
+ ### Lisans
182
+
183
+ [BSD 3-Clause](LICENSE) — ayrıntılar `LICENSE` dosyasında.
184
+
185
+ ---
186
+
187
+ ## Русский
188
+
189
+ **Система управления контентом на Django и Wagtail.**
190
+
191
+ ### Зачем нужна эта страница?
192
+
193
+ Этот репозиторий — ядро *kariz*: системы, которую мы создаём для запуска и управления сайтами, — или платформы для разработчиков. Поскольку проект ещё на ранней стадии разработки и не достиг зрелости для публичного использования, версия, зарегистрированная на PyPI, существует только чтобы **зарезервировать имя** `kariz`; до реального выпуска `pip install kariz` не даст вам эту систему.
194
+
195
+ ### Пакеты системы
196
+
197
+ | Пакет | Назначение |
198
+ | - | - |
199
+ | `kariz.home` | Главная страница и структура контента сайта |
200
+ | `kariz.standardpages` | Стандартные страницы и макеты |
201
+ | `kariz.forms` | Формы и поля |
202
+ | `kariz.navigation` | Меню и настройки сайта |
203
+ | `kariz.images` | Собственная модель изображений и их обработка |
204
+ | `kariz.search` | Страница поиска |
205
+ | `kariz.themes` | Модель темы, выбор шаблона и поиск статики |
206
+ | `kariz.users` | Собственная модель пользователя |
207
+ | `kariz.utils` | Блоки, шаблонные теги, команды управления |
208
+
209
+ ### Требования
210
+
211
+ - Python **3.13** или новее
212
+ - Django **6.1** · Wagtail **7.4** или новее
213
+
214
+ ### Статус
215
+
216
+ Проект активно развивается, но выпускается **без каких-либо гарантий стабильности публичного API**. Краткий план:
217
+
218
+ - [x] Подготовить первый реальный выпуск пакета на PyPI
219
+ - [x] Добавить документацию блоков и руководство для авторов контента
220
+
221
+ ### Лицензия
222
+
223
+ [BSD 3-Clause](LICENSE) — подробности в файле `LICENSE`.
224
+
225
+ ---
226
+
227
+ ## 中文
228
+
229
+ **基于 Django 和 Wagtail 构建的内容管理系统。**
230
+
231
+ ### 为什么会有这个页面?
232
+
233
+ 本仓库是 *kariz* 的核心:我们用来搭建和管理网站的系统 —— 也是一个面向开发者的平台。由于项目仍处于早期开发阶段,尚未成熟到可供公众使用,在 PyPI 上注册的版本仅为**保留 `kariz` 这个名称**;在正式发布之前,`pip install kariz` 并不会为你带来这套系统。
234
+
235
+ ### 系统模块
236
+
237
+ | 模块 | 作用 |
238
+ | - | - |
239
+ | `kariz.home` | 首页与站点内容结构 |
240
+ | `kariz.standardpages` | 标准页面与布局 |
241
+ | `kariz.forms` | 表单与字段 |
242
+ | `kariz.navigation` | 菜单与站点设置 |
243
+ | `kariz.images` | 自定义图片模型与处理 |
244
+ | `kariz.search` | 搜索页面 |
245
+ | `kariz.themes` | 主题模型、模板选择与静态文件查找器 |
246
+ | `kariz.users` | 自定义用户 |
247
+ | `kariz.utils` | 区块、模板标签、管理命令 |
248
+
249
+ ### 环境要求
250
+
251
+ - Python **3.13** 或更高
252
+ - Django **6.1** · Wagtail **7.4** 或更高
253
+
254
+ ### 状态
255
+
256
+ 项目正在积极开发中,但发布时**不保证公共 API 的稳定性**。简短路线图:
257
+
258
+ - [x] 准备在 PyPI 上发布首个正式版本
259
+ - [x] 添加区块文档与内容编写指南
260
+
261
+ ### 许可证
262
+
263
+ [BSD 3-Clause](LICENSE) — 详见 `LICENSE` 文件。
kariz-0.1.0/README.md ADDED
@@ -0,0 +1,243 @@
1
+ # کاریز | kariz
2
+
3
+ > [فارسی](#فارسی) · [English](#english) · [العربية](#العربية) · [Türkçe](#türkçe) · [Русский](#русский) · [中文](#中文)
4
+
5
+ ---
6
+
7
+ ## فارسی
8
+
9
+ **سامانه‌ی مدیریت محتوا، ساخته‌شده روی جنگو و وگتیل.**
10
+
11
+ ### چرا این صفحه اینجاست؟
12
+
13
+ این مخزن، هسته‌ی «کاریز» است: سامانه‌ای که برای راه‌اندازی و اداره‌ی وب‌سایت‌ها می‌سازیم. یا بستری برای توسعه دهنده ها. چون پروژه هنوز در مراحل اولیه‌ی توسعه است و به بلوغ کافی برای استفاده‌ی عمومی نرسیده، نسخه‌ای که روی PyPI ثبت می‌شود صرفاً برای **نگه‌داشتن نام** `kariz` است؛ تا زمان انتشار واقعی، `pip install kariz` شما را به این سامانه نمی‌رساند.
14
+
15
+ ### اپ‌های پکیج
16
+
17
+ | اپ | نقش |
18
+ | - | - |
19
+ | `kariz.home` | صفحه‌ی اصلی و ساختار محتوایی سایت |
20
+ | `kariz.standardpages` | صفحه‌های استاندارد و چیدمان |
21
+ | `kariz.forms` | فرم‌ها و فیلدها |
22
+ | `kariz.navigation` | منو و تنظیمات سایت |
23
+ | `kariz.images` | مدل تصویر سفارشی و پردازش |
24
+ | `kariz.search` | نمای جست‌وجو |
25
+ | `kariz.themes` | مدل تم، انتخاب قالب و پیداگر استاتیک |
26
+ | `kariz.users` | کاربر سفارشی |
27
+ | `kariz.utils` | بلاک‌ها، تگ‌های قالب، دستورهای مدیریتی |
28
+
29
+ ### پیش‌نیازها
30
+
31
+ - پایتون **۳٫۱۳** یا بالاتر
32
+ - جنگو **۶٫۱** · واگتیل **۷٫۴** یا بالاتر
33
+
34
+ ### وضعیت
35
+
36
+ این پروژه فعالانه در حال توسعه است ولی **بدون تضمین پایداری رابط عمومی** منتشر می‌شود. نقشه‌ی راه کوتاه:
37
+
38
+ - [x] آماده‌سازی نخستین انتشار واقعی پکیج روی PyPI
39
+ - [x] افزودن مستندات بلاک‌ها و راهنمای نویسنده‌ی محتوا
40
+
41
+ ### مجوز
42
+
43
+ [BSD 3-Clause](LICENSE) — جزئیات در فایل `LICENSE`.
44
+
45
+ ---
46
+
47
+ ## English
48
+
49
+ **A content management system built on Django and Wagtail.**
50
+
51
+ ### Why is this page here?
52
+
53
+ 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.
54
+
55
+ ### Package apps
56
+
57
+ | App | Role |
58
+ | - | - |
59
+ | `kariz.home` | Home page and the site's content structure |
60
+ | `kariz.standardpages` | Standard pages and layouts |
61
+ | `kariz.forms` | Forms and fields |
62
+ | `kariz.navigation` | Menus and site settings |
63
+ | `kariz.images` | Custom image model and processing |
64
+ | `kariz.search` | Search view |
65
+ | `kariz.themes` | Theme model, template selection and static finder |
66
+ | `kariz.users` | Custom user |
67
+ | `kariz.utils` | Blocks, template tags, management commands |
68
+
69
+ ### Prerequisites
70
+
71
+ - Python **3.13** or newer
72
+ - Django **6.1** · Wagtail **7.4** or newer
73
+
74
+ ### Status
75
+
76
+ This project is under active development, but it is released **without any guarantee of public API stability**. Short roadmap:
77
+
78
+ - [x] Prepare the first real release of the package on PyPI
79
+ - [x] Add block documentation and a content author's guide
80
+
81
+ ### License
82
+
83
+ [BSD 3-Clause](LICENSE) — details are in the `LICENSE` file.
84
+
85
+ ---
86
+
87
+ ## العربية
88
+
89
+ **نظام إدارة محتوى مبني على جنجنغو (Django) وواغتيل (Wagtail).**
90
+
91
+ ### لماذا هذه الصفحة؟
92
+
93
+ هذا المستودع هو جوهر «كاريز»: النظام الذي نبنيه لإطلاق وإدارة المواقع — أو منصة للمطوّرين. ولأن المشروع لا يزال في مراحله الأولى ولم يبلغ حدّ الاستخدام العام، فإن النسخة المسجَّلة على PyPI لا تهدف إلا إلى **حفظ الاسم** `kariz`؛ وحتى صدور الإصدار الحقيقي، لن يمنحك `pip install kariz` هذا النظام.
94
+
95
+ ### حزم النظام
96
+
97
+ | الحزمة | الدور |
98
+ | - | - |
99
+ | `kariz.home` | الصفحة الرئيسية وبنية محتوى الموقع |
100
+ | `kariz.standardpages` | الصفحات القياسية والتخطيطات |
101
+ | `kariz.forms` | النماذج والحقول |
102
+ | `kariz.navigation` | القوائم وإعدادات الموقع |
103
+ | `kariz.images` | نموذج صورة مخصّص ومعالجتها |
104
+ | `kariz.search` | واجهة البحث |
105
+ | `kariz.themes` | نموذج السِّمة واختيار القالب وملفات الثابتة |
106
+ | `kariz.users` | مستخدم مخصّص |
107
+ | `kariz.utils` | المكوّنات ووسوم القوالب وأوامر الإدارة |
108
+
109
+ ### المتطلبات
110
+
111
+ - بايثون (Python) **3.13** أو أحدث
112
+ - جنجنغو (Django) **6.1** · واغتيل (Wagtail) **7.4** أو أحدث
113
+
114
+ ### الحالة
115
+
116
+ هذا المشروع قيد التطوير النشط، لكنه يُنشر **دون أي ضمان لاستقرار الواجهة البرمجية العامة**. خارطة طريق مختصرة:
117
+
118
+ - [x] تجهيز أول إصدار حقيقي للحزمة على PyPI
119
+ - [x] إضافة توثيق المكوّنات ودليل لكاتب المحتوى
120
+
121
+ ### الترخيص
122
+
123
+ [BSD 3-Clause](LICENSE) — التفاصيل في ملف `LICENSE`.
124
+
125
+ ---
126
+
127
+ ## Türkçe
128
+
129
+ **Django ve Wagtail üzerine kurulu bir içerik yönetim sistemi.**
130
+
131
+ ### Bu sayfa neden burada?
132
+
133
+ 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.
134
+
135
+ ### Paket uygulamaları
136
+
137
+ | Uygulama | Görevi |
138
+ | - | - |
139
+ | `kariz.home` | Ana sayfa ve sitenin içerik yapısı |
140
+ | `kariz.standardpages` | Standart sayfalar ve düzenler |
141
+ | `kariz.forms` | Formlar ve alanlar |
142
+ | `kariz.navigation` | Menüler ve site ayarları |
143
+ | `kariz.images` | Özel görsel modeli ve işleme |
144
+ | `kariz.search` | Arama görünümü |
145
+ | `kariz.themes` | Tema modeli, şablon seçimi ve statik dosya bulucu |
146
+ | `kariz.users` | Özel kullanıcı |
147
+ | `kariz.utils` | Bloklar, şablon etiketleri, yönetim komutları |
148
+
149
+ ### Gereksinimler
150
+
151
+ - Python **3.13** veya üzeri
152
+ - Django **6.1** · Wagtail **7.4** veya üzeri
153
+
154
+ ### Durum
155
+
156
+ Bu proje aktif olarak geliştiriliyor, ancak **genel API kararlılığı garantisi olmadan** yayınlanıyor. Kısa yol haritası:
157
+
158
+ - [x] Paketin PyPI üzerindeki ilk gerçek sürümüne hazırlanmak
159
+ - [x] Blok dokümantasyonu ve içerik yazarı rehberi eklemek
160
+
161
+ ### Lisans
162
+
163
+ [BSD 3-Clause](LICENSE) — ayrıntılar `LICENSE` dosyasında.
164
+
165
+ ---
166
+
167
+ ## Русский
168
+
169
+ **Система управления контентом на Django и Wagtail.**
170
+
171
+ ### Зачем нужна эта страница?
172
+
173
+ Этот репозиторий — ядро *kariz*: системы, которую мы создаём для запуска и управления сайтами, — или платформы для разработчиков. Поскольку проект ещё на ранней стадии разработки и не достиг зрелости для публичного использования, версия, зарегистрированная на PyPI, существует только чтобы **зарезервировать имя** `kariz`; до реального выпуска `pip install kariz` не даст вам эту систему.
174
+
175
+ ### Пакеты системы
176
+
177
+ | Пакет | Назначение |
178
+ | - | - |
179
+ | `kariz.home` | Главная страница и структура контента сайта |
180
+ | `kariz.standardpages` | Стандартные страницы и макеты |
181
+ | `kariz.forms` | Формы и поля |
182
+ | `kariz.navigation` | Меню и настройки сайта |
183
+ | `kariz.images` | Собственная модель изображений и их обработка |
184
+ | `kariz.search` | Страница поиска |
185
+ | `kariz.themes` | Модель темы, выбор шаблона и поиск статики |
186
+ | `kariz.users` | Собственная модель пользователя |
187
+ | `kariz.utils` | Блоки, шаблонные теги, команды управления |
188
+
189
+ ### Требования
190
+
191
+ - Python **3.13** или новее
192
+ - Django **6.1** · Wagtail **7.4** или новее
193
+
194
+ ### Статус
195
+
196
+ Проект активно развивается, но выпускается **без каких-либо гарантий стабильности публичного API**. Краткий план:
197
+
198
+ - [x] Подготовить первый реальный выпуск пакета на PyPI
199
+ - [x] Добавить документацию блоков и руководство для авторов контента
200
+
201
+ ### Лицензия
202
+
203
+ [BSD 3-Clause](LICENSE) — подробности в файле `LICENSE`.
204
+
205
+ ---
206
+
207
+ ## 中文
208
+
209
+ **基于 Django 和 Wagtail 构建的内容管理系统。**
210
+
211
+ ### 为什么会有这个页面?
212
+
213
+ 本仓库是 *kariz* 的核心:我们用来搭建和管理网站的系统 —— 也是一个面向开发者的平台。由于项目仍处于早期开发阶段,尚未成熟到可供公众使用,在 PyPI 上注册的版本仅为**保留 `kariz` 这个名称**;在正式发布之前,`pip install kariz` 并不会为你带来这套系统。
214
+
215
+ ### 系统模块
216
+
217
+ | 模块 | 作用 |
218
+ | - | - |
219
+ | `kariz.home` | 首页与站点内容结构 |
220
+ | `kariz.standardpages` | 标准页面与布局 |
221
+ | `kariz.forms` | 表单与字段 |
222
+ | `kariz.navigation` | 菜单与站点设置 |
223
+ | `kariz.images` | 自定义图片模型与处理 |
224
+ | `kariz.search` | 搜索页面 |
225
+ | `kariz.themes` | 主题模型、模板选择与静态文件查找器 |
226
+ | `kariz.users` | 自定义用户 |
227
+ | `kariz.utils` | 区块、模板标签、管理命令 |
228
+
229
+ ### 环境要求
230
+
231
+ - Python **3.13** 或更高
232
+ - Django **6.1** · Wagtail **7.4** 或更高
233
+
234
+ ### 状态
235
+
236
+ 项目正在积极开发中,但发布时**不保证公共 API 的稳定性**。简短路线图:
237
+
238
+ - [x] 准备在 PyPI 上发布首个正式版本
239
+ - [x] 添加区块文档与内容编写指南
240
+
241
+ ### 许可证
242
+
243
+ [BSD 3-Clause](LICENSE) — 详见 `LICENSE` 文件。
@@ -0,0 +1,263 @@
1
+ Metadata-Version: 2.4
2
+ Name: kariz
3
+ Version: 0.1.0
4
+ Summary: Kariz — a content management system built on Django and Wagtail
5
+ License-Expression: BSD-3-Clause
6
+ Project-URL: Homepage, https://pypi.org/project/kariz/
7
+ Keywords: cms,django,wagtail,persian,rtl,content-management
8
+ Classifier: Development Status :: 2 - Pre-Alpha
9
+ Classifier: Environment :: Web Environment
10
+ Classifier: Framework :: Django
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: Operating System :: OS Independent
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.13
15
+ Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
16
+ Requires-Python: >=3.13
17
+ Description-Content-Type: text/markdown
18
+ License-File: LICENSE
19
+ Dynamic: license-file
20
+
21
+ # کاریز | kariz
22
+
23
+ > [فارسی](#فارسی) · [English](#english) · [العربية](#العربية) · [Türkçe](#türkçe) · [Русский](#русский) · [中文](#中文)
24
+
25
+ ---
26
+
27
+ ## فارسی
28
+
29
+ **سامانه‌ی مدیریت محتوا، ساخته‌شده روی جنگو و وگتیل.**
30
+
31
+ ### چرا این صفحه اینجاست؟
32
+
33
+ این مخزن، هسته‌ی «کاریز» است: سامانه‌ای که برای راه‌اندازی و اداره‌ی وب‌سایت‌ها می‌سازیم. یا بستری برای توسعه دهنده ها. چون پروژه هنوز در مراحل اولیه‌ی توسعه است و به بلوغ کافی برای استفاده‌ی عمومی نرسیده، نسخه‌ای که روی PyPI ثبت می‌شود صرفاً برای **نگه‌داشتن نام** `kariz` است؛ تا زمان انتشار واقعی، `pip install kariz` شما را به این سامانه نمی‌رساند.
34
+
35
+ ### اپ‌های پکیج
36
+
37
+ | اپ | نقش |
38
+ | - | - |
39
+ | `kariz.home` | صفحه‌ی اصلی و ساختار محتوایی سایت |
40
+ | `kariz.standardpages` | صفحه‌های استاندارد و چیدمان |
41
+ | `kariz.forms` | فرم‌ها و فیلدها |
42
+ | `kariz.navigation` | منو و تنظیمات سایت |
43
+ | `kariz.images` | مدل تصویر سفارشی و پردازش |
44
+ | `kariz.search` | نمای جست‌وجو |
45
+ | `kariz.themes` | مدل تم، انتخاب قالب و پیداگر استاتیک |
46
+ | `kariz.users` | کاربر سفارشی |
47
+ | `kariz.utils` | بلاک‌ها، تگ‌های قالب، دستورهای مدیریتی |
48
+
49
+ ### پیش‌نیازها
50
+
51
+ - پایتون **۳٫۱۳** یا بالاتر
52
+ - جنگو **۶٫۱** · واگتیل **۷٫۴** یا بالاتر
53
+
54
+ ### وضعیت
55
+
56
+ این پروژه فعالانه در حال توسعه است ولی **بدون تضمین پایداری رابط عمومی** منتشر می‌شود. نقشه‌ی راه کوتاه:
57
+
58
+ - [x] آماده‌سازی نخستین انتشار واقعی پکیج روی PyPI
59
+ - [x] افزودن مستندات بلاک‌ها و راهنمای نویسنده‌ی محتوا
60
+
61
+ ### مجوز
62
+
63
+ [BSD 3-Clause](LICENSE) — جزئیات در فایل `LICENSE`.
64
+
65
+ ---
66
+
67
+ ## English
68
+
69
+ **A content management system built on Django and Wagtail.**
70
+
71
+ ### Why is this page here?
72
+
73
+ 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.
74
+
75
+ ### Package apps
76
+
77
+ | App | Role |
78
+ | - | - |
79
+ | `kariz.home` | Home page and the site's content structure |
80
+ | `kariz.standardpages` | Standard pages and layouts |
81
+ | `kariz.forms` | Forms and fields |
82
+ | `kariz.navigation` | Menus and site settings |
83
+ | `kariz.images` | Custom image model and processing |
84
+ | `kariz.search` | Search view |
85
+ | `kariz.themes` | Theme model, template selection and static finder |
86
+ | `kariz.users` | Custom user |
87
+ | `kariz.utils` | Blocks, template tags, management commands |
88
+
89
+ ### Prerequisites
90
+
91
+ - Python **3.13** or newer
92
+ - Django **6.1** · Wagtail **7.4** or newer
93
+
94
+ ### Status
95
+
96
+ This project is under active development, but it is released **without any guarantee of public API stability**. Short roadmap:
97
+
98
+ - [x] Prepare the first real release of the package on PyPI
99
+ - [x] Add block documentation and a content author's guide
100
+
101
+ ### License
102
+
103
+ [BSD 3-Clause](LICENSE) — details are in the `LICENSE` file.
104
+
105
+ ---
106
+
107
+ ## العربية
108
+
109
+ **نظام إدارة محتوى مبني على جنجنغو (Django) وواغتيل (Wagtail).**
110
+
111
+ ### لماذا هذه الصفحة؟
112
+
113
+ هذا المستودع هو جوهر «كاريز»: النظام الذي نبنيه لإطلاق وإدارة المواقع — أو منصة للمطوّرين. ولأن المشروع لا يزال في مراحله الأولى ولم يبلغ حدّ الاستخدام العام، فإن النسخة المسجَّلة على PyPI لا تهدف إلا إلى **حفظ الاسم** `kariz`؛ وحتى صدور الإصدار الحقيقي، لن يمنحك `pip install kariz` هذا النظام.
114
+
115
+ ### حزم النظام
116
+
117
+ | الحزمة | الدور |
118
+ | - | - |
119
+ | `kariz.home` | الصفحة الرئيسية وبنية محتوى الموقع |
120
+ | `kariz.standardpages` | الصفحات القياسية والتخطيطات |
121
+ | `kariz.forms` | النماذج والحقول |
122
+ | `kariz.navigation` | القوائم وإعدادات الموقع |
123
+ | `kariz.images` | نموذج صورة مخصّص ومعالجتها |
124
+ | `kariz.search` | واجهة البحث |
125
+ | `kariz.themes` | نموذج السِّمة واختيار القالب وملفات الثابتة |
126
+ | `kariz.users` | مستخدم مخصّص |
127
+ | `kariz.utils` | المكوّنات ووسوم القوالب وأوامر الإدارة |
128
+
129
+ ### المتطلبات
130
+
131
+ - بايثون (Python) **3.13** أو أحدث
132
+ - جنجنغو (Django) **6.1** · واغتيل (Wagtail) **7.4** أو أحدث
133
+
134
+ ### الحالة
135
+
136
+ هذا المشروع قيد التطوير النشط، لكنه يُنشر **دون أي ضمان لاستقرار الواجهة البرمجية العامة**. خارطة طريق مختصرة:
137
+
138
+ - [x] تجهيز أول إصدار حقيقي للحزمة على PyPI
139
+ - [x] إضافة توثيق المكوّنات ودليل لكاتب المحتوى
140
+
141
+ ### الترخيص
142
+
143
+ [BSD 3-Clause](LICENSE) — التفاصيل في ملف `LICENSE`.
144
+
145
+ ---
146
+
147
+ ## Türkçe
148
+
149
+ **Django ve Wagtail üzerine kurulu bir içerik yönetim sistemi.**
150
+
151
+ ### Bu sayfa neden burada?
152
+
153
+ 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.
154
+
155
+ ### Paket uygulamaları
156
+
157
+ | Uygulama | Görevi |
158
+ | - | - |
159
+ | `kariz.home` | Ana sayfa ve sitenin içerik yapısı |
160
+ | `kariz.standardpages` | Standart sayfalar ve düzenler |
161
+ | `kariz.forms` | Formlar ve alanlar |
162
+ | `kariz.navigation` | Menüler ve site ayarları |
163
+ | `kariz.images` | Özel görsel modeli ve işleme |
164
+ | `kariz.search` | Arama görünümü |
165
+ | `kariz.themes` | Tema modeli, şablon seçimi ve statik dosya bulucu |
166
+ | `kariz.users` | Özel kullanıcı |
167
+ | `kariz.utils` | Bloklar, şablon etiketleri, yönetim komutları |
168
+
169
+ ### Gereksinimler
170
+
171
+ - Python **3.13** veya üzeri
172
+ - Django **6.1** · Wagtail **7.4** veya üzeri
173
+
174
+ ### Durum
175
+
176
+ Bu proje aktif olarak geliştiriliyor, ancak **genel API kararlılığı garantisi olmadan** yayınlanıyor. Kısa yol haritası:
177
+
178
+ - [x] Paketin PyPI üzerindeki ilk gerçek sürümüne hazırlanmak
179
+ - [x] Blok dokümantasyonu ve içerik yazarı rehberi eklemek
180
+
181
+ ### Lisans
182
+
183
+ [BSD 3-Clause](LICENSE) — ayrıntılar `LICENSE` dosyasında.
184
+
185
+ ---
186
+
187
+ ## Русский
188
+
189
+ **Система управления контентом на Django и Wagtail.**
190
+
191
+ ### Зачем нужна эта страница?
192
+
193
+ Этот репозиторий — ядро *kariz*: системы, которую мы создаём для запуска и управления сайтами, — или платформы для разработчиков. Поскольку проект ещё на ранней стадии разработки и не достиг зрелости для публичного использования, версия, зарегистрированная на PyPI, существует только чтобы **зарезервировать имя** `kariz`; до реального выпуска `pip install kariz` не даст вам эту систему.
194
+
195
+ ### Пакеты системы
196
+
197
+ | Пакет | Назначение |
198
+ | - | - |
199
+ | `kariz.home` | Главная страница и структура контента сайта |
200
+ | `kariz.standardpages` | Стандартные страницы и макеты |
201
+ | `kariz.forms` | Формы и поля |
202
+ | `kariz.navigation` | Меню и настройки сайта |
203
+ | `kariz.images` | Собственная модель изображений и их обработка |
204
+ | `kariz.search` | Страница поиска |
205
+ | `kariz.themes` | Модель темы, выбор шаблона и поиск статики |
206
+ | `kariz.users` | Собственная модель пользователя |
207
+ | `kariz.utils` | Блоки, шаблонные теги, команды управления |
208
+
209
+ ### Требования
210
+
211
+ - Python **3.13** или новее
212
+ - Django **6.1** · Wagtail **7.4** или новее
213
+
214
+ ### Статус
215
+
216
+ Проект активно развивается, но выпускается **без каких-либо гарантий стабильности публичного API**. Краткий план:
217
+
218
+ - [x] Подготовить первый реальный выпуск пакета на PyPI
219
+ - [x] Добавить документацию блоков и руководство для авторов контента
220
+
221
+ ### Лицензия
222
+
223
+ [BSD 3-Clause](LICENSE) — подробности в файле `LICENSE`.
224
+
225
+ ---
226
+
227
+ ## 中文
228
+
229
+ **基于 Django 和 Wagtail 构建的内容管理系统。**
230
+
231
+ ### 为什么会有这个页面?
232
+
233
+ 本仓库是 *kariz* 的核心:我们用来搭建和管理网站的系统 —— 也是一个面向开发者的平台。由于项目仍处于早期开发阶段,尚未成熟到可供公众使用,在 PyPI 上注册的版本仅为**保留 `kariz` 这个名称**;在正式发布之前,`pip install kariz` 并不会为你带来这套系统。
234
+
235
+ ### 系统模块
236
+
237
+ | 模块 | 作用 |
238
+ | - | - |
239
+ | `kariz.home` | 首页与站点内容结构 |
240
+ | `kariz.standardpages` | 标准页面与布局 |
241
+ | `kariz.forms` | 表单与字段 |
242
+ | `kariz.navigation` | 菜单与站点设置 |
243
+ | `kariz.images` | 自定义图片模型与处理 |
244
+ | `kariz.search` | 搜索页面 |
245
+ | `kariz.themes` | 主题模型、模板选择与静态文件查找器 |
246
+ | `kariz.users` | 自定义用户 |
247
+ | `kariz.utils` | 区块、模板标签、管理命令 |
248
+
249
+ ### 环境要求
250
+
251
+ - Python **3.13** 或更高
252
+ - Django **6.1** · Wagtail **7.4** 或更高
253
+
254
+ ### 状态
255
+
256
+ 项目正在积极开发中,但发布时**不保证公共 API 的稳定性**。简短路线图:
257
+
258
+ - [x] 准备在 PyPI 上发布首个正式版本
259
+ - [x] 添加区块文档与内容编写指南
260
+
261
+ ### 许可证
262
+
263
+ [BSD 3-Clause](LICENSE) — 详见 `LICENSE` 文件。
@@ -0,0 +1,7 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ kariz.egg-info/PKG-INFO
5
+ kariz.egg-info/SOURCES.txt
6
+ kariz.egg-info/dependency_links.txt
7
+ kariz.egg-info/top_level.txt
@@ -0,0 +1 @@
1
+
@@ -0,0 +1,31 @@
1
+ [build-system]
2
+ requires = ["setuptools>=77"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "kariz"
7
+ version = "0.1.0"
8
+ description = "Kariz — a content management system built on Django and Wagtail"
9
+ readme = "README.md"
10
+ requires-python = ">=3.13"
11
+ license = "BSD-3-Clause"
12
+ keywords = ["cms", "django", "wagtail", "persian", "rtl", "content-management"]
13
+ dependencies = []
14
+
15
+ classifiers = [
16
+ "Development Status :: 2 - Pre-Alpha",
17
+ "Environment :: Web Environment",
18
+ "Framework :: Django",
19
+ "Intended Audience :: Developers",
20
+ "Operating System :: OS Independent",
21
+ "Programming Language :: Python :: 3",
22
+ "Programming Language :: Python :: 3.13",
23
+ "Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System",
24
+ ]
25
+
26
+ [project.urls]
27
+ Homepage = "https://pypi.org/project/kariz/"
28
+
29
+ [tool.setuptools]
30
+ # این انتشار فقط برای نگه‌داشتن نام است: هیچ کدی منتشر نمی‌شود.
31
+ packages = []
kariz-0.1.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+