redtape

redtape är en fokuserad dokumentgenerator som använder github smaksatt markdown för att generera enkla, attraktiva HTML-dokument. Den integrerar automatiskt med twitter bootstrap och har enkel och attraktiv design. redtape är inspirerad av d, men försök att ha ett enkelt gränssnitt och samtidigt tillåta användare att styla och kontrollera sina utgångs dokument till en hög grad av kundanpassning.
Installera
Om du är på Linux eller OSX, kan du använda PIP installera:
> PIP installera redtape
Vilket kommer att installera redtape och dess beroenden.
Användning
Om du vill använda, köra rt med ett dokument eller katalog full av dokument. Om körs på en katalog, kommer rt att skapa html-filer för varje markdown-fil (.md, .mdown eller .markdown förlängningar):
> Rt mydocument.md
> Rt dokumentation /
tillgångar
Som standard rt förutsätter att du har ställt in en plats för att tjäna de filer från vilka har de tillgångar som RT länkar till dessa dokument. Layouten är exakt samma som tillgångar katalog i redtape förrådet: / tillgångar / {css, img, js} / .. för varje tillgång som du kommer att använda. Om du vill använda redtape standardtillgångar, kan du enkelt skapa en lämplig tillgångs katalog i den aktuella katalogen genom att köra:
> rt --create-tillgångar
Om du kör i enda dokument läge eller inte vill inrätta en tillgång katalog på en eventuell värd för dina HTML-dokument, kan du berätta redtape att bädda varje tillgång som används i ett dokument med hjälp av --embed:
> Rt --embed mydocument.md
JavaScript
Som standard redtape inte kräver någon javascript för att köra, och kommer inte att bädda någon i --embed läge. Om --prettify alternativet väljs, kommer Googles FÖRSKÖNA bibliotek användas för källan belyser istället för pygments, och om --prettify och --embed båda används, kommer den att automatiskt inbäddade.
Redtape är också lämplig för enkla enkelsidiga javascript demonstrationer, och om --use-js är aktiverat, kommer redtape omfattar jquery och bootstrap s javascript bibliotek.
anpassa utgång
Anpassa produktionen är lätt att göra i en mängd olika sätt. Förutom att ändra tillgångs CSS för icke-inbäddade dokument, kan du också lägga till sidhuvud och sidfot eller ens använda egna dokumentmallar baserade på redtape standardmall.
sidhuvud och sidfot
Om du har en anpassad dokument sidhuvud eller sidfot du vill lägga till dina dokument, kan du antingen lägga header.html och footer.html dokument baskatalogen du gör eller som standardvägar som ska användas i config som sidhuvud och sidfot. Som standard kommer dessa att placeras längst upp och längst ned i dokumentet, respektive.
Ett prov uppsättning dokument skulle kunna vara:
> ls mydocs /
mydocs / index.md mydocs / simple.md mydocs / advanced.md
mydocs / header.html mydocs / footer.html
Rendering mydocs med rt mydocs kommer att använda sidhuvud och sidfot för varje dokument i katalogen.
anpassade mallar
Om du har väldigt specifika krav, kan du skriva en egen dokumentmall och ha total kontroll över produktionen. Redtape använder jinja2 mallmotorn, vilket är en allmänt använd mall system liknande django mallar. Kör redtape med --context argumentet för att få en kort beskrivning av vad variabler är tillgängliga för mallen.
Du kan även ärva från basic.jinja, vilket är namnet på redtape s standardmall. Denna mall definierar två block, huvud och kropp, som skulle tillåta dig att farkosten en distinkt dokument kropp samtidigt, till exempel, behålla den grundläggande CSS och JavaScript funktionalitet redtape. Åsidosätta båda kommer att lämna dig med en standard HTML5 dokumentstruktur.
Du kan ange en egen mall att använda med -t, --template eller placera den i dokument som custom.html eller custom.jinja

Krav :.

• Python