自己的计算机上建立lxr源代码检索服务器

SourceInsight固然在windows下面分析源代码很但方便，但是我的工作平台是linux，linux下面也需要经常对代码进行分析和检索，我试用过多种分析工具，最后还是确定使用lxr，通过参考一位台湾朋友t@c发表的一篇名为
Technical Writing's Rule Of Thumb + Local Web based Code Cross Reference (eg. LXR clone)
的文章得以在我的工作计算机ubuntu 8.04和家用计算机ubuntu 8.10上搭建成功，谨在此向t@c仁兄致敬。

现在我把原文略加修改（原文为繁体中文，若干专有名词与大陆不同，作者使用的内核代码为2.6.24，我自己的是2.6.26）后转述如下：

01) LXRng依赖许多package，因此需要安装相关软件，使用如下命令：
$ sudo aptitude install git-core postgresql-8.3 postgresql-client-8.3 libxapian15 libsearch-xapian-perl apache2 libapache2-mod-perl2 libcgi-simple-perl libcgi-ajax-perl libhtml-parser-perl libtemplate-perl libterm-progressbar-perl libdevel-size-perl libdbd-pg-perl ctags

2) 数据库增加有用最大权限的使用者帐号，指令为：
$ sudo -i
$ su - postgres
$ createuser user # Answer "yes" when asked about superprivileged access
$ exit
$ exit

3) 建立数据库，并将http使用者设定为数据库的一般使用者，因此在建立www-data帐号遇到的问题全部回答"N"，指令为：
$ createdb lxrng
$ createuser www-data

4) 由LXR的repository取得LXRng，指令为：
$ cd ~
$ git-clone

5) 启动LXRng设定，指令为：
$ cd ~/lxrng
$ cp lxrng.conf-dist lxrng.conf
$ vim lxrng.conf

6) 将以下字符串注释掉
use LXRng::Repo::Git;
my $gitrepo = LXRng::Repo::Git
->new('/var/lib/lxrng/repos/linux-2.6/.git',
release_re => qr/^v[^-]*$/,
author_timestamp => 0);
my $search = LXRng::Search::Xapian->new('/var/lib/lxrng/text-db/linux-2.6');

7) 新增加以下新的字符串，指令为：
use LXRng::Repo::Plain;
my $plainrepo = LXRng::Repo::Plain->new('/home/user/src/linux-source'); [11]
my $search = LXRng::Search::Xapian->new('/home/user/src/linux-source-2.6.26-textdb'); [12]

8) 修改下列字符串：postgresq
'repository' => $gitrepo, --改为--> 'repository' => $plainrepo,
'base_url' => 'http://lxr-test.linpro.no/lxr', --改为--> 'base_url' => 'http://localhost/lxr', [13]
'cache' => '/var/lib/lxrng/cache', --改为--> 'cache' => '/home/user/lxrng/cache', [14]
'ver_list' => [$gitrepo->allversions], --改为--> 'ver_list' => ['v2.6.26'],
'ver_default' => 'v2.6.20.3', --改为--> 'ver_default' => 'v2.6.26',

9) save&quite（emacs or vim in this example）

10) 下载Linux kernel source code并将目录设置为7）8）中设定好的目录相符合
$ mkdir ~/src
$ cp linux-2.6.26.tar.gz ~/src
$ cd ~/src
$ tar -xzvf linux-2.6.26.tar.gz
$ mkdir linux-source
$ mkdir linux-source/v2.6.26
$ mv linux-source-2.6.26/* linux-source/v2.6.26
$ mkdir linux-source-2.6.26-textdb
$ mkdir ~/lxrng/cache
$ chmod 777 ~/lxrng/cache -R
$ chmod 777 ~/lxrng/webroot -R
$ make -C ~/lxrng/webroot/.static/gfx

11) 生成Linux-2.6.26的XR，指令为：
$ cd ~/lxrng
$ ./lxr-db-admin linux --init
$ ./lxr-genxref linux

12) 设置Apache2
$ cp apache2-site.conf-dist-mod_perl apache2-site.conf
$ sudo ln -s ~/lxrng/apache2-site.conf /etc/apache2/sites-enabled/010-lxrng
$ vim apache2-site.conf
将所有"@@LXRROOT@@"替换成"/home/user/lxrng"
将"@@LXRURL@@"替换成"lxr"

13) 重新启动Apache2
$ sudo /etc/init.d/apache2 reload

14) 使用浏览器打开http://localhost/lxr即可进行代码检索。

如 果要更换domain name，可将现有的"localhost"改为"somewhere.com"，只需要将"lxrng.conf"中的"base_url"替换之后再 执行./lxr-genxref linux即可，这次的执行时间十分短，因为XR都已经存在，现在即可使用浏览器打开新的网址"http://somewhere.com/lxr"检索 代码。至此，配置完毕，希望对大家有用。