Merge pull request #247 from dragomano/update_docs

Update docs

docs/src/ar/blocks/create-new.md

@@ -0,0 +1,46 @@
+---
+description: وصف موجز لواجهة إنشاء الملحق
+order: 2
+---
+
+# إضافة إضافة
+
+لإضافة كتلة، ما عليك سوى النقر عليها. في البداية، يمكنك إنشاء كتل من ثلاثة أنواع: PHP و HTML و BBCode. إذا كنت بحاجة إلى أنواع أخرى، أولاً [قم بتمكين الإضافات اللازمة](../plugins/manage) من نوع `block`.
+
+تبعاً لنوع الكتلة، ستكون مختلف الإعدادات متوفرة، موزعة عبر علامات تبويب مختلفة.
+
+## محتوى
+
+هنا يمكنك تكوين:
+
+- title
+- note
+- محتوى (لبعض الكتل فقط)
+
+![Content tab](content_tab.png)
+
+## علامة التبويب للوصول إلى الموقع
+
+هنا يمكنك تكوين:
+
+- موضع
+- الأذونات
+- المناطق
+
+![Access tab](access_tab.png)
+
+## علامة تبويب المحتوى
+
+هنا يمكنك تكوين:
+
+- خيارات المظهر
+
+![Appearance tab](appearance_tab.png)
+
+## علامة تبويب الضبط
+
+عادةً ما تكون أدوات الضبط الخاصة بالكتل متاحة في علامة تبويب **الضبط**.
+
+![Tuning tab](tuning_tab.png)
+
+يمكن أن تضيف الإضافات تخصيصاتها الخاصة إلى أي من هذه الأقسام، اعتماداً على نوايا المطورين.

docs/src/ar/blocks/impex.md

@@ -0,0 +1,16 @@
+---
+description: وصف موجز لواجهة تصدير واستيراد إضافات البوابة
+order: 3
+---
+
+# التصدير والاستيراد
+
+يمكن تصدير الإضافات كأرشيف مضغوط، لسهولة نقلها بين المنتديات أو النسخ الاحتياطي.
+
+## تصدير الإضافات
+
+في هذا القسم، يمكنك تصدير جميع الإضافات المختارة أو فقط إلى ملف أرشيف.
+
+## استيراد الإضافات
+
+في هذا القسم، يمكنك استيراد الإضافات المحفوظة سابقا من ملف الأرشيف.

docs/src/ar/blocks/index.md

@@ -0,0 +1,4 @@
+---
+title: كتل
+order: 2
+---

docs/src/ar/blocks/manage.md

@@ -0,0 +1,20 @@
+---
+description: وصف منطقة إدارة الإضافات
+order: 1
+---
+
+# إدارة المربعات البرمجية
+
+يسرد هذا القسم جميع كتل البوابة التي تم تكوينها، سواء تم تمكينها أو تعطيلها. يتم فرز الكتل حسب اللوحات.
+
+لكل كتلة، يتم عرض أيقونة أو ملاحظة أو عنوان ، نوع ، مناطق الإخراج ، الأولوية وقائمة الإجراءات .
+
+![Manage blocks](manage_blocks.png)
+
+الإجراءات التالية متاحة لكل صفحة:
+
+- تغيير الأولوية - داخل كل لوحة يمكنك إعداد ترتيب فردي من الكتل
+- تبديل الحالة (تمكين أو تعطيل)
+- استنساخ - إنشاء كتلة جديدة تنسخ الحالي
+- تحرير - تغيير إعدادات كتلة محددة
+- حذف

docs/src/ar/changelog.md

@@ -0,0 +1,24 @@
+---
+title: تغيير
+description: معلومات عن إصدارات Light Portal
+layout: page
+releases: الإصدارات
+---
+
+<script setup>
+import { ReleaseTimeline, DefaultOptions as options } from "release-timeline";
+import "release-timeline/dist/style.css";
+import "release-timeline/dist/vitepress.css";
+//import "release-timeline/dist/animated-background.css";
+import { useData } from "vitepress";
+
+const { frontmatter } = useData();
+
+options.title = `${frontmatter.value.releases}`
+options.github.owner = "dragomano";
+options.github.repo = "Light-Portal";
+options.display.release.name = false
+options.display.release.defaultOpenTab = 'desc'
+</script>
+
+<ReleaseTimeline :options="options" />

docs/src/ar/examples.md

