Oli*_*eng 4 html compiler-construction restructuredtext
我希望有一个静态的基于HTML的网站,而不是博客/ cms,其中包含一些(很少更新的)页面.我认为更新它们的最简单方法是将源保持为ReST格式,并在每次更新时进行编译.这种用法的推荐编译器是什么?我想拥有自己的主题/设计,除了正确的ReST语法之外我不需要任何东西(例如,Sphinx太多了).
Makefile是一个很好的解决方案.这是一个快速模板makefile
# Flags to pass to rst2html
# e.g. RSTFLAGS = --stylesheet-path=mystyle.css
RSTFLAGS =
%.html: %.rst
rst2html $(RSTFLAGS) $< $@
.PHONY: all
.DEFAULT: all
all: index.html foo.html bar.html # any other html files to be generated from an rst file
Run Code Online (Sandbox Code Playgroud)
然后只需make在包含文件的目录中运行,即可从rst中生成html