【问题标题】:Excluding README section from godoc for Github project从 godoc 中排除 Github 项目的 README 部分
【发布时间】:2021-07-18 12:56:45
【问题描述】:

我有一个Github projectREADME.md。出于 godoc 的目的,我添加了 doc.go 文件,但并不意味着将 README.md 包含在 godoc 中。目前自述文件显示为first section in godoc。是否可以完全隐藏 README 部分?

【问题讨论】:

  • 不,没有。 File an issue 就他们更改包文档结构的决定提供反馈。

标签: go github godoc


【解决方案1】:

我找到了一个很好的解决方案,只需将您的 README.md 文件放在 docs folder on Github 中,它就不会出现在 godoc 中,但仍会显示在 Github 上。

我为my project on Github 做了这个,你可以看到godoc does not show the README.mdcontent

编辑:

对您的 github 存储库进行适当的更改后,您需要发布新的补丁版本以获取 pkg.go.dev 以更新更改。

【讨论】:

  • 我可以发誓照你说的做,但由于某种原因,现在 README 再次出现在 godoc 上:github.com/sanggonlee/pogo
  • @Iblisto 您可能只需要强制pkg.go.dev 进行更新。我想我过去曾使用go get 完成此操作,但如果您显然看这里,您也可以点击一个 URL:github.com/golang/go/issues/38848。让我知道这是否有效,我将使用此信息更新我的答案
  • @Iblisto 我有一些时间并尝试使用它,但无法使用任何方法在pkg.go.dev 上更新它。您可能需要发布补丁版本 (v1.0.1) 以使其更新。你可以试试吗?
  • 啊,这似乎奏效了!对不起,我可能没有想对。谢谢!
【解决方案2】:

是否可以完全隐藏 README 部分?

没有。除非您省略该文件或重命名它。

【讨论】:

    猜你喜欢
    • 2012-01-29
    • 2013-06-10
    • 1970-01-01
    • 1970-01-01
    • 2011-05-22
    • 1970-01-01
    • 1970-01-01
    • 2015-07-28
    • 2011-06-15
    相关资源
    最近更新 更多