סוקרטס הוא מחולל אתר סטטי פשוט מיועדות לבלוגים. אתה כותב את ההודעות שלך בטקסט רגיל האהוב עליך לשפת HTML (למשל Markdown, טקסטיל) ולשמור אותם כקבצי טקסט על הכונן הקשיח שלך. סוקרטס ואז לוקח אותם, ויוצר אתר HTML מלא בשבילך. בחינם, תקבל דף בית אשר מפרט את ההודעות אחרונות, לאחר דפים בודדים, דפי קטגוריה, דפי ארכיון, דף על והזנת אטום.
שימוש
ראשית, אתה צריך ליצור בלוג חדש:
בלוג -i סוקרטס
הפעולה זו תיצור ספריית בלוג עם מבנה בלוג פשוט:
בלוג
& Nbsp; הודעות
& Nbsp; 2010-your-post.md
& Nbsp; פריסה
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& Nbsp; תקשורת
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
הודעות הספרייה שבו תוכל למקם את הקבצים את הודעותיך. דבר התחילית _ או. יהיה להתעלם ממנו. פריסה היא הנושא הבסיסי שלך או תבנית. config.yaml הוא קובץ תצורה ברחבי אתר. אל תשכח לעדכן את הקובץ על עם מידע רלוונטי.
גם אתה יכול ליצור בלוג חדש בספריית העבודה הנוכחית:
סוקרטס -i
כאשר אתה מוכן ליצור את האתר שלך, אתה מפעיל:
בלוג -g סוקרטס
או,
סוקרטס -g
במדריך נוכחי.
זה יהיה מקום כל הקבצים שנוצרו בבלוג / לפרוס. אז אתה יכול לקחת מדריך ושלהעלות אותו לשרת שלך.
התקנה
ראשית, להגדיר את הסביבה הווירטואלית שלך ופיפ להתקין סוקרטס.
virtualenv env --no-site-חבילות
env המקור / bin / להפעיל
PIP להתקין סוקרטס
או, כדי לקבל את הקוד האחרון, אתה יכול להתקין מGitHub.
PIP להתקין git -e: //github.com/honza/socrates.git#egg=socrates
השלב הבא הוא להתקין את התבניות שלך. כרגע, אתה יכול לבחור בין תבניות Django ותבניות Jinja2. נושא ברירת המחדל משתמש Django.
נושאים
סוקרטס תומך תבניות Django ותבניות Jinja2. ניתן לציין שבניית תבנית מנוע ברצונך להשתמש בקובץ config.yaml. ישנם שני נושאים בסיסיים בספריית הנושאים שיסייעו לך.
טקסט ל- HTML
סוקרטס יהיה attemp להמיר קבצי הטקסט שלך ל- HTML באמצעות מעבד תמלילים. אתה צריך לציין את שמו של מעבד הטקסט בconfig.yaml. זה צריך להיות כל האותיות הקטנות. מעבדים נתמכים כרגע:
- Markdown
- טקסטיל
- ReStructuredText
- HTML (טקסט ללא שינוי)
כברירת מחדל, סוקרטס מתקין רק את מעבדי טקסט Markdown. אתה יכול להתקין את האחרים עם פיפס:
PIP להתקין טקסטיל
PIP להתקין docutils
פיתוח
אתה יכול להתחיל את שרת פיתוח פשוט כדי לסייע לך בפיתוח .:
בלוג -r סוקרטס
או,
סוקרטס -r
במדריך נוכחי.
תיעוד
התיעוד כלול בתוך ספריית המסמכים וכתוב בreStructuredText באמצעות הספינקס. התיעוד לקרוא בקלות בעורך טקסט רגיל. עם זאת, אתה יכול לבנות גרסת HTML כך:
PIP להתקין ספינקס
מסמכי cd /
לעשות html
_build הפתוח / html / index.html
או, אתה יכול להציג את הגרסה המקוונת של התיעוד האחרון
תכונות :.
- תבניות Django וJinja2 מוכרות >
- פשוט להתקין באמצעות פיפס
- Markdown, reStructuredText, תמיכת טקסטיל
- תצורת YAML
- עדכון Atom
- דפי GitHub תואמים
דרישות :
- Python
תגובות לא נמצא