ייבוא פריסת Bootstrap 5
למד איך לפרק תבנית Bootstrap-5 תחת bx_Import להרגל, כותרת, תבניות קטעים גמישות ו LayoutHTML ולאחר מכן להרכיב במערכת编辑 בבלוטרוניקס.
מטרת המדריך
במדריך זה תייבא פריסת Bootstrap-5 קיימת למערכת הניהול של bluetronix. במהלך כך תפרק את דף ה-HTML המקורי לכותרת, כותרת תחתונה, תבניות קטעים נפרדות ואת מסגרת התבנית עצמה. לאחר מכן תוכל להוסיף, להזיז ולשכפל את הקטעים השונים בעורך.
הערה: מדריך זה עוסק בייבוא הפריסה הבסיסי. עיבוד נוסף או החלפה של תמונות יידונו במדריך הבא.
1. פתח את התבנית המקורית תחת bx_Import
פתח במנהל הקבצים את התיקייה bx_Import. שם נמצא בתורו את הפריסה המיובאת במצב המקורי – לדוגמה, עם תיקיות התמונות והקבצי HTML המקוריים. באחד זה תעבוד רק עם הקבצים המקוריים הקיימים; שינויים לא יישמרו בתבנית המקורית.
לצורך הדוגמה הזו פתח את הקובץ index.html ועבור אל עריכה. קובץ זה יתפרק כעת לרכיבים השונים של פריסת ה-CMS.
מקום לתמונה: מנהל קבצים עם תיקיית bx_Import פתוחה, תיקיות תמונות וקבצי HTML מקוריים – dev_bootstrap_import_bx_import_originaldateien.jpeg. יש לצלם תמונה ולהטמיע אותה כאן לאחר מכן.
מקום לתמונה: index.html מ-bx_Import בעורך ה-HTML – dev_bootstrap_import_index_html_bearbeiten.jpeg. יש לצלם תמונה ולהטמיע אותה כאן לאחר מכן.
2. הפרד את הכותרת מ-index.html
חפש בקוד ה-HTML עם Ctrl + F את header. בהרבה תבניות Bootstrap, ניתן למצוא את הכותרת במהירות מכיוון שהיא מסומנת באלמנט HTML מתאים. בתבניות מסוימות, הכותרת מורכבת רק מאזור div; במקרה זה תצטרך לבדוק את המבנה בזהירות.
סמן את האזור המלא של הכותרת והעתק אותו. עדיף לעבוד עם שני חלונות פתוחים כדי שאתה יכול לעבור בין התבנית המקורית לבין פרויקט ה-CMS שלך.
מקום לתמונה: אזור הכותרת של index.html שנמצא דרך החיפוש ונמסר להעתקה – dev_bootstrap_import_header_markieren.jpeg. יש לצלם תמונה ולהטמיע אותה כאן לאחר מכן.
3. העבר את הכותרת למערכת ניהול תוכן
חזור לפרויקט שלך, פתח את הספריה הראשית ולאחר מכן כותרת → קוד HTML. הדבק שם את קוד הכותרת שהעתקת קודם.
לאחר מכן, בדוק את הנתיבים המקומיים. ברבים מהעיצובים יש להוסיף קו חיץ מתחיל להוראות יחסיות ונתיבי תמונה, כדי שהם יתפקדו בצורה נכונה בתוך מבנה ה-CMS.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
חשוב: השתמש ב-Ctrl + H לחיפוש והחלפה, אך אל תחליף נתיבים בעיוורון. בדוק במיוחד URLs חיצוניים, עוגנים, קישורי mailto:- ונתיבים מוחלטים שכבר קיימים.
Placeholder צילום מסך: תיקיית ראשית → כותרת → קוד HTML עם כותרת שהוכנסה – dev_bootstrap_import_header_html_einfuegen.jpeg. יש לקיחת התמונה ולחבר אותה כאן.
4. הפרד את כותרת התחתונה והעבר אותה
לאחר מכן, חפש את הפוטר בקובץ index.html המקורי. חותך או מעתיק את אזור הפוטר המלא ומדביק אותו בקובץ הפוטר שיועד לכך בתיקיית הראשית של הפרויקט שלך. בדוק גם שם את כל נתיבי href ו-src המקומיים.
Placeholder צילום מסך: קובץ פוטר בתיקיית הראשית עם קוד הפוטר שהוכנס – dev_bootstrap_import_footer_html_einfuegen.jpeg. יש לקיחת התמונה ולחבר אותה כאן.
5. חלק את אזור התוכן הראשי לתבניות קטעים נפרדות
התוכן הנותר של הדף אחרי כותרת ופוטר לא מועתק ישירות ל-index.html של הפרויקט שלך. במקום זאת, פתח את bx_Layout → SectionTemplate.txt → קוד HTML.
הדבק את האזור הדומיננטי הנותר של התבנית המקורית בסוף הקובץ הזה. לאחר מכן, חלק אותו לאזורים בודדים שישמשו בנפרד בעורך.
בין שתי תבניות סקשן תציב בדיוק את המפריד הבא:
<!--__SP_SectionTemplate__-->
כל חלק שמופרד כך יכול מאוחר יותר להיות מוזרק כתבנית נפרדת בעורך. כך תוכל לסדר Sections בחופשיות, להשתמש בהם מספר פעמים או להשאירם מחוץ לדף.
Placeholder צילום מסך: bx_Layout → SectionTemplate.txt עם מספר Sections והמפריד <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. יש לקיחת התמונה ולחבר אותה כאן.
6. העבר את מסגרת הפריסה ל-00_layout
לאחר חיתוך הכותרת, הפוטר וה-Sections הראשיים, נשאר המסגרת HTML עצמה, לדוגמה עם DOCTYPE, אזור הhead ורכיבי עיצוב עליונים נוספים. העתק את הקוד הנותר הזה.
לאחר מכן, פתח את ניהול המסד נתונים וערוך את המסד 00_layout. שם כבר זמינות תבניות עיצוב. אתה יכול לערוך תבנית קיימת או ליצור עיצוב חדש.
הדבק את המסגרת שהעתקת תחת LayoutHTML. בעמדות המקוריות של הכותרת, התוכן המרכזי והפוטר תשתמש בתגי ה-CMS:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
בעת רינדור הדף, התגים הללו מוחלפים בכותרת המתאימה, הדף הראשי הנוכחי והפוטר. קוד ה-PHP המתאים תחת LayoutPHP יופעל אוטומטית בעת טעינת העיצוב.
Placeholder צילום מסך: מסד נתונים 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. נקה את תכני הראש והשתמש ב-HTML של הכותרת
בדוק את אזור הhead שהועתק והסר תוכן שכבר הוגדר על ידי ה-CMS או נטען במקום אחר. תוכל גם להסיר כותרת דף קבועה אם היא נוצרת אוטומטית על ידי המערכת.
קוד הכותרת, הנדרש על ידי העורך ואינו מהווה חלק ישיר מ-LayoutHTML, יוגש תחת Extras → Header-HTML. כך העורך יכול לקחת בחשבון את התוכן שהוטר להיות שם בזמן עריכת הדף.
Placeholder צילום מסך: Extras → Header-HTML עם הקוד כותרת שהועבר לשם – dev_bootstrap_import_extras_header_html.jpeg. יש לקיחת התמונה ולחבר אותה כאן.
9. בחר את הפריסה המיובאת עבור הדף
אם יצרת עיצוב חדש ב-00_layout, פתח בעורך את הגדרות הדף ובחר שם את העיצוב המיובא שלך. רק אז תוצג הדף הרלוונטי עם מסגרת העיצוב הזו.
Placeholder צילום מסך: הגדרות דף עם בחירת העיצוב החדש המיובא – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. יש לקיחת התמונה ולחבר אותה כאן.
10. הרכב את דף הבית מתוך הקטעים המיובאים
לחץ על עריכה בדף שלך. דף הבית יכול להיראות תחילה ריק. זה נורמלי, מכיוון שעוד לא הוכנסו שום מקטעים חדשים לדף עצמו.
בחר הוספה → מקטע דף. שם צריכים להופיע האזורים שהפרדת קודם ב-SectionTemplate.txt בעזרת מפריד הסקשן.
הוסף את החלקים הנדרשים אחד אחרי השני וכך שחזר את הדף המקורי. לאחר מכן תוכל להזיז את החלקים כרצונך, להשאיר חלקם בחוץ או להוסיף אותם מספר פעמים.
תמונה להמחשה: עורך → הוספה → חלק דף עם תבניות החלקים המיובאים – dev_bootstrap_import_sections_einfuegen.jpeg. יש לצלם את התמונה ולאחר מכן לקשר אותה כאן.
11. השתמש בדף המקורי כהפניה
בתוך קבצים → bx_Import תוכל לפתוח את index.html המקורי כהצגה מוקדמת. השתמש בו כמדריך בעת הרכבת דף ה-CMS החדש שלך מחלקים בודדים.
אם חלק מהתבניות חסרות בהן תמונות בהתחלה, תהליך העברתן הנכונה יטופל במדריך הבא.
12. בדוק את הנתיבים והעריכות האפשריות של כל הקטעים
בדוק בסוף פעם נוספת את Sections → תבנית חלק וודא את כל המסלולים המקומיים. עבור רבים מהמסלולים הדומים, תוכל לבצע את השינויים בעורך טקסט עם Ctrl + H ביעילות.
לאחר מכן, בדוק כל חלק מיובא בעורך. ודא שכל התכנים מוצגים נכון ושהטקסטים והאלמנטים הנדרשים ניתנים לעריכה.
אם, לדוגמה, טקסט מסוים אינו ניתן לעריכה, בדוק את מבנה ה-HTML שלו. אם טקסט רגיל נמצא ישירות בתוך div, בהתאם למבנה זה עשוי להיות הגיוני להזיז את הטקסט לתוך אלמנט p מתאים.
תמונה להמחשה: דף הבית המורכב לאחר הוספת והסדרת החלקים – dev_bootstrap_import_fertige_startseite.jpeg. יש לצלם את התמונה ולאחר מכן לקשר אותה כאן.
13. למה הפריסה מחולקת
בעקבות ההפרדה בין כותרת, תחתית, מסגרת פריסה וחלקים בודדים, אינך צריך להעתיק קומפוננטים אלה כל פעם מחדש מהקובץ המקורי של Bootstrap.
הכותרת והתחתית המרכזיות יכולות להיות בשימוש חוזר, בעוד שהחלקים של הדפים הבודדים זמינים בעורך כלTemplates כך שתוכל להרכיב דפים שונים מתבנית Bootstrap ולשנות את סדר התוכן בכל עת.
סיכום
לייבוא Bootstrap-5 השתמש בקבצים המקוריים תחת bx_Import כתבנית. הכותרת והתחתית מועברות בנפרד לאזורים המיועדים ב-CMS, החלק העיקרי מפורק לתבניות בודדות דרך SectionTemplate.txt ומסגרת ה-HTML הנותרת נשמרת תחת 00_layout → LayoutHTML.
לאחר מכן, בחר את הפריסה בהגדרות הדף והקם את הדף באמצעות הוספה → חלק דף מהחלקים המיובאים. בדוק בסוף את כל המסלולים, הפניות CSS ו-JavaScript וכן את נוחות העריכה של החלקים הבודדים.
שאלות נפוצות
מה לקוחות שואלים אותנו לעיתים קרובות
למה התבנית המקורית של Bootstrap נשמרת תחת bx_Import?
התיקיה bx_Import משמשת כנקודת התחלה והפניה לתבנית המקור המיובאת. המרכיבים הנדרשים מועברים משם לאזורים המתאימים ב-CMS.
איזה קובץ אני משתמש לייבוא הראשון?
במדריך הזה משתמשים ב-index.html כבסיס. ממנו מופרדים הכותרת, התחתית, חלקי-main והמסגרת הנותרת.
איך אני מוצא את הכותרת והתחתית במהירות בקוד 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 יכול לשקול את גרסת הקובץ או את תאריך השינוי במהלך ה-rending. לאחר שינוי, הדפדפן יכול לטעון את הקובץ העדכני במקום גרסה ישנה מהמטמון.
למה הוצג הדף הבית ריק בהתחלה לאחר ייבוא הפריסה?
העיצוב מספק בתחילה רק את המסגרת. חלקי הדף עצמם צריכים להיות מותקנים בדף דרך הוספה → חלק דף.
האם אני יכול להשתמש בחלק דף מיובא מספר פעמים?
כן. תבניות החלקים הנפרדות יכולות להיות מותקנות בעורך לפי הצורך, מועברות וגם משומשות מספר פעמים.
מה לעשות אם נתיבי התמונה או הקישור היחסיים לא פועלים?
בדוק את נתיבי href ו-src המקומיים והוסף במידת הצורך סלש מוביל. עם Ctrl + H תוכל להחליף נתיבים חוזרים, אבל כדאי לא לשנות באופן עיוור כתובות URL חיצוניות, עוגנים ונתיבי מיוחדים אחרים.
מה לעשות אם טקסט בעורך לא ניתן לעריכה?
בדוק את מבנה ה-HTML של החלק הרלוונטי. אם טקסט רגיל לדוגמה נמצא ישירות בתוך div, ייתכן שסוג p מתאים יהיה הגיוני בהתאם לבנייה.
איך אני יכול להשוות את עמוד המקור בעת השחזור?
פתח את ה-index.html המקורי תחת קבצים → bx_Import באמצעות התצוגה והשתמש בו כהפניה לסדר ולמבנה של החלקים.