极客讨论器

　　极客讨论器是一款阅读代码工具，内置源代码分析，将C/C++/Python/Java/C#/Objective-C源代码以“函数地图”的形式来展示调用关系，并且可以和源代码相互定位；我们生活在信息爆炸的时代，对于程序员来说，源代码是他们主要接触的信息之一；仅仅是Linux内核的源代码图，就足以让人望而生畏，而偏偏作为程序员，又不得不接触各种人用各种语言写的源代码，极客讨论器就是为辅助您理解源代码而生的；用户可以使用程序提供的旅行模式按照函数调用顺序阅读源代码，可以使用消息路标来标注函数，查看其它函数和它的调用关系。强大又实用，需要的用户可以下载体验

软件功能

　　自动检测服务器

　　如下图所示，test文件夹已经是subversion检出目录了。可以在test文件夹的资源管理器菜单中选择gtalkabout菜单项。

　　如果找不到gtalkabout菜单项，请在极客讨论器的目录中新建一个register.bat文本文件，用记事本编辑它，输入：

　　regsvr32 /v gtashell.dll

　　保存，然后选择“以管理员身份运行”即可。

　　出现的“Subversion配置页”默认就是从工作区检测。注意服务器的用户名和密码是无法从工作区检测的，必须手工填写。

　　和前面介绍的团队项目和开源项目不同的是，工作区目录就是调用关联菜单时的文件夹，或是拖动进来的文件夹，所以不需要额外配置了。

　　还可以在极客讨论器处于启动页面时，把目录拖进来。如果拖进来的目录是subversion检出目录，会出现和同样的配置页面。

软件特色

　　版本库导航栏

　　版本库导航栏位于控制台页上。它代表了配置指定的版本库，形状是一个箭头，其中的箭身表示了版本库中“已知”的所有版本，箭头表示版本库中“未知”的版本。

　　怎么会有“未知”的版本呢？当版本库是在服务器上，或者在开源网站时，有可能随时有人往版本库里提交新版本，此时的导航栏还是存的原来的那些版本。如果想检查版本库此时有没有新版本，只需点击一下箭头即可，如果有新版本，箭身会收缩并接收新版本；如果没有新版本，而您有版本库的提交权限，则会调出“提交”页为您提供创建新版本。

　　箭身里有一个蓝色的进度条，表示的是下载到本地的版本。只要在配置页中配置了“使用映射库”并且“映射版本库到本地”，那么会自动将远程的版本库一个版本一个版本的下载到本地，无需人工干预。访问下载到本地的版本速度要比还在远程的版本快很多，而且可以离线访问。

　　版本库导航栏上的滑块可以在栏上拖动，当拖动到工作区区域时，会切换至工作区的资源；拖动到栏身其它区域时，会调出此区域代表的版本的资源。

　　可以拖动滑块到某一版本上，然后点击控制台上的“更新”按钮，会出现更新页，将工作区的资源更新到指定版本。可以单独选择要更新的文件。

　　如果您修改了工作区里的内容，而且有版本库的提交权限，可以向版本库进行提交。控制台上有“提交”按钮，下面会讲到，这里先推荐用“箭头”操作完成提交。“箭头”操作就是点击导航栏最右边的箭头，它会先检查是否有别人提交了新版本，如果有，会弹回并接受新增的版本，如果新增的内容和您提交的内容发生冲突的话，会提供解决冲突的页面，以免覆盖掉别人重要的提交。

　　而控制台上的“提交”按钮则不检查服务器是否有新版本，冲突会留待服务端解决。

　　可以通过导航栏比对任何两个版本之间的资源的不同。双击滑块会在滑块处插上一面红旗，以红旗所在的版本为比较基，拖动滑块到任何其它版本，就会看到滑块所在版本相对于红旗所在版本之间的不同了。

　　还可以通过导航栏查看任意一个或多个文件在版本库中哪些版本被修改了。选中需要查看的文件，点击控制台上查看文件版本按钮，所有这个文件有修改的版本就会发出闪光。

安装说明

　　1、需要的用户可以点击本网站提供的下载路径下载得到对应的程序安装包

　　2、通过解压功能将压缩包打开，双击gtalkabout_p_cn.exe程序，会弹出一个程序界面

　　3、点击EXTract按钮即可，等待程序加载完成

　　4、加载完成后，会生成一个文件夹，此时打开文件夹

