Markdoc

Markdoc là tuyệt vời cho các tài liệu kỹ thuật, hướng dẫn sử dụng, wiki dự án nội bộ, hoặc các thế hệ trang web tĩnh.
Đối với tài liệu kỹ thuật / Hướng dẫn sử dụng, Markdoc có thể được sử dụng để viết và vẽ hướng dẫn viết tay và hướng dẫn sử dụng cho phần mềm. Tài liệu như vậy thường sẽ được tách biệt với tài liệu API tự động tạo ra, và có thể cung cấp một cái nhìn cấp cao hơn so với tài liệu API một mình. Nó có thể được sử dụng cho các tài liệu khách hàng cho các ứng dụng web / máy tính để bàn, hoặc thậm chí tài liệu phát triển cho các khuôn khổ.
Đối với nội bộ dự án Wikis, wiki Markdoc bao gồm một tập tin văn bản đơn giản duy nhất cho mỗi trang. Bằng cách kết hợp một wiki với một DVCS (như Mercurial hoặc Git), bạn có thể cộng tác với nhiều người khác. Sử dụng các DVCS để theo dõi, chia sẻ và hợp nhất các thay đổi với nhau, và xem wiki & rsquo; s lịch sử.
Đối với tĩnh Site Generation, Markdoc chuyển đổi wiki thành HTML liệu và phương tiện truyền thông. Điều này cho phép bạn quản lý một blog, trang web cá nhân hay một tập hợp các trang trong một wiki Markdoc, có lẽ với phong cách tùy chỉnh CSS, HTML và công bố kết xuất vào một trang web. Markdoc không cần phải được cài đặt trên các trang web lưu trữ, kể từ khi kết quả HTML là hoàn toàn độc lập

Tính năng .

• Thiết lập Google theo dõi trong một dòng cấu hình Analytics.
• Barebones wiki mà chỉ trông giống như thư mục với các file văn bản Markdown định dạng trong đó.
• A-xây dựng trong máy chủ HTTP và ứng dụng WSGI để phục vụ lên một wiki biên dịch với một lệnh duy nhất.
• Liên tục xây dựng (thông qua rsync) có nghĩa là các máy chủ có thể tiếp tục chạy trong khi Markdoc tái biên dịch wiki. Chỉ cần làm mới trình duyệt của bạn để xem các thay đổi.
• Thêm cú pháp Pygments-powered làm nổi bật để wiki Markdoc của bạn với một tham số cấu hình duy nhất.
• Markdoc là phần mềm phạm vi công cộng. Nó sẽ luôn luôn được hoàn toàn miễn phí để sử dụng, và bạn có thể phát hành lại nó (một phần hoặc toàn bộ) trong mọi trường hợp (mã nguồn mở, độc quyền hay không) không có ghi công hoặc encumberances.

Yêu cầu :

• argparse
• CherryPy
• Jinja2
• Markdown
• Pygments
• PyYAML
• webob
• Python 2.4 hoặc cao hơn
• rsync