gantry5

إطار العملاق

هل أنت مستعد للبدء مع Gantry 5؟ هذا عظيم! نحن هنا للمساعدة.

في هذه الصفحة، سوف تحصل على بعض النصائح السريعة لمساعدتك في البدء باستخدام Gantry 5. ويمكنك العثور على مزيد من الوثائق التفصيلية لكل من هذه النصائح عن طريق النقر فوق الزر " معرفة المزيد" الموجود أسفل كل قسم.

نأمل أن تستمتع بـ Gantry 5 بقدر ما استمتعنا بصنعها.

متطلبات المتصفح

متطلبات الإدارة الخلفية لـ Gantry حسب الأفضلية هي كما يلي:

• جوجل كروم 60+
• فايرفوكس 60+
• سفاري 12+
• أوبرا 47+
• إم إس إيدج

ملاحظة: لم يعد Internet Explorer مدعومًا

تثبيت Gantry 5 وموضوع الهيدروجين

Gantry 5 هو إطار عمل يتم من خلاله إنشاء السمات التي تعمل بالطاقة العملاقة. لكي تعمل سمة Gantry، ستحتاج إلى تثبيت كل من الإطار والموضوع . القيام بهذا ليس بالأمر الصعب على الإطلاق.

أول ما عليك فعله هو تنزيل أحدث إصدار من Gantry 5 وHydrogen. يمكنك القيام بذلك عن طريق النقر على الروابط أدناه، أو عبر GitHub.

تحميل مستقر	تحميل CI Builds

بمجرد حصولك على أحدث الحزم، يصبح التثبيت بسيطًا. لقد قمنا بتوفير دليل خطوة بخطوة في جزء التثبيت من هذه الوثائق.

يتعلم أكثر

الوصول إلى مسؤول العملاقة

جملة

عندما تقوم بتثبيت وتنشيط كل من إطار عمل Gantry وHydrogen، يمكنك الوصول إلى مسؤول Gantry 5 بعدة طرق مختلفة. أسهل طريقة هي الانتقال ببساطة إلى Components > Gantry 5 Templates من النهاية الخلفية لـ Joomla.

هنا، سترى قائمة بأية سمات مثبتة تعمل بنظام Gantry. يمكنك معاينة السمة من هنا أو تحديد تكوين للانتقال مباشرة إلى مسؤول Gantry حيث يمكنك البدء في تعديل موقعك الذي يعمل بنظام Gantry.

التنقل في مسؤول Gantry 5

يحتوي Gantry Administrator على العديد من الأدوات الإدارية التي يمكنك تصفحها لتكوين كيفية ظهور ووظائف السمة التي تدعمها Gantry. إليك تفصيل سريع لكل من هذه الأدوات، وما يمكنك فعله بها.

ستلاحظ عناصر القائمة التالية في Gantry 5 Administrator:

1. محرر القائمة : تمنحك هذه اللوحة الإدارية القدرة على تحسين قائمة النظام الأساسي عن طريق تغيير التصميم وإعادة ترتيب الروابط وإنشاء عناصر القائمة الموجودة خارج مدير القائمة المتكامل لنظام إدارة المحتوى (CMS).

2. حول : توفر لك هذه الصفحة معلومات سريعة سريعة حول الموضوع الذي يتم الوصول إليه حاليًا. يعد هذا متجرًا شاملاً للحصول على معلومات حول الموضوع بما في ذلك: الاسم ورقم الإصدار والمنشئ وروابط الدعم والميزات والمزيد.

3. إعدادات النظام الأساسي : ينقلك هذا الزر إلى صفحة إعدادات نظام إدارة المحتوى لـ Gantry 5. في Joomla، هذه هي صفحة تكوين الأذونات .

4. مسح ذاكرة التخزين المؤقت : يقوم هذا الزر بمسح ملفات ذاكرة التخزين المؤقت المتعلقة بـ Gantry. يتضمن ذلك كافة الملفات المؤقتة خارج CSS ومعلومات التكوين.

5. القائمة المنسدلة للمخططات التفصيلية : تسهل هذه القائمة المنسدلة التبديل بسرعة بين المخططات التفصيلية دون الحاجة إلى مغادرة مسؤول جسر الرافعة.

