GoHub 更新至 0.6,在线 Golang 文档阅读

喻恒春
 喻恒春
发布于 2018年05月21日
收藏 13

GoHub 更新至 0.6,基于 Github REST API v3 的 Golang 在线文档。

GoHub

WIP (尚在开发中...)

GoHub 使用 Github REST API v3 提供在线 Golang 文档阅读.

  • 便捷的文档项目组织

  • Go Doc API 翻译双语对照阅读

  • 渲染 Markdown 或更多编程语言文档

对 GoHub 有任何建议或问题, 请至 GoHub Wiki 和 Issues

golist.json

golist.json 用于组织文档. 支持两种结构:

  • Object 单个文档项目, 多个 Package 组成

  • Array 文档项目列表, 每个项目的地址和说明, 每个项目下必须有 golist.json

例: 单个文档项目, 使用 GoDocu 生成.

{
  "Repo": "github.com/golang/go",
  "Filename": "doc_zh_CN.go",
  "Package": [
    {
      "Import": "archive/tar",
      "Synopsis": "tar包实现了tar格式压缩文件的存取.",
      "Progress": 100,
    },
    {
      "Import": "archive/zip",
      "Synopsis": "zip包提供了zip档案文件的读写服务.",
      "Progress": 95,
    }
  ],
}

例: 文档项目列表, 手工书写

[
  {
    "repo": "golang-china/golangdoc.translations",
    "synopsis": "Go 标准库中文版"
  }
]

也就是说 GoHub 的 golist.json 是文档组织的源头, 期望您的文档项目加入.

贡献

GoLang 标准库翻译文档来自 golangdoc.translations.

Golang-China 需要贡献者, 贡献辅助工具代码或翻译文档, 不限于 GoLang 标准库.

依赖

Powered by:

LICENSE

Copyright (c) 2018 The GoHub Authors. All rights reserved. Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题:GoHub 更新至 0.6,在线 Golang 文档阅读
加载中
返回顶部
顶部