mirror of
https://github.com/anuraghazra/github-readme-stats.git
synced 2024-12-15 06:04:17 +08:00
6bcc98d99d
* `Wakatime` -> `WakaTime` * Fix wrong `WakaTime` brand naming on tr translation * `wakatime stats` -> `WakaTime stats`
373 lines
17 KiB
Markdown
373 lines
17 KiB
Markdown
<p align="center">
|
|
<img width="100px" src="https://res.cloudinary.com/anuraghazra/image/upload/v1594908242/logo_ccswme.svg" align="center" alt="GitHub Readme Stats" />
|
|
<h2 align="center">GitHub Readme Stats</h2>
|
|
<p align="center">Adicione suas estatísticas no GitHub geradas dinamicamente em seus readmes!</p>
|
|
</p>
|
|
<p align="center">
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/actions">
|
|
<img alt="Testes aprovados" src="https://github.com/anuraghazra/github-readme-stats/workflows/Test/badge.svg" />
|
|
</a>
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/graphs/contributors">
|
|
<img alt="GitHub Contributors" src="https://img.shields.io/github/contributors/anuraghazra/github-readme-stats" />
|
|
</a>
|
|
<a href="https://codecov.io/gh/anuraghazra/github-readme-stats">
|
|
<img alt="Tests Coverage" src="https://codecov.io/gh/anuraghazra/github-readme-stats/branch/master/graph/badge.svg" />
|
|
</a>
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/issues">
|
|
<img alt="Issues" src="https://img.shields.io/github/issues/anuraghazra/github-readme-stats?color=0088ff" />
|
|
</a>
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/pulls">
|
|
<img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/anuraghazra/github-readme-stats?color=0088ff" />
|
|
</a>
|
|
<a href="https://securityscorecards.dev/viewer/?uri=github.com/anuraghazra/github-readme-stats">
|
|
<img alt="OpenSSF Scorecard" src="https://api.securityscorecards.dev/projects/github.com/anuraghazra/github-readme-stats/badge" />
|
|
</a>
|
|
<br />
|
|
<br />
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="#demonstração">Ver demonstração</a>
|
|
·
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml">Reportar erros</a>
|
|
·
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.yml">Solicitar recursos</a>
|
|
</p>
|
|
<p align="center">
|
|
<a href="/docs/readme_fr.md">Français</a>
|
|
·
|
|
<a href="/docs/readme_cn.md">简体中文</a>
|
|
·
|
|
<a href="/docs/readme_es.md">Español</a>
|
|
·
|
|
<a href="/docs/readme_de.md">Deutsch</a>
|
|
·
|
|
<a href="/docs/readme_ja.md">日本語</a>
|
|
·
|
|
<a href="/docs/readme_pt-BR.md">Português Brasileiro</a>
|
|
·
|
|
<a href="/docs/readme_it.md">Italiano</a>
|
|
·
|
|
<a href="/docs/readme_kr.md">한국어</a>
|
|
.
|
|
<a href="/docs/readme_nl.md">Nederlands</a>
|
|
.
|
|
<a href="/docs/readme_np.md">नेपाली</a>
|
|
.
|
|
<a href="/docs/readme_tr.md">Türkçe</a>
|
|
</p>
|
|
</p>
|
|
<p align="center">Gostou do projeto? Por favor considere <a href="https://www.paypal.me/anuraghazra">fazer uma doação</a> para ajudar a melhorá-lo!
|
|
|
|
# Características <!-- omit in toc -->
|
|
|
|
- [Cartão de estatísticas do GitHub](#cartão-de-estatísticas-do-github)
|
|
- [Ocultando estatísticas específicas](#ocultando-estatísticas-específicas)
|
|
- [Adicionando contagem de contribuições privadas à contagem total de commits](#adicionando-contagem-de-contribuições-privadas-à-contagem-total-de-commits)
|
|
- [Exibindo ícones](#exibindo-ícones)
|
|
- [Temas](#temas)
|
|
- [Personalização](#personalização)
|
|
- [Pins extras do GitHub](#pins-extras-do-github)
|
|
- [Utilização](#utilização)
|
|
- [Demonstração](#demonstração)
|
|
- [Cartão de principais linguagens de programação](#cartão-de-principais-linguagens-de-programação)
|
|
- [Utilização](#utilização-1)
|
|
- [Ocultar linguagens individualmente](#ocultar-linguagens-individualmente)
|
|
- [Layout de cartão de linguagens compacto](#layout-de-cartão-de-linguagens-compacto)
|
|
- [Demonstração](#demonstração-1)
|
|
- [Estatística semanal WakaTime](#estatística-semanal-wakatime)
|
|
- [Demonstração](#demonstração-2)
|
|
- [Todas as demonstrações](#todas-as-demonstrações)
|
|
- [Dica (Alinhandos os cartões de repositório)](#dica-alinhandos-os-cartões-de-repositório)
|
|
- [Implante em sua própria instância do Vercel](#implante-em-sua-própria-instância-do-vercel)
|
|
- [:sparkling\_heart: Apoie o projeto](#sparkling_heart-apoie-o-projeto)
|
|
|
|
# Cartão de estatísticas do GitHub
|
|
|
|
Copie e cole isso no seu conteúdo de remarcação e é isso. Simples!
|
|
|
|
Mude o valor de `?username=` para o seu nome de usuário no GitHub.
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
_Nota: As classificações são baseadas nas estatísticas do usuário, veja [src/calculateRank.js](../src/calculateRank.js)_
|
|
|
|
### Ocultando estatísticas específicas
|
|
|
|
Para ocultar estatísticas individualmente, você pode passar um parâmetro de consulta `?hide=` com valores separados por vírgula.
|
|
|
|
> Opções: `&hide=stars,commits,prs,issues,contribs`
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
### Adicionando contagem de contribuições privadas à contagem total de commits
|
|
|
|
Adicione a contagem de todas as suas contribuições privadas à contagem total de confirmações usando o parâmetro de consulta `?count_private=true`.
|
|
|
|
_Nota: Se você estiver implantando este projeto, as contribuições privadas serão contadas por padrão; caso contrário, você precisará compartilhar suas contagens de contribuições privadas._
|
|
|
|
> Opções: `&count_private=true`
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
### Exibindo ícones
|
|
|
|
Para habilitar ícones, basta utilizar o parâmetro `show_icons=true` na sua requisição, da seguinte forma:
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
### Temas
|
|
|
|
Com temas predefinidos, pode personalizar a aparência dos cartões sem precisar fazer nenhuma [configuração manual](#personalização).
|
|
|
|
Utilize o parâmetro `?theme=THEME_NAME`, da seguinte forma:
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
#### Todos os temas predefinidos :
|
|
|
|
dark, radical, merko, gruvbox, tokyonight, onedark, cobalt, synthwave, highcontrast, dracula
|
|
|
|
<img src="https://res.cloudinary.com/anuraghazra/image/upload/v1595174536/grs-themes_l4ynja.png" alt="GitHub Readme Stat Themes" width="600px"/>
|
|
|
|
Visualize [todos o temas disponíveis](../themes/README.md) ou o [arquivo de configuração de tema](../themes/index.js), além de **também poder contribuir com novos temas**, se desejar :D
|
|
|
|
### Personalização
|
|
|
|
Personalize a aparência do seu `Stats Card` ou `Repo Card` da maneira que desejar com os parâmetros de URL.
|
|
|
|
#### Opções comuns
|
|
|
|
- `title_color` - Cor do título do cartão _(hex color)_
|
|
- `text_color` - Cor de texto do conteúdo _(hex color)_
|
|
- `icon_color` - Cor dos ícones (se disponível) _(hex color)_
|
|
- `bg_color` - Cor de fundo do cartão _(hex color)_
|
|
- `hide_border` - Esconde a borda do cartão _(boleano)_
|
|
- `theme` - Nome do tema, escolha em [todos os temas disponíveis](../themes/README.md)
|
|
- `cache_seconds` - Defina o cabeçalho do cache manualmente _(min: 14400, max: 86400)_
|
|
- `locale` - defina o idioma no cartão _(por exemplo. cn, de, es, etc.)_
|
|
|
|
> Nota sobre o cache: Cartões de repositório tem um cache padrão de 30 minutos (1800 segundos), se o número a contagem de forks e contagem de estrelas é menor que 1 mil o padrão é 2 horas (7200 segundos). Note também que o cache é limitado a um mínimo de 30 minutos e um máximo de 24 horas.
|
|
|
|
#### Opções exclusivas do cartão de estatísticas:
|
|
|
|
- `hide` - Oculta itens específicos das estatísticas _(Valores separados por vírgulas)_
|
|
- `hide_title` - Ocultar o título _(boolean)_
|
|
- `hide_rank` - Ocultar a classificação _(boolean)_
|
|
- `show_icons` - Mostrar ícones _(boolean)_
|
|
- `include_all_commits` - Contabiliza todos os commits ao invés de apenas os atual ano _(boolean)_
|
|
- `count_private` - Contabiliza commits privados _(boolean)_
|
|
- `line_height` - Define a altura do espaçamento entre o texto _(number)_
|
|
|
|
#### Opções exclusivas do cartão de repositórios:
|
|
|
|
- `show_owner` - Exibir o nome da pessoa a quem o repositório pertence _(boolean)_
|
|
|
|
#### Opções exclusivas do cartão de linguagens:
|
|
|
|
- `hide` - Oculta linguagens específicas _(Valores separados por vírgulas)_
|
|
- `hide_title` - Oculta o título _(boolean)_
|
|
- `layout` - Alternar entre os cinco layouts disponíveis `normal` & `compact` & `donut` & `donut-vertical` & `pie`
|
|
- `card_width` - Define a largura do cartão manualmente _(number)_
|
|
|
|
> :warning: **Importante:**
|
|
> Nomes de linguagens devem ser uma sequência escapada de URI, como específicado em [Codificação por cento](https://pt.wikipedia.org/wiki/Codificação_por_cento)
|
|
> (Ou seja: `c++` deve se tornar `c%2B%2B`, `jupyter notebook` deve se tornar `jupyter%20notebook`, etc.)
|
|
|
|
---
|
|
|
|
# Pins extras do GitHub
|
|
|
|
Os Pins extras do GitHub permitem fixar mais de 6 repositórios no seu perfil usando um perfil README.me do GitHub.
|
|
|
|
Uhu! Você não está mais limitado a 6 repositórios fixados.
|
|
|
|
### Utilização
|
|
|
|
Copie e cole esse código no seu README.md e altere os atributos.
|
|
|
|
Endpoint: `api/pin?username=anuraghazra&repo=github-readme-stats`
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### Demonstração
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
Utilize a variável [show_owner](#personalização) para incluir o nome de usuário do proprietária do repositório
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
# Cartão de principais linguagens de programação
|
|
|
|
Exibe uma métrica de linguagens de programação mais usadas pelo usuário do GitHub.
|
|
|
|
_Nota: As principais linguagens de programação não fazem declarações sobre habilidades pessoais ou similares, é apenas uma figura-chave com base nas estatísticas do GitHub do usuário indicando a frequência com que cada uma foi utilizada._
|
|
|
|
### Utilização
|
|
|
|
Copie e cole esse código no seu README.md e altere os atributos.
|
|
|
|
Endpoint: `api/top-langs?username=anuraghazra`
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### Ocultar linguagens individualmente
|
|
|
|
Utilize o parâmetro `?hide=language1,language2` para ocultar linguagens específicas.
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### Layout de cartão de linguagens compacto
|
|
|
|
Utilize a opção `&layout=compact` para mudar o layout do cartão.
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### Demonstração
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
- Layout compacto
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
# Estatística semanal WakaTime
|
|
|
|
Altere o valor de `?username=` para o seu username do WakaTime.
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### Demonstração
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
---
|
|
|
|
|
|
|
|
### Todas as demonstrações
|
|
|
|
- Padronizado
|
|
|
|
|
|
|
|
- Ocultando estatísticas específicas
|
|
|
|
|
|
|
|
- Mostrando ícones
|
|
|
|
|
|
|
|
- Incluir todos os commits
|
|
|
|
|
|
|
|
- Temas
|
|
|
|
Escolha entre um dos [temas predefinidos](#temas)
|
|
|
|
|
|
|
|
- Personalizando o cartão de estatísticas
|
|
|
|
|
|
|
|
- Customizando o cartão de repositório
|
|
|
|
|
|
|
|
- Principais linguagens
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
---
|
|
|
|
### Dica (Alinhandos os cartões de repositório)
|
|
|
|
Por padrão, você não poderá organizar as imagens lado a lado. Para fazer isso, você pode usar a seguinte abordagem:
|
|
|
|
```html
|
|
<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>
|
|
```
|
|
|
|
## Implante em sua própria instância do Vercel
|
|
|
|
#### [Check Out Step By Step Video Tutorial By @codeSTACKr](https://youtu.be/n6d4KHSKqGk?t=107)
|
|
|
|
Como a API do GitHub permite apenas 5 mil solicitações por hora, é possível que minha `https://github-readme-stats.vercel.app/api` atinja a cota limite. Se hospedar em seu próprio servidor Vercel, não precisará se preocupar com nada. Clique no botão de implantação para começar!
|
|
|
|
Nota: Desde [#58](https://github.com/anuraghazra/github-readme-stats/pull/58) há possibilidade de lidar com mais de 5 mil chamadas por hora, sem interrupções :D
|
|
|
|
[](https://vercel.com/import/project?template=https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
<details>
|
|
<summary>Guia de configuração do Vercel</summary>
|
|
|
|
1. Acesse [vercel.com](https://vercel.com/)
|
|
1. Clique em `Login`
|
|
|
|
1. Acesse com o GitHub clicando em `Continue with GitHub`
|
|
|
|
1. Entre no GitHub e permita acesso a todos os repositórios, se solicitado
|
|
1. Faça Fork neste repositório
|
|
1. Volte ao seu [painel principal do Vercel](https://vercel.com/dashboard)
|
|
1. Selecione `Import Project`
|
|
|
|
1. Selecione `Import Git Repository`
|
|
|
|
1. Selecione a raiz e mantenha tudo como está, basta adicionar sua variável de ambiente chamada PAT_1 (que será exibida), que conterá um token de acesso pessoal (PAT), que você pode criar facilmente [aqui](https://github.com/settings/tokens/new) (deixe tudo como está, apenas dê um nome, que pode ser o que você quiser)
|
|
|
|
1. Clique em `deploy` e já estará tudo pronto. Veja seus domínios para usar a API!
|
|
|
|
</details>
|
|
|
|
## :sparkling_heart: Apoie o projeto
|
|
|
|
Disponibilizo como código aberto quase tudo o que posso e tento responder a todos que precisam de ajuda para utilizar esses projetos. Claro,
|
|
isso demanda tempo. Utilize este serviço gratuitamente.
|
|
|
|
No entanto, se você utilizar este projeto e estiver satisfeito com ele, ou apenas quiser me encorajar a continuar criando coisas, existem algumas formas fazê-lo:
|
|
|
|
- Dando os devidos créditos ao usar github-readme-stats no seu README.me, adicionando uma referência ao projeto :D
|
|
- Dando uma estrela (Starring) e compartilhando o projeto 🚀
|
|
- [](https://www.paypal.me/anuraghazra) - Você pode fazer doações únicas via PayPal. Provavelmente vou comprar um ~~café~~ chá. :tea:
|
|
|
|
Obrigado! :heart:
|
|
|
|
---
|
|
|
|
[](https://vercel.com?utm_source=github_readme_stats_team&utm_campaign=oss)
|
|
|
|
Contribuições são bem-vindas! <3
|
|
|
|
Feito com :heart: e JavaScript.
|