תיעוד

מדריך פרסום

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

פרסום Reactייצוא Next.jsחיפוש DNSבדיקת SSLמחולל מטא

התחלה מהירה

פרסום פירושו להפוך קבצי אתר מקומיים ל-URL שאנשים יכולים לפתוח. DeployPages בנוי לפלט סטטי, כך שהפרסום הראשון יכול להתחיל מתיקייה במקום מהגדרת שרת.

אפשרות 1: פרסום גרור ושחרר

הדרך המהירה ביותר לפרויקטים סטטיים. אם האתר כבר כולל HTML, CSS, JavaScript או תיקיית build גמורה, אפשר להעלות אותו ישירות.

התאמה טובה עבור

דפי נחיתה, אתרים אישיים, קורות חיים, אבות טיפוס, תיעוד סטטי ופלט frontend אחר שהדפדפן יכול לפתוח.
  • 1
    הכינו את תיקיית הפרויקט

    התיקייה שמעלים צריכה לכלול קובץ index.html בשורש, יחד עם כל קובצי הסגנון, הסקריפטים והתמונות שהדף תלוי בהם.

    מבנה תיקיות לדוגמה
    my-site/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    טעות נפוצה

    אם index.html חסר או נמצא עמוק בתוך תיקיית משנה, האתר לא ייטען כראוי אחרי ההעלאה.
  • 2
    פתחו את אזור ההעלאה

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

  • 3
    העלו את התיקייה

    גררו את התיקייה המלאה לאזור ההעלאה או בחרו אותה בבורר הקבצים. בפרויקטי framework, העלו את תיקיית הפלט של ה-build ולא את תיקיית קוד המקור.

  • 4
    פתחו את ה-URL שנוצר

    כאשר ההעלאה מסתיימת, DeployPages מחזיר URL פעיל שאפשר להשתמש בו מיד לבדיקה או לשיתוף.

אפשרות 2: תהליך CLI

שימושי כאשר אותו build מתפרסם שוב ושוב, והפרסום צריך להשתלב בסקריפט, בעבודת CI או ברשימת בדיקה.

השתמשו בזה כשהפרסום חוזר על עצמו

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

התקינו את ה-CLI

השתמשו במנהל החבילות המועדף כדי להתקין את ה-CLI גלובלית.

npm install -g @deploypages/cli

אימות

הריצו את פקודת ההתחברות והשלימו את שלב ההרשאה בדפדפן.

deploypages login

פרסמו את התיקייה הנוכחית

הריצו את פקודת הפרסום מתוך תיקיית הפלט של ה-build.

deploypages deploy

מדריך build ל-frameworks

Frameworks מודרניים צריכים שלב build לפני ההעלאה. המטרה תמיד זהה: ליצור קבצים סטטיים פשוטים שהדפדפן יכול לפתוח ישירות.

מה המשמעות של "build"

Build ממיר קובצי מקור של framework ל-HTML, CSS, JavaScript ונכסים שאפשר לפרסם.

React / Vue / Vite

Command:npm run build
Output:dist/

העלו את תיקיית dist עצמה, לא את שורש הפרויקט.

Next.js ייצוא סטטי

Command:npm run build
Output:out/

הגדירו output: 'export' ב-next.config.js לפני ה-build.

HTML רגיל

Command:אין צורך בשלב build
Output:התיקייה הקיימת שלכם

השאירו את index.html בשורש התיקייה.

Hugo / Hexo

Command:hugo או hexo generate
Output:public/

העלו את תיקיית public שנוצרה.

דוגמה לייצוא סטטי ב-Next.js

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

מגבלות ייצוא סטטי

תכונות שרצות על שרת, כמו API routes, server-side props ו-middleware, אינן זמינות ב-build סטטי מיוצא.

דומיינים מותאמים אישית

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

מה נחשב כדומיין?

כל דומיין שאתם מנהלים אצל רשם יכול לעבוד, כל עוד יש לכם אפשרות לערוך את רשומות ה-DNS שלו.

שלב 1: הוסיפו את הדומיין בלוח הבקרה

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

שלב 2: הגדירו DNS

DeployPages יספק את יעדי DNS הדרושים לאימות בעלות וניתוב תנועה.

שלב 3: המתינו לאימות

כאשר ה-DNS מתעדכן, סטטוס הדומיין הופך לתקין ואפשר להשלים את הפעלת ה-HTTPS.

סוגHostערךמטרה
CNAMEwwwcname.deploypages.siteמפנה תנועה ל-DeployPages
TXT_deploypages-challengedeploypages-verify=...מאמת בעלות על הדומיין

בחירת ערך ה-Host

  • השתמשו ב-www בעת חיבור www.example.com.
  • השתמשו ב-@ בעת חיבור דומיין השורש example.com.
  • השתמשו בתווית תת-דומיין כמו blog בעת חיבור blog.example.com.

עדכון אתר

אותו תהליך, גרסה חדשה

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

    שנו טקסט, סגנונות, מדיה או נכסים באופן מקומי.

  • 2
    בנו מחדש בעת הצורך

    אם הפרויקט משתמש ב-framework, צרו תחילה תיקיית פלט חדשה מה-build.

  • 3
    פתחו את לוח הבקרה של הפרויקט

    חזור לדף הפרויקט ב-DeployPages.

  • 4
    העלו את הגרסה החדשה

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

לאחר השלמת ההעלאה, ה-build החדש הופך לפעיל והגרסאות הקודמות נשארות זמינות לשחזור.

שאלות נפוצות

האם גם לא מפתחים יכולים להשתמש ב-DeployPages?
כן. אם האתר כבר מיוצא כקבצים סטטיים, פרסום בגרור ושחרר מספיק.
מדוע אני רואה 404 לאחר פרסום?
הסיבה הנפוצה ביותר היא קובץ index.html חסר או מיקום שגוי. ודאו שקובץ הכניסה לפרסום נמצא בשורש התיקייה שהועלתה.
מה אם מסלולי React או Vue נשברים בעת רענון?
DeployPages תומך ב-SPA fallback עבור הגדרות frontend סטטיות נפוצות, אך עדיין צריך לייצא את ה-build כהלכה.
האם אני יכול להעלות סרטונים או נכסים גדולים יותר?
כן, אבל הביצועים טובים יותר כאשר מדיה גדולה מאוד עוברת אופטימיזציה או מוגשת דרך ערוץ מסירה שמתאים לקבצים כבדים.
האם אני יכול להגן על אתר באמצעות סיסמה?
כן, בתוכניות שכוללות הגנה בסיסמה. השתמשו בזה לתצוגות מקדימות, מסמכים פנימיים או השקות מדורגות.
עבור לפרויקטים לדוגמה