跳转到主要内容

用于自动构建网站或项目文档的HTML页面的工具。内容可以存储为ReStructuredText或HTML,并具有灵活的模板系统。

项目描述

rest2web 是一个用于自动生成网站、网站部分或项目文档的工具。其主要功能包括

  • docutils 集成(将您的页面存储在ReST或HTML中)

  • 自动构建索引页面和导航链接(侧边栏和面包屑导航)

  • 模板中嵌入代码,具有无限的表达性

  • 灵活的宏系统。

  • 使用相对链接,因此可以从文件系统中查看网站

  • 内部使用Unicode - 因此您无需这样做

  • 包括网站多语言翻译的功能

  • 内置相册创建插件。

  • 基本系统非常易于使用

  • 许多强大的(可选)功能

内容可以存储为HTML,或以ReST格式;在这种情况下,将使用 docutils 生成HTML。 rest2web 将每个页面插入到模板中,并自动为章节创建索引页面和导航链接。

0.5.0更新中有很多变化。请参阅变更日志以获取完整详情。

最重要的变化包括

  • 添加了“快速入门指南”

  • rest2web 现在可以从 ReST 文档目录中构建网站;如果您不想提供 restindexes 或索引页面,则无需提供

  • 全局 uservalues(实际上是在每个页面中可用的变量)可以在 配置文件 或命令行中设置

  • 提供了许多新的 命令行选项,包括设置详细程度(使 rest2web 更加安静!)

  • 新增了 标准函数,特别是用于更好地定制模板的 'include'(例如,为某些目录定义不同的页脚)

  • 在命名空间和 indextree(源文件名、目标文件名、完整 URL 等)中提供更多信息

项目详情


由以下组织支持