go - godoc 不显示源代码

Question

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

我试过了

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

但不起作用，仍然可以链接到类型定义代码。只是想知道是否错过了某事。去版本，1.3。

Answer 1

该src文件仅指命令行模式，而不是服务器模式，因此对您没有帮助。我看到它的方式有几个选择：

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

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

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

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

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