6. الأنماط : تمنحك هذه اللوحة الإدارية إمكانية الوصول إلى إعدادات المخطط التفصيلي ذات الصلة بالنمط. يتضمن ذلك أشياء مثل ألوان السمات والخطوط والإعدادات المسبقة للأنماط والمزيد.

7. الإعدادات : توفر لك هذه اللوحة الإدارية القدرة على تكوين الإعدادات الوظيفية للموضوع. يتضمن ذلك تعيين الإعدادات الافتراضية للجسيمات، بالإضافة إلى تمكين/تعطيل الجسيمات الفردية.

8. التخطيط : هذه اللوحة الإدارية هي المكان الذي يمكنك من خلاله تكوين التخطيط لموضوعك. يتم إنشاء مواضع وحدة الوضع والجزيئات والفواصل والبرامج النصية غير المعروضة مثل كود Google Analytics في هذه اللوحة.

يتعلم أكثر

ما هي الخطوط العريضة والجسيمات والذرات وما إلى ذلك؟

نظرًا لأن Gantry 5 يختلف كثيرًا عن أي إصدار من Gantry قبله، فقد توصلنا إلى بعض المصطلحات للمساعدة في فهم العلاقات التي تربط ميزات Gantry الجديدة ببعضها البعض. فيما يلي تحليل سريع للمصطلحات الشائعة الاستخدام المتعلقة بـ Gantry 5.

شرط	تعريف
الخطوط العريضة	نمط قابل للتكوين يُستخدم في منطقة واحدة أو أكثر من موقعك. إنه بمثابة الحاوية التي يتم فيها تعيين نمط الصفحة وإعداداتها وتخطيطها.
جسيم	عادةً ما يتم استخدام كتلة صغيرة من البيانات في الواجهة الأمامية. إنه يعمل مثل عنصر واجهة المستخدم/الوحدة النمطية إلى حد كبير، ولكن يمكن تهيئته بسهولة في Gantry 5 Administrator.
ذرة	نوع من الجسيمات يحتوي على بيانات غير معروضة، مثل البرمجة النصية المخصصة (JS، CSS، وما إلى ذلك) أو البرامج النصية التحليلية لتتبع حركة المرور.

يتعلم أكثر

أين يمكن الحصول على المساعدة

تم إعداد غرفة دردشة باستخدام Gitter حيث يمكنك التحدث عن المشروع مع المطورين والمساهمين والأعضاء الآخرين في المجتمع. هذا هو أفضل مكان يمكنك الذهاب إليه للحصول على نصائح سريعة ومناقشة الميزات مع الآخرين.

الوثائق متاحة أيضًا، ويتم إضافتها باستمرار مع تقدم التطوير. هل هناك شيء مفقود؟ يمكنك المساهمة في التوثيق من خلال GitHub.

كيفية المساهمة

من السهل المساهمة في إطار عمل Gantry 5 أو الوثائق المرتبطة به. يتم إجراء التطوير لكلا المشروعين عبر Github، حيث يمكنك إرسال مشكلات للإبلاغ عن أي أخطاء أو اقتراح تحسينات، بالإضافة إلى إرسال طلبات السحب الخاصة بك لإرسال الإصلاحات والإضافات الخاصة بك.

نوصي بالدردشة مع الفريق عبر Gitter قبل إرسال طلب السحب لتجنب مضاعفة الإصلاح المعلق بالفعل أو من المحتمل أن يتم استبداله بتغيير قادم.

باستخدام نسخة جيت من العملاقة

لاستخدام إصدار git من Gantry، تحتاج أولاً إلى تثبيت تبعيات الملحن. للقيام بذلك، قم بتشغيل:

 bin/composer-install

بعد ذلك، تحتاج إلى ربط Gantry بشكل صحيح في تثبيت CMS الخاص بك.

تجميع JS وتجميع SCSS

في بيئة التطوير الخاصة بنا، نستخدم Gulp لتجميع JavaScript وتجميع SCSS مع إمكانية watch بحيث يؤدي أي تغيير في الملفات المستهدفة إلى تشغيل إعادة الترجمة تلقائيًا.

