Markdoc

Markdoc is uitstekend vir tegniese dokumentasie, handleidings, interne projek wikis, of statiese webwerf geslagte.
Vir tegniese dokumentasie / Handleidings kan Markdoc gebruik word om te skryf en lewer handgeskrewe gidse en handleidings vir sagteware. Sodanige dokumentasie sal normaalweg aparte wees outomaties gegenereer API dokumentasie, en dalk 'n hoër vlak as die lig API docs alleen gee. Dit kan gebruik word vir die kliënt dokumentasie vir web / desktop applications, of selfs ontwikkelaar dokumentasie vir raamwerke.
Vir Interne Projek Wikis, Markdoc wikis bestaan ​​uit 'n enkele plain-text lêer per bladsy. Deur die kombinasie van 'n wiki met 'n DVCS (soos Mercurial of Git), kan jy saam met verskeie ander mense. Gebruik die DVCS te spoor, te deel en veranderinge met mekaar saam te smelt, en kyk na die wiki & rsquo; s geskiedenis.
Vir statiese Site Generation, Markdoc vat wikis in rou HTML-lêers en media. Dit kan jy 'n blog, persoonlike webwerf of 'n versameling van bladsye in 'n Markdoc wiki, miskien met persoonlike CSS style te bestuur, en publiseer die dienste HTML om 'n webwerf. Markdoc hoef nie geïnstalleer word op die hosting werf, aangesien die gevolglike HTML is heeltemal onafhanklik

Eienskappe :.

• Stel Google Analytics dop in een lyn van opset.
• Bones wikis wat net lyk soos dopgehou met Afprijzingsmanager-geformateerde teks lêers in hulle nie.
• 'n ingeboude in HTTP bediener en WSGI aansoek om te dien op 'n saamgestel wiki met 'n enkele bevel.
• Deurlopende bou (via rsync) beteken dat die bediener kan bly voortbestaan ​​terwyl Markdoc re-stel die wiki. Verfris net jou leser om die veranderinge te sien.
• Voeg Pygments-aangedrewe accentuering om jou Markdoc wiki met 'n enkele opset parameter.
• Markdoc is publieke domein programmatuur. Dit sal altyd heeltemal gratis om te gebruik, en jy kan dit herversprei (gedeeltelik of in geheel) onder geen omstandighede (open-source, eiendom of andersins) met geen toeskrywing of beswarings.

Vereistes :

• argparse
• CherryPy
• Jinja2
• Afprijzingsmanager
• Pygments
• PyYAML
• webob
• Python 2.4 of hoër
• rsync