Socrates

蘇格拉底是面向博客一個簡單的靜態網站發生器。你寫你的職位，你最喜歡的純文本到HTML語言（如降價，紡織），並將其保存為您的硬盤的文本文件。蘇格拉底然後帶他們，並為您創建一個完整的HTML網站。對於免費的，你會得到一個主頁，其中列出最新的帖子，單頁後，分類頁，存檔頁，一個關於頁面和一個原子飼料。
用法
首先，你需要創建一個新的博客：
蘇格拉底-i博客
這將創建一個簡單的博客結構的博客目錄：
博客
＆NBSP;崗位
＆NBSP; 2010-your-post.md
＆NBSP;佈局
＆NBSP;的index.html
＆NBSP; single.html
＆NBSP; category.html
＆NBSP; ...
＆NBSP;媒體
＆NBSP;的style.css
＆NBSP; config.yaml
＆NBSP; about.md
職位目錄，你將會把你的帖子的文件。任何前綴_或。將被忽略。佈局是你的基本的主題或模板。 config.yaml是站點範圍的配置文件。不要忘了更新相關信息有關文件。
您還可以創建在當前工作目錄下新建一個博客：
蘇格拉底-i
當您準備好生成你的網站，你運行：
蘇格拉底-g博客
或者，
蘇格拉底-g
為當前目錄。
這將會把所有生成的文件在博客/部署。然後，您可以採取的目錄，並把它上傳到你的服務器。
安裝
首先，設置你的虛擬環境和PIP安裝蘇格拉底。
的virtualenv ENV --no現場，包
源ENV /斌/啟動
PIP安裝蘇格拉底
或者，以獲得最新的代碼，你可以安裝在Github上。
PIP安裝-e混帳：//github.com/honza/socrates.git#egg=socrates
接下來的步驟是安裝模板。此刻，你可以Django的模板和模板的Jinja2之間進行選擇。默認主題使用Django的。
主題
蘇格拉底支持Django的模板和模板的Jinja2。你可以指定你想在config.yaml文件中使用的模板引擎。有讓你開始兩個基本主題，在themes目錄。
文本到HTML
蘇格拉底將學嘗試使用文本處理的文本文件轉換成HTML。你應該指定config.yaml文字處理器的名稱。它應該是全部小寫。目前支持的處理器：
- 降價
- 紡織
- reStructuredText的
- HTML（未修改文）
默認情況下，蘇格拉底只安裝了降價的文字處理器。您可以安裝其他與PIP：
PIP紡織安裝
PIP安裝docutils的
發展
你就可以開始一個簡單的開發服務器，以幫助您開發：
蘇格拉底-r博客
或者，
蘇格拉底-r
為當前目錄。
文件
該文件包含在文檔目錄中，並使用獅身人面像寫在reStructuredText的。該文檔輕鬆地閱讀在一個標準的文本編輯器。但是，你可以建立像這樣的HTML版本：
PIP安裝獅身人面像
CD文檔/
使HTML
開_build / HTML / index.html的
或者，您可以查看最新的文檔的在線版本

特點：

• 在熟悉Django和Jinja2的模板
• 在經過簡單安裝PIP
• 在降價，reStructuredText的，紡織的支持
• 在YAML配置
• 在Atom提要
• 在Github上的網頁兼容

要求：

• 在Python中