@@ -0,0 +1,40 @@
+---
+title: أمثلة الموقع
+description: معلومات عن المواقع التي تستخدم الإضاءة المدخلة
+layout: page
+subtitle: المواقع التي تستخدم Light Portal
+lead: إذا كنت ترغب في إضافة موقعك إلى هذه القائمة، فقط أرسل لي رسالة عبر <em>Admin -> Portal -> إعدادات-> ردود الفعل</em> في المنتدى الخاص بك.
+---
+
+<script setup>
+import {
+  VPTeamPage,
+  VPTeamPageTitle
+} from 'vitepress/theme'
+import ExampleSites from './ExampleSites.vue'
+
+const sites = [
+  {
+    image: '/example_1.png',
+    title: 'Light Portal Showcase',
+    link: 'https://demo.dragomano.ru',
+  },
+  {
+    image: '/example_2.png',
+    title: 'Απανταχού Τριγλιανοί Απόγονοι',
+    link: 'https://www.triglianoi.gr'
+  },
+  {
+    image: '/example_3.png',
+    title: 'Italian SMF',
+    link: 'https://www.italiansmf.net/forum/'
+  },
+]
+</script>
+
+<VPTeamPage>
+  <VPTeamPageTitle>
+    <template #title></template>
+    <template #lead></template>
+  </VPTeamPageTitle>
+  <ExampleSites :sites="sites" /></VPTeamPage>

docs/src/ar/getting-started/configuration.md

@@ -0,0 +1,60 @@
+---
+description: ملخص موجز لإعدادات البوابة المتاحة
+order: 3
+outline:
+  - 2
+  - 3
+---
+
+# إعدادات البوابة
+
+استخدم الوصول السريع من خلال العنصر في قائمة المنتدى الرئيسية أو القسم المقابل في لوحة الإدارة لفتح إعدادات البوابة.
+
+ولن نصف بالتفصيل كل من الظروف المتاحة، ولن نذكر سوى أهم تلك الظروف.
+
+## الإعدادات العامة
+
+في هذا القسم، يمكنك تخصيص صفحة البوابة الأمامية بالكامل، وتمكين الوضع المستقل، وتغيير أذونات المستخدم للوصول إلى عناصر البوابة.
+
+### إعدادات الصفحة الأمامية والمقالات
+
+لتغيير محتوى الصفحة الرئيسية للبوابة، حدد الوضع المناسب "بوابة الصفحة الأمامية":
+
+- معطل
+- الصفحة المحددة (سيتم عرض الصفحة المحددة فقط)
+- جميع الصفحات من الفئات المحددة
+- الصفحات المحددة
+- جميع المواضيع من اللوحات المحددة
+- المواضيع المحددة
+- لوحات مختارة
+
+### الوضع المستقل
+
+هذا هو الوضع الذي يمكنك فيه تحديد الصفحة الرئيسية الخاصة بك (حتى إذا كانت على موقع آخر)، وإزالة العناصر غير الضرورية من القائمة الرئيسية (قائمة المستخدمين، التقويم، إلخ). انظر `portal.php` في المنتدى الجذر على سبيل المثال.
+
+### الأذونات
+
+هنا يمكنك فقط ملاحظة منظمة الصحة العالمية و يمكن أن تفعل ما تفعله مع العناصر المختلفة (الكتل والصفحات) للبوابة.
+
+## الصفحات والكتل
+
+في هذا القسم، يمكنك تغيير الإعدادات العامة للصفحات والكتل المستخدمة سواء عند إنشائها أو عند عرضها.
+
+## لوحات
+
+في هذا القسم، يمكنك تغيير بعض الإعدادات لوحات المدخل الموجودة وتخصيص اتجاه الكتل في هذه اللوحات.
+
+![Panels](panels.png)
+
+## متنوعات
+
+في هذا القسم، يمكنك تغيير مختلف الإعدادات المساعدة للبوابة، والتي قد تكون مفيدة لمطوري القوالب والملحقات.
+
+### وضع التوافق
+
+- قيمة معلمة **action** للبوابة - يمكنك تغيير هذا الإعداد لاستخدام Light Portal بالتزامن مع تعديلات مشابهة أخرى. ثم ستفتح الصفحة الرئيسية على العنوان المحدد.
+- معلمة **page** لصفحات البوابة - انظر أعلاه. بالمثل، لصفحات البوابة - قم بتغيير المعلمة وستفتح على عناوين URL مختلفة.
+
+### صيانة
+
+- تحسين جداول البوابة أسبوعياً - تمكين هذا الخيار بحيث يتم حذف الصفوف التي تحتوي على قيم فارغة في جداول البوابة في قاعدة البيانات وسيتم تحسين الجداول.

