עריכת הפרויקט

לאתר Shoplifter יש שני ממשקים: האתר שרואים המבקרים, ולוח הבקרה שבו בעל האתר עורך את התוכן. אתם כותבים את רכיבי Astro של האתר. את התוכן שניתן לעריכה ואת מסך העריכה שלו מתארים באמצעות JSON.

החלק הזה מלווה דוגמה אחת של אתר Studio: כותרת ותמונה באזור הפתיחה, כרטיסי שירות חוזרים ופרטי עסק. עקבו אחרי אותם שדות לאורך המדריכים, במקום ללמוד כל קובץ בנפרד.

כיצד החלקים מתחברים

1. מגדירים ערך. הקובץ definition.json מגדיר את hero.title כשדה טקסט ומספק ערך התחלתי.
2. ממקמים את הקלט. הקובץ editor.json מציב את קבוצת hero תחת Home page ← Opening section.
3. מציגים אותו. הרכיב שנבחר ב־shoplifter.json קורא את content.hero.title.
4. מנסים עריכה. הקובץ המקומי fixtures.json מאפשר לבדוק כותרת אחרת בלי לשנות חנות חיה.
5. מאפשרים לבעל האתר לערוך. בלוח הבקרה בעל האתר משנה את אותו שדה; ה־SDK מספק את הערך השמור לרכיב.

שינוי המיקום של קלט במסך שונה משינוי המקום שבו הערך נשמר. מקטע בעורך אינו יוצר אובייקט תוכן חדש.

הכירו כל קובץ בפרויקט

קובץ	על איזו שאלה הוא עונה	מדריך מפורט
shoplifter.json	אילו רכיבים מרכיבים את האתר?	רכיבים וחיבור הפרויקט
definition.json	מה בעל האתר יכול לערוך, וכיצד הערכים בנויים?	שדות, סוגים, ברירות מחדל וגרסאות
editor.json	היכן כל קלט מופיע בלוח הבקרה?	קבוצות, מקטעים ותקצירי אוספים
data.json	אילו נתוני פלטפורמה נדרשים לדף?	בקשות נתונים בעלות שם והתוצאות שלהן
assets.json	אילו תמונות נארזות, ואילו שדות הן מאתחלות?	תמונות וקישורי נכסים
design.json	אילו ברירות מחדל חזותיות נתמכות ישמשו באתר?	ערכות והגדרות עיצוב
migrations.json	כיצד תוכן קיים ישרוד שינוי בסכמה?	מיגרציות תוכן בעלות גרסה
מקור, נתוני דמה וקבצים שנוצרים	מה עורכים, מה יוצרים מחדש ובמה לא נוגעים?	קובצי פיתוח ומאפייני רכיבים

כל מדריך מסביר את מטרת הקובץ, מציג דוגמה, מתאר את המפתחות ומחבר אותו לקובץ הבא.

עצבו את מסך העריכה של בעל האתר

התחילו בבניית עורך עם קבוצות ומקטעים. המשיכו אל סוגי שדות ופקדי קלט ואל רשימות חוזרות וגלריות כדי ליצור חוויית עריכה צפויה.

זהו עורך התוכן של בעל האתר. טפסי פנייה של מבקרים משתמשים בממשק טפסי הפניות הנפרד.

על מה אתם אחראים

הפרויקט אחראי לדף הבית, לכותרת העליונה, לכותרת התחתונה ולעיצוב שלהם. ה־SDK אחראי למטא־נתונים, לשפה ולכיוון הטקסט, לנתיבי תוכן ויצירת קשר מנוהלים ולמעטפת התמיכה. שמרו על האינטגרציה שנוצרה; הוספת נתיבים והחלפת תבניות משותפות אינן נתמכות.

ערכו ישירות את קובצי ה־JSON או השתמשו בפקודות העריכה המאומתות של ה־CLI. לאחר מכן צרו טיפוסים מחדש, אמתו ובדקו את התוצאה המוצגת. לפני העלאה המשיכו אל נתוני דמה ואימות.