Socrates

Sokrates är en enkel statisk webbplats generator inriktad bloggar. Du skriver dina inlägg i din favorit oformaterad text till HTML-språket (t.ex. Wiki, textil) och spara dem som textfiler på din hårddisk. Sokrates sedan tar dem, och skapar en full HTML sajten för dig. Gratis, kommer du att få en hemsida som listar senaste inläggen, ensamstående inläggssidor, kategorisidor, arkivsidor, en om sidan och en atom-flöde.
Användning
Först måste du skapa en ny blogg:
socrates -i blogg
Detta kommer att skapa en blogg katalog med en enkel blogg struktur:
blogg
& nbsp; inlägg
& Nbsp; 2010-your-post.md
& Nbsp; layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; media
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Den inlägg katalogen är där du kommer att placera dina inlägg filer. Allt inleds med _ eller. kommer att ignoreras. layouten är din grundläggande tema eller en mall. config.yaml är en sajt omfattande konfigurationsfil. Glöm inte att uppdatera om filen med relevant information.
Du kan också skapa en ny blogg i den aktuella arbetskatalogen:
Sokrates -i
När du är redo att skapa din sida, kör du:
socrates -g blogg
Eller,
socrates -g
för aktuell katalog.
Detta kommer att placera alla genererade filer i bloggen / distribuera. Du kan sedan ta katalogen och ladda upp den till din server.
Installation
Först, skapa din virtuella miljö och Pip installera Sokrates.
virtualenv env --no-site-paket
source ENV / bin / Aktivera
Pip installera socrates
Eller, för att få den senaste koden, kan du installera från Github.
PIP installera -e git: //github.com/honza/socrates.git#egg=socrates
Nästa steg är att installera dina mallar. Just nu kan du välja mellan Django mallar och Jinja2 mallar. Standard Temat använder Django.
Teman
Sokrates stöder Django mallar och Jinja2 mallar. Du kan ange vilken mallmotor du vill använda i config.yaml filen. Det finns två grundläggande teman i teman katalogen för att komma igång.
Text till HTML
Sokrates kommer attemp konvertera dina textfiler till HTML med hjälp av en ordbehandlare. Du bör ange namnet på text processor i config.yaml. Det bör vara gemener. För närvarande stöds processorer:
- Markdown
- Textil
- ReStructuredText
- HTML (omodifierad text)
Som standard Sokrates installerar bara Markdown text processorer. Du kan installera de andra med pip:
Pip installera textila
Pip installera docutils
utveckling
Du kan starta en enkel utveckling server för att hjälpa dig i utvecklingen .:
socrates -r blogg
Eller,
socrates -r
för aktuell katalog.
Dokumentation
Dokumentationen finns i docs katalogen och är skriven i ReStructuredText använder Sphinx. Dokumentationen är lättläst i en vanlig textredigerare. Däremot kan du bygga en HTML-version som så:
Pip installera sfinx
cd docs /
göra html
öppen _build / html / index.html
Eller kan du visa onlineversionen av den senaste dokumentationen

Funktioner :.

• Familiar Django och Jinja2 mallar
• Enkel installation via pip
• Markdown, ReStructuredText, Textil support
• YAML konfiguration
• Atom feed
• Github sidor kompatibla

Krav :

• Python