　　5、双击主程序即可将程序打开，不需要过多的程序安装步骤

　　6、更新后即可，根据用户自己的习惯进行更新

使用说明

　　一、离线浏览远程版本库

　　关于映射库的配置，建议上是这样的：本地版本库的配置就不能改了，肯定是“使用映射库”并且“使用映射库做本地版本库”；对于远程版本库的配置，强烈建议都“使用映射库”，至于要不要映射版本库到本地，对于本地来说，肯定是要好处的，花少量的磁盘空间，可以获得更快的访问速度，但是对于远程来说，太多的同步映射请求也许会增加它的负担。

　　但是如果需要离线浏览远程版本库，一定是需要映射版本库到本地的。

　　一旦在离线的环境下，如右图所示，提示无法连接远程版本库，并提示您重新配置。

　　回到配置页面Subversion配置页将连接方式改为“离线使用”。

　　进入程序主界面，版本库导航栏上的箭头没有。这是因为箭头代表“未知”版本，离线的情况下，即无法获取“未知”版本，也无法生成新的“未知”版本。

　　导航栏高级用法

　　在前面已经讲过导航栏的组成，概念，基本用法。在本节再补充说明控制台上其它按钮，结合导航栏完成的一些高级功能。

　　快速浏览文件的修改：浏览一个源代码文件是怎么一步一步从无到有写成现在这样的。

　　前面已经介绍过怎么用“查看文件版本”按钮，把所有修改了某个文件的版本闪现出来。当导航栏上有闪光版本时，滑块移动按钮组会将滑块在闪光版本间移动，当红旗，也就是比较基版本按钮按下时，滑块移动按钮组会同时移动红旗和滑块，保证红旗在滑块前一个版本位置上。而滑块移动附加操作按钮会在滑块移动的同时，附带打开文件，附带显示版本日志。

　　通过上面的介绍，就能实现快速浏览文件修改：先选择要浏览的文件，闪现它的所有修改版本，按下红旗按钮，按下移动滑块的同时打开文件按钮，显示日志按钮，然后用滑块移动按钮组移动滑块即可，向前移动是查看前一次修改，向后移动查看后一次修改。

　　快速找到文件原来的某个版本：“我”隐约记得这个源代码文件原来某个版本的样子，想找到它，怎么快速找到这个版本。

　　用二分法。先闪现这个文件的所有修改版本，如果很多，把红旗插在最近的版本位置，滑块拖动到大约修改版本一半的位置，看看是不是想要的这次修改？如果不是，也许根据内容看得出是在这之前，还是在这之后的修改：之前的修改，点击红旗/滑块互换按钮，让红旗插在中间位置，再把滑块拖动到大约四分之一的位置；之后的修改，就把滑块拖动到大约四分之三的位置。依次类推，直到精确的找到想要的版本。

　　找到大约某个时间的版本：“我”记得三天前程序运行没有问题的，现在出问题了，回到三天前的版本。

　　打开日期定位版本，会出现版本库的修改日历。点击某一天，就会定位到当天的第一个提交版本上。

　　在前面已经讲过导航栏的组成，概念，基本用法。在本节再补充说明控制台上其它按钮，结合导航栏完成的一些高级功能。

常见问题

　　什么是极客讨论器？

　　极客讨论器是对源代码进行批注和讨论的软件。

　　先说什么是批注：批注的概念来源于读书。最著名的有金圣叹批水浒，脂砚斋批红楼梦，我们看书的时候也有把其中的难点，重点画出来，用我们自己的语言解释一遍。书需要细细品读，源代码也需要认真钻研。

　　再说什么是讨论：讨论原意就是你一言我一语，针对某件事或某个人进行对话。而针对源代码的讨论更是精确到了其中的某一行，某一个语句，某一个变量上。

　　最后再说什么极客讨论器：既然是讨论器，必然有服务器或者平台才能讨论，一个人无法讨论。但是因为一个人钻研源代码的也不少，所以也有个人用的讨论器。

　　我平时写程序注释都懒得写，干吗还要批注？

　　这个问题分两种不同的情况来分别回答：第一种情况：源代码是您写的；第二种情况：源代码不是您写的。

　　有一则笑话说：程序员最恨两件事，第一件事，写程序要写注释，第二件事，看别人的程序，没有注释。

