shoplifter.json: חיבור חלקי הפרויקט

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

shoplifter.json

{
  "contractVersion": 1,
  "components": {
    "homepage": "src/components/HomePage.astro",
    "header": "src/components/Header.astro",
    "footer": "src/components/Footer.astro"
  }
}

המשמעות של כל מפתח

מפתח	משמעות	מתי לשנות
contractVersion	גרסת מבנה הקובץ; כרגע 1	משאירים בערך הנתמך. זו אינה גרסת האתר שלכם.
components.homepage	הרכיב שמוצג בדף הבית	כאשר מעבירים או מחליפים את רכיב הבית.
components.header	רכיב הכותרת העליונה המשותף	כאשר מעבירים או מחליפים אותו.
components.footer	רכיב הכותרת התחתונה המשותף	כאשר מעבירים או מחליפים אותו.
leads	מקור טפסי פניות ורישומים שנוצרו ממנו, אם יש	בעת הוספת טפסי פניות.

הנתיבים יחסיים לשורש הפרויקט. שלושת נתיבי הרכיבים חייבים להצביע על קובצי .astro תחת src/. הקבצים צריכים להתקיים כדי שאימות ה־CLI יצליח; נתיבים מוחלטים או נתיבי ../ אינם נתמכים.

בטפסי פניות, מגדירים בתחילה את leads.source למודול TypeScript של הטפסים. תהליך היצירה מוסיף את התיאורים הניידים; אין צורך לתחזק ידנית את הרישומים שנוצרו.

עקבו אחרי ערך לאורך הפרויקט

הקובץ הזה בוחר את HomePage.astro. הקובץ definition.json מגדיר את hero.title. הערך ששמר בעל האתר מגיע לרכיב בתור content.hero.title. הקובץ editor.json קובע היכן השדה מופיע בלוח הבקרה.

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

לאחר שינוי נתיבים הריצו shoplifter types ו־shoplifter validate. תקנו רכיב חסר בנתיב שהוגדר עבורו, במקום לשנות את האינטגרציה שנוצרה.