Socrates

Socrate è un semplice generatore di sito statico orientato verso i blog. Scrivete i vostri messaggi in testo normale favorito per il linguaggio HTML (ad es Markdown, tessile) e salvarle come file di testo sul vostro hard disk. Socrate poi li prende, e crea un sito HTML completo per voi. Gratuitamente, avrete una home page che elenca tutti i messaggi, pagine singole poste, pagine di categoria, le pagine di archivio, una pagina su e feed Atom.
Utilizzo
In primo luogo, è necessario creare un nuovo blog:
blog socrates -i
Questo creerà una directory di blog con una struttura semplice blog:
blog
& nbsp; messaggi
& Nbsp; 2010-your-post.md
& Nbsp; di layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; supporti
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
L'elenco messaggi è dove potrete inserire i vostri file post. Tutto prefisso _ o. verrà ignorato. il layout è il tema di base o di un modello. config.yaml è un file di configurazione a livello di sito. Non dimenticare di aggiornare il file su informazioni pertinenti.
È inoltre possibile creare un nuovo blog nella directory di lavoro corrente:
socrates -i
Quando si è pronti a creare il vostro sito, si esegue:
blog socrates -g
O,
socrates -g
per la directory corrente.
Questo metterà tutti i file generati in blog / deploy. È quindi possibile prendere quella directory e caricarlo sul server.
Installazione
In primo luogo, impostare l'ambiente virtuale e Pip installazione Socrates.
virtualenv env --no-site-packages
fonte env / bin / attivare
pip installare socrates
Oppure, per ottenere il codice più recente, è possibile installare da Github.
pip installare git -e: //github.com/honza/socrates.git#egg=socrates
Il passo successivo è quello di installare i modelli. Al momento, è possibile scegliere tra i modelli di Django e modelli Jinja2. Il tema di default utilizza Django.
Temi
Socrates supporta i modelli di Django e modelli Jinja2. È possibile specificare quale template motore che si desidera utilizzare nel file config.yaml. Ci sono due temi fondamentali nella directory temi per iniziare.
Testo da HTML
Socrates si attemp per convertire i file di testo in HTML usando un elaboratore di testo. È necessario specificare il nome del processore testo in config.yaml. Dovrebbe essere tutto minuscolo. Processori attualmente supportati:
- Markdown
- Tessile
- ReStructuredText
- HTML (testo non modificato)
Per impostazione predefinita, Socrate installa solo i processori di testo Markdown. È possibile installare gli altri con pip:
pip installazione tessile
pip installare docutils
sviluppo
È possibile avviare un semplice server di sviluppo di aiuto per lo sviluppo .:
blog socrates -r
O,
socrates -r
per la directory corrente.
Documentazione
La documentazione è contenuta all'interno della directory docs ed è scritto in reStructuredText utilizzando Sfinge. La documentazione è facilmente leggibile in un editor di testo standard. Tuttavia, è possibile creare una versione HTML in questo modo:
pip installare sfinge
docs cd /
fare html
_build aperto / html / index.html
In alternativa, è possibile visualizzare la versione online della documentazione più recente

Caratteristiche :.

• modelli Django e Jinja2 familiari
• Semplice installare via pip
• Markdown, reStructuredText, supporto tessile
• configurazione YAML
• feed Atom
• pagine Github compatibile

Requisiti :

• Python