开发工具【免费下载链接】github-profile-readme-generator Generate GitHub profile README easily with the latest add-ons like visitors count, GitHub stats, etc using minimal UI.项目地址https://gitcode.com/gh_mirrors/gi/github-profile-readme-generator点击查看免费下载GitHub Profile README Generator以下简称生成器在基础 Markdown 输出之外还整合了多个由社区开发者维护的开源 Addon增强组件用于在个人 README 中动态展示 GitHub 统计、连续贡献天数、主页访问计数和最新博客文章。本文以仓库中的 addons 说明文档 为主体结合 Addons 页面组件、Markdown 生成器源码 与 默认配置逐类讲解每个 Addon 的用途、参数含义、定制方式以及它们在生成器中的开关与代码级接入原理读完后你可以准确理解生成器输出的每段 Addon 代码并掌握 Blog Post Workflow 的完整配置方法。Addons 页面在项目中的定位addons.md是生成器站点的静态内容源之一它定义了/addons路由页面src/app/addons/page.tsx的正文内容对应的 Next.js 元数据标题为 Addonscanonical指向/addons。文档开篇即说明了项目的立场生成器本身并不重复造轮子而是使用其他开发者开发的开源 Addons来增强工具实用性并明确表达了对这些第三方开源项目的致谢。这意味着生成器输出的动态徽章与统计卡片全部由外部免费微服务渲染生成器负责的是把这些服务的 URL 按用户配置拼装进最终 README。文档共收录四类 Addon下面逐一展开。一、GitHub README Stats动态统计卡与技能卡由 Anurag Hazra 开发的github-readme-stats是一个根据你的 GitHub 数据动态渲染统计图片的服务主打⚡️ Dynamically generated stats for your github readmes。GitHub Stats Card统计卡在 README 中嵌入下面这种形式的图片标签即可获得统计卡a hrefhttps://github.com/你的用户名 targetblank img srchttps://github-readme-stats.vercel.app/api?username你的用户名show_iconstrue width320 altgithub stats/ /a核心参数username指定统计对象show_iconstrue控制是否在统计项旁显示图标。文档示例中该卡片被包在指向作者主页的链接内用户点击图片即可跳转到对应 GitHub 主页。Top Skills Card技能卡用于展示你最常用的编程语言占比a hrefhttps://github.com/你的用户名 targetblank img srchttps://github-readme-stats.vercel.app/api/top-langs/?username你的用户名layoutcompacthidehtml width320 alttop skills/ /a参数含义layoutcompact让语言列表以紧凑横向布局渲染hidehtml表示不统计 HTML 这类标记语言。两个卡片端点共用同一个服务均支持主题定制。生成器中的接入方式生成器在 markdown-generator.ts 中通过githubStats开关控制该类统计输出——当用户在表单勾选 GitHub Stats 且已填写 GitHub 用户名时生成器会一次性输出两张卡片左侧为top-langsshow_iconstruelocaleenlayoutcompact居中为api统计卡show_iconstruelocaleen两者均使用nbsp;做间距排版。与之配套的topLanguages开关则只控制语言卡。对应表单控件位于 skills-section.tsx勾选项分别为githubStats、topLanguages、streakStats。在 defaults.ts 中可以看到这两类卡片的可定制选项结构theme主题名、titleColor标题颜色、textColor文字颜色、bgColor背景颜色、hideBorder隐藏边框、cacheSeconds缓存秒数、locale语言默认en。这些选项直接对应github-readme-stats服务的查询参数勾选统计后即可按需修改最终拼入图片 URL。二、GitHub Readme Streak Stats连续贡献天数卡片由 Jonah Lawrence 开发的github-readme-streak-stats服务通过展示当前连续贡献天数来激励开发者坚持为开源做贡献Stay motivated while contributing to open source。示例嵌入方式该服务同样支持主题定制文档建议前往其官方仓库查看themes配置方式。在生成器中它由streakStats开关控制markdown-generator.ts 会输出pimg aligncenter srchttps://github-readme-streak-stats.herokuapp.com/?user你的用户名 alt你的用户名 //p注意生成器默认只在 URL 上追加user参数theme保留为空字符串见 defaults.ts 的streakStatsOptions因此使用默认主题如需换主题可在选项中对theme赋值生成的 URL 会带上themexxx。三、GitHub Profile Views Counter主页访问计数徽章由 Anton Komarev 开发的github-profile-views-counter是一个免费的云微服务用于统计你的 GitHub 主页被访问的次数示例嵌入文档明确说明该徽章的color颜色、label标签文字和style样式都可以定制。这是生成器最常用的 Addon 之一。用户在Profile Enhancement区域勾选 Show profile visitors counter badge对应 basic-info-section.tsx 的visitorsBadge复选框后markdown-generator.ts 会输出p alignleft img srchttps://komarev.com/ghpvc/?username你的用户名labelProfile viewscolor0e75b6styleflat alt你的用户名 / /p三个参数的默认值定义在 defaults.tsbadgeStyle默认flat文档示例使用的flat-square是另一种常见风格、badgeColor默认0e75b6蓝色、badgeLabel默认Profile views。也就是说即使不额外配置生成器也会给出完整可用的访问计数徽章。四、Dynamic Latest Blog Posts自动同步最新博客文章由 Gautam Krishna R 开发的blog-post-workflow是一个 GitHub Actions 工作流它通过 RSS 订阅源如 dev.to、Medium或 StackOverflow 活动自动把最新文章列表写入你的 GitHub 主页或项目 README无需手动维护。这是四类 Addon 中唯一需要动手配置工作流文件的组件文档给出了完整的接入步骤。步骤一在 README.md 中预留替换锚点在 README 中任意位置加入下面的注释区块标题可自定但注释必须原样保留。工作流每次运行时会把这段注释整体替换为真实文章列表# Blog posts !-- BLOG-POST-LIST:START -- !-- BLOG-POST-LIST:END --!-- BLOG-POST-LIST:START --与!-- BLOG-POST-LIST:END --是工作流识别并重写的锚点标记二者缺一不可。步骤二创建 GitHub Actions 工作流文件在仓库中创建.github目录如不存在则连同workflows子目录一起创建然后新建文件.github/workflows/blog-post-workflow.yml内容如下name: Latest blog post workflow on: schedule: # Runs every hour - cron: 0 * * * * jobs: update-readme-with-blog: name: Update this repos README with latest blog posts runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - uses: gautamkrishnar/blog-post-workflowmaster with: feed_list: https://dev.to/feed/你的用户名, https://medium.com/feed/你的用户名文件结构说明on.schedule.cron: 0 * * * *每小时整点触发一次工作流actions/checkoutv2检出仓库代码供后续步骤修改 READMEgautamkrishnar/blog-post-workflowmaster核心动作with.feed_list接收逗号分隔的 RSS 地址列表多个订阅源用逗号分隔写在同一字符串中工作流会在每次运行时拉取这些 RSS 源将最新文章条目渲染进 README 的锚点注释之间然后自动提交。步骤三替换订阅源并提交将feed_list中的示例地址替换为你自己的 RSS 地址dev.to 的格式为https://dev.to/feed/用户名Medium 的格式为https://medium.com/feed/用户名提交后等待工作流按计划执行即可。之后每次触发README 都会自动更新为最新的文章列表。生成器与 Addons 的映射关系一览结合 markdown-generator.ts 与 defaults.ts可将四类 Addon 与生成器的开关、默认参数汇总如下Addon外部服务端点生成器开关关键默认参数defaults.tsGitHub README Statsgithub-readme-stats.vercel.app/api//api/top-langsgithubStats、topLanguageslocale: en、hideBorder: false、cacheSeconds: nullStreak Statsgithub-readme-streak-stats.herokuapp.comstreakStatstheme: 默认主题Profile Views Counterkomarev.com/ghpvc/visitorsBadgebadgeStyle: flat、badgeColor: 0e75b6、badgeLabel: Profile viewsBlog Post WorkflowRSS 订阅源需手动配置.github/workflows/blog-post-workflow.ymlcron: 0 * * * *、feed_list逗号分隔需要留意的是以上 URL 与参数由生成器源码拼接输出如 markdown-generator.ts具体渲染效果与更多定制项主题名、布局、徽章样式等取决于对应外部服务当时的接口能力实际使用时请以相关服务的官方仓库说明为准。另外从 markdown-generator.ts 可以看到生成器还接入了github-profile-trophy奖杯墙等类似性质的动态徽章服务它们与本文四类 Addon 同属外部动态渲染、生成器拼接 URL的接入模式。结语四类 Addon 覆盖了 GitHub 主页 README 最常见的动态内容需求统计卡与技能卡展示技术数据、连续贡献卡传递活跃度、访问计数徽章体现主页热度、博客工作流让 README 保持内容新鲜度。理解它们的端点、参数与生成器开关的对应关系后你既能精确解释生成器输出的每一行 Markdown也能脱离生成器、直接在个人 README 中手工复用这些组件——只需替换 URL 中的username并调整参数即可。若要进一步了解生成器如何把这些 URL 与社交链接、技能图标等一并组装成完整 Markdown可继续阅读 markdown-generator.ts 的generateMarkdown函数与 生成器主页源码。赞分享开发工具【免费下载链接】github-profile-readme-generator Generate GitHub profile README easily with the latest add-ons like visitors count, GitHub stats, etc using minimal UI.项目地址https://gitcode.com/gh_mirrors/gi/github-profile-readme-generator点击查看免费下载相关推荐Fief高级特性自定义用户字段与权限管理技巧Fief高级特性自定义用户字段与权限管理技巧 Fief是一个功能强大的用户认证管理SaaS平台提供了丰富的自定义用户字段和精细的权限管理功能。无论你是构建企rawpy去马赛克算法DemosaicAlgorithm枚举的完整解析与应用rawpy去马赛克算法DemosaicAlgorithm枚举的完整解析与应用 rawpy是一个基于libraw的Python RAW图像处理库提供了强大的R推荐一款强大的GitHub个人资料README生成器GitHub Profile README Generator推荐一款强大的GitHub个人资料README生成器GitHub Profile README Generator 在今天的开源世界中你的GitHub个人资开发工具上一篇OpenCompass 新数据集接入全流程指南从数据集脚本到评测配置下一篇ComfyUI Impact Pack深度解析5大核心技术模块实现AI图像增强与精细化处理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考