Markdoc מיועד לניהול תיעוד טכני, אבל יכול לשמש למגוון של מטרות. יש Markdoc כמה נקודות ראויות לציון מכירה:
* Wikis מורכב לחלוטין של קבצי טקסט, כך שאתה יכול בקלות לשים אותם תחת שליטת גרסה.
* Wikis לקמפל לספריות HTML עצמאיות, שיכול להיות מופצת כארכיבים או מוגשות על ידי שרת HTTP.
* אתה יכול לחלופין כולל תקשורת סטטי שיהיה מלוקט לתוך ספריית HTML לצד כל הדפים שניתנו.
* Markdoc מגיע עם יישום וHTTP שרת הטהור פייתון WSGI מלוא תפקודי להגשה עד הוויקי הידור.
* אתה יכול להפוך ויקי עם מגוון רחב של הרחבות Markdown, כגון הדגשה מבוססת Pygments קוד, תחביר מורחב לרשימות הגדרה, דור TOC, וכולי.
* ניתן להתאים אישית לחלוטין איך wiki שלכם מוצג על ידי עריכת תבניות Jinja2 משמשות להמרת Markdown שניתנו למסמכי HTML מלאים.
התחלה מהירה
התקנה:
#! / Bin / bash
ssh שיבוט HG: //hg@bitbucket.org/zacharyvoase/markdoc
markdoc cd /
PIP להתקין צרכים -r
פיתון setup.py להתקין
מה שהופך את ויקי
#! / Bin / bash
markdoc לאתחלי-ויקי
דיסק שלי-wiki /
ויקי vim / somefile.md
# ... לכתוב כמה תיעוד ...
לבנות markdoc
markdoc משרת
# .. Http הפתוח: // localhost: 8008 / בדפדפן ...
פריסה
יש אתרי הוויקי Markdoc פריסת ברירת המחדל הבא:
WIKI_ROOT /
| - .html /
| - .templates /
| - .tmp /
| - סטטי /
| - / Wiki
`- Markdoc.yaml
.html / ו.tmp / צריך להיות מחוץ ספריות מכל VCS, שכן הם מכילים קבצים זמניים.
עיין בתיעוד של הפריסה בdoc / wiki / layout.md לקבלת מידע נוסף על התפקידים של תיקיות המשנה שונים
דרישות :.
- > פייתון
- PIP
- rsync
תגובות לא נמצא