没有显示源代码的godoc

godoc without showing source code

我得到了几个与 godoc 兼容的 Go 项目。我们使用 godoc 作为文档服务器在内部共享文档和代码,没有重大问题。然而,当我们想与第三方共享文档时,我们需要更多地控制打开代码。有没有办法在显示类型和文档但从不 link 或显示源代码的特殊模式下 运行 godoc?

我试过了

godoc -http=0.0.0.0:8090 -links=false -src=false

但不起作用,仍然可以link键入定义代码。只是想知道是否错过了某事。 Go 版本,1.3.

src文件只指命令行模式,不指服务器模式,所以对你没有帮助。在我看来,有几个选项:

  1. 根据您的需要重写 godoc 并使用您自己的 fork。

  2. 不要使用服务器模式,在命令行模式下呈现文档,然后创建一个服务器。

  3. 更好的是(我不完全确定 2 是否有效)- 稍微重写模板,这样就不会链接源代码。但是您仍然需要确保手动输入路径的人不会看到代码,因此也需要伪造源模板。或者...

  4. 也许是最简单的事情 - 运行 它在 nginx 或类似的反向代理之后,并确保服务器中的 /src 路径对外部访问者关闭,或密码保护什么的。这样您的内部团队仍然可以使用它。

就我个人而言,我会选择 4,这是几分钟的工作,将是最强大和灵活的解决方案。