想做类似华为云、阿里云这种帮助中心、文档中心的网站,求思路

zlp1176
  • 2
新手上路,请多包涵

公司内部想在官网提供一个文档中心,大概是面向用户的,然后需要调研一下实现方案,我想借鉴华为云和阿里云的展示方式,但不知采用何种技术较为简单。
image.png
公司领导一种方案是gitbook, gitbook我觉得样式、功能等不易定制和扩展(比如添加 文档反馈需要计入到数据库中的功能),可能我了解的也不深。
还有一种方案就是文档目录等等存后台,功能样式前端自己开发。
还有其他的什么实现方式吗?有经验的小伙伴,希望大家能给我提供一些思路,谢谢~

回复
阅读 1.1k
2 个回答
✓ 已被采纳

在静态站生成框架上改模板和样式吧?

举例来说,需要独立的文档站点可以考虑 mkdocs、hugo、metalsmith 这些静态网站生成器,优点是有很多插件和皮肤可以直接用,省事儿。

要是需要和已有的网页框架整合,markdown 渲染库也很多。无论是前端渲染还是后端渲染都不是什么问题,需要关注的就是文章索引(从目录树生成还是可配置?)、调教下渲染结果的样式做到美观。

用静态站生成器的方案有点就是省事,可用的实现有 ruby 的 jekyll 、 python 的 mkdocs、nodejs 的 hexo、go 的 hugo 、nodejs 的 metalsmith 等等,各有特点。根据你们期望的技术栈选就行。缺点是想整合到已有网页框架会比较麻烦,要自己改模板和样式,嵌入已有的网页也是问题(iframe?)。

自己写的话,vue/react都有markdown库,连 jquery 都有。选项太多不列举了。优点是能无缝整合到已有的网站框架里,现有的网页组件全都能复用。缺点就是都要自己写,得自己考虑前端渲染还是后端渲染还是预渲染,根据需求在不同阶段把markdown给渲染成HTML,要自己调教样式,要自己组织和管理内容,等等。反正麻烦事一堆。


以上均为没有更多信息的情况下自由发挥随机联想的产物,如有冒犯敬请谅解。

然后去远足
  • 35.2k

阿里云的文档显然是 Markdown 编辑的、然后预渲染成 HTML 的(这样做对 SEO 会更友好)。
。这点从 CSS 样式上就能看出来:

image.png

不过看上去是自研的框架,起码我没看出来有那些主流的开源的文档项目的影子。

GitBook 的话可扩展性还是蛮不错的吧,它有自己的插件系统,你要额外功能的话可以自己开发插件,包括主题什么的。也可以看看社区里有哪些插件觉得不错的直接拿来用。

撰写回答
你尚未登录,登录后可以
  • 和开发者交流问题的细节
  • 关注并接收问题和回答的更新提醒
  • 参与内容的编辑和改进,让解决方法与时俱进
宣传栏