redtape

birocratice este un generator de act concentrat care utilizează github reduceri aromat pentru a genera documente simple, HTML atractive. Se integrează automat cu stare de nervozitate bootstrap și oferă un stil simplu, atractiv. birocratice este inspirat de d, dar încearcă să aibă o interfață simplă în timp ce încă permițând utilizatorilor să controleze stilul și documentele lor de ieșire la un grad ridicat de personalizare.
Instalarea
Dacă sunteți pe linux sau OSX, puteți pip pentru a instala:
> PIP instala birocratice
Care va instala birocratice și dependențele sale.
Utilizare
Pentru a utiliza, a alerga RT pe un document sau director complet de documente. În cazul în care rula pe un director, rt va crea fișiere HTML pentru fiecare fișier reduceri (.md, .mdown, sau extensii .markdown):
> Rt mydocument.md
> Documentare rt /
activele
În mod implicit, tc presupune ați configurat o locație pentru a servi fișierele din care au intre activele care RT link-uri în aceste documente. Layout-ul este exact la fel ca și directorul active în magazia birocratice: / active / {css, img, JS} / .. pentru fiecare activ pe care le va folosi. Dacă doriți să utilizați activele implicite birocratice, puteți crea cu ușurință un director activ adecvat în directorul curent de funcționare:
> RT --create-active
Dacă se execută în modul singur document sau nu doresc să înființeze un director activ pe eventuala gazdă pentru documentele HTML, vă pot spune birocratice pentru a încorpora fiecare activ utilizat într-un document folosind --embed:
> Rt --embed mydocument.md
javascript
În mod implicit, birocratice nu necesită nici javascript pentru a rula, și nu va încorpora nici în mod --embed. Dacă este selectată opțiunea --prettify, biblioteca prettify Google va folosi sursă evidențierea în loc de pygments, și dacă --prettify și --embed sunt folosite atât, acesta va fi încorporat în mod automat.
Birocratice este de asemenea potrivit pentru o singură pagină demonstrații JavaScript simplu, iar dacă --use-JS este activat, birocratice va include jQuery și bibliotecile javascript bootstrap lui.
Ieșire personalizarea
Ieșire Personalizarea este ușor de făcut într-o varietate de moduri. În afară de schimbarea CSS avantaj pentru documente care nu-încorporat, puteți adăuga, de asemenea, anteturi și subsoluri sau chiar folosi modele de documente personalizate, bazate pe șablon implicit birocratice lui.
anteturi și subsoluri
Dacă aveți un antet de document personalizat sau subsol pe care doriți adăugat la documentele, puteți fie să adăugați documente header.html și footer.html la directorul de bază pe care redare sau stabilite căile implicite pentru a fi utilizate în configurarea ca antet și subsol. În mod implicit, acestea vor fi plasate în partea de sus și de jos a documentului, respectiv.
Un set probă de documente ar putea fi:
> ls mydocs /
mydocs / index.md mydocs / simple.md mydocs / advanced.md
mydocs / header.html mydocs / footer.html
Rendering mydocs cu mydocs RT va folosi antet și subsol pentru fiecare document în directorul.
template-uri personalizate
Dacă aveți cerințe foarte specifice, vă puteți scrie propriul șablon de document și au control total al producției. Birocratice foloseste motorul de templating jinja2, care este un sistem de templating utilizat pe scară largă similar django șabloane. Birocratice Pornește cu argumentul --context pentru a obține o idee despre ceea ce variabile sunt disponibile la șablonul.
Puteți moșteni, de asemenea, de la basic.jinja, care este numele șablonului implicit birocratice lui. Acest model definește două blocuri, cap și corp, ceea ce ar permite să ambarcatiunile de un corp distinct de document în timp ce, de exemplu, reținerea CSS de bază și funcționalitatea de activarea JavaScript-de birocratice. Anularea amândoi vă va lăsa cu o structură standard de document HTML5.
Puteți specifica un șablon personalizat pentru a utiliza cu -t, --template sau puneți-l în directorul document custom.html sau custom.jinja

Cerințe :.

• Python