Socrates

Socrate est un générateur simple site statique orientée vers des blogs. Vous écrivez vos messages dans votre texte brut favori pour la langue HTML (par exemple Markdown, textile) et de les enregistrer sous forme de fichiers texte sur votre disque dur. Socrate les prend alors, et crée un site HTML complet pour vous. Gratuitement, vous obtiendrez une page d'accueil qui énumère les derniers messages, pages de poste unique, Catégorie pages, pages d'archives, une page sur et un flux Atom.
Utilisation
Tout d'abord, vous devez créer un nouveau blog:
Socrate le blog
Cela va créer un répertoire de blog avec une structure simple blog:
le blog
& nbsp; les messages
& Nbsp; 2010-your-post.md
& Nbsp; la mise en page
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; les médias
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Le répertoire des messages est où vous allez placer vos fichiers de messages. Tout ce préfixe _ ou. seront ignorés. mise en page est votre thème de base ou un modèle. config.yaml est un fichier de configuration du site. Ne oubliez pas de mettre à jour le dossier sur des informations pertinentes.
Vous pouvez également créer un nouveau blog dans le répertoire de travail courant:
Socrate -i
Lorsque vous êtes prêt à créer votre site, vous exécutez:
Socrate le blog
Ou,
Socrate -g
pour le répertoire courant.
Cela permet de placer tous les fichiers générés dans le blog / déployer. Vous pouvez alors prendre ce répertoire et de le transférer à votre serveur.
Installation
Tout d'abord, mettre en place votre environnement virtuel et Pip installer Socrate.
virtualenv env --no-site-packages
la source env / bin / activer
pip installer Socrate
Ou, pour obtenir le dernier code, vous pouvez installer à partir Github.
pip installer git -e: //github.com/honza/socrates.git#egg=socrates
La prochaine étape est d'installer vos modèles. Pour le moment, vous pouvez choisir entre des modèles et des modèles Django jinja2. Le thème par défaut utilise Django.
Thèmes
Socrate supporte les modèles Django et modèles jinja2. Vous pouvez spécifier quel moteur de gabarits que vous souhaitez utiliser dans le fichier de config.yaml. Il ya deux thèmes de base dans le répertoire de thèmes pour vous lancer.
texte HTML
Socrates attemp de convertir vos fichiers texte en HTML en utilisant un traitement de texte. Vous devez spécifier le nom du processeur de texte dans config.yaml. Il devrait être en minuscules. Processeurs actuellement pris en charge:
- Markdown
- Textile
- ReStructuredText
- HTML (texte non modifié)
Par défaut, Socrate ne installe que les traitements de texte de Markdown. Vous pouvez installer les autres avec pip:
pip installer textile
pip installer docutils
Développement
Vous pouvez commencer un simple serveur de développement pour vous aider dans le développement .:
Socrate le blog
Ou,
Socrate -r
pour le répertoire courant.
Documentation
La documentation est contenue dans le répertoire docs et est écrit en utilisant reStructuredText Sphinx. La documentation est facile à lire dans un éditeur de texte standard. Cependant, vous pouvez construire une version HTML comme ceci:
pip installer sphinx
cd / docs
make html
_build ouverte / html / index.html
Ou, vous pouvez consulter la version en ligne de la documentation la plus récente

Caractéristiques :.

• familiers modèles Django et jinja2
• Simple installation via pip
• Markdown, reStructuredText, le soutien Textile
• YAML
• Atom
• pages Github compatible

Exigences :

• Python