ShowDoc是一个不错的技术文档工具，也可以自行在centos搭建后记录一些个人信息。文档支持Markdown语法，可以导出pdf文件。
说明：Centos 系统为 7.6
一 配置Apache 2.4
yum list httpd //查看是否安装了httpd服务
yum -y install httpd //安装httpd服务
service httpd start //启动httpd服务
systemctl enable httpd.service //如有必要，设置开机启动
安装完后，请确认成功。使用本地浏览器尝试打开http://1.1.1.1/。记得开启centos上的端口限制。
二 配置PHP 7.2
参看： CentOS 7 安装 PHP 7 https://www.jianshu.com/p/7c0e6c2663fd
安装完成后，记得确认成功。建立一个phpinfo文件测试一下。
touch /var/www/html/phpinfo.php
vim /var/www/html/phpinfo.php
在phpinfo.php文件中输入
<?php phpinfo(); ?>
保存关闭，然后通过本地浏览器访问http://1.1.1.1/phpinfo.php，是否可以输出php信息，我自己部署就偶尔会遇到不能正确输出的情况。
2.1 有可能打不开文件，修改php.ini，设置short_open_tag = On，
参看：
https://blog.csdn.net/weixin_43182313/article/details/110122710?utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7EBlogCommendFromMachineLearnPai2%7Edefault-6.control&dist_request_id=1330144.20895.16181105770208477&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7EBlogCommendFromMachineLearnPai2%7Edefault-6.control
2.2 到这里豁然开朗，临时把 phpinfo() 这个方法从disable_functions 中删除掉，重新加载 php.ini 文件
参看：
https://blog.csdn.net/qq393008294/article/details/75783382?utm_medium=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7EBlogCommendFromMachineLearnPai2%7Edefault-1.control&dist_request_id=&depth_1-utm_source=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7EBlogCommendFromMachineLearnPai2%7Edefault-1.control
排除bug之后，就能看到输出了。
三 部署ShowDoc
ShowDoc 官网:https://www.showdoc.com.cn/
安装形式我一般是选择自行下载后安装。
mkdir /home/ftp //在centos home目录建立一个ftp目录
cd /home/ftp
wget https://github.com/star7th/showdoc/archive/refs/heads/master.zip //下载到ftp目录
yum -y install unzip //安装unzip解压软件，如果没有的话
unzip master.zip //解压
解压后会生成目录 showdoc-master,该目录下所有文件copy到web目录。
cp -R showdoc-master/* /var/www/html/
然后使用本地浏览器打开 http://1.1.1.1/install，通常会提示
请赋予 install 目录以可写权限！
请赋予 Public/Uploads/ 目录以可写权限！
请赋予 server/Application/Runtime 目录以可写权限！
请赋予 server/Application/Common/Conf/config.php 文件以可写权限！
请赋予 server/Application/Home/Conf/config.php 文件以可写权限！
(如果你确定赋予了文件权限但却一直看到此信息，则可考虑关闭selinux试试)
请安装php-mbstring
请赋予 Sqlite 目录以可写权限！【这是后面会遇到的，可以提前修改一下】
cd /var/www/html
chmod -R o+w install/
chmod -R o+w Public/Uploads/
chmod -R o+w server/Application/Runtime/
chmod o+w server/Application/Common/Conf/config.php
chmod o+w server/Application/Home/Conf/config.php
chmod -R o+w Sqlite/
安装php-mbstring。挨个照着处理好。处理完成，没有错误后，就可以进入showdoc了。
文档支持Markdown语法，非常方便。
学海无涯，错误难免，如有发现，尽请指正。
--the end
