mac gource
当您可以动态显示项目中的活动和活动时,为什么还要选择无聊的数字和静态图来描述您的开源项目? Gource是一种出色且灵活的工具,可用于通过人们喜欢的视频可视化来显示存储库中的活动。 可以根据GNU通用公共许可证 (版本3或更高版本)的条款重新分配和修改Gource。 以下是一些有关其他人如何使用Gource的有趣视频,可以帮助您考虑如何使用Gource:
Yum Gource可视化
Yum Gource Visualization视频是对Yum项目的首席开发人员和Fedora的长期贡献者Seth Vidal的致敬,他在骑自行车时被撞车司机杀死后不久。 塞思对百胜的贡献是蓝色,而其他人的贡献则是白色。
Linux内核开发
1991- 2015年的Linux Kernel Development展示了Gource如何帮助您可视化任何开源项目(在此示例中为Linux内核)的完整开发历史。
人口动态
人口动态1970-2010提供人口动态的可视化。
任何灵活且可自定义的工具都带有令人眼花array乱的选项和配置。 例如,我使用下面的命令从Metrics Grimoire工具套件中生成MailingListStats(mlstats)存储库的可视化:
$ gource -f --logo images/bitergia_logo_sm.png --title "MailingListStats AKA mlstats" --key --start-date '2014-01-01' --user-image-dir images -a 1 -s .05 --path ../MailingListStats
以下是使用这些选项生成的视频 :
选项详细信息:
- --path / path / to / repo(或从repo dir的顶层省略并运行Gource)
- -f全屏显示
- --logo图片/bitergia_logo_sm.png
- --title“ MailingListStats AKA mlstats”
- --key(显示文件类型的颜色键)
- --start-date'2014-05-01'
- --user-image-dir图像(带有.jpg或.png用户图像的目录-化身为“全名.png”)
- -a 1(如果在x秒内无任何React,则自动跳至下一个条目-默认值为3)
- -s .05(每天以秒为单位的速度-默认为10)
Gource还可以使用自定义日志格式显示非存储库信息(错误跟踪器或邮件列表)。
例如,这就是我使用Gource的自定义日志格式对邮件列表进行可视化的方式:
- 使用mlstats创建的数据库中的一个Linux邮件列表中的所有消息运行查询。
- 收集有关每个邮件列表帖子的数据,包括发帖人,如果是回复,则是他们正在回复的用户(
M
通过回复而修改的主题)。 否则,将其标记为新消息(A
添加的新线程) - 将电子邮件剥离为用户名(
@example.com
之前的所有内容),以使用户的标识符更短,这对于可视化效果更好。 - 将输出格式化为一个名为gource_output.log的文件,该文件是一种很好的管道分隔Gource自定义日志格式,按时间以这种格式排序:
unixtime|user-email_sender|A|new unixtime|user-email_sender|M|user-in_response_to
- Ran gource
$ gource -i 5 --max-user-speed 100 -a 1 --highlight-users gource_output.log
- 使用的选项:
-
-i 5
时间文件保持空闲状态(缺省值0)。 这样一来,人们被回复的内容就会在5秒钟后消失,以进行清理并使其更具可读性。 -
--max-user-speed 100
速度用户可以每秒移动一次(默认值:500)。 我将此速度降低到100,以使其更易于查看用户。 -
-a 1
如果几秒钟内没有发生任何React(默认值:3),则自动跳至下一个条目,以加快此速度。 -
--highlight-users
防止发送电子邮件的用户名消失。 我本来希望对文件名使用相同的名称,但文件名似乎无法找到。
-
要了解有关Gource的更多信息,请查看项目的Github页面或查看Dawn在多伦多LinuxCon上的演讲。
本文提供了有关Dawn将在8月23日星期二与Gource进行LinuxCon演讲,“ 可视化代码仓库”和更多内容的内容的示例 。在LinuxCon上,她将在典型的源代码可视化之外,深入研究使用Gource的更多选项和创造性方式。 与会者应该从她的演讲中走出关于如何制作精彩视频的想法和技术,这些视频显示开放源代码项目和社区中的活动。
mac gource