什么是重构文本的简单网页编译器？

而不是一个博客/ cms，我想有一个静态的基于html的网站与几个（很少更新）的网页。我认为更新它们的最简单方法是将源代码保存为像ReST这样的格式，并在每次更新时进行编译。这种用法的建议编译器是什么？我想拥有自己的主题/设计，除了正确的ReST语法之外，我不需要任何东西（例如Sphinx太多了）。什么是重构文本的简单网页编译器？

来源

2010-01-19 Oliver Zheng

rest2web生成HTML可能更诸如此类的事情，你要寻找的。

来源

2010-01-19 20:07:46

我决定去这一点，因为这是最起码的 - 正是我想要的。谢谢！ – 2010-01-20 22:30:28

一个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处理文件，从第一个

来源

2010-01-19 19:59:17

如果你不一定需要重组文本，但减价或纺织品一样好，那么检查出jekyll。

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

来源

2010-01-19 20:08:03 Christian

我也使用它，但我来这里研究jekyll的重构文本功能！ – joar 2011-07-30 08:59:39

我使用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文件基本上是与下面一行的虚拟模板：