# open-giteye-api **Repository Path**: dinghangLoop_admin/open-giteye-api ## Basic Information - **Project Name**: open-giteye-api - **Description**: No description available - **Primary Language**: Java - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 11 - **Created**: 2021-03-05 - **Last Updated**: 2021-03-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # giteye.net ### 站点地址 https://giteye.net ### 什么是 giteye.net ? giteye.net 是专为开源作者设计的数据图表服务工具类站点，提供了包括 `Star 趋势图`、`贡献者列表`、`Gitee指数`等数据图表服务。目前支持了Gitee，之后会马上支持Github。 ### 为何使用 - 您只需进行简单的几步操作，就可以快速生成开源项目的专属图表， Giteye提供近实时动态图表URL，您只需将地址挂到您的站点上，就让您的项目数据可视化 - Giteye为每种图表提供了多种主题，您可以选择不同风格的主题。来进行生成图表。适配您的主页和站点 - Giteye拥有强大的自动更新机制，能够在10分钟左右就更新您项目的最新数据。 而这一切，您无需干预。让别人看到的永远是您最新的数据图表 - 您无需担心带宽问题，Giteye使用了全球CDN加速，数据图表显示从任何地域加载都不会给您的首页带来额外负担 - 支持Gitee和Github的数据采集，Github数据功能会陆续开放 - Giteye能够给你的仓库数据带来更为详细的访问统计，IP统计，访问来源统计，地域访问统计，日月访问量汇总的数据，实时更新。让你对你的开源项目了如指掌。这部分内容也在陆续开放 ### 性能如何 - giteye.net 最终生成的是`png`格式的静态图片，并不需要应用服务器花资源和时间在每次请求的时候去动态实时生成，但会每10分钟左右（非精确时间）更新一次。 - 所有图表的图片存放在全球加速 `CDN` 上，所以能保证图片快速响应，也不会产生服务端带宽限制问题，即使访问量再大也不会对我们服务器造成压力。 ### 有哪些特性 - [x] 无次数限制：因为是每位作者会进行Gitee授权，所以几乎不会受到Gitee API的访问次数限制 - [x] 多种数据指标：现在支持Star趋势图、Gitee指数以及贡献者列表，以后会支持更多有意思的数据指标 - [x] 多种可选图表：现在支持有折线图和雷达图，以后会支持更多类型图表 - [x] 多种可选主题：提供多种不同配色的主题供你选择，来美化项目的图表 - [x] 时间轴平铺：通过动态插值技术使得在时间轴上分布的时间是平均的（X轴每一格总是隔1天），不会因为Star数数据不均衡而导致出现一会隔1天，一会隔好几天甚至几月几年的情况 - [x] 增量更新：每隔10分钟执行一次增量更新，每次更新只在上次的数据基础上累加，但如果出现了`Unstar`，可能会出现图表star数比实际高的情况，但过1小时全量同步后就会消除这个问题 - [x] 全量更新：每隔1小时左右执行一次全量更新，会一次性更新所有数据 - [x] 高并发大流量：所有生成的图片都存放在CDN上，不必担心带宽、网速以及服务器压力问题，即使我们的服务器挂了也不会影响到您图表的正常展示 ### 支持仓库平台 - [x] [Gitee](https://gitee.com) - [ ] [Github](https://github.com) ### 支持数据指标 - [x] Star趋势 - [x] Gitee指数 - [x] 贡献者列表 - [ ] 页面访问量 - [ ] IP访问量 - [ ] 访客地域分布 - [ ] 新老访客比例 ### 如何使用 #### Step 1. 浏览器输入网址 [https://giteye.net](https://giteye.net) 进入首页 ![首页](/asset/img/shouye.png) 并点击 `立即加入` 按钮 #### Step 2. 微信扫码登陆 ![微信扫码](/asset/img/wx_saoma.png) 点击 `立即加入` 或 `登陆` 按钮后会弹出微信二维码，关注后自动登录 #### Step 3. 前往Gitee进行授权 ![授权](/asset/img/shouquan.png) 点击`Gitee`的Logo图标前往Gitee页面进行授权 （Github平台的支持尚未开通，目前还不能支持） ![Gitee授权](/asset/img/gitee_shouquan.png) 在 `Gitee` 授权页面中点击 `同意授权` 注：为了获取 `Gitee` 平台的数据支持，需要您同意对 giteye.net 进行授权，否则无法提供任何有意义的服务。这个授权只在第一次时需要，之后就不再需要，同时Giteye保证只进行查询基础信息操作，不会进行任何其他操作。 #### Step 4. 创建 Star 趋势图 在 `Gitee` 授权通过后，会跳转到 `我的图表` 页面，如下图 ![我的图表](/asset/img/create_chart_1.png) 在此页面点击`创建图表`按钮 ![仓库列表](/asset/img/repo_list.png) 弹出您的仓库列表页面，选择其中您要生成图表的仓库 ![选择指标和主题](/asset/img/create_chart_2.png) 在此页面选择数据指标和图表主题，我们这里以选择`Star趋势图`为例 #### Step 5. 生成图表 ![生成按钮](/asset/img/shengcheng.png) 选择完之后，点击`生成`按钮开始生成图表 ![等待生成](/asset/img/dengdai.png) 这里可能要花费一些时间（几秒到几分钟不等），您的项目的Star数越多，需要等待的时间也越长 ![生成结果](/asset/img/jeiguo.png) 最终生成结果如上图所示，此页面为图表详情页，上面展示的是动态图表，会根据用户鼠标滑动而响应 #### Step 6. 复制图表地址到您的 README.md 中 ![复制图表地址](/asset/img/fuzhi.png) 在图表详情页下方框框中显示的是包该项目 `star趋势图` 的图片地址的 `Markdown` 代码片段，可以将其复制到您项目的 README.md 文件、或是其他页面中。