diff --git a/docs/readme_ru.md b/docs/readme_ru.md new file mode 100644 index 0000000000000..4a21f9499c9fc --- /dev/null +++ b/docs/readme_ru.md @@ -0,0 +1,1013 @@ +

+ GitHub Readme Stats +

GitHub Readme Stats

+

Сделай динамически обновляемую статистику в своем README!

+

+

+ + Tests Passing + + + GitHub Contributors + + + Tests Coverage + + + Issues + + + GitHub pull requests + + + OpenSSF Scorecard + +
+
+ + + +

+ +

+ Посмотреть демо + · + Сообщить об ошибке + · + Предложить функцию + · + FAQ + · + Задать вопрос +

+

+ Deutsch + · + English + · + Español + · + Français + · + Italiano + · + Nederlands + · + Português Brasileiro + · + Türkçe + · + Русский + · + Український + · + नेपाली + · + 日本語 + · + 简体中文 + · + 한국어 +

+

+ + + +> [!IMPORTANT]\ +>

Обратите внимание, что переводы могут быть устаревшими, постарайтесь по возможности использовать английскую версию

+ +

+ +# Перевод + +Перевод выполнен [senymama](https://github.com/senymama) и может содержать ошибки и быть устаревшим (дату последнего обновления можно узнать в информации о последнем коммите этого фйла). В этом случае отправляйте issues в мой форк репозитория, поскольку [авторы](https://github.com/anuraghazra/github-readme-stats/graphs/contributors) не имеют отношения к этому переводу. + +Также мой перевод может немного отличается от оригинальной документации, потому что в некоторых моментах авторская документация мне показалось недостаточно наглядной. (Например я добавил пример баннера после описания каждого параметра, и все примеры теперь в теге \
, чтобы документация занимала меньше места и была более читаемой) + +P.s. (Это я пишу уже после завершения перевода) +Перевести 1000 строк markdown кода на русский у меня заняло около 6 часов, и не меньше займет перевод на украинский. +Если вы хотите поддержать мои старания и замотивировать продолжать поддерживать эту документацию вы можете: + +* Посмотреть мои другие репозитории и поставить звезду на те, которые вам покажутся интересными + +Возможно я добавлю дополнительные способы поддержать меня, но пока мне хватит активности на моем профиле, это действительно очень замотивирует меня как продолжать этот проект, так и делать новые и делать их более качественно. + +# Функции (фичи) + +- [Перевод](#перевод) +- [GitHub Stats Card (баннер статистики)](#github-stats-card-баннер-статистики) + - [Скрытие определенных данных](#скрытие-определенных-данных) + - [Показ дополнительных данных](#показ-дополнительных-данных) + - [Отображение иконок](#отображение-иконок) + - [Темы](#темы) +- [GitHub Extra Pins (Добавочные закрепы)](#github-extra-pins-добавочные-закрепы) + - [Использование](#использование) +- [GitHub Gist Pins (Закрепы gits'ов)](#github-gist-pins-закрепы-gitsов) + - [Использование](#использование-1) +- [Top Languages Card (Баннер самых используемые языков)](#top-languages-card-баннер-самых-используемые-языков) + - [Использование](#использование-2) + - [Алгоритм сбора статистики](#алгоритм-сбора-статистики) + - [Исключить отдельные репозитории](#исключить-отдельные-репозитории) + - [Скрыть определенные языки](#скрыть-определенные-языки) + - [Показать больше языков](#показать-больше-языков) + - [Компактный макет](#компактный-макет) + - [Макет с круговой диаграммой](#макет-с-круговой-диаграммой) + - [Вертикальный макет с круговой диаграммой](#вертикальный-макет-с-круговой-диаграммой) + - [Макет с диаграммой-пирогом](#макет-с-диаграммой-пирогом) + - [Макет без шкалы](#макет-без-шкалы) +- [Баннер статистики WakaTime](#баннер-статистики-wakatime) + - [Макет без шкалы](#макет-без-шкалы-1) + - [Компактный макет](#компактный-макет-1) +- [Кастомизация](#кастомизация) + - [Общие настройки](#общие-настройки) + - [Градиент на bg\_color](#градиент-на-bg_color) + - [Доступные языки](#доступные-языки) + - [Эксклюзивные настройки баннера статистики](#эксклюзивные-настройки-баннера-статистики) + - [Эксклюзивные настройки Repo Card](#эксклюзивные-настройки-repo-card) + - [Эксклюзивные настройки Gist Card](#эксклюзивные-настройки-gist-card) + - [Эксклюзивные настройки Language Card](#эксклюзивные-настройки-language-card) + - [Эксклюзивные настройки WakaTime Card](#эксклюзивные-настройки-wakatime-card) +- [All Demos](#all-demos) + - [Быстрый совет (выравнивание баннеров)](#быстрый-совет-выравнивание-баннеров) +- [Развертывание собственного экземпляра](#развертывание-собственного-экземпляра) + - [На Vercel](#на-vercel) + - [:film\_projector: Пошаговый видеоурок от @codeSTACKr](#film_projector-пошаговый-видеоурок-от-codestackr) + - [На других платформах](#на-других-платформах) + - [Отключение ограничений скорости](#отключение-ограничений-скорости) + - [Держите свой форк в актуальном состоянии](#держите-свой-форк-в-актуальном-состоянии) +- [:sparkling\_heart: Поддержать проект](#sparkling_heart-поддержать-проект) + +# Важно + +> [!IMPORTANT]\ +> Поскольку GitHub API [разрешает только 5 тысяч запросов в час для одной учетной записи](https://docs.github.com/en/graphql/overview/resource-limitations), общедоступный Vercel, размещенный на `https://github-readme-stats.vercel.app/api` может достичь ограничения (см. [#1471](https://github.com/anuraghazra/github-readme-stats/issues/1471)). Чтобы это избежать мы используем кэширование (см. https://github.com/anuraghazra/github-readme-stats#common-options). Вы можете избежать ограничения, развернув [свой собственный экземпляр Vercel](#disable-rate-limit-protections). + +Uptime Badge + +> [!IMPORTANT]\ +> Мы маленькая команда, поэтому при расстановки приоритетов задач мы полагаемся на голоса :+1:. Мы используем "Top Issues dashboard" для отслеживания спроса комьюнити (см. [#1935](https://github.com/anuraghazra/github-readme-stats/issues/1935)). Голосуйте за за интересующие вас issues и pull request. В первую очередь мы будет работать над самыми популярными вопросами. + +# GitHub Stats Card (баннер статистики) + +Скопируйте и вставьте это в свой markdown файл, и все. Да, так просто! + +Замените значение `?username=` на свой GitHub username. + +```md +[![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats) +``` +
+:eyes: Простейший пример + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra) +
+ + +> [!WARNING]\ +> По умолчанию на карточке статистики отображаются только такие статистические данные, как звезды, коммиты и запросы на включение из общедоступных репозиториев. Чтобы отобразить личную статистику на карточке статистики, вам следует [развернуть свой собственный экземпляр](#deploy-on-your-own), используя свой GitHub API токен. + +> [!NOTE]\ +> Ранги: S (лучший 1%), A+ (12.5%), A (25%), A- (37.5%), B+ (50%), B (62.5%), B- (75%), C+ (87.5%) and C (everyone). Эта схема рангов основана на [системе японской академической оценки](https://wikipedia.org/wiki/Academic_grading_in_Japan). Глобальные данне рассчитываются как взвешенная сумма для каждой статистики (количество коммитов, запросов на включение, обзоров, проблем, звезд и подписчиков), на основе кумулятивной функции распределения [экспоненты](https://wikipedia. org/wiki/exponential_distribution) и [log-normal](https://wikipedia.org/wiki/Log-normal_distribution). Реализацию можно изучить здесь: [src/calculateRank.js](https://github.com/anuraghazra/github-readme-stats/blob/master/src/calculateRank.js). Круг вокруг рейтинга показывает 100 минус глобальный процент. + +### Скрытие определенных данных + +Вы можете добавить параметр `&hide=` чтобы скрыть любую статистику. Значения следует разделять запятыми. + +> Опции: `&hide=stars,commits,prs,issues,contribs` + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&hide=contribs,prs) +``` + +
+:eyes: Показать пример + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&hide=contribs,prs) +
+ +### Показ дополнительных данных + +Вы можете добавить параметр `&show=` чтобы добавить любую статистику. Значения следует разделять запятыми. + +> Опции: `&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage` + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage) +``` + +
+:eyes: Показать пример +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage) + +
+ +### Отображение иконок + +Чтобы включить иконки, добавьте параметр `&show_icons=true`. + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true) +``` + +
+:eyes: Показать пример + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true) +
+ +### Темы + +Благодаря встроенным темам вы можете настроить внешний вид карты без какой-либо [ручной настройки](#кастомизация). + +Используйте параметр `&theme=THEME_NAME` так: + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=radical) +``` + +
+:eyes: Показать пример +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=radical) +
+ +#### Все встроенные темы + +GitHub Readme Stats имеет несколько встроенных тем (такие как `dark`, `radical`, `merko`, `gruvbox`, `tokyonight`, `onedark`, `cobalt`, `synthwave`, `highcontrast`, `dracula`). + + +
+:eyes: Посмотреть + +GitHub Readme Stats Themes + +
+ +Вы можете посмотреть превью [всех доступных тем](themes/README.md) или [файл конфигурации темы](themes/index.js). Обратите внимание, что мы приостановили добавление новых тем, чтобы уменьшить затраты на обслуживание; все запросы на включение, связанные с новыми темами, будут закрыты. + +#### Адаптивная тема баннера + + +
+:eyes: Показать пример + +[![Anurag's GitHub stats-Dark](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=dark#gh-dark-mode-only)](https://github.com/anuraghazra/github-readme-stats#responsive-card-theme#gh-dark-mode-only) +[![Anurag's GitHub stats-Light](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=default#gh-light-mode-only)](https://github.com/anuraghazra/github-readme-stats#responsive-card-theme#gh-light-mode-only) + +
+ +Поскольку GitHub загружает баннеры из своего [CDN](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/about-anonymized-urls), нельзя определить тему browser/GitHub со стороны сервера. Однако существует несколько способов, для создания динамических баннеров на стороне клиента. + +##### Использование прозрачной темы + +Мы добавили `transparent` тему без фона. Эта тем оптимизирована так, чтобы хорошо выглядеть как на светлых, так и на темных темах GitHub. Используйте параметр `&theme=transparent` так: + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=transparent) +``` + +
+:eyes: Показать пример + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=transparent) + +
+ +##### Добавит прозрачный альфа-канал в тему bg\_color + +Вы можете использовать параметр `bg_color`, чтобы сделать любую из [доступных тем](themes/README.md) прозрачной. Это делается путем установки `bg_color` в цвет с прозрачным альфа-каналом (т.е. `bg_color=00000000`): + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&bg_color=00000000) +``` + +
+:eyes: Показать пример + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&bg_color=00000000) + +
+ +##### Использовать тэг темы GitHub + +Вы можете использовать тэги [темы GitHub](https://github.blog/changelog/2021-11-24-specify-theme-context-for-images-in-markdown/) для автоматического переключения темы в зависимости от темы пользователя. Для этого добавьте `#gh-dark-mode-only` или `#gh-light-mode-only` в конец URL изображения. Этот тэг определяет будет ли отображаться это изображение для пользователей со светлой или темной темой соответственно. + +```md +[![Anurag's GitHub stats-Dark](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=dark#gh-dark-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-dark-mode-only) +[![Anurag's GitHub stats-Light](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=default#gh-light-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-light-mode-only) +``` + +
+:eyes: Показать пример + +[![Anurag's GitHub stats-Dark](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=dark#gh-dark-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-dark-mode-only) +[![Anurag's GitHub stats-Light](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=default#gh-light-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-light-mode-only) + +
+ +##### Использовать новую медиа-функцию GitHub + +Вы можете использовать [новую GitHub медиа-функцию](https://github.blog/changelog/2022-05-19-specify-theme-context-for-images-in-markdown-beta/) в HTML, чтобы указать для для каких пользователей следует отображать изображение. Это делается с помощью HTML-тега `` в сочетании с `prefers-color-scheme`. + +```html + + + + + +``` + +
+:eyes: Показать пример + + + + + + + +
+ +# GitHub Extra Pins (Добавочные закрепы) + +GitHub extra pins позволяет вам закрепить более 6 репозиториев в вашем профиле используя Github readme profile. +Да! Вы больше не ограниченны всего 6-ю репозиториями. +### Использование + +Вставьте этот код в ваш readme и отредактируйте ссылки. + +Конечная точка: `api/pin/?username=anuraghazra&repo=github-readme-stats` + +```md +[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=github-readme-stats)](https://github.com/anuraghazra/github-readme-stats) +``` + + +
+:eyes: Показать пример + +![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra\&repo=github-readme-stats) + +
+ +Используйте опцию [show\_owner](#repo-card-exclusive-options) для добавления имени +пользователя владельца репозитория. + +```md +![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra\&repo=github-readme-stats\&show_owner=true) +``` + +
+:eyes: Показать пример + +![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra\&repo=github-readme-stats\&show_owner=true) + +
+ +# GitHub Gist Pins (Закрепы gits'ов) + +GitHub gist pins позволяет вам закрепить gits в вашем Github профиле используя Github readme profile. + +### Использование + +Вставьте этот код в ваш readme и отредактируйте ссылки. + +Конечная точка: `api/gist?id=bbfce31e0217a3689c8d961a356cb10d` + +```md +[![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d)](https://gist.github.com/Yizack/bbfce31e0217a3689c8d961a356cb10d/) +``` + +
+:eyes: Показать пример + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d) + +
+ +Используйте опцию [show\_owner](#gist-card-exclusive-options) для добавления имени +пользователя владельца gits'а. + +```md +[![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d\&show_owner=true)](https://gist.github.com/Yizack/bbfce31e0217a3689c8d961a356cb10d/) +``` + +
+:eyes: Показать пример + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d\&show_owner=true) + +
+ +# Top Languages Card (Баннер самых используемые языков) + +На баннере "самые популярные языки" показаны наиболее часто использованные языки программирования пользователя. + +> [!WARNING]\ +> По умолчанию этот баннер отображает статистику только из общедоступных репозиториев. Если вы хотите добавить информацию из частных репозиториев, вам нужно [развернуть свой экземпляр](#deploy-on-your-own) используя собственный GitHub API токен. + +> [!NOTE]\ +> Этот баннер не отображает уровень навыков пользователя, это показатель GitHub, показывающий на каких языках больше всего кода в репозиториях пользователя. Это новая функция github-readme-stats. + +> [!WARNING]\ +> Этот баннер отображает информацию только из ваших не форкнутых репозиториев, не зависимо от того, кто является автором коммитов. Он не включает ваши вклады в репозиториях других пользователей/организаций. Сейчас нет возможности получить эту информацию через GitHub API. Если вы хотите улучшить это поведение вы можете поддержать [запрос этой функции](https://github.com/orgs/community/discussions/18230) созданный в сообществе GitHub [@rickstaa](https://github.com/rickstaa) + +> [!WARNING]\ +> Сейчас этот баннер показывает данные только о первых 100 репозиториях, это связанно с ограничениями API GitHub, которое приводит к простоям общественных экземпляров (см. [#1471](https://github.com/anuraghazra/github-readme-stats/issues/1471)). В будущем это поведение будет улучшено путем действий GitHub'а или добавлением переменных среды для экземпляров пользователей. + +### Использование + +Вставьте этот код в ваш readme и отредактируйте ссылки. + +Конечная точка: `api/top-langs?username=anuraghazra` + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra) + +
+ + +### Алгоритм сбора статистики + +Для расчета процентного содержания языков на языковой карте мы используем следующий алгоритм: + +```js +ranking_index = (byte_count ^ size_weight) * (repo_count ^ count_weight) +``` + +По умолчанию для определения процентного содержания, отображаемого на баннере, используется только количество байтов (т.е. `size_weight=1` и `count_weight=0`). Однако вы можете использовать параметры `&size_weight=` и `&count_weight=` для взвешенного расчета процента. Значения должны быть положительными действительными числами. [Более подробная информация]((https://github.com/anuraghazra/github-readme-stats/issues/1600#issuecomment-1046056305)). + +* `&size_weight=1&count_weight=0` - *(по умолчанию)* Подсчет по количеству байтов. +* `&size_weight=0.5&count_weight=0.5` - *(рекомендованное)* Используется как количество байтов, так и количество репозиториев. +* `&size_weight=0&count_weight=1` - Подсчет по количеству репозиториев + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&size_weight=0.5&count_weight=0.5) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&size_weight=0.5&count_weight=0.5) + +
+ +### Исключить отдельные репозитории + +Используйте параметр `&exclude_repo=repo1,repo2` чтобы исключить определенные репозитории. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&exclude_repo=github-readme-stats,anuraghazra.github.io) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&exclude_repo=github-readme-stats,anuraghazra.github.io) + +
+ +### Скрыть определенные языки + +Используйте параметр `&hide=language1,language2` чтобы скрыть определенные языки. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide=javascript,html) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide=javascript,html) + +
+ +### Показать больше языков + +Используйте опцию `&langs_count=`, чтобы определить количество языков, отображаемых на баннере. Допустимые значения - целые числа от 1 до 20 (включительно). По умолчанию установлено `5` для `normal`/`donut` и `6` для остальных макетов.s. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&langs_count=8) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&langs_count=8) + +
+ +### Компактный макет + +Используйте параметр `&layout=compact` чтобы изменить макет на компактный. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=compact) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=compact) + +
+ +### Макет с круговой диаграммой + +Используйте параметр `&layout=donut` чтобы изменить макет. + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut) + +
+ +### Вертикальный макет с круговой диаграммой + +Используйте параметр `&layout=donut-vertical` чтобы изменить макет. + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut-vertical)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut-vertical) + +
+ +### Макет с диаграммой-пирогом + +Используйте параметр `&layout=pie` чтобы изменить макет. + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=pie)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показать пример + +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=pie)](https://github.com/anuraghazra/github-readme-stats) + +
+ +### Макет без шкалы + +Используйте параметр `&hide_progress=true` чтобы скрыть шкалу и проценты (макет будет автоматически установлен на `compact`) + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide_progress=true) +``` + +
+:eyes: Показать пример + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide_progress=true) + +
+ +# Баннер статистики WakaTime + +> [!WARNING]\ +> Имейте в виду, что в настоящее время отображаются данные тотлько из общедоступных профилей WakaTime. Поэтому убедитесь, что в настройках профиля WakaTime включены `Display code time publicly` и `Display languages, editors, os, categories publicly` одновременно. + +Измените значение `?username=` на ваше имя юзернейм в [WakaTime](https://wakatime.com). + +```md +[![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показать пример + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs) + +
+ +### Макет без шкалы + +Используйте параметр `&hide_progress=true` чтобы скрыть шкалы + +```md +[![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&hide_progress=true)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показать пример + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&hide_progress=true) + +
+ +### Компактный макет + +Используйте параметр `&layout=compact` чтобы изменить макет на компактный. + +```md +[![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&layout=compact)](https://github.com/anuraghazra/github-readme-stats) + +``` +
+:eyes: Показать пример + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&layout=compact) +
+ +# Кастомизация + +Вы можете настроить внешний вид всех своих карточек по своему усмотрению с помощью параметров URL. + +## Общие настройки + +| Параметр | Описание | Тип | Стандартное значение | +| --- | --- | --- | --- | +| `title_color` | Цвет названия баннера. | string (hex color) | `2f80ed` | +| `text_color` | Основной цвет текста. | string (hex color) | `434d58` | +| `icon_color` | Цвет иконок если возможно. | string (hex color) | `4c71f2` | +| `border_color` | Цвет границы баннера. Не применится, если `hide_border` включен. | string (hex color) | `e4e2e2` | +| `bg_color` | Цвет заднего фона. | string (hex color или градиент в формате *angle,start,end*) | `fffefe` | +| `hide_border` | Скрыть границу баннера. | boolean | `false` | +| `theme` | Название темы, выберете из [всех доступных тем](themes/README.md). | enum | `default` | +| `cache_seconds` | Длительность кэширования в секундах (min: 21600 (6 часов), max: 86400 (24 часа)). | integer | `21600` | +| `locale` | Устанавливает язык в карточке, вы можете посмотреть полный [список доступных языков](#available-locales). | enum | `en` | +| `border_radius` | Скругление углов. | number | `4.5` | + +> [!WARNING]\ +> Мы используем кеширование, чтобы снизить нагрузку на наши серверы (см. [#1371](https://github.com/anuraghazra/github-readme-stats/issues/1471#issuecomment-1271551425)). Наши баннеры имеют длительность кеша 6 часов (21600 секунд). Обратите внимание, что длительность кэша может быть от 6 до 24 часов. Если вы хотите чтобы ваша статистика обновлялась чаще, вы можете [развернуть свой экземпляр](#deploy-on-your-own) и установить [переменную среды](#disable-rate-limit-protections) `CACHE_SECONDS` по своему усмотрению. + +### Градиент на bg\_color + +Вам необходимо указать несколько значений, разделенных запятыми в таком формате: + + &bg_color=DEG,COLOR1,COLOR2,COLOR3...COLOR10 + +### Доступные языки + +Список доступных языков: + + + +
+ +| Код | Язык | +| --- | --- | +| `en` | Английский | +| `ar` | Арабский | +| `bn` | Бенгальский | +| `my` | Бирманский | +| `hu` | Венгерский | +| `vi` | Вьетнамский | +| `nl` | Голландский | +| `el` | Греческий | +| `id` | Индонезийский | +| `es` | Испанский | + + + +| Code | Locale | +| --- | --- | +| `it` | Итальянский | +| `cn` | Китайский | +| `zh-tw` | Китайский (Тайваньский) | +| `kr` | Корейский | +| `ml` | Малаялам | +| `de` | Немецкий | +| `np` | Непальский | +| `pl` | Польский | +| `pt-pt` | Португальский (Португалия) | +| `pt-br` | Португальский (Бразилия) | + + + +| Code | Locale | +| --- | --- | +| `ru` | Русский | +| `sk` | Словакский | +| `tr` | Турецкий | +| `uz` | Узбекский | +| `uk-ua` | Украинский | +| `fr` | Французский | +| `cs` | Чешский | +| `ja` | Японский | +| `se` | Шведский | + +
+ +Если мы не поддерживаем ваш язык, рассмотрите возможность внести свой вклад! Более подробную информацию о том, как это сделать, вы можете найти в наших [рекомендациях для авторов](CONTRIBUTING.md#translations-contribution). + +## Эксклюзивные настройки баннера статистики + +| Параметр | Описание | Тип | Стандартное значение | +| --- | --- | --- | --- | +| `hide` | Спрятать [определенные значения](#hiding-individual-stats) статистики. | string (comma-separated values) | `null` | +| `hide_title` | Спрятать название вашего баннера. | boolean | `false` | +| `card_width` | Ширина баннера в пикселях. | number | `500px (примерно)` | +| `hide_rank` | Скрывает ранг и автоматически уменьшить размер баннера. | boolean | `false` | +| `rank_icon` | Установить альтернативную иконку ранга (`github`, `percentile` или `default`). | enum | `default` | +| `show_icons` | Показывать иконки рядом со всеми данными. | boolean | `false` | +| `include_all_commits` | Подсчитайте общее количество коммитов, а не только коммиты текущего года. | boolean | `false` | +| `line_height` | Межстрочный отступ. | integer | `25` | +| `exclude_repo` | Исключает указанные репозитории. | string (значения через запятую) | `null` | +| `custom_title` | Установить свое название баннера. | string | ` GitHub Stats` | +| `text_bold` | Использовать жирный шрифт. | boolean | `true` | +| `disable_animations` | Отключает всю анимацию на баннере. | boolean | `false` | +| `ring_color` | Цвет кольца ранга. | string (hex color) | `2f80ed` | +| `number_format` | Переключает между двумя доступными форматами отображения значений баннера: «короткий» (т.е. «6,6К») или «длинный» (т.е. «6626»). | enum | `short` | +| `show` | Показывает [дополнительные элементы](#showing-additional-individual-stats) на карточке статистики (`reviews`, `discussions_started`, `discussions_ Answered`, `prs_merged` или `prs_merged_percentage`). | string (comma-separated values) | `null` | + +> [!NOTE]\ +> Если hide\_rank=`true`, минимальная ширина карточки составляет 270 пикселей + длина заголовка и отступы. + +## Эксклюзивные настройки Repo Card + +| Параметр | Описание | Тип | Стандартное значение | +| --- | --- | --- | --- | +| `show_owner` | Показать имя владельца репозитория. | boolean | `false` | +| `description_lines_count` | Ручная установка количество строк описания. Значения должно быть между 1 и 3. Если параметр не указан, значение будет регулироваться автоматически. | number | `null` | + +## Эксклюзивные настройки Gist Card + +| Параметр | Описание | Тип | Стандартное значение | +| --- | --- | --- | --- | +| `show_owner` | Показать имя владельца gist'а. | boolean | `false` | + +## Эксклюзивные настройки Language Card + +| Параметр | Описание | Тип | Стандартное значение | +| --- | --- | --- | --- | +| `hide` | Скрыть [указанные языки](#hide-individual-languages) с баннера. | string (значения, разделенные запятыми) | `null` | +| `hide_title` | Скрыть название баннера. | boolean | `false` | +| `layout` | Установить один из 5 макетов: `normal` / `compact` / `donut` / `donut-vertical` / `pie`. | enum | `normal` | +| `card_width` | Установить ширину баннера. | number | `300` | +| `langs_count` | Установить количество отображаемых языков (значение между 1 и 20). | integer | `5` для `normal` и `donut`, `6` для остальных макетов | +| `exclude_repo` | Исключить указанные репозитория. | string (значения, разделенные запятыми) | `null` | +| `custom_title` | Установить свое название баннера. | string | `Most Used Languages` | +| `disable_animations` | Отключить все анимации баннера. | boolean | `false` | +| `hide_progress` | Используется в компактном макете, скрывает шкалы и проценты, оставляя только названия языков. | boolean | `false` | +| `size_weight` | Настраивает алгоритм статистики языка (см. [Language stats algorithm](#language-stats-algorithm)). | integer | `1` | +| `count_weight` | Настраивает алгоритм статистики языка (см. [Language stats algorithm](#language-stats-algorithm)). | integer | `0` | + +> [!WARNING]\ +> Названия языков должны быть URI-escaped, как указано в [процентном кодировании](https://en.wikipedia.org/wiki/Percent-encoding) +> (т.е.: `c++` должен стать `c%2B%2B`, `jupyter notebook` должен стать `jupyter%20notebook`, и т.д.) +> Используйте [urlencoder.org](https://www.urlencoder.org/) чтобы делать это автоматически . + +## Эксклюзивные настройки WakaTime Card + +| Параметр | Описание | Тип | Стандартное значение | +| --- | --- | --- | --- | +| `hide` | Скрыть указанные языки с баннера. | string (значения, разделенные запятыми) | `null` | +| `hide_title` | Скрыть название баннера. | boolean | `false` | +| `line_height` | Установить отступ между строк. | integer | `25` | +| `hide_progress` | Скрыть шкалу и проценты. | boolean | `false` | +| `custom_title` | Установить свое название баннера. | string | `WakaTime Stats` | +| `layout` | Установить один из доступных макетов: `default` / `compact`. | enum | `default` | +| `langs_count` | Ограничить количество языков на баннере, по умолчанию отображаются все. | integer | `null` | +| `api_domain` | Установить свой домен API для баннера, например использовать сервисы [Hakatime](https://github.com/mujx/hakatime) или [Wakapi](https://github.com/muety/wakapi) | string | `wakatime.com` | +| `display_format` | Установить формат отображения статистики. Выберете `time` или `percent` для отображения статистики по времени или проценту. | enum | `time` | +| `disable_animations` | Отключить все анимации баннера. | boolean | `false` | + +*** + +# All Demos +
+:eyes: Показать + +* Default + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra) + +* Hiding specific stats + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&hide=contribs,issues) + +* Showing additional stats + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage) + +* Showing icons + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&hide=issues\&show_icons=true) + +* Shows Github logo instead rank level + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&rank_icon=github) + +* Shows user rank percentile instead of rank level + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&rank_icon=percentile) + +* Customize Border Color + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&border_color=2e4058) + +* Include All Commits + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&include_all_commits=true) + +* Themes + +Choose from any of the [default themes](#themes) + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=radical) + +* Gradient + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&bg_color=30,e96443,904e95\&title_color=fff\&text_color=fff) + +* Customizing stats card + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api/?username=anuraghazra\&show_icons=true\&title_color=fff\&icon_color=79ff97\&text_color=9f9f9f\&bg_color=151515) + +* Setting card locale + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api/?username=anuraghazra\&locale=es) + +* Customizing repo card + +![Customized Card](https://github-readme-stats.vercel.app/api/pin?username=anuraghazra\&repo=github-readme-stats\&title_color=fff\&icon_color=f9f9f9\&text_color=9f9f9f\&bg_color=151515) + +* Gist card + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d) + +* Customizing gist card + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d&theme=calm) + +* Top languages + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra) + +* WakaTime card + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs) + +
> + +*** + +## Быстрый совет (выравнивание баннеров) + +По умолчанию GitHub оставляет зазор между баннерами. Чтобы разместить их вплотную используйте такой подход: + +```html + + + + + + +``` + +```html + + + + + + +``` + +
+:eyes: Показать пример + +* По умолчанию + +[![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats) +[![Anurag's Top Langs](https://github-readme-stats.vercel.app/api/top-langs?username=anuraghazra&layout=compact&langs_count=8&card_width=320)](https://github.com/anuraghazra/github-readme-stats) + +* Используя предложенный подход + + + + + + + + +*** + + + + + + + + +
+ +# Развертывание собственного экземпляра + +## На Vercel + +### :film\_projector: [Пошаговый видеоурок от @codeSTACKr](https://youtu.be/n6d4KHSKqGk?t=107) + +Поскольку GitHub API разрешает только 5 тысяч запросов в час, мой `https://github-readme-stats.vercel.app/api` сталкивается с ограничениями в скорости. +Если вы развернете собственный экземпляр на своем сервере Vercel, вам не о чем беспокоится. +Нажмите кнопку развертывания, чтобы начать! + +> [!NOTE]\ +> Начиная с [#58](https://github.com/anuraghazra/github-readme-stats/pull/58), мы сможем обработать более 5 тысяч запросов в час и иметь меньше проблем с ограничениями :grin:. + +> [!NOTE]\ +> Если вы используете тарифный план [Pro (т.е. платный)](https://vercel.com/pricing), то значение [maxDuration](https://vercel.com/docs/concepts/projects/project-configuration#value-definition) в [vercel.json](https://github.com/anuraghazra/github-readme-stats/blob/master/vercel.json) может быть увеличено, если время ожидания вашего экземпляра часто истекает во время запроса баннера. +> Рекомендуется поддерживать это значение ниже `30` секунд, чтобы предотвратить чрезмерное использование памяти. + +[![Развернуть на Vercel](https://vercel.com/button)](https://vercel.com/import/project?template=https://github.com/anuraghazra/github-readme-stats) + +
+ :hammer_and_wrench: Пошаговый гайд по настройке экземпляра на vercel + +1. Откройте [vercel.com](https://vercel.com/). +2. Войдите с помощью GitHub, нажав на `Log in`, а затем на `Continue with GitHub`. + ![](https://files.catbox.moe/pcxk33.png) + ![](https://files.catbox.moe/b9oxey.png) +3. Во время входа через GitHub разрешите доступ ко всем репозиториям, если это потребуется. +4. Сделайте форк этого репозитория. +5. Вернитесь в свой [Vercel dashboard](https://vercel.com/dashboard). +6. Для импорта проекта, нажмите на `Add New...` и выберете `Project`. + ![](https://files.catbox.moe/3n76fh.png) +7. Нажмите на `Continue with GitHub`, найдите нужный репозиторий и импортируйте его, нажав на `Import`. Кроме того, вы можете импортировать сторонний репозиторий, используя `Import Third-Party Git Repository ->` в нижней части страницы. + ![](https://files.catbox.moe/mg5p04.png) +8. Создайте токен личного доступа GitHub (PAT) [здесь](https://github.com/settings/tokens/new) и разрешите `repo` и `user` (это позволит получить доступ к частным репозиториям и информации о пользователе). +9. Добавьте PAT в переменную среды `PAT_1` (как показано). + ![](https://files.catbox.moe/0yclio.png) +10. Нажмите `deploy`, и все готово. Посмотрите на свои домены, чтобы использовать свой API! + +
+ +## На других платформах + +> [!WARNING]\ +> Этот способ официально не поддерживается и был добавлен только для удовлетворения некоторых конкретных случаев, когда Vercel не может быть использован (например [#2341](https://github.com/anuraghazra/github-readme-stats/discussions/2341)). Поэтому этот метод имеет ограниченную поддержку и не рекомендуется. + +
+:hammer_and_wrench: Пошаговый гайд по настройке экземпляра на других платформах + +1. Сделайте форк или клонируйте репозиторий в соответствии с потребностью. +2. Добавьте `express` в раздел зависимостей `package.json` + +3. При необходимости запустите `npm i` (для первоначальной настройки) +4. Запустите `node express.js`, чтобы запустить сервер, или установите точку входа `express.js` в `package.json`, если вы выполняете развертывание в управляемой службе. + +5. Все готово 🎉 +
+ +## Отключение ограничений скорости + +Github Readme Stats содержит несколько переменных среды, которые можно использовать для снятия ограничений скорости: + +* `CACHE_SECONDS`: эта переменная среды имеет приоритет над минимальными и максимальными значениями кэша и позволяет обойти эти значения для своего экземпляра. + +См. [документацию Vercel](https://vercel.com/docs/concepts/projects/environment-variables) о добавлении этих переменных среды в проект. + +## Держите свой форк в актуальном состоянии + +Вам следует поддерживать свой форк и, следовательно, свой экземпляр в актуальном состоянии с исходным репозиторием. +Чтобы это сделать используйте кнопку GitHub [Sync Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) +Вы также можете использовать пакет [pull](https://github.com/wei/pull), созданный [@wei](https://github.com/wei), чтобы автоматизировать данный процесс. + +# :sparkling\_heart: Поддержать проект + +Я открываю исходный код почти всего, чего могу, и стараюсь отвечать всем, кто нуждается в моей помощи. Очевидно что это требует времени. +Вы можете пользоваться этими услугами бесплатно. + +Однако, если вы пользуетесь моими услугами и довольны ими или вы просто хотите побудить меня продолжать создавать что-то, вы можете поддержать меня меня несколькими способами: + +* Добавить обратные ссылки на мой проект, если вы используете github-readme-stats в своем readme файле. :D +* Поставить звезду и поделится проектом. :rocket: +* [![paypal.me/anuraghazra](https://ionicabizau.github.io/badges/paypal.svg)](https://www.paypal.me/anuraghazra) - Вы можете сделать единоразовое пожертвование через PayPal. Я, наверное, куплю ~~кофе~~ чай. :tea: + +Спасибо! :heart: + +*** + +[![https://vercel.com?utm\_source=github\_readme\_stats\_team\&utm\_campaign=oss](powered-by-vercel.svg)](https://vercel.com?utm_source=github_readme_stats_team\&utm_campaign=oss) + +Соучастие приветствуется! <3 + +Сделано с любовью :heart: и JavaScript. diff --git a/docs/readme_ua.md b/docs/readme_ua.md new file mode 100644 index 0000000000000..52c851d96d1d6 --- /dev/null +++ b/docs/readme_ua.md @@ -0,0 +1,1010 @@ +

+ GitHub Readme Stats +

GitHub Readme Stats

+

Зроби статистику, що динамічно оновлюється, у своєму README!

+

+

+ + Tests Passing + + + GitHub Contributors + + + Tests Coverage + + + Issues + + + GitHub pull requests + + + OpenSSF Scorecard + +
+
+ + + +

+ +

+ Подивитись демо + · + Повідомити про помилку + · + Запропонувати функцію + · + FAQ + · + Задати питання +

+

+ Deutsch + · + English + · + Español + · + Français + · + Italiano + · + Nederlands + · + Português Brasileiro + · + Türkçe + · + Русский + · + Український + · + नेपाली + · + 日本語 + · + 简体中文 + · + 한국어 +

+

+ + + +> [!IMPORTANT]\ +>

Зверніть увагу, що переклади можуть бути застарілими, постарайтеся наскільки можна використовувати англійську версію

+ +

+ +# Переклад + +Переклад виконаний [senymama](https://github.com/senymama) і може містити помилки та бути застарілим (дату останнього оновлення можна дізнатися в інформації про останній коментар цього файлу). Також хочу зазначити, що українська мова не є мені рідною, тому переклад може бути неточним і він не містить сленгу, просто тому, що я недостатньо розуміюся на мові. У цьому випадку відправляйте issues в мій форк репозиторію, оскільки [автори](https://github.com/anuraghazra/github-readme-stats/graphs/contributors) не мають відношення до цього перекладу. + +Також мій переклад може трохи відрізняється від оригінальної документації, тому що в деяких моментах авторська документація мені видалася недостатньо наочною. (Наприклад, я додав приклад баннеру після опису кожного параметра, і всі приклади тепер у тегу \
, щоб документація займала менше місця і була більш читаною) + +Якщо ви хочете підтримати мої старання та мотивувати продовжувати підтримувати цю документацію ви можете: + +* Подивитися мої інші репозиторії та поставити зірку на ті, які вам здадуться цікавими + +Можливо, я додам додаткові способи підтримати мене, але поки мені вистачить активності на моєму профілі, це дійсно дуже мотивує мене як продовжувати цей проект, так і робити нові і робити їх якісніше. + +# Функції (фічі) + +- [Переклад](#переклад) +- [GitHub Stats Card (баннер статистики)](#github-stats-card-баннер-статистики) + - [Приховування певних даних](#приховування-певних-даних) + - [Показ додаткових даних](#показ-додаткових-даних) + - [Відображення іконок](#відображення-іконок) + - [Темы](#темы) +- [GitHub Extra Pins (Додаткові закрепи)](#github-extra-pins-додаткові-закрепи) + - [Використання](#використання) +- [GitHub Gist Pins (Закріпи gits'ов)](#github-gist-pins-закріпи-gitsов) + - [Використання](#використання-1) +- [Top Languages Card (Банер найбільш використовувані мови)](#top-languages-card-банер-найбільш-використовувані-мови) + - [Використання](#використання-2) + - [Алгоритм збору статистики](#алгоритм-збору-статистики) + - [Виключити окремі репозиторії](#виключити-окремі-репозиторії) + - [Приховати певні мови](#приховати-певні-мови) + - [Показати більше мов](#показати-більше-мов) + - [Компактный макет](#компактный-макет) + - [Макет з круговою діаграмою](#макет-з-круговою-діаграмою) + - [Вертикальні макет з кругової діаграми](#вертикальні-макет-з-кругової-діаграми) + - [Макет з діаграмою-пирогом](#макет-з-діаграмою-пирогом) + - [Макет без шкали](#макет-без-шкали) +- [Банер статистики WakaTime](#банер-статистики-wakatime) + - [Макет без шкали](#макет-без-шкали-1) + - [Компактный макет](#компактный-макет-1) +- [Кастомізація](#кастомізація) + - [Общие настройки](#общие-настройки) + - [Градієнт на bg\_color](#градієнт-на-bg_color) + - [Доступні мови](#доступні-мови) + - [Ексклюзивні налаштування банера статистики](#ексклюзивні-налаштування-банера-статистики) + - [Ексклюзивні налаштування Repo Card](#ексклюзивні-налаштування-repo-card) + - [Ексклюзивні налаштування Gist Card](#ексклюзивні-налаштування-gist-card) + - [Ексклюзивні налаштування Language Card](#ексклюзивні-налаштування-language-card) + - [Ексклюзивні налаштування WakaTime Card](#ексклюзивні-налаштування-wakatime-card) +- [All Demos](#all-demos) + - [Швидка порада (вирівнювання банерів)](#швидка-порада-вирівнювання-банерів) +- [Розгортання власного примірника](#розгортання-власного-примірника) + - [На Vercel](#на-vercel) + - [:film\_projector: Покроковий відеоурок від @codeSTACKr](#film_projector-покроковий-відеоурок-від-codestackr) + - [На інших платформах](#на-інших-платформах) + - [Вимкнення обмежень швидкості](#вимкнення-обмежень-швидкості) + - [Тримайте свій форк в актуальному стані](#тримайте-свій-форк-в-актуальному-стані) +- [:sparkling\_heart: Підтримати проект](#sparkling_heart-підтримати-проект) + +# Важливо + +> [!IMPORTANT]\ +> Оскільки GitHub API [дозволяє лише 5 тисяч запитів на годину для одного облікового запису](https://docs.github.com/en/graphql/overview/resource-limitations), загальнодоступний Vercel, розміщений на https://github-readme-stats.vercel.app/api може досягти обмеження (див. [#1471](https://github.com/anuraghazra/github-readme-stats/issues/1471)). Щоб уникнути цього ми використовуємо кешування (див. https://github.com/anuraghazra/github-readme-stats#common-options). Ви можете уникнути обмеження, розгорнувши [свій власний екземпляр на Vercel](#disable-rate-limit-protections). + +Uptime Badge + +> [!IMPORTANT]\ +> Ми маленька команда, тому при розташуванні пріоритетів завдань ми покладаємось на голоси: +1:. Ми використовуємо "Top Issues dashboard" для відстеження попиту комьюніті (див. [# 1935](https://github.com/anuraghazra/github-readme-stats/issues/1935)). Голосуйте за цікаві для вас issues і pull request. Насамперед ми будемо працювати над найпопулярнішими питаннями. + +# GitHub Stats Card (баннер статистики) + +Скопіюйте та вставте це у свій markdown файл, і все. Та так просто! + +Замініть значення `?username=` на GitHub username. + +```md +[![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats) +``` +
+:eyes: Найпростіший приклад + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra) +
+ + +> [!WARNING]\ +> За замовчуванням на картці статистики відображаються лише такі статистичні дані, як зірки, комміти та запити на включення із загальнодоступних репозиторіїв. Щоб відобразити особисту статистику на картці статистики, вам слід [розгорнути власний екземпляр](#deploy-on-your-own), використовуючи свій GitHub API токен. + +> [!NOTE]\ +> Ранги: S (найкращий 1%), A+ (12.5%), A (25%), A- (37.5%), B+ (50%), B (62.5%), B- (75%), C+ (87.5%) та C (everyone). Ця схема рангів заснована на [системі японської академічної оцінки](https://wikipedia.org/wiki/Academic_grading_in_Japan). Глобальні дані розраховуються як зважена сума для кожної статистики (кількість коммітів, запитів на включення, оглядів, проблем, зірок та передплатників), на основі кумулятивної функції розподілу [експоненти](https://wikipedia. org/wiki/exponential_distribution) та [log -normal](https://wikipedia.org/wiki/Log-normal_distribution). Реалізацію можна вивчити тут: [src/calculateRank.js](https://github.com/anuraghazra/github-readme-stats/blob/master/src/calculateRank.js). Коло навколо рейтингу показує 100 мінус глобальний відсоток. + +### Приховування певних даних + +Ви можете додати параметр `&hide=`, щоб приховати будь-яку статистику. Значення слід розділяти комами. + +> Опції: `&hide=stars,commits,prs,issues,contribs` + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&hide=contribs,prs) +``` + +
+:eyes: Показати приклад + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&hide=contribs,prs) +
+ +### Показ додаткових даних + +Ви можете додати параметр `&show=` щоб додати будь-яку статистику. Значення слід розділяти комами. + +> Опції: `&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage` + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage) +``` + +
+:eyes: Показати приклад +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage) + +
+ +### Відображення іконок + +Щоб увімкнути іконки, додайте параметр `&show_icons=true`. + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true) +``` + +
+:eyes: Показати приклад + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true) +
+ +### Темы + +Завдяки вбудованим темам ви можете налаштувати зовнішній вигляд карти без будь-якої [ручної настройки](#кастомізація). + +Використовуйте параметр `&theme=THEME_NAME` так: + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=radical) +``` + +
+:eyes: Показати приклад +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=radical) +
+ +#### Усі вбудовані теми + +GitHub Readme Stats має кілька вбудованих тем (такі як `dark`, `radical`, `merko`, `gruvbo`, `tokyonight`, `onedark`, `cobalt`, `synthwave`, `highcontrast`, `dracula`) . + + +
+:eyes: Подивитись + +GitHub Readme Stats Themes + +
+ +Ви можете переглянути прев'ю [всіх доступних тем](themes/README.md) або [файл конфігурації теми](themes/index.js). Зверніть увагу, що ми призупинили додавання нових тем, щоб зменшити витрати на обслуговування; всі запити на включення, пов'язані з новими темами, будуть закриті. + +#### Адаптивна тема банера + +
+:eyes: Показати приклад + +[![Anurag's GitHub stats-Dark](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=dark#gh-dark-mode-only)](https://github.com/anuraghazra/github-readme-stats#responsive-card-theme#gh-dark-mode-only) +[![Anurag's GitHub stats-Light](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=default#gh-light-mode-only)](https://github.com/anuraghazra/github-readme-stats#responsive-card-theme#gh-light-mode-only) + +
+ +Оскільки GitHub завантажує банери зі свого [CDN](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/about-anonymized-urls), не можна визначити тему browser/GitHub з сторони сервера. Однак існує кілька способів створення динамічних банерів на стороні клієнта. + +##### Використання прозорої теми + +Ми додали `transparent` тему без фону. Ця тема оптимізована так, щоб добре виглядати як на світлих, так і на темних темах GitHub. Використовуйте параметр `&theme=transparent` так: + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=transparent) +``` + +
+:eyes: Показати приклад + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=transparent) + +
+ +##### Додати прозорий альфа-канал у тему bg\_color + +Ви можете використовувати параметр `bg_color`, щоб зробити будь-яку з [доступних тем](themes/README.md) прозорою. Це робиться шляхом встановлення `bg_color` у колір з прозорим альфа-каналом (тобто `bg_color=00000000`): + +```md +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&bg_color=00000000) +``` + +
+:eyes: Показати приклад + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&bg_color=00000000) + +
+ +##### Використовувати тег теми GitHub + +Ви можете використовувати теги [теми GitHub] для автоматичного перемикання теми залежно від теми користувача. Для цього додайте `#gh-dark-mode-only` або `#gh-light-mode-only` наприкінці URL-адреси зображення. Цей тег визначає, чи відображатиметься це зображення для користувачів зі світлою або темною темою відповідно. + +```md +[![Anurag's GitHub stats-Dark](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=dark#gh-dark-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-dark-mode-only) +[![Anurag's GitHub stats-Light](https://github-readme-stats.vercel.app/api?username=anuraghazra&show_icons=true&theme=default#gh-light-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-light-mode-only) +``` + +
+:eyes: Показати приклад + +[![Anurag's GitHub stats-Dark](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=dark#gh-dark-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-dark-mode-only) +[![Anurag's GitHub stats-Light](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=default#gh-light-mode-only)](https://github.com/anuraghazra/github-readme-stats#gh-light-mode-only) + +
+ +##### Використовувати нову медіафункцію GitHub + +Ви можете використовувати [нову GitHub медіа-функцію](https://github.blog/changelog/2022-05-19-specify-theme-context-for-images-in-markdown-beta/) в HTML, щоб вказати для для яких користувачів слід відображати зображення. Це робиться за допомогою HTML-тегу `` у поєднанні з `prefers-color-scheme`. + +```html + + + + + +``` + +
+:eyes: Показати приклад + + + + + + + +
+ +# GitHub Extra Pins (Додаткові закрепи) + +GitHub extra pins дозволяє закріпити більше 6 репозиторіїв у вашому профілі використовуючи Github readme profile. +Так! Ви більше не обмежені лише 6 репозиторіями. +### Використання + +Вставте цей код у ваш readme та відредагуйте посилання. + +Кінцева точка: `api/pin/?username=anuraghazra&repo=github-readme-stats` + +```md +[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=github-readme-stats)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra\&repo=github-readme-stats) + +
+ +Використовуйте [show\_owner](#repo-card-exclusive-options) для додавання імені +користувача власника репозиторію. + +```md +![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra\&repo=github-readme-stats\&show_owner=true) +``` + +
+:eyes: Показати приклад + +![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra\&repo=github-readme-stats\&show_owner=true) + +
+ +# GitHub Gist Pins (Закріпи gits'ов) + +GitHub gist pins дозволяє закріпити gits у вашому Github профілі використовуючи Github readme profile. + +### Використання + +Вставте цей код у ваш readme та відредагуйте посилання. + +Кінцева точка: `api/gist?id=bbfce31e0217a3689c8d961a356cb10d` + +```md +[![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d)](https://gist.github.com/Yizack/bbfce31e0217a3689c8d961a356cb10d/) +``` + +
+:eyes: Показати приклад + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d) + +
+ +Використовуйте [show\_owner](#gist-card-exclusive-options) для додавання імені +користувача власника gits'а. + +```md +[![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d\&show_owner=true)](https://gist.github.com/Yizack/bbfce31e0217a3689c8d961a356cb10d/) +``` + +
+:eyes: Показати приклад + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d\&show_owner=true) + +
+ +# Top Languages Card (Банер найбільш використовувані мови) + +На банері "найпопулярніші мови" показані найчастіше використані мови програмування користувача. + +> [!WARNING]\ +> За промовчанням цей банер відображає статистику лише із загальнодоступних репозиторіїв. Якщо ви хочете додати інформацію з приватних репозиторіїв, вам потрібно розгорнути свій екземпляр](#deploy-on-your-own), використовуючи власний GitHub API токен. + +> [!NOTE]\ +> Цей банер не відображає рівень навичок користувача, це показник GitHub, що показує якими мовами найбільше коду в репозиторіях користувача. Це нова функція github-readme-stats. + +> [!WARNING]\ +> Цей банер відображає інформацію лише з ваших не форкнутих репозиторіїв, незалежно від того, хто є автором коммітів. Він не включає ваші вклади у репозиторіях інших користувачів/організацій. Наразі немає можливості отримати цю інформацію через GitHub API. Якщо ви хочете покращити цю поведінку ви можете підтримати [запит цієї функції](https://github.com/orgs/community/discussions/18230) створений у спільноті GitHub [@rickstaa](https://github.com/rickstaa) + +> [!WARNING]\ +> Зараз цей банер показує дані лише про перші 100 репозиторій, це пов'язано з обмеженнями API GitHub, що призводить до простоїв громадських екземплярів (див. [#1471](https://github.com/anuraghazra/github-readme-stats/issues/ 1471)). У майбутньому ця поведінка буде покращена шляхом дій GitHub'а або додаванням змінних середовища для екземплярів користувачів. + +### Використання + +Вставте цей код у ваш readme та відредагуйте посилання. + +Кінцева точка: `api/top-langs?username=anuraghazra` + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra) + +
+ + +### Алгоритм збору статистики + +Для розрахунку процентного змісту мов на мовній карті ми використовуємо наступний алгоритм: + +```js +ranking_index = (byte_count ^ size_weight) * (repo_count ^ count_weight) +``` + +За умовчанням для визначення процентного змісту, що відображається на банері, використовується лише кількість байтів (тобто `size_weight=1` та `count_weight=0`). Однак ви можете використовувати параметри `&size_weight=` та `&count_weight=` для зваженого розрахунку відсотка. Значення мають бути позитивними дійсними числами. [Детальніша інформація]((https://github.com/anuraghazra/github-readme-stats/issues/1600#issuecomment-1046056305)). + +* `&size_weight=1&count_weight=0` - *(за замовчуванням)* Підрахунок за кількістю байтів. +* `&size_weight=0.5&count_weight=0.5` - *(рекомендоване)* Використовується як кількість байтів, і кількість репозиторіїв. +* `&size_weight=0&count_weight=1` - Підрахунок за кількістю репозиторіїв + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&size_weight=0.5&count_weight=0.5) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&size_weight=0.5&count_weight=0.5) + +
+ +### Виключити окремі репозиторії + +Використовуйте параметр `&exclude_repo=repo1,repo2` щоб виключити певні репозиторії. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&exclude_repo=github-readme-stats,anuraghazra.github.io) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&exclude_repo=github-readme-stats,anuraghazra.github.io) + +
+ +### Приховати певні мови + +Використовуйте параметр `&hide=language1,language2` щоб приховати певні мови. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide=javascript,html) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide=javascript,html) + +
+ +### Показати більше мов + +Використовуйте опцію `&langs_count=`, щоб визначити кількість мов, які відображаються на банері. Допустимі значення - цілі числа від 1 до 20 (включно). За замовчуванням встановлено `5` для `normal`/`donut` та `6` для інших макетів. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&langs_count=8) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&langs_count=8) + +
+ +### Компактный макет + +Використовуйте параметр `&layout=compact` щоб змінити макет на компактний. + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=compact) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=compact) + +
+ +### Макет з круговою діаграмою + +Використовуйте параметр `&layout=donut` щоб змінити макет. + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut) + +
+ +### Вертикальні макет з кругової діаграми + +Використовуйте параметр `&layout=donut-vertical` щоб змінити макет. + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut-vertical)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=donut-vertical) + +
+ +### Макет з діаграмою-пирогом + +Використовуйте параметр `&layout=pie` щоб змінити макет. + +```md +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=pie)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&layout=pie)](https://github.com/anuraghazra/github-readme-stats) + +
+ +### Макет без шкали + +Використовуйте параметр `&hide_progress=true` щоб приховати шкалу та відсотки (макет буде автоматично встановлений на `compact`) + +```md +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide_progress=true) +``` + +
+:eyes: Показати приклад + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra&hide_progress=true) + +
+ +# Банер статистики WakaTime + +> [!WARNING]\ +> Майте на увазі, що в даний час відображаються дані лише з загальнодоступних профілів WakaTime. Тому переконайтеся, що в налаштуваннях профілю WakaTime включені `Display code time publicly` та `Display languages, editors, os, categories publicly` одночасно. + +Змініть значення `?username=` на ваше ім'я користувача в [WakaTime](https://wakatime.com). + +```md +[![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs) + +
+ +### Макет без шкали + +Використовуйте параметр `&hide_progress=true` щоб приховати шкали + +```md +[![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&hide_progress=true)](https://github.com/anuraghazra/github-readme-stats) +``` + +
+:eyes: Показати приклад + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&hide_progress=true) + +
+ +### Компактный макет + +Використовуйте параметр `&layout=compact` щоб змінити макет на компактный. + +```md +[![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&layout=compact)](https://github.com/anuraghazra/github-readme-stats) + +``` +
+:eyes: Показати приклад + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs\&layout=compact) +
+ +# Кастомізація + +Ви можете налаштувати зовнішній вигляд всіх карток на свій розсуд за допомогою параметрів URL. + +## Общие настройки + +| Параметр | Опис | Тип | Стандартне значення | +| --- | --- | --- | --- | +| `title_color` | Колір назви банера. | string (hex color) | `2f80ed` | +| `text_color` | Основний колір тексту. | string (hex color) | `434d58` | +| `icon_color` | Колір іконок, якщо можливо. | string (hex color) | `4c71f2` | +| `border_color` | Цвет границы баннера. Не применится, если `hide_border` включен. | string (hex color) | `e4e2e2` | +| `bg_color` | Колір заднього фону. | string (hex color або градієнт у форматі *angle,start,end*) | `fffefe` | +| `hide_border` | Приховати кордон банера. | boolean | `false` | +| `theme` | Назву теми, оберіть з [всіх доступних тем](themes/README.md). | enum | `default` | +| `cache_seconds` | Тривалість кешування за секунди (min: 21600 (6 годин), max: 86400 (24 години)). | integer | `21600` | +| `locale` | Встановлює мову в картці, ви можете переглянути повний [список доступних мов](#available-locales). | enum | `en` | +| `border_radius` | Заокруглення кутів. | number | `4.5` | + +> [!WARNING]\ +> Ми використовуємо кешування, щоб знизити навантаження на наші сервери (див. [#1371](https://github.com/anuraghazra/github-readme-stats/issues/1471#issuecomment-1271551425)). Наші банери мають тривалість кешу 6 годин (21 600 секунд). Зверніть увагу, що тривалість кешу може бути від 6 до 24 годин. Якщо ви хочете, щоб ваша статистика оновлювалася частіше, ви можете [розгорнути свій екземпляр](#deploy-on-your-own) і встановити [змінне середовище](#disable-rate-limit-protections) `CACHE_SECONDS` на свій розсуд. + +### Градієнт на bg\_color + +Вам необхідно вказати кілька значень, розділених комами в такому форматі: + + &bg_color=DEG,COLOR1,COLOR2,COLOR3...COLOR10 + +### Доступні мови + +Список доступних мов: + + + +
+ +| Код | Язык | +| --- | --- | +| `en` | Англійська | +| `ar` | Арабська | +| `bn` | Бенгальська | +| `my` | Бірманський | +| `hu` | Угорська | +| `vi` | В'єтнамська | +| `nl` | Голландська | +| `el` | Грецька | +| `id` | Індонезійська | +| `es` | Іспанська | + + + +| Code | Locale | +| --- | --- | +| `it` | Італійська | +| `cn` | Китайська | +| `zh-tw` | Китайська (Тайванська) | +| `kr` | Корейська | +| `ml` | Малаялам | +| `de` | Німецька | +| `np` | Непальська | +| `pl` | Польська | +| `pt-pt` | Португальська (Португалія) | +| `pt-br` | Португальська (Бразилія) | + + + +| Code | Locale | +| --- | --- | +| `ru` | Російська | +| `sk` | Словацький | +| `tr` | Турецька | +| `uz` | Узбецький | +| `uk-ua` | Українська | +| `fr` | Французька | +| `cs` | Чеська | +| `ja` | Японська | +| `se` | Шведська | + +
+ +Якщо ми не підтримуємо вашу мову, розгляньте можливість зробити свій внесок! Більш детальну інформацію про те, як це зробити, ви можете знайти у наших [рекомендаціях для авторів](CONTRIBUTING.md#translations-contribution). + +## Ексклюзивні налаштування банера статистики + +| Параметр | Опис | Тип | Стандартне значення | +| --- | --- | --- | --- | +| `hide` | Сховати [певні значення](#hiding-individual-stats) статистики. | string (значення через кому) | `null` | +| `hide_title` | Сховати назву вашого банера. | boolean | `false` | +| `card_width` | Ширина банера у пікселях. | number | `500px (примерно)` | +| `hide_rank` | Приховує ранг та автоматично зменшити розмір банера. | boolean | `false` | +| `rank_icon` | Встановити альтернативну іконку рангу ( `github`, `percentile` або `default`). | enum | `default` | +| `show_icons` | Показувати іконки поряд із усіма даними. | boolean | `false` | +| `include_all_commits` | Підрахуйте загальну кількість коммітів, а не лише коміти поточного року. | boolean | `false` | +| `line_height` | Міжрядковий відступ. | integer | `25` | +| `exclude_repo` | Виключає зазначені репозиторії. | string (значення через кому) | `null` | +| `custom_title` | Встановити свою назву банера. | string | ` GitHub Stats` | +| `text_bold` | Використовувати жирний шрифт. | boolean | `true` | +| `disable_animations` | Вимикає всю анімацію на банері. | boolean | `false` | +| `ring_color` | Колір кільця рангу. | string (hex color) | `2f80ed` | +| `number_format` | Перемикає між двома доступними форматами відображення значень банера: "короткий" (тобто "6,6К") або "довгий" (тобто "6626"). | enum | `short` | +| `show` | Показує [додаткові елементи](#showing-additional-individual-stats) на картці статистики (`reviews`, `discussions_started`, `discussions_ Answered`, `prs_merged` або `prs_merged_percentage`). | string (значення через кому) | `null` | + +> [!NOTE]\ +> Якщо hide\_rank=`true`, мінімальна ширина картки становить 270 пікселів + довжина заголовка та відступи. + +## Ексклюзивні налаштування Repo Card + +| Параметр | Опис | Тип | Стандартне значення | +| --- | --- | --- | --- | +| `show_owner` | Показати ім'я власника репозиторію. | boolean | `false` | +| `description_lines_count` | Ручне встановлення кількість рядків опису. Значення мають бути між 1 і 3. Якщо параметр не вказано, значення буде регулюватися автоматично. | number | `null` | + +## Ексклюзивні налаштування Gist Card + +| Параметр | Опис | Тип | Стандартне значення | +| --- | --- | --- | --- | +| `show_owner` | Показати ім'я власника gist'а. | boolean | `false` | + +## Ексклюзивні налаштування Language Card + +| Параметр | Опис | Тип | Стандартне значення | +| --- | --- | --- | --- | +| `hide` | Приховати [зазначені мови](#hide-individual-languages) з банера. | string (значення через кому) | `null` | +| `hide_title` | Сховати назву банера. | boolean | `false` | +| `layout` | Встановити один із 5 макетів: `normal` / `compact` / `donut` / `donut-vertical` / `pie`. | enum | `normal` | +| `card_width` | Встановити ширину банера. | number | `300` | +| `langs_count` | Встановити кількість мов, що відображаються (значення між 1 і 20). | integer | `5` для `normal` та `donut`, `6` для інших макетів | +| `exclude_repo` | Виключити зазначені репозиторії. | string (значення через кому) | `null` | +| `custom_title` | Встановити свою назву банера. | string | `Most Used Languages` | +| `disable_animations` | Вимкнути всі анімації банера. | boolean | `false` | +| `hide_progress` | Використовується в компактному макеті, приховує шкали та відсотки, залишаючи лише назви мов. | boolean | `false` | +| `size_weight` | Налаштовує алгоритм статистики мови (див. [Language stats algorithm](#language-stats-algorithm)). | integer | `1` | +| `count_weight` | Налаштовує алгоритм статистики мови (див. [Language stats algorithm](#language-stats-algorithm)). | integer | `0` | + +> [!WARNING]\ +> Назви мов мають бути URI-escaped, як зазначено у [процентному кодуванні](https://en.wikipedia.org/wiki/Percent-encoding) +> (тобто: `c++` має стати `c%2B%2B`, `jupyter notebook` має стати `jupyter%20notebook`, і т.д.) +> Використовуйте [urlencoder.org](https://www.urlencoder.org/), щоб робити це автоматично. + +## Ексклюзивні налаштування WakaTime Card + +| Параметр | Опис | Тип | Стандартне значення | +| --- | --- | --- | --- | +| `hide` | Приховати вказані мови з банера. | string (значення через кому) | `null` | +| `hide_title` | Приховати назву банер. | boolean | `false` | +| `line_height` | Встановити відступ між рядками. | integer | `25` | +| `hide_progress` | Приховати шкалу та відсотки. | boolean | `false` | +| `custom_title` | Встановити свою назву банера. | string | `WakaTime Stats` | +| `layout` | Встановити один із доступних макетів: `default` / `compact`. | enum | `default` | +| `langs_count` | Обмежити кількість мов на банері, за замовчуванням відображаються всі. | integer | `null` | +| `api_domain` | Встановити свій домен API для банера, наприклад, використовувати сервіси [Hakatime](https://github.com/mujx/hakatime) або [Wakapi](https://github.com/muety/wakapi) | string | `wakatime.com` | +| `display_format` | Встановити формат відображення статистики. Виберіть `time` або `percent` для відображення статистики за часом або відсотком. | enum | `time` | +| `disable_animations` | Вимкнути всі анімації банера. | boolean | `false` | + +*** + +# All Demos +
+:eyes: Показати + +* Default + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra) + +* Hiding specific stats + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&hide=contribs,issues) + +* Showing additional stats + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&show=reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage) + +* Showing icons + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&hide=issues\&show_icons=true) + +* Shows Github logo instead rank level + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&rank_icon=github) + +* Shows user rank percentile instead of rank level + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&rank_icon=percentile) + +* Customize Border Color + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&border_color=2e4058) + +* Include All Commits + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&include_all_commits=true) + +* Themes + +Choose from any of the [default themes](#themes) + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&show_icons=true\&theme=radical) + +* Gradient + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra\&bg_color=30,e96443,904e95\&title_color=fff\&text_color=fff) + +* Customizing stats card + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api/?username=anuraghazra\&show_icons=true\&title_color=fff\&icon_color=79ff97\&text_color=9f9f9f\&bg_color=151515) + +* Setting card locale + +![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api/?username=anuraghazra\&locale=es) + +* Customizing repo card + +![Customized Card](https://github-readme-stats.vercel.app/api/pin?username=anuraghazra\&repo=github-readme-stats\&title_color=fff\&icon_color=f9f9f9\&text_color=9f9f9f\&bg_color=151515) + +* Gist card + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d) + +* Customizing gist card + +![Gist Card](https://github-readme-stats.vercel.app/api/gist?id=bbfce31e0217a3689c8d961a356cb10d&theme=calm) + +* Top languages + +![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=anuraghazra) + +* WakaTime card + +![Harlok's WakaTime stats](https://github-readme-stats.vercel.app/api/wakatime?username=ffflabs) + +
> + +*** + +## Швидка порада (вирівнювання банерів) + +GitHub залишає зазор між банерами. Щоб розмістити їх впритул використовуйте такий підхід: + +```html + + + + + + +``` + +```html + + + + + + +``` + +
+:eyes: Показати приклад + +* За замовчуванням + +[![Anurag's GitHub stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)](https://github.com/anuraghazra/github-readme-stats) +[![Anurag's Top Langs](https://github-readme-stats.vercel.app/api/top-langs?username=anuraghazra&layout=compact&langs_count=8&card_width=320)](https://github.com/anuraghazra/github-readme-stats) + +* Використовуючи запропонований підхід + + + + + + + + +*** + + + + + + + + +
+ +# Розгортання власного примірника + +## На Vercel + +### :film\_projector: [Покроковий відеоурок від @codeSTACKr](https://youtu.be/n6d4KHSKqGk?t=107) + +Оскільки GitHub API дозволяє лише 5 тисяч запитів на годину, мій https://github-readme-stats.vercel.app/api стикається з обмеженнями в швидкості. +Якщо ви розгорнете власний екземпляр на своєму сервері Vercel, вам нема про що турбуватися. +Натисніть кнопку розгортання, щоб почати! + +> [!NOTE]\ +> Починаючи з [#58](https://github.com/anuraghazra/github-readme-stats/pull/58), ми зможемо обробити більше 5 тисяч запитів на годину і мати менше проблем з обмеженнями :grin:. + +> [!NOTE]\ +> Якщо ви використовуєте тарифний план [Pro (тобто платний)](https://vercel.com/pricing), то значення [maxDuration](https://vercel.com/docs/concepts/projects/project-configuration #value-definition) в [vercel.json](https://github.com/anuraghazra/github-readme-stats/blob/master/vercel.json) може бути збільшено, якщо час очікування вашого екземпляра часто закінчується під час запиту банер. +> Рекомендується підтримувати це значення нижче `30` секунд, щоб запобігти надмірному використанню пам'яті. + +[![Развернуть на Vercel](https://vercel.com/button)](https://vercel.com/import/project?template=https://github.com/anuraghazra/github-readme-stats) + +
+ :hammer_and_wrench: Покроковий гайд з налаштування екземпляра на vercel + +1. Відкрийте [vercel.com](https://vercel.com/). +2. Увійдіть за допомогою GitHub, натиснувши на `Log in`, а потім на `Continue with GitHub`. + ![](https://files.catbox.moe/pcxk33.png) + ![](https://files.catbox.moe/b9oxey.png) +3. Під час входу через GitHub дозвольте доступ до всіх репозиторій, якщо це потрібно. +4. Зробіть форк цього репозиторію. +5. Поверніться до [Vercel dashboard](https://vercel.com/dashboard). +6. Для импорта проекта, нажмите на `Add New...` и выберете `Project`. + ![](https://files.catbox.moe/3n76fh.png) +7. Натисніть на `Continue with GitHub`, знайдіть потрібний репозиторій та імпортуйте його, натиснувши на `Import`. Крім того, ви можете імпортувати сторонній репозиторій, використовуючи `Import Third-Party Git Repository ->` у нижній частині сторінки. + ![](https://files.catbox.moe/mg5p04.png) +8. Створіть токен особистого доступу GitHub (PAT) [тут](https://github.com/settings/tokens/new) і дозвольте `repo` та `user` (це дозволить отримати доступ до приватних репозиторій та інформації про користувача). +9. Додайте PAT до змінного середовища `PAT_1` (як показано). + ![](https://files.catbox.moe/0yclio.png) +10. Натисніть `deploy` і все готове. Подивіться на свої домени, щоб використовувати API! + +
+ +## На інших платформах + +> [!WARNING]\ +> Цей спосіб офіційно не підтримується і був доданий тільки для задоволення деяких конкретних випадків, коли Vercel не може бути використаний (наприклад [#2341] (https://github.com/anuraghazra/github-readme-stats/discussions/2341)). Тому цей метод має обмежену підтримку та не рекомендується. + +
+:hammer_and_wrench: Покроковий гайд з налаштування екземпляра на інших платформах + +1. Зробіть форк або клонуйте репозиторій відповідно до потреби. +2. Додайте `express` у розділ залежностей `package.json` + +3. За потреби запустіть `npm i` (для початкового налаштування) +4. Запустіть `node express.js`, щоб запустити сервер, або встановіть точку входу `express.js` у `package.json`, якщо ви виконуєте розгортання в керованій службі. + +5. Все готове 🎉 + +
+ +## Вимкнення обмежень швидкості + +Github Readme Stats містить кілька змінних середовища, які можна використовувати для зняття обмежень швидкості: + +* `CACHE_SECONDS`: ця змінна середовища має пріоритет над мінімальними та максимальними значеннями кешу і дозволяє обійти ці значення для свого екземпляра. + +Див. [документацію Vercel](https://vercel.com/docs/concepts/projects/environment-variables) про додавання цих змінних середовища до проекту. + +## Тримайте свій форк в актуальному стані + +Вам слід підтримувати свій форк і, отже, свій екземпляр у актуальному стані з вихідним репозиторієм. +Щоб це зробити, використовуйте кнопку GitHub [Sync Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) +Ви також можете використовувати пакет [pull](https://github.com/wei/pull), створений [@wei](https://github.com/wei), щоб автоматизувати цей процес. + +# :sparkling\_heart: Підтримати проект + +Я відкриваю вихідний код майже всього, чого можу, і намагаюся відповідати всім, хто потребує моєї допомоги. Очевидно, що це вимагає часу. +Ви можете користуватись цими послугами безкоштовно. + +Однак, якщо ви користуєтеся моїми послугами та задоволені ними або ви просто хочете спонукати мене продовжувати створювати щось, ви можете підтримати мене декількома способами: + +* Додати зворотні посилання на мій проект, якщо ви використовуєте github-readme-stats у своєму файлі readme. :D +* Поставити зірку та поділиться проектом. :rocket: +* [![paypal.me/anuraghazra](https://ionicabizau.github.io/badges/paypal.svg)](https://www.paypal.me/anuraghazra) - Ви можете зробити одноразову пожертву через PayPal. Я, напевно, куплю чай. :tea: + +Дякую! :heart: + +*** + +[![https://vercel.com?utm\_source=github\_readme\_stats\_team\&utm\_campaign=oss](powered-by-vercel.svg)](https://vercel.com?utm_source=github_readme_stats_team\&utm_campaign=oss) + +Співучасть вітається! <3 + +Зроблено з любов'ю: heart: та JavaScript. diff --git a/readme.md b/readme.md index 363b008b2f8c2..e9767181e1415 100644 --- a/readme.md +++ b/readme.md @@ -41,27 +41,31 @@ Ask Question

- Français - · - 简体中文 + Deutsch · Español · - Deutsch + Français · - 日本語 + Italiano + · + Nederlands · Português Brasileiro · - Italiano + Türkçe · - 한국어 + Русский · - Nederlands + Український · नेपाली · - Türkçe + 日本語 + · + 简体中文 + · + 한국어