关于Read the Docs嵌入Web应用及文档权限管控的技术咨询

1. 嵌入Web应用 #

Read the Docs支持将文档嵌入你的Web应用，主要有两种可行方式：

• iframe嵌入：直接用iframe标签加载Read the Docs生成的文档页面，官方默认配置允许这种嵌入，你只需把文档页面的URL作为iframe的src属性值即可。
• API自定义渲染：借助Read the Docs的API获取文档的结构化内容，再根据你的Web应用样式自定义展示逻辑，适合需要深度定制嵌入效果的场景。

相关内容可查阅官方文档中的「Embedding Documentation」章节。

2. 文档权限管控 #

Read the Docs的付费商业版（Read the Docs for Business）完全支持你提到的三级权限管控需求：

• 公开内容：可将部分文档设置为公开状态，所有用户无需授权即可访问。
• 授权外部用户可见内容：支持通过邮件邀请或生成共享链接，让指定的外部用户（非内部团队成员）访问特定私有文档。
• 内部用户可见全部内容：内部团队成员默认可访问所有内部文档，还能进一步细分团队内的角色权限。

如果使用免费的公共托管版，仅支持公开文档，无法实现私有和授权访问的权限控制。相关内容可查阅官方文档中的「Read the Docs for Business - Access Control」章节。

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