Socrates

Socrates is een eenvoudige statische site generator gericht op blogs. Je schrijft je berichten in uw favoriete platte tekst naar HTML-taal (bijv Markdown, textiel) en opslaan als tekst bestanden op uw harde schijf. Socrates neemt ze dan, en zorgt voor een volledige HTML-site voor jou. Voor gratis, krijgt u een startpagina die laatste berichten, enkele post pagina's, categorie pagina's, archiefpagina's, een over-pagina en een atoom-feed lijsten krijgen.
Gebruik
Ten eerste, moet u een nieuwe blog te maken:
Socrates -i blog
Dit zal een blog directory met een eenvoudige blog structuur aan te brengen:
blog
& Nbsp; berichten
& Nbsp; 2010-your-post.md
& Nbsp; lay-out
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& Nbsp; media
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
De berichten directory is waar je je berichten bestanden te plaatsen. Iets voorafgegaan door _ of. worden genegeerd. lay-out is uw basis thema of een sjabloon. config.yaml is een site-brede configuratiebestand. Vergeet niet om het over bestand met relevante informatie bij te werken.
U kunt ook een nieuwe blog in de huidige werkmap:
Socrates -i
Wanneer u klaar bent om uw site te genereren zijn, gebruik je:
Socrates -g blog
Of,
Socrates -g
voor de huidige directory.
Dit zal alle gegenereerde bestanden plaatsen in blog / implementeren. Je kunt dan die map en deze uploaden naar uw server.
installatie
Ten eerste, het instellen van uw virtuele omgeving en Pip Socrates installeren.
virtualenv env --no-plaats-pakketten
bron env / bin / activeren
pip Socrates installeren
Of, om de laatste code krijgen, kunt u installeren vanaf Github.
pip installeren -e git: //github.com/honza/socrates.git#egg=socrates
De volgende stap is om uw sjablonen te installeren. Op dit moment kunt u kiezen tussen Django templates en Jinja2 templates. Het standaardthema gebruikt Django.
Thema's
Socrates ondersteunt Django templates en Jinja2 templates. U kunt opgeven welke template engine die u wilt gebruiken in de config.yaml bestand. Er zijn twee fundamentele thema's in de thema map om mee te beginnen.
Tekst naar HTML
Socrates zal attemp om uw tekst bestanden te converteren naar HTML met behulp van een tekstverwerker. Je moet de naam van de tekstverwerker in config.yaml opgeven. Het moet allemaal kleine letters zijn. Momenteel ondersteunde processors:
- Markdown
- Textiel
- ReStructuredText
- HTML (ongewijzigde tekst)
Standaard Socrates installeert alleen de Markdown tekst processors. U kunt de anderen met pip installeren:
pip textiel installeren
pip docutils installeren
Ontwikkeling
U kunt een eenvoudige ontwikkeling server om u te helpen bij de ontwikkeling beginnen .:
Socrates -r blog
Of,
Socrates -r
voor de huidige directory.
Documentatie
De documentatie is opgenomen in de map docs en is geschreven in reStructuredText behulp van Sphinx. De documentatie is gemakkelijk te lezen in een standaard tekstverwerker. Echter, kunt u een HTML-versie zoals zo op te bouwen:
pip sfinx installeren
cd docs /
maken html
geopend _build / html / index.html

• Vertrouwd Django en Jinja2 sjablonen

  Kenmerken te bekijken. >

• Eenvoudig te installeren via pip
• Markdown, reStructuredText, Textiel ondersteuning
• YAML configuratie
• Atom-feed
• Github pagina's compatibel

Eisen

• Python