Socrates

Sócrates es un generador de sitio estático sencillo dirigido a los blogs. Usted escribe sus mensajes en su texto sin formato favorito para el lenguaje HTML (por ejemplo, Markdown, textil) y guardarlos como archivos de texto en su disco duro. Sócrates luego los lleva, y crea un sitio HTML completo para usted. De forma gratuita, obtendrá una página de inicio que enumera todos los mensajes, páginas de entrada individuales, páginas de categorías, páginas de archivo, una página y una alimentación de átomo.
Uso
En primer lugar, es necesario crear un nuevo blog:
el blog socrates -i
Esto creará un directorio de blogs con una estructura simple blog:
el blog
& nbsp; posts
& Nbsp; 2010-your-post.md
& Nbsp; layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; los medios de comunicación
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
El directorio de mensajes es donde usted pondrá sus archivos mensajes. Todo el prefijo _ o. se tendrá en cuenta. diseño es su tema básico o una plantilla. config.yaml es un archivo de configuración en todo el sitio. No se olvide de actualizar el archivo sobre la información pertinente.
También puede crear un nuevo blog en el directorio de trabajo actual:
socrates -i
Cuando esté listo para generar su sitio, ejecuta:
el blog socrates -g
O,
socrates -g
para el directorio actual.
Esto colocará todos los archivos generados en el blog / desplegar. A continuación, puede tomar ese directorio y subirlo a tu servidor.
Instalación
En primer lugar, configurar el entorno virtual y PIP instalar Sócrates.
virtualenv env --no-site-packages
env fuente / bin / activar
PIP instalar socrates
O bien, para obtener la última versión del código, se puede instalar desde Github.
PIP instalar git -e: //github.com/honza/socrates.git#egg=socrates
El siguiente paso es instalar las plantillas. Por el momento, se puede elegir entre las plantillas de Django y plantillas Jinja2. El tema por defecto usa Django.
Temas
Sócrates apoya las plantillas de Django y plantillas Jinja2. Puede especificar qué motor de plantillas que desea utilizar en el archivo config.yaml. Hay dos temas básicos en el directorio de temas para empezar.
texto a HTML
Sócrates attemp para convertir tus archivos de texto en HTML usando un procesador de texto. Debe especificar el nombre del procesador de texto en config.yaml. Debe estar en minúsculas. Procesadores soportados actualmente:
- Markdown
- Textiles
- ReStructuredText
- HTML (texto sin modificar)
De forma predeterminada, Sócrates sólo instala los procesadores de texto Markdown. Puede instalar los demás con la pipa:
PIP instalar textil
PIP instalar docutils
Desarrollo
Puede iniciar un servidor de desarrollo simple para ayudarle en el desarrollo .:
el blog socrates -r
O,
socrates -r
para el directorio actual.
Documentación
La documentación está contenida en el directorio docs y está escrito en reStructuredText usando Esfinge. La documentación es fácil de leer en un editor de texto estándar. Sin embargo, usted puede construir una versión HTML de este modo:
PIP instalar esfinge
docs cd /
hacer html
_build abierto / html / index.html
O bien, puede ver la versión en línea de la documentación más reciente

Características :.

• plantillas de Django y Jinja2 familiares
• Simple instalar a través de pip
• Markdown, reStructuredText, soporte textil
• configuración YAML
• Atom

Compatible
• páginas Github

Requisitos :

• Python