　　先说第一种情况：实话说，我们开发组都是不写注释的人。写起代码来“思绪如飞”，要停下来写写注释或者文档则感觉要被拽到地上。再实话说，如果我们真是注释写的清楚，文档写得漂亮，也不会开发这样的软件了。比起注释和文档这种由“人类”语言构成，解释由“机器”语言组成的源代码的别扭方式，极客讨论器实际上是提供“非人类”语言来解释源代码的途径。

　　什么是“非人类”语言？程序补丁，参数，图片，运行截图，链接其它程序等等。虽说软件名称叫“讨论器”，我们自己使用起来都不是用“人话”来讨论，而是类似与：“此处为3，程序截图”，“传入：'中文字符串'，浏览器截图，程序截图”，或者带一个补丁将某处代码修改为加一个for循环，然后“运行时间为”等等等等。

　　再说第二种情况：如果您“不幸”要阅读其他人写的源代码，而他的源代码又没有您能理解的注释和文档，那您就需要极客讨论器批注或者和别人讨论来理解代码了。

　　这种情况下最典型的就是开源代码。虽说在开源界是良莠不齐，鱼龙混杂，但是确实有不少非常优秀的代码。身为程序员很难做到不接触开源代码。极客讨论器能在只读的版本库上批注源代码，而且有公众平台让研究相同开源项目的程序员讨论学习，事半功倍。

　　极客讨论器是不是版本控制软件？为什么很多功能都是版本控制的功能？

　　这个问题可以说是，但也不全是。

　　第一个问题的答案如果回答得更全面一点，应该是：极客讨论器是对受版本控制的源代码进行批注和讨论的软件。因为版本控制是如此的必不可少，所以在极客讨论器内部，集成了一个图形化版本控制客户端，来进行版本控制操作。但是，核心价值还是批注和讨论源代码。

　　后面会解释为什么版本控制是必不可少的。

　　为什么对受版本控制的源代码才能进行批注和讨论？

　　请思考一下这个问题：很多人都做过在一张合影照片上标出您好友在哪里，不难吧？那如果是一段视频，里面的人在不停的走动呢？上一秒您的好友在视频左上角，下一秒到了右下角，再下一秒可能走出视频了。。。源代码就像一段视频，是“活”的，变化的，不是“死”的，静止的。一个月前您批注的这个函数，现在可能您给它改了一个名称，加了一个参数，一个月以后可能把它彻底删掉了。。。就像不能在流沙上建楼房一样，批注也不能在“流动的”源代码上进行。

　　和视频中标好友的例子类比，版本控制就相当于给源代码拍了一张张照片，批注实际上是在某一张照片上标出“好友”，当源代码改变了，成了“另一张照片”，极客讨论器会和翻出批注时的源代码“照片”，进行对比，重新定位到“好友”的最新位置上。

　　为什么选用subversion做版本控制？

　　subversion在版本控制界的地位我们在这里无需给它打广告了。如果说它在开源界，企业内部，乃至个人使用的版本控制都排在前几位，相信异议不大。当然不说它具有绝对的领先地位，比如在开源界，就大有被git后来居上的态势。不过哪怕是github，它的每个项目也都有subversion的接口。

　　熟悉版本控制的朋友都知道，subversion通常意义上说它是集中式版本控制，而git，hg等等是分布式版本控制。但是subversion支持版本库的本地化同步，使得它在实际使用时也可以分布式访问，比起git/hg不差。极客讨论器内部集成了subversion的本地化同步功能，无需额外操作，即可享受到比远程访问更快捷的访问，还可以离线访问远程版本库。

　　极客讨论器会和我常用的subversion客户端相冲突吗？

　　不会。实际上在我们开发组内部也都安装了subversion命令行客户端，TortoiseSVN等软件，所有这些subversion客户端，包括SmartSVN，SyncSVN，VisualSVN等等，我们测试了许多，都没有出现有冲突的情况。

　　特别是subversion命令行客户端，和TortoiseSVN，分别使用控制台和集成到资源管理器中，它们提供的某些便捷是极客讨论器所比不了的，反过来说，极客讨论器所实现的核心价值，“极客讨论”，也是用控制台或者资源管理器所不擅长的。极客讨论器也不会去重复它们的功能。

　　极客讨论器会支持其它版本控制吗？

　　会的，不久的将来，git和hg都会集成到极客讨论器中