没有显示源代码的godoc

Question

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

我试过了

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

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

Answer 1

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

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

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

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

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

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