Markdoc

Markdoc ay mahusay para sa mga teknikal na dokumentasyon, mga manual, panloob na proyekto wikis, o static na mga henerasyon site.
Para Technical Documentation / manual, Markdoc ay maaaring gamitin upang magsulat at i-render hand-nakasulat na gabay at mga manwal para sa mga software. Ang ganitong babasahin ay normal ay hiwalay mula sa awtomatikong nabubuong API documentation, at maaaring magbigay ng isang mas mataas na antas na tingnan kaysa sa API docs nag-iisa. Maaaring gamitin para sa mga papeles ng client para sa web / desktop application, o kahit na dokumentasyon ng developer para sa Framework.
Para sa Internal Project wiki, binubuo Markdoc wiki ng isang solong plain-text file sa bawat pahina. Sa pamamagitan ng pagsasama ng isang wiki na may isang DVCS (tulad ng mga papalit-palit o Git), maaari kang makipagtulungan sa maraming iba pang mga tao. Gamitin ang DVCS upang subaybayan, magbahagi at pagsamahin ang mga pagbabago sa bawat isa, at tingnan ang mga wiki & rsquo; s history.
Para Static Site Generation, Markdoc nagpalit wikis sa raw file na HTML at media. Ito ay nagbibigay-daan sa iyo upang pamahalaan ang isang blog, mga personal na website o isang koleksyon ng mga pahina sa isang Markdoc wiki, marahil na may pasadyang mga estilo ng CSS, at i-publish ang nai-render na HTML sa isang website. Markdoc hindi kailangang mai-install sa hosting site, dahil ang nanggagaling HTML ay lubos na independiyenteng

Mga Tampok .

• I-set up ng Google pagsubaybay sa isang linya ng configuration Analytics.
• Barebones wiki na lamang ang hitsura ng mga direktoryo sa Markdown-format na teksto ng mga file sa mga ito.
• Ang isang built-in HTTP server at WSGI application upang maghatid ng hanggang isang naipon wiki na may isang solong command.
• Ang patuloy na gagawa (sa pamamagitan ng rsync) nangangahulugan na ang server ay maaaring patuloy na tumatakbo habang Markdoc re-compiles ang wiki. I-refresh lamang ang iyong browser upang makita ang mga pagbabago.
• Magdagdag Pygments-powered syntax highlight sa iyong Markdoc wiki na may isang solong parameter configuration.
• Markdoc ay software pampublikong domain. Ito ay palaging magiging libre gamitin, at maaari mong mamigay na muli ito (sa bahagi o sa kabuuan) sa ilalim ng anumang mga pangyayari (open-source, pagmamay-ari o kung hindi man) na walang pagpapatungkol o encumberances.

Mga kinakailangan

• argparse
• CherryPy
• Jinja2
• Markdown
• Pygments
• PyYAML
• webob
• Python 2.4 o mas mataas na
• rsync