【译】PCL官网教程翻译(9)：为PCL生成一个本地文档 - Generate a local documentation for PCL

英文原网页查看。
修订：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