redtape הוא מחולל מסמך ממוקד המשתמש markdown בטעם GitHub ליצור מסמכי HTML פשוט, אטרקטיביים. זה באופן אוטומטי משתלב עם bootstrap twitter וכולל עיצוב פשוט ואטרקטיבי. redtape הוא בהשראת ד, אבל מנסה יש ממשק פשוט ואילו משתמשים עדיין מאפשרים לסגנון ולשלוט מסמכי התפוקה שלהם לרמה גבוהה של התאמה אישית.
התקנה
אם אתה על לינוקס או OSX, אתה יכול להשתמש בפיפס להתקין:
> PIP להתקין redtape
שיתקין redtape והתלות שלה.
שימוש
כדי להשתמש ב, rt לרוץ על מסמך או ספרייה מלאה של מסמכים. אם תפעל על ספרייה, rt ייצור קבצי HTML עבור כל קובץ markdown (.md, .mdown, או הרחבות .markdown):
> Rt mydocument.md
> תיעוד rt /
נכסים
כברירת מחדל, rt מניח שיש לך להגדיר מיקום לשרת קבצים ממנו לנכסים שרט קישורים למסמכים אלה. הפריסה היא בדיוק אותו הדבר כמו בספריית הנכסים במאגר redtape: / נכסים / {css, img, js} / .. לכל נכס שאתה תהיה באמצעות. אם אתה רוצה להשתמש בנכסי ברירת המחדל של redtape, אתה יכול בקלות ליצור ספריית נכס מתאימה בספרייה הנוכחית על ידי ריצה:
> Rt --create-נכסים
אם אתה פועל במצב מסמך יחיד או לא רוצה להגדיר את ספריית נכס בסופו של הדבר למארח מסמכי ה- HTML שלך, אתה יכול להגיד לי redtape להטביע כל נכס המשמש במסמך באמצעות --embed:
> Rt --embed mydocument.md
javascript
כברירת מחדל, redtape לא דורש שום JavaScript כדי לפעול, ולא להטביע כל במצב --embed. אם אפשרות --prettify נבחרה, הספרייה לייפות של גוגל תשמש למקור הדגשה במקום pygments, ואם --prettify ו--embed משמשים שניהם, זה יהיה מוטבע באופן אוטומטי.
Redtape מתאים גם להפגנות javascript עמוד בודד פשוטות, ואם --use-JS מופעל, redtape יכלול jquery וספריות JavaScript של bootstrap.
פלט התאמה אישית
התאמה אישית של פלט קל לעשות במגוון דרכים. מלבד שינוי CSS הנכס למסמכים משובצים שאינם, אתה יכול גם להוסיף כותרות עליונות ותחתונות, או אפילו להשתמש בתבניות מסמך מותאמות אישית המבוססות על תבנית ברירת המחדל של redtape.
כותרות עליונות ותחתונות
אם יש לך כותרת מסמך מותאמת אישית או תחתון שברצונך להוסיף למסמכים שלך, אתה יכול גם להוסיף מסמכי header.html וfooter.html לספריית הבסיס אתה טיוח או נתיבי ברירת מחדל מוגדרים לשימוש בconfig ככותרת עליונה ותחתונה. כברירת מחדל, אלה יוצבו בחלק העליון והתחתון של המסמך שלך, בהתאמה.
סט מדגם של מסמכים יכול להיות:
> Mydocs ls /
mydocs / index.md mydocs / simple.md mydocs / advanced.md
mydocs / header.html mydocs / footer.html
mydocs טיוח עם mydocs rt ישתמש הכותרת העליונה ותחתונה לכל מסמך בספרייה.
תבניות מותאמות אישית
אם יש לך דרישות מאוד ספציפיות, אתה יכול לכתוב תבנית המסמך שלך ויש להם שליטה מוחלטת של התפוקה. Redtape משתמש במנוע בניית תבנית jinja2, שהינה מערכת בניית תבנית בשימוש נרחבת דומה ליחידת תבניות. redtape לרוץ עם טיעון --context כדי לקבל מושג קצר של מה משתנים זמינים לתבנית.
גם אתה יכול לרשת מbasic.jinja, שהוא השם של תבנית ברירת המחדל של redtape. תבנית זו מגדירה שני בלוקים, ראש וגוף, אשר יאפשר לך לעצב ואילו גוף מסמך נפרד, למשל, שמירה על CSS הבסיסי ופונקציונליות של JavaScript redtape. דריסת שני תשאיר אותך עם מבנה מסמך HTML5 סטנדרטי.
באפשרותך לציין תבנית מותאמת אישית לשימוש עם -t, --template או למקם אותו בספריית המסמכים כcustom.html או custom.jinja
דרישות :.
- Python
תגובות לא נמצא