Markdoc จะมุ่งสู่การจัดการเอกสารทางเทคนิค แต่สามารถนำมาใช้สำหรับช่วงของวัตถุประสงค์ Markdoc มีไม่กี่จุดขายที่โดดเด่น:
* Wikis ถูกสร้างขึ้นอย่างสมบูรณ์ของไฟล์ธรรมดาเพื่อให้คุณสามารถใส่พวกเขาภายใต้การควบคุมเวอร์ชัน
* Wikis เรียบเรียงไดเรกทอรี HTML แบบสแตนด์อโลนซึ่งสามารถกระจายเป็น tarballs หรือบริการโดยเซิร์ฟเวอร์ HTTP
* คุณสามารถเลือกที่จะรวมถึงสื่อแบบคงที่ซึ่งจะถูกรวบรวมลงในไดเรกทอรี HTML ควบคู่ไปกับการแสดงผลหน้าเว็บทั้งหมดของคุณ
* Markdoc มาพร้อมกับบริสุทธิ์หลาม WSGI การประยุกต์ใช้การทำงานอย่างเต็มที่และเซิร์ฟเวอร์ HTTP สำหรับการให้บริการขึ้นรวบรวมวิกิ
* คุณสามารถทำให้วิกิพีเดียของคุณด้วยหลากหลายของนามสกุล Markdown เช่น Pygments ตามรหัสการเน้นไวยากรณ์ที่เพิ่มขึ้นสำหรับรายการนิยามรุ่น TOC และอื่น ๆ
* คุณสมบูรณ์สามารถกำหนดวิธีการที่วิกิพีเดียของคุณจะแสดงผลโดยการแก้ไข Jinja2 แม่แบบที่ใช้ในการแปลง Markdown แสดงผลลงในเอกสาร HTML อย่างเต็มรูปแบบ
Quickstart
การติดตั้ง:
#! / bin / ทุบตี
hg SSH โคลน: //hg@bitbucket.org/zacharyvoase/markdoc
markdoc cd /
PIP ติดตั้งต้อง -r
หลาม setup.py ติดตั้ง
ทำให้วิกิพีเดีย
#! / bin / ทุบตี
markdoc init วิกิพีเดียของฉัน
ซีดีของฉัน-วิกิพีเดีย /
วิกิพีเดียเป็นกลุ่ม / somefile.md
# ... เขียนเอกสารบางอย่าง ...
markdoc สร้าง
markdoc ให้บริการ
# .. เปิด http: // localhost: 8008 / ในเบราว์เซอร์ ...
เค้าโครง
วิกิ Markdoc มีรูปแบบเริ่มต้นต่อไปนี้:
WIKI_ROOT /
| - .html /
| - .templates /
| - .tmp /
| - คงที่ /
| - วิกิพีเดีย /
`- markdoc.yaml
.html / และ .tmp ไดเรกทอรี / ควรจะแยกออกจาก VCS ใด ๆ เนื่องจากพวกเขามีไฟล์ชั่วคราว
ศึกษาเอกสารรูปแบบในเอกสาร / วิกิพีเดีย / layout.md สำหรับข้อมูลเพิ่มเติมเกี่ยวกับบทบาทของไดเรกทอรีย่อยต่างๆ
ต้องการ .
- งูใหญ่
- pip
- rsync
ความคิดเห็นที่ไม่พบ