Sphinx JSONHTMLBuilder生成的.fjson与普通.json有何区别？

• 用途与定位不同

  • .json文件对应完整的文档页面数据，包含整个页面的所有元素，比如导航栏、侧边栏、页面标题、正文内容、页脚元信息等，相当于把传统HTML页面的所有结构转成了JSON格式，是可以独立使用的完整数据单元。
  • .fjson是片段JSON（Fragment JSON），只存储文档中的核心内容片段，比如某个章节的正文、被多个页面复用的内容块，没有页面级的框架信息，主要用于局部渲染或者内容复用，不能单独作为完整页面使用。

• 内容结构差异

  • .json的结构更完整，包含页面级的上下文数据，比如当前页面的路径、层级关系、全局导航配置等，数据量更大。
  • .fjson的结构非常精简，只保留内容本身的结构化数据，没有额外的页面框架相关字段，数据量更小，更轻量化。

• 生成逻辑区别

  • .json文件通常和源文档一一对应，每个.rst源文件会生成一个对应的.json文件，对应一个独立的页面。
  • .fjson是从文档内容中提取的可复用片段，可能是某个被多次引用的内容块，或者文档拆分出来的局部章节，用于避免重复生成相同内容，提升构建和渲染的效率。

内容的提问来源于stack exchange，提问作者luciano