docs/src/ar/getting-started/index.md

@@ -0,0 +1,4 @@
+---
+title: بدء العمل
+order: 1
+---

docs/src/ar/getting-started/installation.md

@@ -0,0 +1,30 @@
+---
+description: قائمة بمتطلبات تركيب البوابة، فضلا عن حلول للمشاكل المحتملة
+order: 1
+---
+
+# تثبيت
+
+لا توجد أي دقائق هنا. Light Portal يمكن تثبيتها مثل أي تعديل آخر لـ SMF - من خلال مدير الحزمة.
+
+## المتطلبات
+
+- [SMF 2.1.x](https://download.simplemachines.org)
+- متصفح حديث مع تفعيل JavaScript
+- الإنترنت (البوابة والعديد من الإضافات تقوم بتحميل السكربتات والأنماط من CDN)
+- PHP 8.1 أو أعلى
+- امتداد PHP `intl` لتوطين بعض سلاسل اللغة بشكل صحيح
+- امتدادات PHP `dom` و `simplexml` لتصدير/استيراد الصفحات والكتل
+- امتداد PHP `zip` لتصدير/استيراد الإضافات
+
+:::info ملاحظة
+
+يكفي تنزيل الحزمة التي تحتوي على ملفات البوابة من [الدليل الرسمي](https://custom.simplemachines.org/mods/index.php?mod=4244) ورفعها عبر مدير الحزم في منتداك.
+
+:::
+
+## استكشاف الأخطاء
+
+إذا كان استضافتك "ذكية" جدًا فيما يتعلق بالأذونات ولم يتم فك ملفات البوابة أثناء التثبيت، تحتاج إلى استخراج الدلائل `Themes` و `Sources` يدويًا من أرشيف التعديل إلى مجلد منتداك (حيث توجد بالفعل دلائل Themes و Sources، بالإضافة إلى الملفات `cron.php` و `SSI.php` و `Settings.php`، إلخ) وتعيين الأذونات المناسبة. غالبًا ما تكون `644` أو `664` أو `666` للملفات، و `755` أو `775` أو `777` للمجلدات.
+
+كما تحتاج إلى فك ضغط الملف `database.php` من أرشيف التعديل إلى جذر منتداك، وتعيين حقوق التنفيذ له (`666`) والوصول إليه عبر المتصفح (يجب أن تكون مسجلاً كمسؤول المنتدى). يحتوي هذا الملف على تعليمات لإنشاء الجداول المستخدمة بواسطة البوابة.

docs/src/ar/getting-started/updating.md

@@ -0,0 +1,16 @@
+---
+description: معلومات عن كيفية تحديث البوابة
+order: 2
+---
+
+# التحديث
+
+إذا لم تكن هناك ملاحظات في سجل التغييرات لأحدث إصدار، يكفي استخراج الدلائل `Themes` و `Sources` من أرشيف التعديل إلى جذر منتداك، فوق الموجودة بالفعل، وسيكون التحديث صحيحًا. ولكن من الأفضل إلغاء تثبيت الإصدار الحالي قبل تثبيت الإصدار الجديد.
+
+:::info ملاحظة
+
+منذ الإصدار 2.4 يمكنك الترقية دون إلغاء تثبيت الإصدار السابق. ببساطة قم بتنزيل الأرشيف الجديد، انتقل إلى مدير الحزمة وانقر فوق زر "ترقية" بجانب الحزمة التي تم تحميلها.
+
+![Updating](upgrade.png)
+
+:::

docs/src/ar/glossary.md

@@ -0,0 +1,31 @@
+---
+description: قائمة بالمفاهيم الأساسية المستخدمة في Light Portal
+---
+
+# Glossary
+
+قائمة بالمفاهيم الأساسية المستخدمة في Light Portal.
+
+## كتلة
+
+الكتل هي عناصر `aside` تحتوي على محتوى مخصص أو محتوى محدد مسبقًا. تمامًا كما تتكون بعض المنازل من الطوب والأرضيات، قد تحتوي صفحات البوابة الخاصة بك على العديد من الكتل مرتبة على لوحات مختلفة.
+
+## الصفحة
+
+الصفحات هي المحتوى الذي أنشأه المستخدم والمتاح في `https://{your_domain}?page={slug}`. يمكن لأي مستخدم لديه الأذونات المناسبة إنشاء صفحات.
+
+## إضافة
+
+قاطرة البوابة. القدرة على تخصيص التفاعل مع تعديلات طرف ثالث (بما في ذلك طرق البوابة الأخرى). على سبيل المثال، إذا كنت بحاجة إلى أنواع كتل جديدة، تحتاج فقط إلى تمكين الملحق المقابل.
+
+## مقالة
+
+بطاقات في الصفحة الأمامية التي تعرض المحتوى المحدد في الإعدادات: لوحات المنتدى أو المواضيع، الصفحات، الصور، إلخ.
+
+## الفئة
+
+الفئات مطلوبة لتصنيف صفحات البوابة. ومع ذلك، يمكنك أن تفعل ذلك بدونهم إذا كان المنتدى الخاص بك مكرسا لموضوع واحد.
+
+## وسم
+
+تم تصميم العلامات أيضًا لتصنيف صفحات البوابة. وهي أيضًا الكلمات الرئيسية المستخدمة في علامة الميتا `keywords`.

docs/src/ar/how-to/add-custom-comment-system.md

@@ -0,0 +1,16 @@
+---
+description: تعليمات حول كيفية إضافة تعليقات مخصصة لصفحات البوابة
+---
+
+# إضافة نظام تعليقات مخصص
+
+لنفترض أنك غير راضية عن نظام التعليق الافتراضي واختيار دمج خدمة خارجية.
+
+اختر و قم بتفعيل واحدة من الملحقات المصغرة للتعليق:
+
+- Disqus
+- FacebookComments
+- Giscus
+- VkComments
+
+قم بتغيير إعدادات الإضافات مع احتياجاتك، ثم انتقل إلى _Portal => الإعدادات => الصفحة و الكتلة_ المنطقة. ابحث عن الخيار المسمى **إظهار تعليقات الصفحة** وحدد المتغير المطلوب. أخيرا، حفظ الإعدادات الخاصة بك.

docs/src/ar/how-to/create-layout.md

@@ -0,0 +1,65 @@
+---
+description: تعليمات لإنشاء مخططات بوابتك الخاصة
+---
+
+# إنشاء تخطيط الصفحة الأمامية الخاصة
+
+:::info ملاحظة
+
+منذ الإصدار 2.6 نستخدم [BladeOne](https://github.com/EFTEC/BladeOne) لتقديم مخططات الصفحة الأمامية.
+
+:::
+
+بالإضافة إلى التخطيطات الموجودة، يمكنك دائماً إضافة الخاص بك.
+
+للقيام بذلك، أنشئ ملف `custom.blade.php` في دليل `/Themes/default/portal_layouts`:
+
+```php:line-numbers {9}
+@empty ($context['lp_active_blocks'])
+<div class="col-xs">
+@endempty
+	<!-- <div> @dump($context['user']) </div> -->
+
+	<div class="lp_frontpage_articles article_custom">
+		{{ show_pagination() }}
+
+		@foreach ($context['lp_frontpage_articles'] as $article)
+		<div class="
+			col-xs-12 col-sm-6 col-md-4
+			col-lg-{{ $context['lp_frontpage_num_columns'] }}
+			col-xl-{{ $context['lp_frontpage_num_columns'] }}
+		">
+			<figure class="noticebox">
+				{!! parse_bbc('[code]' . print_r($article, true) . '[/code]') !!}
+			</figure>
+		</div>
+		@endforeach
+
+		{{ show_pagination('bottom') }}
+	</div>
+
+@empty ($context['lp_active_blocks'])
+</div>
+@endempty
+```
+
+بعد ذلك سترى تخطيط جديد للصفحة الأمامية - 'مخصص' - على إعدادات البوابة:
+
+![Select custom template](set_custom_template.png)
+
+يمكنك إنشاء أكبر عدد من التخطيطات كما تريد. استخدم `debug.blade.php` و مخططات أخرى في دليل `/Themes/default/LightPortal/layouts` كأمثلة.
+
+لتخصيص الستيسفيت، قم بإنشاء ملف `portal_custom.css` في دليل `/Themes/default/css`:
+
+```css {3}
+/* Custom layout */
+.article_custom {
+  /* Your rules */
+}
+```
+
+:::tip نصيحة
+
+إذا كنت قد أنشأت قالب الصفحة الأمامية الخاص بك وترغب في مشاركته مع المطور والمستخدمين الآخرين، استخدم https://codepen.io/pen/ أو غيرها من الموارد المماثلة.
+
+:::