MkDocs משתמש אותם העקרונות כמו כל מחולל אחר סטטי אתר בסביבה.
זה דורש המפתח לערוך קובץ תצורה (MKDocs משתמש YAML לזה), ליצור תבניות דף (דרך Jinja2), ולהוסיף תוכנו בתיקייה מיוחדת (כמו קבצי Markdown).
לאחר מכן הוא יכול לפתוח את CLI פייתון לרוץ כמה פקודות ולהרכיב אתר HTML סופי מכל משאביו.
אם הוא רוצה לעדכן משהו, הוא יכול לעשות את כל השינויים שלו במקור ולקמפל מחדש את האתר באמצעות הקונסולה.
המוצר הסופי הוא אוסף של HTML, CSS, JS ונכסי סטטי שניתן לארח עם כל סוג של שרת האינטרנט קיים בשוק.
MkDocs תומך במספר בלתי מוגבל של דפים, דור תפריט אוטומטי, ערכות נושא אתר סופיים, meta נתונים דף, ומגיע עם מבנה פרויקט בסיסי שעליו כדי להתחיל.
MkDocs עובד עם שני הגרסאות של שפת Python, 2.x 3.x ו
מה חדש בהודעה זו :.
- < li> לדקלם קבצי 404.html אם הם קיימים לנושא הנוכחי.
- תיקון באג:
- ברים ארוכים nav, טיוח שולחן וקוד הדגשה בנושאי MkDocs וReadTheDocs.
- בעיה עם קוד google_analytics.
- הסרת __pycache__ מזפת החבילה.
- Markdown שהולכים לעוגן בדף הנוכחי.
- אל תוסיף מחלקות CSS גם prettyprint לכל HTML, רק להוסיף אותו בנושא MkDocs.
- כותרות סעיפי תצוגה בנושא ReadTheDocs.
- השתמש משקיף הקלפי בכלב שמירה כל כך לבנות מחדש עבודות על מערכות קבצים ללא inotify.
- לשפר פלט שגיאת שגיאות תצורה הקשורים נפוצות.
קישורים
מה חדש בגרסת 0.13.3:
- לדקלם קבצי 404.html אם הם קיימים ל נושא הנוכחי.
קישורים
מה חדש בגרסת 0.12.2:
- לדקלם קבצי 404.html אם הם קיימים ל נושא הנוכחי.
קישורים
מה חדש בגרסת 0.11.1:
- לדקלם קבצי 404.html אם הם קיימים ל נושא הנוכחי.
קישורים
דרישות :
- ג'ינג'ה 2.7.1 או גבוה
- Markdown 2.3.1 או גבוה יותר
- PyYAML 3.1 או גבוה יותר
תגובות לא נמצא