英文原网页查看。
修订:20201115
为PCL生成一个本地文档
出于实用性原因,您可能希望有一个与PCL版本相对应的本地文档。在本教程中,您将学习如何生成它,以及如何设置Apache,以便搜索栏能够正常工作。
本教程是为Ubuntu 12.04和14.04编写的,您可以在GitHub上编辑它来添加您的平台。
依赖性
您需要安装一些依赖项,以便能够生成文档:
$ sudo apt-get install doxygen graphviz sphinx3 python-pip
$ sudo pip install sphinxcontrib-doxylink
生成文档
进入已配置PCL的build文件夹(参见教程),并输入:
$ make doc
然后你可以用浏览器打开文档,例如:
$ firefox doc/doxygen/html/index.html
文件已在PCL构建目录中生成,但尚未安装;如果你想安装它,只需:
$ sudo make install
默认的PCL CMAKE_INSTALL_PREFIX是/usr/local,这意味着文档将位于/usr/local/share/doc/pcl-1.7/html/index.html中
注意
您将很快注意到搜索栏无法工作!(打开搜索”搜索“,而不是搜索)
安装和配置Apache
Apache (Apache HTTP服务器)是一个web服务器应用程序,在本节中,您将学习如何配置Apache,以便能够在脱机文档中使用搜索功能。
首先你需要安装Apache和php:
$ sudo apt-get install apache2 php5 libapache2-mod-php5
然后你需要编辑默认的网站位置:
$ sudo gedit /etc/apache2/sites-available/000-default.conf
将DocumentRoot(默认值= /var/ww /html)更改为/usr/local/share/doc/pcl-1.7/html/(或您的本地PCL doc构建路径)
然后更改Apache目录选项:
$ sudo gedit +153 /etc/apache2/apache2.conf
将第153行的一段改为:
<Directory />
#Options FollowSymLinks
Options Indexes FollowSymLinks Includes ExecCGI
AllowOverride All
Order deny,allow
Allow from all
</Directory>
重启Apache,如果打开localhost,搜索栏就可以工作了:
$ sudo /etc/init.d/apache2 restart
$ firefox localhost