# הוראות לבוט: איך מוסיפים ספר לקטלוג ספריית הרב יהודה טאוב קרא את הקובץ כולו לפני שאתה נוגע בקטלוג. ## מה זה הקטלוג - **הכתובת באתר:** https://yudataub.github.io/aaa/catalog.html - **הקובץ:** `catalog.html` בשורש המאגר `yudataub/aaa` ב־GitHub. זה קובץ HTML אחד, בלי מסד נתונים ובלי קבצים נוספים. - **מה יש בו:** כרגע 123 ספרים ב־13 מדורים. לכל ספר יש כרטיס עם כריכה, שם, תיאור, קישור לקריאה, ולפעמים גם כפתור "🛒 להזמנת הספר" לבוקפוד. - **פרסום:** האתר מתעדכן אוטומטית תוך כמה דקות אחרי מיזוג לענף `main`. --- ## ⛔ כללים 1. **לא לשכפל ספרים.** לפני שמוסיפים ספר, חפש ב־`catalog.html` גם את השם שלו וגם את המזהה של הקובץ בדרייב (החלק שאחרי `/d/`). אם הספר כבר קיים, עדכן את הכרטיס הקיים ואל תוסיף כרטיס חדש. 2. **לא למחוק ולא להזיז** ספרים קיימים, אלא אם הרב יהודה ביקש זאת במפורש. 3. **לבדוק כל קישור** לפני שמכניסים אותו לקטלוג (ראה "בדיקת קישורים" למטה). 4. **לא לשנות** את העיצוב, את קוד ה־CSS או את הסקריפט בתחתית הקובץ. מוסיפים רק כרטיסים ומעדכנים מספרים. 5. בכל שינוי בכמות הספרים מעדכנים גם את המספרים בראש הדף ובכותרת המדור (שלב 4). --- ## שלב 1: לאסוף את פרטי הספר | שדה | חובה? | מאיפה | |---|---|---| | שם הספר | חובה | | | מדור | חובה | אחד מ־13 המדורים בטבלה למטה | | תיאור קצר, משפט אחד | חובה | מהספר או מדף בוקפוד | | קישור לקריאה | חובה | קובץ בגוגל דרייב, בדרך כלל PDF, **משותף ל"כל מי שיש לו את הקישור"** | | כריכה | מומלץ | תמונה בדרייב, בתיקייה "הדמיות מהאתר" | | קישור קנייה | אם קיים | דף הספר בבוקפוד | | סוג וגודל | מומלץ | 📄 ספר / 📊 מצגת / 📝 מסמך / 🎧 שמע / 🎬 וידאו, וגודל הקובץ (למשל 4.2MB) | --- ## שלב 2: בדיקת קישורים ### קישור לקריאה (דרייב) - בדוק את הקישור בלי להיות מחובר לגוגל, למשל עם `curl -s -o /dev/null -w '%{http_code}' <קישור>`: - **200:** פתוח לכולם, תקין. - **401:** הקובץ פרטי. צריך לשתף אותו ("כל מי שיש לו את הקישור" ← צופה), או לבקש מהרב יהודה לשתף. - **404:** הקובץ לא קיים. אל תכניס אותו לקטלוג. - **קבצים ישנים** שהמזהה שלהם מתחיל ב־`0B` צריכים גם מפתח גישה בסוף הקישור: `&resourcekey=0-...`. בלעדיו הם לא ייפתחו לאחרים, גם כשהם משותפים. את המפתח מקבלים מפרטי הקובץ בדרייב (viewUrl). ### כריכה - הכתובת בנויה כך: `https://drive.google.com/thumbnail?id=<מזהה התמונה>&sz=w500` - הכתובת צריכה להחזיר תמונה (image/png או image/jpeg). אם היא מחזירה דף HTML, התמונה לא משותפת. - אם אין כריכה: תמונה שנמצאת בתיקייה "הדמיות מהאתר": https://drive.google.com/drive/folders/1my71HQod-DPQzVmu7NIwYmzye3j61BDa - אם גם שם אין: כשקובץ הספר עצמו ציבורי, אפשר להציג את העמוד הראשון שלו. שים את מזהה קובץ הספר בכתובת ה־thumbnail. ### קישור קנייה (בוקפוד) - דף הסופר, שבו כל הספרים הפעילים: https://bookpod.co.il/author/%D7%99%D7%94%D7%95%D7%93%D7%94-%D7%98%D7%90%D7%95%D7%91 - אפשר לבדוק ספר גם לפי המספר שלו בבוקפוד: `https://bookpod.co.il/book/x-<מספר>` - אם כותרת הדף היא "**הספר לא נמצא**", אין לספר דף מכירה. **אל תוסיף כפתור קנייה.** - אחרת, השתמש בכתובת המלאה שהדף עובר אליה, למשל `https://bookpod.co.il/book/פור-המן-1817`. - השווה את השם בבוקפוד לשם בקטלוג. אם הם שונים, שאל לפני שאתה מקשר. --- ## שלב 3: להוסיף כרטיס מצא ב־`catalog.html` את המדור, לפי `
`. הוסף את הכרטיס בתוך `
` של אותו מדור, לפני ה־`
` שסוגר אותו. ### תבנית כרטיס ```html
שם הספרהאות-הראשונה

