2010-01-19 28 views
4

而不是一個博客/ cms,我想有一個靜態的基於html的網站與幾個(很少更新)的網頁。我認爲更新它們的最簡單方法是將源代碼保存爲像ReST這樣的格式,並在每次更新時進行編譯。這種用法的建議編譯器是什麼?我想擁有自己的主題/設計,除了正確的ReST語法之外,我不需要任何東西(例如Sphinx太多了)。什麼是重構文本的簡單網頁編譯器?

回答

2

rest2web生成HTML可能更諸如此類的事情,你要尋找的。

+0

我決定去這一點,因爲這是最起碼的 - 正是我想要的。謝謝! – 2010-01-20 22:30:28

5

一個Makefile將是一個很好的解決方案。這裏有一個快速的模板生成文件

# Flags to pass to rst2html 
# e.g. RSTFLAGS = --stylesheet-path=mystyle.css 
RSTFLAGS = 

%.html: %.rst 
     rst2html $(RSTFLAGS) $< [email protected] 

.PHONY: all 
.DEFAULT: all 

all: index.html foo.html bar.html # any other html files to be generated from an rst file 

然後,只需在目錄中運行make處理文件,從第一個

1

如果你不一定需要重組文本,但減價或紡織品一樣好,那麼檢查出jekyll

我自己使用它。豎起大拇指。

+0

我也使用它,但我來這裏研究jekyll的重構文本功能! – joar 2011-07-30 08:59:39

0

我使用nanoc3以及docutils(通過sphinx安裝)在靜態站點生成器中啓用良好的重新構造支持。我已經看過(並希望使用)純粹的Python解決方案(hyde),但是nanoc允許使用更清晰的ReST源文件。

我也考慮過使用sphinx來產生一個靜態網站,但是如果沒有大量的代碼來支持它,就不那麼容易。

我很高興詳細說明如何做到這一點,如果仍然對此主題感興趣。它基本上使用docutils來輸出源代碼中的html。我有一個簡單nanoc處理器,這是否:

module Nanoc3::Filters 

    class ReST < Nanoc3::Filter 

    identifier :rest 

    def run(content, params={}) 
     open('|rst2html.py --template=rest.template', 'r+') do |io| 
     io.write(content) 
     io.close_write 
     io.read 
     end 
    end 

    end 

end 

的rest.template文件基本上是與下面一行的虛擬模板:

%(body)s 
相關問題