开发者社区 问答 正文

求一个开源或在线的带左侧列表文档系统,想CHM那样的。:报错

就是用于写帮助文档,API文档的。能在线写,发布以后,用户可以在线查看。

有左侧列表,多级目录,像chm那样的。有全文检索,可以导出PDF\CHM等格式让用户下载。

gitbook有些慢,不想用。有没有国内的,或者开源自己能部署的。

展开
收起
kun坤 2020-06-14 08:42:15 559 分享 版权
阿里云 AI 助理回答

根据您的需求,您希望找到一个能够在线编写API文档的工具,它应支持以下功能:

  1. 在线编辑与发布:允许作者直接在网页上编写文档内容,并能即时发布,供用户在线查看。
  2. 多级目录结构:具备类似CHM文件的左侧列表和多级目录功能,以便于组织和导航复杂的内容结构。
  3. 全文检索能力:内置搜索功能,帮助用户快速查找文档中的特定信息。
  4. 导出多种格式:支持将文档导出为PDF、CHM等常见格式,便于用户下载离线阅读。
  5. 国内服务或开源部署:倾向于使用国内服务以确保访问速度,或者开源软件以便自行部署。

针对您的需求,虽然知识库中没有直接提供具体的工具推荐,但市面上有几款符合描述的工具您可以考虑:

  • Docusaurus:这是一个由Facebook维护的开源项目,支持Markdown编写文档,具有自动化的侧边栏生成、版本控制和多语言支持。它可以轻松构建具有多级目录的文档站点,并且可以自定义主题和插件来实现全文搜索等功能。您需要自己部署服务器来运行它。

  • Hugo:Hugo是一个非常快速的静态站点生成器,适合构建文档网站。它支持Markdown,可以通过主题和插件实现丰富的功能,包括多级目录和搜索。Hugo同样需要您自行部署,但搭建过程相对简单,且性能优秀。

  • GitLab Pages + GitLab Docs:如果您不介意使用国外服务,但对GitBook的速度不满意,可以考虑使用GitLab提供的Pages服务结合GitLab Docs特性。这允许您在GitLab仓库中编写Markdown文档,并通过GitLab Docs特性生成具有良好导航结构的文档网站,同时支持多种输出格式和在线预览。GitLab在国内也有镜像服务,可以提升访问速度。

  • AntV Docsite:这是蚂蚁集团开源的一款文档站点构建工具,专为技术文档设计,支持Markdown编写,内置多语言、多版本、实时预览等功能,同时也支持自动生成侧边栏和全文搜索。适用于构建具有复杂结构的技术文档站点。

以上工具均为开源项目,意味着您可以自由部署到自己的服务器上,从而满足对速度和服务地点的需求。选择时,请根据您的具体需求(如技术栈偏好、部署便利性、社区活跃度等)进行评估。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答分类:
API
问答地址: