redtape

redtape is 'n gefokusde dokument generator wat gebruik GitHub gegeurde Afprijzingsmanager eenvoudige, aantreklike HTML dokumente op te wek. Dit integreer outomaties met twitter bootstrap en funksies eenvoudige, aantreklike stilering. redtape is geïnspireer deur d, maar probeer om 'n eenvoudige koppelvlak te hê terwyl nog toelaat om gebruikers te stileer en hul uitset dokumente beheer na 'n hoë graad van aanpassing.
Die installering
As jy op linux of OSX, kan jy pit gebruik te installeer:
> PIP installeer redtape
Wat sal installeer redtape en sy afhanklikes.
Gebruik
Te gebruik, run rt op 'n dokument of gids vol dokumente. As hardloop op 'n gids, sal rt skep html lêers vir elke Afprijzingsmanager lêer (md, .mdown, of .markdown uitbreidings):
> Rt mydocument.md
> Rt dokumentasie /
bates
By verstek, rt veronderstel jy het 'n plek om die lêers van wat die bates wat rt skakels in hierdie dokumente te dien. Die uitleg is presies dieselfde as die bates gids in die redtape bewaarplek: / bates / {css, img, JS} / .. vir elke bate wat jy sal gebruik word. As jy wil verstek bates redtape se om te gebruik, kan jy maklik 'n geskikte bate gids in die huidige gids deur die loop:
> Rt --create-bates
As jy loop in die enkele dokument af of wil nie om 'n bate gids op die uiteindelike gasheer vir jou HTML dokumente, kan jy vertel redtape elke bate gebruik word in 'n dokument wat deur die gebruik van --embed te sluit:
> Rt --embed mydocument.md
javascript
By verstek, redtape nie vereis dat enige javascript uit te voer, en sal nie enige in --embed modus insluit. As die --prettify opsie gekies is, sal Google se aardig biblioteek gebruik word vir die bron beklemtoon in plaas van pygments, en as --prettify en --embed albei gebruik, sal dit outomaties ingesluit word.
Redtape is ook geskik vir 'n eenvoudige enkel-bladsy javascript demonstrasies, en as --use-js geaktiveer is, sal redtape sluit jQuery en bootstrap se JavaScript biblioteke.
opstel uitset
Opstel uitset is maklik om te doen in 'n verskeidenheid van maniere. Behalwe die verandering van die bate CSS vir nie-vasgelegde dokumente, kan jy ook kop-en voet by te voeg of selfs gebruik persoonlike dokument templates gebaseer op redtape standaard sjabloon.
kop-en voet
As jy 'n persoonlike dokument kop-of voet jy wil by jou dokumente, kan jy óf voeg header.html en footer.html dokumente aan die basis gids jy lewering of stel verstek paaie in die config as kop-en voet gebruik word. By verstek, sal hierdie geplaas word by die bo-en onderkant van jou dokument, onderskeidelik.
'N Monster stel dokumente kan wees:
> Ls mydocs /
mydocs / index.md mydocs / simple.md mydocs / advanced.md
mydocs / header.html mydocs / footer.html
Lewering van mydocs met rt mydocs sal die kop-en voet gebruik vir elke dokument in die gids.
persoonlike templates
As jy het 'n baie spesifieke vereistes, kan jy skryf jou eie dokument sjabloon en het totale beheer van die produksie. Redtape gebruik die jinja2 template enjin, wat is 'n wyd gebruik template stelsel soortgelyke templates te Django. Begin redtape met die --context argument 'n kort idee van wat veranderlikes beskikbaar is om die sjabloon te kry.
Jy kan ook in besit van basic.jinja, wat is die naam van redtape standaard sjabloon. Hierdie sjabloon definieer twee blokke, kop en liggaam, wat jou sal toelaat om te maak, 'n duidelike dokument liggaam terwyl, byvoorbeeld, die behoud van die basiese CSS en JavaScript-funksies van redtape. Oorheersende beide sal laat jou met 'n standaard HTML5 dokument struktuur.
Jy kan 'n persoonlike sjabloon spesifiseer om te gebruik met t, --template of plaas dit in die dokument gids as custom.html of custom.jinja

Vereistes :.

• Python