Markdoc

Markdoc on erinomainen tekninen dokumentaatio, käsikirjat, sisäinen projekti wikit, tai staattisen sivuston sukupolville.
Teknisestä dokumentaatiosta / Käyttöohjeet, Markdoc voidaan kirjoittaa ja tehdä käsin kirjoitettu ja ohjeet ohjelmiston. Tällaiset asiakirjat on yleensä erillään automaattisesti syntyvän API-dokumentaation, ja saattaa antaa korkeamman tason näkymä kuin API dokumentaatio yksin. Sitä voitaisiin käyttää asiakkaan asiakirjat web / desktop sovelluksia, tai jopa kehittäjä asiakirjat kehyksiä.
Sisäisen projekti wikit, Markdoc wikit koostuvat yhdestä pelkkää tekstiä tiedosto sivua kohden. Yhdistämällä wiki kanssa DVCS (kuten Mercurial tai Git), voit tehdä yhteistyötä useiden muiden ihmisten. Käytä DVCS seurata, jakaa ja yhdistää muutokset toisiinsa, ja tarkastella wiki & rsquo; s historia.
Staattinen sivusto Generation, Markdoc muuntaa wikit osaksi raaka HTML-tiedostoja ja mediaa. Näin voit hallita blogi, omat sivut tai kokoelma sivuja Markdoc wiki, ehkä mukautettuja CSS-tyylejä ja julkaista sulatettu HTML verkkosivuilla. Markdoc ei tarvitse asentaa isäntä asema, koska tuloksena HTML on täysin itsenäinen.

Ominaisuudet :

• Määritä Google Analytics yhdellä rivillä kokoonpano.
• Barebones wikit että vain näyttävät hakemistot Wikitekstin muotoiltua tekstitiedostoja niihin.
• Sisäänrakennettu HTTP-palvelin ja WSGI sovellus tarjoilla käännetty wiki yhdellä komennolla.
• Jatkuva rakentaa (kautta rsync) tarkoittaa palvelin voi pitää käynnissä samalla Markdoc uudelleen kokoaa wiki. Vain päivitä selain nähdä muutoksia.
• Lisää Pygments-käyttöinen syntaksikorostuksen sinun Markdoc wiki yhdellä konfiguraatioparametrin.
• Markdoc on julkista ohjelmisto. Se on aina täysin vapaasti käyttää, ja voit jakaa sen (osittain tai kokonaan) missään olosuhteissa (avoimen lähdekoodin, oma tai muuten) ilman myöntämiseen tai encumberances.

vaatimukset :

• argparse
• Cherrypy
• Jinja2
• Wikitekstin
• Pygments
• PyYAML
• webob
• Python 2.4 tai uudempi
• rsync