GoHub 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
GoHub 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
GoHub 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 BSD
开发语言 JavaScript HTML/CSS
操作系统 跨平台
软件类型 开源软件
所属分类 Web应用开发网页组件
开源组织
地区 国产
投 递 者 喻恒春
适用人群 未知
收录时间 2015-05-29

软件简介

GoHub 基于 Github Pages 提供在线 Golang 文档阅读.。特征:

  • 便捷的文档项目组织

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

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

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

实现基础

得益于 GitHub API 和 RawGit, GoHub 项目代码和 Golang 翻译文档项目代码是分离的。GoHub 通过 GitHub API 获取项目的 Latest release Tag,从 RawGit CDN 获取该 Tag 下的文档。RawGit CDN 中的数据是静态的, 不提供更新服务。更新 Latest release Tag 可使 GoHub 展现新的文档. 对于没有建立 Latest release Tag 的项目, 您可以 fork 后, 在 fork 项目中建立 Latest release Tag。

组织方式

GoHub 使用文件 golist.json 来组织文档项目. 为简化逻辑使用两种结构.

Object方式 表示包文档索引: 全部以 Object 组织, list 为子包列表.

{
    "std": {
        "type": "doc_zh_CN.go",
        "repo": "golang-china/golangdoc.translations/src",
        "list": {
            "archive/tar": "tar包实现了tar格式压缩文件的存取.",
            "archive/zip": "zip包提供了zip档案文件的读写服务."
        }
    }
}

数组方式 表示项目索引: 每个条目都是 GitHub 上得一个项目, repo 下必须含有 golist.json 文件. 该文件内容可以为包文档索引或者包文档索引.

[
    {
        "repo": "golang-china/golangdoc.translations",
        "description": "Go std 文档"
    },
    {
        "repo": "gohub/google",
        "description":"Google Go 文档"
    }
]

GoHub 的 golist.json 为文档源头, repo 所有者通过定义 golist.json 自由拓扑文档关系.

Go 标准库

GoLang 标准库的翻译文档来自 Golang-Chinagolangdoc.translations 项目。期待您参与该项目并改善翻译文档.

致谢

GoHub 的设计灵感来自 FlatDoc。Powered by:

  • jQuery  New Wave JavaScript

  • marked  a markdown parser

  • base64.js Base64 implementation for JavaScript

  • highlight.js Syntax highlighting for the Web

  • JingYes CSS3 Framework

展开阅读全文

代码

评论

点击引领话题📣
发表于大前端专区
2018/05/21 18:13

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

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 文档项目列表, 每个项目...

0
13
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
发表了博客
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
发表了问答
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
暂无内容
0 评论
28 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部