github-readme-stats/docs/readme_cn.md
Conan Kunhwan Ahn 621365061f
docs: fix broken links at translated docs (#771)
* docs: fix broken links at translated docs

* test: fix broken test.

* test: use dynamic year instead of static number
2021-01-07 17:09:35 +05:30

14 KiB
Raw Blame History

GitHub Readme Stats

GitHub Readme Stats

在你的 README 中获取动态生成的 GitHub 统计信息!

Tests Passing Issues GitHub pull requests

查看 Demo · 报告 Bug · 请求增加功能

Français · 简体中文 · Español · Deutsch · 日本語 · Português Brasileiro · Italiano · 한국어 . Nederlands

喜欢这个项目?请考虑捐赠来帮助它完善!

特性

GitHub 统计卡片

将这行代码复制到你的 markdown 文件中,就是如此简单!

更改 ?username= 的值为你的 GitHub 用户名。

[![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats)

注: 等级基于用户的统计信息计算得出,详见 src/calculateRank.js

隐藏指定统计

想要隐藏指定统计信息,你可以调用参数 ?hide=,其值用 , 分隔。

选项:&hide=stars,commits,prs,issues,contribs

![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&hide=contribs,prs)

将私人项目贡献添加到总提交计数中

你可以使用参数 ?count_private=true 把私人贡献计数添加到总提交计数中。

注:如果你是自己部署本项目,私人贡献将会默认被计数,如果不是自己部署,你需要分享你的私人贡献计数。

选项: &count_private=true

![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&count_private=true)

显示图标

如果想要显示图标,你可以调用 show_icons=true 参数,像这样:

![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true)

主题

你可以通过现有的主题进行卡片个性化,省去手动自定义的麻烦。

通过调用 ?theme=THEME_NAME 参数,像这样:

![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=radical)

所有现有主题

dark, radical, merko, gruvbox, tokyonight, onedark, cobalt, synthwave, highcontrast, dracula

GitHub Readme Stat Themes

你可以预览所有可用主题或者签出主题配置文件, 而且如果你喜欢, 你也可以贡献新的主题 :D

自定义

你可以通过使用 URL 参数的方式,为你的 Stats CardRepo Card 自定义样式。

常用选项:

  • title_color - 卡片标题颜色 (十六进制色码)
  • text_color - 内容文本颜色 (十六进制色码)
  • icon_color - 图标颜色(如果可用)(十六进制色码)
  • bg_color - 卡片背景颜色 (十六进制色码) 或者angle,start,end 的形式渐变
  • hide_border - 隐藏卡的边框 (布尔值)
  • theme - 主题名称,从所有可用主题中选择
  • cache_seconds - 手动设置缓存头 (最小值: 1800最大值: 86400
  • locale - 在卡片中设置语言 (例如 cn, de, es, 等等)
bg_color 渐变

你可以在 bg_color 选项中提供多个逗号分隔的值来呈现渐变,渐变的格式是 :-

&bg_color=DEG,COLOR1,COLOR2,COLOR3...COLOR10

缓存的注意事项: 如果 fork 数和 star 数 少于 1k , Repo 卡片默认缓存是 4 小时 14400 秒) ,否则是 2 小时7200。另请注意缓存被限制为最短 2 小时,最长 24 小时。

统计卡片专属选项:

  • hide - 隐藏特定统计信息 (以逗号分隔)
  • hide_title - (boolean)
  • hide_rank - (boolean)
  • hide_border - (boolean)
  • show_icons - (boolean)
  • include_all_commits - 统计总提交次数而不是仅统计今年的提交次数 (boolean)
  • count_private - 统计私人提交 (boolean)
  • line_height - 设置文本之间的行高 (number)

Repo 卡片专属选项:

  • show_owner - 显示 Repo 的所有者名字 (boolean)

语言卡片专属选项:

  • hide - 从卡片中隐藏指定语言 (Comma seperated values)
  • hide_title - (boolean)
  • hide_border - (boolean)
  • layout - 在两个可用布局 default & compact 间切换
  • card_width - 手动设置卡片的宽度 (number)

⚠️ 重要:Percent Encoding 所指定,语言名称应使用 uri 转义。 (例: c++ 应该是 c%2B%2B, jupyter notebook 应该是 jupyter%20notebook, 等.)


GitHub 更多置顶

GitHub 更多置顶 允许你在使用 GitHub readme profile 时,在个人资料中置顶多于 6 个 repo 。

是的!你不再受限于置顶最多 6 个存储库了。

使用细则

复制粘贴这段代码到你的 README 文件中,并更改链接。

端点: api/pin?username=anuraghazra&repo=github-readme-stats

[![ReadMe Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=github-readme-stats)](https://github.com/anuraghazra/github-readme-stats)

Demo

ReadMe Card

使用 show_owner 变量将 Repo 所有者的用户名包含在内。

ReadMe Card

热门语言卡片

热门语言卡片显示了 GitHub 用户常用的编程语言。

注意:热门语言并不表示我的技能水平或类似的水平,它是用来衡量用户在 github 上拥有最多代码的语言的一项指标,它是 github-readme-stats 的新特性

使用细则

将此代码复制粘贴到您的 README.md 文件中,并修改链接。

端点: api/top-langs?username=anuraghazra

[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats)

隐藏指定语言

可以使用 ?hide=language1,language2 参数来隐藏指定的语言。

[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide=javascript,html)](https://github.com/anuraghazra/github-readme-stats)

紧凑的语言卡片布局

你可以使用 &layout=compact 参数来改变卡片的样式。

[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=compact)](https://github.com/anuraghazra/github-readme-stats)

Demo

Top Langs

  • 紧凑布局

Top Langs


全部 Demos

  • 默认

Anurag's github stats

  • 隐藏指定统计

Anurag's github stats

  • 显示图标

Anurag's github stats

  • 包含全部提交

Anurag's github stats

  • 主题

默认主题中进行选择

Anurag's github stats

  • 渐变

Anurag's github stats

  • 自定义统计卡片

Anurag's github stats

  • 自定义 repo 卡片

Customized Card

  • 热门语言

Top Langs


快速提示 (对齐 Repo 卡片)

你通常无法将图片靠边显示。为此,您可以使用以下方法:

<a href="https://github.com/anuraghazra/github-readme-stats">
  <img align="center" src="https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=github-readme-stats" />
</a>
<a href="https://github.com/anuraghazra/convoychat">
  <img align="center" src="https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=convoychat" />
</a>

自己部署

Check Out Step By Step Video Tutorial By @codeSTACKr

因为 GitHub 的 API 每个小时只允许 5 千次请求,我的 https://github-readme-stats.vercel.app/api 很有可能会触发限制。如果你将其托管在自己的 Vercel 服务器上,那么你就不必为此担心。点击 deploy 按钮来开始你的部署!

注意: 从 #58 开始,我们应该能够处理超过 5 千次的请求,并且不会出现宕机问题 :D

Deploy to Vercel

设置 Vercel 的指导
  1. 前往 vercel.com
  2. 点击 Log in
  3. 点击 Continue with GitHub 通过 GitHub 进行登录
  4. 登录 GitHub 并允许访问所有存储库(如果系统这样提示)
  5. Fork 这个仓库
  6. 返回到你的 Vercel dashboard
  7. 选择 Import Project
  8. 选择 Import Git Repository
  9. 选择 root 并将所有内容保持不变,并且只需添加名为 PAT_1 的环境变量如图所示其中将包含一个个人访问令牌PAT你可以在这里轻松创建(保留默认,并且只需要命名下,名字随便)
  10. 点击 deploy这就完成了查看你的域名就可使用 API 了!

💖 支持这个项目

我尽己所能地进行开源,并且我尽量回复每个在使用项目时需要帮助的人。很明显,这需要时间,但你可以免费享受这些。

然而, 如果你正在使用这个项目并感觉良好,或只是想要支持我继续开发,你可以通过如下方式:

  • 在你的 readme 中使用 github-readme-stats 时,链接指向这里 :D
  • Star 并 分享这个项目 🚀
  • paypal.me/anuraghazra - 你可以通过 PayPal 一次性捐款. 我多半会买一杯 咖啡 茶. 🍵

谢谢! ❤️


https://vercel.com?utm_source=github_readme_stats_team&utm_campaign=oss

欢迎贡献! <3

❤️ 发电,用 JavaScript 制作。