שם הספר

תיאור קצר

📄 ספר4.2MB🛒 להזמנת הספרפתח ←
``` ### איך ממלאים את התבנית - **`data-title`, `alt` ו־`h3`:** שם הספר, זהה בשלושת המקומות. `data-title` ו־`data-desc` משמשים לחיפוש באתר. - **`data-href`:** הקישור לקריאה. - **תווים מיוחדים:** כתוב `&` במקום `&`. בתוך `data-desc` ו־`data-title` כתוב `"` במקום `"` ו־`'` במקום `'`. - **בלי כריכה:** כתוב `data-has-cover="0"`, ובמקום הכתובת ב־`src` שים את כתובת התמונה החלופית (אותה כתובת שמופיעה ב־`onerror`). - **בלי קישור קנייה:** מחק את כל התג `...`. - **שפה אחרת:** אפשר להוסיף תווית שפה אחרי ה־`h3`, למשל `EN`. - **ספר שמופיע בשני מדורים:** הוסף כרטיס בכל אחד מהם. בכל כרטיס, מיד אחרי `

` של התיאור, הוסף: `📌 מופיע גם ב<שם המדור השני>` - **קישור קריאה נוסף:** לפני `` הוסף: `🔗 קישור נוסף` ### המדורים | מדור | `data-cat` | צבע (`--c`) | תיקייה בדרייב | |---|---|---|---| | 💜 אהבת השם | `ahavat_hashem` | `#8B5CF6` | https://drive.google.com/drive/folders/1Jmb7YFcbuaTz1cfsvn7uMX0ClaR4HnFh | | 🌿 ארץ ישראל | `eretz_israel` | `#10B981` | https://drive.google.com/drive/folders/1MZlgzARoWdAfLBoKYShjen-tGkHGTVF1 | | 🙏 הודיה והכרת הטוב | `hodaya` | `#F59E0B` | https://drive.google.com/drive/folders/1yMrmyXROQM3UTeQM0pDMb6PnJz5GZVxU | | 👶 חינוך בשנה הראשונה | `chinuch_shana` | `#3B82F6` | https://drive.google.com/drive/folders/19GTmWzcc3JBeYJ7NUWPmaSsVwbeGVZ-2 | | 🎊 מעגל החיים — שמחות | `maagal_chaim` | `#EC4899` | https://drive.google.com/drive/folders/1G1NERF6DRe-S4X6XQ8hnrSO8eW2vcyTN | | 📅 מעגל השנה | `maagal_shana` | `#6366F1` | https://drive.google.com/drive/folders/1JJ7vKTmFqcii6geD8nr5u0ysJ3QcOO5- | | 📖 ספרי ביוגרפיה | `biografia` | `#D97706` | https://drive.google.com/drive/folders/1uSy4F-Xx3rSbI9LKw-XunaXBlj3Q8K8d | | 📜 פרשת השבוע | `parashat_shavua` | `#7C3AED` | https://drive.google.com/drive/folders/1tVfLg7gH51pDmy5UsW5Jc3V59M6Ri-UD | | 🏠 שלום בית | `shalom_bait` | `#EF4444` | https://drive.google.com/drive/folders/1BFY7Ks15UbFnDf-f1JQ5on_zMwd7P6YV | | 😊 שמחה וחיוך | `simcha` | `#F97316` | https://drive.google.com/drive/folders/19_lZPZEcZO47HNH9ZxC4R9KHfAfGUS-0 | | ✨ ספרי סיפורים שיצרתי | `sippurim` | `#059669` | https://drive.google.com/drive/folders/114XExHPEVxbDqcmsSCPFaSX4k6AcRHfw | | 🌍 שבע מצוות בני נח | `bnei_noach` | `#0891B2` | https://drive.google.com/drive/folders/1VuRZ2N24jnthIZ18mMp0HbGJVW67KuNM | | 📂 שונות | `shonot` | `#6B7280` | https://drive.google.com/drive/folders/1zcLEzlf51E3O9hnGFO6iZHu4cIz3h2fo | **מדור חדש:** רק באישור הרב יהודה. מעתיקים `
` קיים שלם עם `data-cat` חדש, צבע ותיקייה, ומוסיפים כפתור מתאים ב־`