Skip to content

OpenSourceWin/OpenSourceWin.github.io

Repository files navigation

开源码力榜官方网站

我们是谁?

我们是如何评选的?

  1. 开发者的开源贡献度基于 GitHub 全域开发者活跃数据计算得到。
  2. 开源贡献度的计算使用了开发者与项目之间的活动关联、开发者在同一仓库中的协作关系与图算法计算获得。
  3. 计算仓库影响力的基本主张为:更有影响力的开发者在 GitHub 上更加活跃、更有影响力的开发者更倾向于参与到更有影响力的项目中、更有影响力的项目会吸引到更多更有影响力的开发者参与。
  4. 计算开发者贡献度的基本主张为:贡献度更高的开发者会在更多的仓库协作单元上活跃,贡献度高的开发者共容易吸引到其他开发者与其进行深入和高频协作。

如何提供你的资料?

如你所见我们的官方网站也是完全开源的,它基于Hexo静态网站生成器搭建,我们利用 GitHub Actions 提供的持续集成功能来实时发布我们的内容。OpenSource.win里的所有入榜用户个人资料的维护亦采用开源的方式,由用户自己完善后向我们提交 PR,经审核完成后合并入主站并实时发布。

如何开始?

点击本页面右上角的 Fork 按钮,将代码添加至你自己的主仓库。然后用你喜欢的 Git 工具将代码 Clone 到本地。

进入代码目录,安装 Hexo 的必要依赖。

cd OpenSourceWin
npm i

如果用户名目录已经存在,你只需要去目录下面的 index.md 完善更新自己的信息即可。

不存在你就需要创建自己的个人介绍页了,注意:页面的名称请使用你的 GitHub 用户名。

npx hexo new page <你的用户名>

假设你的用户名是 foo,现在你会发现在 source 目录下面出现了一个新的 foo 目录。里面有 index.md 这个文件,这里既是你用来撰写个人简介的地方,如它的后缀所示,个人简介由 Markdown 格式书写。打开这个文件,修改并添加以下内容(注意:尖括号<>以及以内的内容仅代表对当前项目的解释,在正式使用时请依照此修改为你的内容):

---
slug: <GitHub用户名>
name: <昵称,如果不填写则默认使用 slug>
description: <在首页显示的个人简介,不要超过50个字>
avatar: <个人头像文件,下面会介绍, 优先级比 github_avatar 高>
github_id: <GitHub ID,这是一个纯数字ID,用于展示嵌入 osgraph 的能力图谱>
github_avatar: <Github 头像地址>
---

<在这里可以用Markdown书写个人简介>

上面提到的个人头像文件,我们建议每个用户都要提交一个个人头像,以便我们标示你。这个图片可以是 jpg,png,gif 格式,应该是一个正方形分辨率至少超过 256x256 的文件。

将此文件放置在个人简介的同级目录下,比如这个文件叫 avatar.png,它应该放置到 source/foo 目录下,然后上列的 avatar 项目应该填写 avatar.png,如果改头像存在会优先展示该头像,不存在会降级使用 github_avatar 的值。

如果头像不存在,我们会通过脚本从 GitHub 上获取头像也就是上面的 github_avatar 的值。

所有内容修改完成后,将其提交至 GitHub,并向我们的主项目提交一个 PR 请求,然后等待我们的审核合并后即可正常显示。

注意事项

  1. 请不要修改除你自己的用户名所在目录以外的其它文件。
  2. 如果你不在榜单内,请不要提交。
  3. GitHub 的页面生成不是实时的,大约需要15分钟左右才能看到效果。

榜单列表

以下是当年入选此榜单的九十九位用户列表。

OpenSource.win

其他年份的榜单请从导航栏往年榜单下拉菜单选择年份查看。

脚本批量更新用户信息

脚本用法说明