إذا كنت ترغب في إعداد هذا في بيئة التطوير الخاصة بك، فيمكنك القيام بذلك باتباع هذه التعليمات البسيطة.

لاحظ أنه لكي ينجح هذا الأمر، يجب أن يكون لديك مصدر Gantry 5 وليس حزمة. يمكنك إما استنساخه أو تنزيل المصدر من GitHub.

أول شيء تحتاجه هو Node / NPM . إذا لم تكن لديك بالفعل، فيمكنك الحصول على برنامج التثبيت لنظام التشغيل الخاص بك من https://nodejs.org/download/.

الخطوة التالية هي تثبيت كافة تبعيات وحدة JS. للقيام بذلك، تأكد من أنك في جذر مشروع Gantry 5، وقم بتشغيل الأمر npm install .

بمجرد الانتهاء من ذلك، يمكنك تثبيت Gulp . نوصي بتثبيت Gulp عالميًا حتى تتمكن من استخدام الأمر من أي مجلد. إليك الأمر للقيام بذلك: sudo npm install gulp --global

يحتوي Gantry على مجموعات مختلفة من ملفات JS وCSS التي يمكن إعادة ترجمتها من الجذر. في المرة الأولى التي تبدأ فيها استخدام Gantry، أو إذا كنت بحاجة إلى إعادة تعيين جميع الوحدات وإعادة تثبيتها، يمكنك تشغيل الأمر npm run build-assets . ستؤدي هذه العملية إلى إزالة جميع مجلدات node_modules وإعادة تشغيل npm install في كافة مجلدات المشروع. وسوف يستغرق بعض الوقت.

هناك طريقة بديلة لن تؤدي إلى إزالة كافة مجلدات node_modules هي عبر gulp -up .

إلى جانب الأمر -up ، يمكنك بدلاً من ذلك استخدام -update , --update , -up , --up , -install , --install , -inst , --inst , -go , --go , -deps , --deps . أيهما أسهل بالنسبة لك أن تتذكره. سوف يفهم الكود من تلقاء نفسه ما إذا كان يحتاج إلى التثبيت لأول مرة أو مجرد تحديث وحدات العقدة.

لاحظ أن هذا قد يستغرق بضع لحظات.

في هذه المرحلة، لديك كل ما تحتاجه لتشغيل Gulp. فقط اكتب الأمر gulp وسترى أنه يتم تجميع CSS وJS.

نحن نقدم بعض المهام المفيدة أيضًا:

1. $ gulp / $ gulp all : يجمع كل CSS وJS في المشروع.
2. $ gulp watch : يبدأ تشغيل المترجمين في وضع watch . أي تغيير يتم تطبيقه على ملفات JS أو SCSS المستهدفة سيؤدي إلى إعادة الترجمة تلقائيًا.
3. $ gulp watch --css / $ gulp watch --js : يبدأ تشغيل المترجمين في وضع watch ويستمع إلى تغييرات SCSS أو JS فقط. مفيد إذا كنت تركز فقط على أحدهما وليس الآخر.
4. $ gulp css / $ gulp js : يجمع كل ملفات CSS أو JS، في حالة أنك تعمل على أحدهما فقط دون الآخر.
5. $ gulp —prod : يجمع كل CSS وJS في وضع الإنتاج. لن تحتوي الملفات المجمعة على خرائط مصدر وسيتم ضغطها (يستغرق هذا عادةً وقتًا أطول قليلاً من الوضع العادي).

تحديث خطوط جوجل

يمكن إنشاء ملف Google Fonts JSON باتباع الدليل الموجود على https://developers.google.com/fonts/docs/developer_api أو ببساطة باستخدام https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY -عنوان URL https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY . تحتاج إلى تمكين استخدام Google Fonts API وتوفير مفتاح API الخاص بك بدلاً من YOUR-API-KEY .

رخصة

تم ترخيص Gantry Framework v5 أو الإصدارات الأحدث بموجب نظام ترخيص مزدوج (MIT أو GPL الإصدار 2 أو أحدث. وهذا يعني أنك حر في اختيار الترخيص (MIT أو GPL الإصدار 2 أو الأحدث) المناسب لاحتياجاتك.

مزيد من التفاصيل