Socrates

Sócrates é um gerador simples site estático voltado para blogs. Você escreve seus posts em seu texto claro favorito à linguagem HTML (por exemplo, Markdown, têxtil) e salvá-los como arquivos de texto em seu disco rígido. Sócrates, em seguida, leva-los, e cria um site HTML completo para você. De graça, você vai ter uma home page que lista todos os posts, páginas único post, páginas da categoria, páginas de arquivo, uma página sobre e um feed Atom.
Uso
Em primeiro lugar, você precisa criar um novo blog:
socrates -i blogue
Isto irá criar um diretório blog com uma estrutura simples blog:
Blog
& nbsp; mensagens
& Nbsp; 2010-your-post.md
& Nbsp; de layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; media
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
O diretório de mensagens é onde você vai colocar seus arquivos de mensagens. Qualquer coisa prefixado com _ or. irá ser ignorado. layout é o seu tema básico ou um modelo. config.yaml é um arquivo de configuração de todo o site. Não se esqueça de atualizar o arquivo sobre as informações relevantes.
Você também pode criar um novo blog no diretório de trabalho atual:
socrates -i
Quando você estiver pronto para gerar o seu site, você corre:
socrates -g blogue
Ou,
socrates -g
para o diretório atual.
Isto irá colocar todos os arquivos gerados em blog / implantar. Você pode então tomar a pasta e faça o upload para o seu servidor.
Instalação
Primeiro, configure seu ambiente virtual e Pip instalar Sócrates.
VIRTUALENV env --no-site-packages
fonte env / bin / ativar
pip instalar socrates
Ou, para obter o código mais recente, você pode instalar a partir do Github.
pip instalar git -e: //github.com/honza/socrates.git#egg=socrates
O próximo passo é a instalação de seus modelos. No momento, você pode escolher entre modelos de Django e modelos Jinja2. O tema padrão usa Django.
Temas
Sócrates apoia templates Django e modelos Jinja2. Você pode especificar qual mecanismo de modelagem que você deseja usar no arquivo config.yaml. Existem dois temas fundamentais no diretório de temas para você começar.
Text to HTML
Sócrates vai attemp para converter seus arquivos de texto em HTML usando um processador de texto. Você deve especificar o nome do processador de texto em config.yaml. Ele deve estar em minúsculas. Processadores atualmente aceitos:
- Markdown
- Têxtil
- ReStruturedText
- HTML (texto inalterado)
Por padrão, Sócrates só instala os processadores de texto Markdown. Você pode instalar os outros com pip:
pip instalar têxtil
pip instalar docutil
Desenvolvimento
Você pode iniciar um servidor de desenvolvimento simples para ajudá-lo no desenvolvimento .:
socrates -r blogue
Ou,
socrates -r
para o diretório atual.
Documentação
A documentação está contida dentro do diretório docs e é escrito em reStructuredText usando Esfinge. A documentação é facilmente lido em um editor de texto padrão. No entanto, você pode construir uma versão HTML da seguinte forma:
pip instalar sphinx
docs cd /
fazer html
_build aberto / html / index.html
Ou, você pode ver a versão online da documentação mais recente

Características :.

• templates Django e Jinja2 familiares
• Simples instalar via pip
• Markdown, reStruturedText, suporte Têxtil
• configuração YAML
• feed Atom
• páginas Github compatível

Requisitos :

• Python