واردات لایه Bootstrap 5
بیاموزید که چگونه یک الگوی Bootstrap-5 را در bx_Import به قسمتهای Header، Footer، الگوهای بخش انعطافپذیر و LayoutHTML تقسیم کرده و سپس در ویرایشگر bluetronix آنها را کنار هم قرار دهید.
هدف این آموزش
در این آموزش، شما یک طراحی Bootstrap-5 موجود را به CMS bluetronix وارد میکنید. در اینجا، صفحه HTML اصلی را به Header، Footer، الگوهای بخشهای جداگانه و قاب طراحی واقعی تقسیم میکنید. سپس میتوانید قسمتهای مختلف صفحه را به راحتی در ویرایشگر قرار دهید، جابهجا کنید و چندین بار استفاده کنید.
نکته: این آموزش به بررسی واردات طراحی پایه میپردازد. ویرایش بیشتر یا تعویض تصاویر در آموزشهای بعدی بررسی خواهد شد.
1. الگوی اصلی را در bx_Import باز کنید
در مدیریت فایل، پوشه bx_Import را باز کنید. در اینجا، طراحی وارد شده ابتدا در حالت اصلی خود قرار دارد - به عنوان مثال با پوشههای تصاویر و فایلهای HTML اصلی. در این قسمت فقط با فایلهای اصلی موجود کار میکنید؛ تغییرات در الگوی اصلی ذخیره نمیشوند.
برای این مثال، فایل index.html را باز کرده و به ویرایش بروید. این فایل اکنون به اجزای مختلف طراحی CMS تقسیم میشود.
placeholder اسکرینشات: مدیریت فایل با پوشه باز bx_Import، پوشههای تصاویر و فایلهای HTML اصلی - dev_bootstrap_import_bx_import_originaldateien.jpeg. تصویر را هنوز بگیرید و سپس در اینجا قرار دهید.
placeholder اسکرینشات: index.html از bx_Import در ویرایشگر HTML - dev_bootstrap_import_index_html_bearbeiten.jpeg. تصویر را هنوز بگیرید و سپس در اینجا قرار دهید.
2. Header را از index.html جدا کنید
در کد HTML با استفاده از Ctrl + F به جستجوی header بپردازید. در بسیاری از الگوهای Bootstrap، Header به سرعت پیدا میشود زیرا با یک عنصر HTML مربوطه علامتگذاری شده است. در برخی الگوها، Header تنها از یک ناحیه div تشکیل شده است؛ در این صورت باید ساختار را با دقت بیشتری بررسی کنید.
کل ناحیه Header را علامتگذاری کرده و کپی کنید. بهترین کار این است که با دو پنجره باز کار کنید تا بتوانید بین الگوی اصلی و پروژه CMS خود جابهجا شوید.
placeholder اسکرینشات: ناحیه Header از index.html که از طریق جستجو پیدا شده و برای کپی کردن علامتگذاری شده - dev_bootstrap_import_header_markieren.jpeg. تصویر را هنوز بگیرید و سپس در اینجا قرار دهید.
3. Header را به CMS انتقال دهید
به پروژه خود برگردید، دایرکتوری اصلی را باز کرده و سپس Header → کد HTML را باز کنید. کد Header کپی شده قبلی را در آنجا встав کنید.
سپس مسیرهای محلی را بررسی کنید. در بسیاری از طرحها، باید ارجاعات نسبی و مسیرهای تصویر با یک اسلش پیشرو همراه باشد تا در ساختار CMS به درستی کار کند.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
مهم: از Ctrl + H برای جستجو و جایگزینی استفاده کن، اما مسیرها را بهطور کور جایگزین نکن. بهویژه URLهای خارجی، لنگرها، لینکهای mailto:- و مسیرهای مطلق را بررسی کن.
جایگزین اسکرینشات: دایرکتوری اصلی → هدر → کد HTML با هدر درج شده – dev_bootstrap_import_header_html_einfuegen.jpeg. تصاویر را همچنان ضبط کرده و سپس در اینجا وارد کن.
4. Footer را جدا کرده و منتقل کنید
سپس فوتر را در index.html اصلی جستجو کن. بخش کامل فوتر را برش زده یا کپی کن و آن را در فایل فوتر مربوط در دایرکتوری اصلی پروژهات قرار بده. همچنین همه href و src محلی را در آنجا بررسی کن.
جایگزین اسکرینشات: فایل فوتر در دایرکتوری اصلی با کد فوتر درج شده – dev_bootstrap_import_footer_html_einfuegen.jpeg. تصاویر را همچنان ضبط کرده و سپس در اینجا وارد کن.
5. ناحیه اصلی را به الگوهای بخشهای جداگانه تقسیم کنید
محتوای صفحه باقیمانده پس از هدر و فوتر بهصورت مستقیم در index.html پروژهات کپی نمیشود. بلکه bx_Layout → SectionTemplate.txt → کد HTML را باز کن.
باقیمانده بخش اصلی الگوی اصلی را در انتهای این فایل قرار بده. سپس آن را به بخشهای جداگانه تقسیم کن که بعداً بهطور جداگانه در ویرایشگر در دسترس باشند.
بین دو الگوی بخش، دقیقاً جداکننده زیر را قرار بده:
<!--__SP_SectionTemplate__-->
هر بخش جدا شده میتواند بعداً بهعنوان یک الگوی مستقل در ویرایشگر درج شود. به این ترتیب میتوانی بخشها را آزادانه مرتبسازی، چندین بار استفاده یا در یک صفحه حذف کنی.
جایگزین اسکرینشات: bx_Layout → SectionTemplate.txt با چندین بخش و جداکننده <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. تصاویر را همچنان ضبط کرده و سپس در اینجا وارد کن.
6. قاب طراحی را در 00_layout قرار دهید
پس از جدا کردن هدر، فوتر و بخشهای اصلی، چارچوب HTML واقعی باقی میماند، بهعنوان مثال با DOCTYPE، بخش head و سایر عناصر بالادستی. این کد باقیمانده را کپی کن.
سپس مدیریت پایگاه داده را باز کن و پایگاه داده 00_layout را ویرایش کن. در آنجا الگوهای موجود در دسترس است. میتوانی یک الگوی موجود را ویرایش کنی یا یک الگوی جدید بسازی.
چارچوب کپی شده را زیر LayoutHTML قرار بده. در موقعیتهای اصلی هدر، محتوا و فوتر از علامتهای CMS استفاده کن:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
هنگام رندر صفحه، این علامتها با هدر مربوطه، صفحه اصلی فعلی و فوتر جایگزین میشوند. کد PHP مربوطه در زیر LayoutPHP بهطور خودکار هنگام بارگذاری الگو اجرا میشود.
جایگزین اسکرینشات: پایگاه داده 00_layout با LayoutHTML و علامتها برای هدر، بخش اصلی و فوتر – dev_bootstrap_import_00_layout_layouthtml.jpeg. تصاویر را همچنان ضبط کرده و سپس در اینجا وارد کن.
7. مسیرهای CSS، JavaScript و Favicon را بررسی کنید
در داخل کد الگو، تمام مراجعات به فایلهای CSS، JavaScript و Favicon را بررسی کن. در مسیرهای محلی، اسلش پیشنیاز را قرار بده. برای فایلهای CSS و JavaScript همچنین از علامت نسخهگذاری فایل CMS استفاده کن.
یک فراخوانی JavaScript میتواند بهصورت زیر باشد:
<script src="__FV_/bx_script/core.min.js__"></script>
نشانه __FV_...__ به سیستم این امکان را میدهد که نسخه فایل یا تاریخ تغییر را هنگام رندر در نظر بگیرد. به این ترتیب، مرورگر میتواند بدون نیاز به بهروزرسانی دستی کش مرورگر، فایل CSS یا JavaScript کنونی را پس از تغییرات بارگذاری کند.
8. محتوای Head را تمیز کنید و از HTML Header استفاده کنید
بخش head منتقل شده را بررسی کن و محتوایی که قبلاً توسط CMS تنظیم شدهاست یا در جای دیگری بارگذاری میشود را حذف کن. همچنین عنوان صفحه ثابت را میتوانی حذف کنی، اگر این عنوان بهصورت خودکار توسط سیستم تولید شود.
کد هدر که ویرایشگر به آن نیاز دارد و نباید مستقیماً جزء LayoutHTML باشد، باید در زیر Extras → Header-HTML قرار گیرد. به این ترتیب ویرایشگر میتواند محتوای موجود در آنجا را هنگام ویرایش صفحه در نظر بگیرد.
جایگزین اسکرینشات: Extras → Header-HTML با کد هدر که به آنجا منتقل شده است – dev_bootstrap_import_extras_header_html.jpeg. تصاویر را همچنان ضبط کرده و سپس در اینجا وارد کن.
9. طرح وارد شده را برای صفحه انتخاب کنید
اگر یک الگوی جدید در 00_layout ایجاد کردهای، در ویرایشگر به تنظیمات صفحه برو و الگوی وارد شده خود را انتخاب کن. تنها در این صورت است که صفحه مربوطه با این چارچوب الگو نمایش داده میشود.
جایگزین اسکرینشات: تنظیمات صفحه با انتخاب الگوی جدید وارد شده – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. تصاویر را همچنان ضبط کرده و سپس در اینجا وارد کن.
10. صفحه اصلی را از بخشهای وارد شده کنار هم قرار دهید
روی صفحه خود کلیک کن و ویرایش را انتخاب کن. ممکن است صفحه شروع در ابتدا خالی به نظر برسد. این طبیعی است، زیرا هنوز هیچ یک از بخشهای جدید در صفحه اصلی درج نشده است.
درج → بخش صفحه را انتخاب کن. باید بخشهایی را ببینی که قبلاً در SectionTemplate.txt با جداکننده بخش جدا کردهای.
بخشهای مورد نیاز را یکی یکی وارد کن و بدین ترتیب صفحه اصلی را بازسازی کن. سپس میتوانی بخشها را بهدلخواه جابهجا کنی، حذف کنی یا چند بار وارد کنی.
جایگزین تصویر: ویرایشگر → درج → بخش صفحه با قالبهای بخش وارد شده – dev_bootstrap_import_sections_einfuegen.jpeg. تصویر را بگیرید و سپس در اینجا درج کنید.
11. از صفحه اصلی به عنوان مرجع استفاده کنید
در فایلها → bx_Import میتوانی index.html اصلی را به عنوان پیشنماش باز کنی. از آن به عنوان مرجع استفاده کن در حالی که صفحه جدید CMS خود را از بخشهای مختلف تشکیل میدهی.
اگر در ابتدا تصاویری در قالبهای خاصی وجود نداشته باشد، انتقال صحیح آنها در آموزشهای بعدی بررسی خواهد شد.
12. مسیرها و قابلیت ویرایش تمام بخشها را بررسی کنید
در پایان دوباره بخشها → قالب بخش را بررسی کن و تمامی مسیرهای محلی را بررسی کن. برای بسیاری از مسیرهای مشابه، میتوانی تغییرات را به صورت کارآمد با استفاده از Ctrl + H در ویرایشگر متن انجام دهی.
سپس هر بخش وارد شده را در ویرایشگر تست کن. بررسی کن که آیا همه محتوا به درستی نمایش داده میشود و متنها و عناصر مورد نظر قابل ویرایش هستند.
اگر به عنوان مثال متنی قابل ویرایش نیست، ساختار HTML آن را بررسی کن. اگر یک متن عادی مستقیماً در یک div قرار داشته باشد، ممکن است بسته به ساختار، مفید باشد متن را به یک عنصر p مناسب منتقل کنی.
جایگزین تصویر: صفحه اصلی نهایی بعد از درج و ترتیببندی بخشها – dev_bootstrap_import_fertige_startseite.jpeg. تصویر را بگیرید و سپس در اینجا درج کنید.
13. چرا طراحی تقسیم میشود
از آنجا که هدر، فوتر، قابهای طراحی و بخشهای مختلف جدا شدهاند، نیاز نیست که هر بار این اجزا را از فایل اصلی Bootstrap کپی کنی.
هدر و فوتر مرکزی قابل استفاده مجدد هستند، در حالی که بخشهای مختلف صفحه به عنوان قالبهای انعطافپذیر در ویرایشگر در دسترس هستند. به این ترتیب میتوانی از یک قالب Bootstrap صفحات مختلفی را بسازی و ترتیب محتوا را در هر زمانی تغییر دهی.
خلاصه
برای وارد کردن Bootstrap-5 از فایلهای اصلی در bx_Import به عنوان الگو استفاده کن. هدر و فوتر بهصورت جداگانه در بخشهای مربوطه CMS منتقل میشوند، و بخش اصلی از طریق SectionTemplate.txt به قالبهای مختلف تقسیم میشود و قاب HTML باقیمانده تحت 00_layout → LayoutHTML ذخیره میشود.
سپس در تنظیمات صفحه، طرح را انتخاب کن و صفحه را از طریق درج → بخش صفحه از بخشهای وارد شده تشکیل ده. در پایان تمام مسیرها، ارجاعات CSS و JavaScript و قابلیت ویرایش بخشهای مختلف را بررسی کن.
سوالات متداول
چه سوالاتی را مشتریان معمولاً از ما میپرسند
چرا الگوی اصلی Bootstrap تحت bx_Import باقی میماند؟
پوشه bx_Import به عنوان نقطه شروع و مرجع برای الگوی اصلی وارد شده عمل میکند. اجزا مورد نیاز از آن به بخشهای مربوطه CMS منتقل میشوند.
کدام فایل را برای اولین واردات استفاده کنم؟
در این آموزش، index.html به عنوان نقطه شروع استفاده میشود. از آن هدرها، فوترها، بخشهای اصلی و قاب طراحی باقیمانده جدا میشوند.
چگونه به سرعت هدر و فوتر را در کد HTML پیدا کنم؟
از Ctrl + F استفاده کن و به عنوان مثال، به دنبال header یا footer بگرد. در الگوهایی که فاقد تگهای HTML مربوطه هستند، باید ساختارهای div اطراف را دقیقتر بررسی کنی.
بخشهای مختلف صفحه در کجا ذخیره میشوند؟
قالبها در bx_Layout در SectionTemplate.txt ذخیره میشوند و با جداکننده <!--__SP_SectionTemplate__--> از یکدیگر جدا میشوند.
کدام نشانهها به LayoutHTML نیاز است؟
در موقعیتهای بخشهای جدا شده از __DB_Layout_Header__، __DB_Layout_Main__ و __DB_Layout_Footer__ استفاده میکنید.
چرا فایلهای CSS و JavaScript با __FV_ علامتگذاری میشوند؟
این کار به CMS اجازه میدهد تا هنگام رندر کردن، نسخه یا تاریخ تغییرات فایل را در نظر بگیرد. بعد از یک تغییر، مرورگر میتواند فایل جاری را بارگذاری کند، نه یک نسخه کش قدیمی.
چرا صفحه اصلی بعد از واردات طرح در ابتدا خالی است؟
طرح در ابتدا تنها فریم را فراهم میکند. بخشهای واقعی باید از طریق درج → بخش صفحه به صفحه اضافه شوند.
آیا میتوانم یک بخش وارد شده را چندین بار استفاده کنم؟
بله. الگوهای بخش جداگانه میتوانند در ویرایشگر به دلخواه وارد، جابجا و همچنین چندین بار استفاده شوند.
اگر مسیرهای نسبی تصویر یا پیوند کار نکردند، چه کنم؟
مسیرهای محلی href و src را بررسی کنید و در صورت نیاز یک اسلش در ابتدا اضافه کنید. با استفاده از Ctrl + H میتوانید مسیرهای تکراری را جایگزین کنید، اما باید از تغییر کور URLهای خارجی، لنگرها و سایر مسیرهای خاص خودداری کنید.
اگر متنی در ویرایشگر قابل ویرایش نباشد، چه کاری باید انجام دهم؟
ساختار HTML بخش مربوطه را بررسی کنید. اگر متن عادی مستقیماً در یک div-container قرار داشته باشد، بسته به ساختار، استفاده از یک عنصر p مناسب ممکن است.
چگونه میتوانم صفحه اصلی را در هنگام بازسازی مقایسه کنم؟
فایل index.html اصلی را از طریق گزینه پروندهها → bx_Import در پیشنمایش باز کنید و از آن به عنوان مرجع برای ترتیب و ساختار بخشها استفاده کنید.