תחילת העבודה עם הוגו: איך ליצור אתר פשוט

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

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

אתה יכול בקלות להגדיר וליצור אתר הוגו באמצעות ערכת נושא הוגו בנוי מראש. עם מספר שלבים קצרים בלבד, תוכל להוסיף תוכן ודפים לאתר שלך באמצעות Markdown.

כיצד להתקין את הוגו

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

מק

אתה יכול להתקין את Hugo באמצעות Homebrew.

1. פתח את מסוף ה-macOS שלך.
2. התקן את מנהל החבילות של Homebrew.

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. התקן את הוגו.

   לְהִתְבַּשֵׁל להתקין הוגו

חלונות

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

1. פתח את Windows PowerShell, שאמור כבר להיות חלק ממערכת ההפעלה שלך Windows.
2. אם אתה מתקין את Scoop בפעם הראשונה, ייתכן שתצטרך להגדיר את מדיניות הביצוע שלך.
   instagram viewer

   מַעֲרֶכֶת-ExecutionPolicy RemoteSigned -תְחוּם משתמש נוכחי

3. התקן סקופ:

   iex (חָדָשׁ-object net.webclient).downloadstring('https://get.scoop.sh')
   

4. התקן את הוגו:

   סְקוּפּ להתקין הוגו

כיצד ליצור פרויקט הוגו

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

1. פתח את המסוף או שורת הפקודה שלך. נווט אל התיקיה שבה תרצה ליצור את הפרויקט שלך.
2. בצע את אתר חדש של hugo פקודה:

   הוגו חָדָשׁ אֲתַר חָדָשׁ-האתר-hugo

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

כיצד להוסיף ערכת נושא

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

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

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

   CD חָדָשׁ-האתר-hugo

3. הפעל את הפקודה כדי להוסיף את ערכת הנושא Tale. אתה יכול להוסיף את הנושא כתת-מודול, שייצור תיקיה חדשה בשם מַעֲשִׂיָה בתוך ה נושא תיקייה.

   git init
   git submodule הוסף https://github.com/EmielH/tale-hugo.git themes/tale

   לחלופין, אתה יכול לשכפל את מאגר הסיפורים של GitHub לתוך תיקיית הנושאים של הפרויקט שלך.

   git שיבוט https://github.com/EmielH/tale-hugo.git themes/tale

4. נווט אל תיקיית הפרויקט שלך. הקלק על ה ערכות נושא תיקייה כדי לפתוח אותה. לא משנה באיזו פקודה השתמשת, תהיה פקודה חדשה מַעֲשִׂיָה תיקייה המאחסנת את ערכת הנושא שהורדת לאחרונה.
5. בתוך ה config.toml קובץ, הוסף את ערכת הנושא של הסיפור כחלק מהתצורה. זה יגיד להוגו להשתמש בסגנונות HTML, CSS וסגנונות אחרים שנושא ה-Tale כולל.

   נושא = "מַעֲשִׂיָה"

כיצד להוסיף דפים לאתר שלך

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

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

כדי להוסיף עמוד משנה חדש או פוסט חדש לאתר שלך, תצטרך להוסיף קובץ Markdown חדש לתוך תוֹכֶן תיקייה. לכל פוסט או עמוד יהיה קובץ Markdown משלו המשויך אליו.

1. פתח את ה תוֹכֶן תיקייה בתוך פרויקט הוגו שלך. צור קובץ Markdown חדש בשם myFirstPost.md.
2. פתח את הקובץ בכל עורך טקסט כגון Notepad++ או Visual Studio Code.
3. בחלק העליון של הקובץ, הוסף כמה מטא נתונים. זה יכלול מידע חשוב על הפוסט. ערכת הנושא שבה אתה משתמש תעצב את המידע הזה בצורה מסוימת בדף.

   
   מְחַבֵּר: "השם שלך"
   כותרת: "הפוסט הראשון שלי"
   תַאֲרִיך: "2022-05-17"
   

4. לאחר שהוספת את המטא נתונים, תוכל להתחיל להוסיף את התוכן שלך באמצעות Markdown.

   זֶה הוא הפוסט הראשון שלי באתר הוגו שלי!
   נעשה שימוש בנושא הוגו לזֶה האתר נקרא Tale.
   זה הוא פשוט מאוד להתקנה ו להגדיר.
   # כותרת משנה
   זֶה הוא תוכן כלשהו.
   # כותרת משנה נוספת
   זֶה הוא יותר תוכן.

5. אל תהסס להוסיף עוד קבצי סימון כדי להוסיף עוד דפים לאתר שלך.

כיצד להפעיל ולבדוק את אתר הוגו שלך באופן מקומי

כדי להפעיל את האתר שלך, השתמש ב- הוגו לשרת פקודה.

1. פתח מסוף או שורת פקודה.
2. נווט אל תיקיית השורש של פרויקט הוגו שלך.
3. הפעל את הוגו לשרת פקודה:

   הוגו לשרת

4. המתן עד שהאתר ישלים את תהליך האתחול. לאחר השלמת זה, הטרמינל ידפיס הודעה שאומרת מאיזו כתובת מקומית אתה יכול לגשת לאתר. בדרך כלל, זהו http://localhost: 1313/.
5. פתחו דפדפן אינטרנט והכנסו http://localhost: 1313/, או כל כתובת שהמסוף נתן לך. אתה תראה את העמוד הראשי של אתר הוגו שלך.
6. בעמוד תהיה רשימת פוסטים עבור כל קובץ סימון שברשותך. במקרה זה, ישנם שני קובצי סימון המאוכלסים בתוכן. זה כולל את הדף myFirstPost.md שעשית קודם לכן. זה כולל גם פוסט חדש בשם bananaCakeRecipe.md.
7. לחץ על קישור הכותרת באחת מהתצוגות המקדימות. זה יעביר אותך לעמוד המלא של הפוסט הספציפי הזה.

אירוח את אתר הוגו שלך

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

לאחר שיצרת את אתר הוגו שלך, תוכל להתחיל ללמוד עוד על איך לארח אותו. ישנן אפשרויות רבות של אירוח אתרים בחינם לבחירתך, כגון Dropbox, Google Drive או OneDrive.

כיצד להשיג אירוח אתרים בחינם עם Dropbox, Google Drive או OneDrive

קרא הבא