小团队的相关文档如果想部署成网页应该用什么方案？

[ggp1ot2]

团队内想把之前开发的一些接口、相关代码整理成文档。

已经分类别写了很多个 markdown 文件。

我可以使用一些基于 Sphinx 的工具，将这些 markdown 渲染成网页格式发布。

但是还有一些其他的问题让我暂时没想到好的方案。

一个是为了防止泄漏，在进入网页前，需要有个页面去输入账号密码验证。

我直接用框架弄出来的就是一个一个的 html ，点击就打开了，如果还需要加登陆页，我想到的就是再单独找一个登陆页的 html ，然后用 Django 什么的，手动一个一个把上面生成的 html 搞成子页面，感觉太麻烦。

当然，也不一定必须是要额外添加一个面，只是需要一个方法来控制只有团队内部或者拥有指定口令的人才能访问，如果还能额外有个页面管理就更好了。

所以就像这样的需求 [将 markdown 转成 html 并且还能支持指定人查看] 有没有什么更好的方案？

[no13bus]

showdoc

[Aixiaoa]

搜索 静态博客 有的会带秘密访问 或者 随便一个静态生成器加 traefik 之类的。由 traefik 做密码

[Les1ie]

https://github.com/star7th/showdoc

showdoc 似乎比较接近需求了？

[mango88]

套个 nginx 用 basic auth

[zhhanging]

wiki.js 可以吗

[tt0411]

愿意付费用 github 的话, 可以试试 https://docs.github.com/en/enterprise-cloud@latest/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site

[asdjgfr]

本地部署一套 wiki.js ，完全符合你的需求。https://js.wiki/

[nsynet57]

考虑文档常常要更新，最好用 wiki 方式

[beichenshao]

部署成网页，对于你们来说，是个伪需求，你们希望的是做文档预览和权限管理，其实用飞书云文档就好了，md 文件上传直接预览，还可以直接转成在线文档，对于权限管理，飞书文档做的也非常好，然后直接注册使用即可，无部署，小团队无收费。

[tool2d]

这个需求，路由验证 cookie 可以轻松做到吧。

问问你们后端吧，就几行代码的事情。

[clf]

需要密码访问的话，直接 nginx 加一个基础的身份认证就行了。

[clf]

如果想要比较正常的登录页面。可以用 logto 封一层。目前我司就是用 logto 进行登录验证，然后访问不同的页面。

[Phiiiil]

推荐一个自用的 markdown 程序，轻量化，部署简单，https://github.com/gaowei-space/markdown-blog

目前不支持登录验证，可以通过 nginx 把站点改为仅内网访问、固定 I P 访问

[amrice]

github pages+markdown

[ggp1ot2]

@Les1ie #3 感觉不够好看，不知道是否支持自定义 CSS

[ggp1ot2]

@tt0411 #6 感觉这个很好，只不过因为这个也不是 kpi 任务，估计没有预算哈哈哈

[SenLief]

内网搭建一个 wiki ，如果没那么高的要求，用 notion ，飞书一类的就好了。

[ggp1ot2]

@beichenshao #9 并不是伪需求，换句话说，也算伪需求，只不过网页格式最合适。飞书云文档以及语雀等工具不是没考虑过，首先要求对方都有飞书账号，我们公司从某种意义上也是某节跳动竞争对手，所以绝不可能用相关工具，另外有些文档内包含比较隐私的例如 IP 、密码什么的，领导肯定不同意内容放在别人的服务器上

[play78]

这个我刚好做过。 文档是 sphinx 实现的。
认证是通过 nginx + lua script 来实现。 利用 luascript 发送给公司某应用服务器，实现单点登录。还可以为每个文件设置权限。利用已有的系统进行认证，不用每个人还需要再分配账号密码。

[youyi1996]

Docsify + HTTP Basic Auth 呗，无需转换 Markdown 至 HTML
缺点是某些手机 APP 里的浏览器框架不会弹出登录对话框，比如毒瘤 Wechat

[coderge]

`语雀`也不错, 可以整理团队知识库, 开发文档之类的.

[mouyong]

http://mouyong.github.io/vitepress-doc-website/ 文档站看看？

[mouyong]

nginx basic 认证加上 #22 文档站应该可以满足

[xylophone21]

装个 gitlab?

[AmberMmoe]

mkdocs ，或者 facebook 那个小恐龙，都挺好用的

[RheatiN]

docusaurus ，好看又简单

[Herry001]

是一个简单的账号验证就行（登陆后没有权限组，全部都能看），还是说要一个带权限组的？
前者用 Docsify 再加个认证就行，后者找个 Wiki 系统（比如 BookStack ）。

[star7th]

建议使用 showdoc https://github.com/star7th/showdoc 开源免费私有部署。

[mosakashaka]

spring ，加个登录验证，其他链接地址代理静态资源

[litchinn]

https://github.com/BookStackApp/BookStack

[zed1018]

其实我觉得小团队文档直接放私有 git 仓库就好了，别的我不知道，gitlab 的 markdown 渲染还是不错的，用 wiki 的话更好一些

[Casbin]

Showdoc 开源文档平台+Casdoor 开源单点登录系统