ShowDoc是一款非常适合写IT文档的系统,《奕蝶系统云重装帮助手册》就是用这款软件写的,非常方便、美观。但我用这个文档软件也就是想发布一个帮助手册,不会再写第二个项目了,可是软件里面好像没有将某一项目设置成默认主页的功能,输入域名https://help.grandbutterfly.com/打开的是系统默认页面,必须输入项目的地址才能查看手册内容:https://help.grandbutterfly.com/web/#/1?page_id=1,这就很不方便,能不能将默认打开的主页设置为手册项目的主页面呢?既然ShowDoc没有这个功能,只能看源代码了,幸运的是,只要对源代码稍做改动,就可以实现这一小目标。
ShowDoc默认打开的主页面如下图:
下面我们来修改一点源代码,首先从软件根目录依次打开以下路径:
/server/Application/Home/Controller/
在此目录下打开“IndexController.class.php
”文件,如下图:
我们找到第13行代码:
header("location:./web/#/");
这行代码就是打开首页后要路转的地址,现在默认是跳转到了“/web/#/
”这个地址,就是我们上图所示页面。
我们正是通过修改这条语句来控制跳转的目标路径,我们将跳转路径修改为:
header("location:./web/gb.html");
如下图所示:
修改完成保存文件。
现在我们跳转的“gb.html
”并不是我们项目的主页,只是一个中间页面,我们还需要将这个中间页面跳转到项目主页才行,我们在web目录下新建一个“gb.htm
l”文件,编辑如下内容:
<!DOCTYPE html> <html> <head> <meta http-equiv="refresh" content="0;url=https://help.grandbutterfly.com/web/#/1?page_id=1" /> <meta charset=utf-8> <meta name=viewport content="width=device-width,initial-scale=1"> <meta name=renderer content=webkit> <meta http-equiv=X-UA-Compatible content=edge> <title>奕蝶系统云重装帮助手册 - GrandButterfly.com</title> <meta name=keywords content="奕蝶SCR,一键重装系统,GrandButterfly"> <meta name=description content="奕蝶系统云重装,奕蝶SCR,一键重装系统,奕蝶系统软件,GrandButterfly System Cloud Reinstall"> </head> <p></p> <div><span> 正在打开《奕蝶系统云重装帮助手册》,请稍候……</span></div> </body> </html>
如下图所示:
其中最重要的一句就是:
<meta http-equiv="refresh" content="0;url=https://help.grandbutterfly.com/web/#/1?page_id=1" />
这个标签,作用是打开这个页面后再次跳转到手册项目页面,执行过程如下图:
跳转完成如下图:
通过这一处小小的修改,就将默认的页面替换成我们的项目地址了,以后再打开https://help.grandbutterfly.com这个网址就直接查看到帮助手册了。
总结一下修改过程:
1、找到跳转代码:header("location:./web/#/");
。
2、修改跳转目标为一个中间页面:gb.html
3、新建中间页面:gb.html
。
4、将中间页面跳转到最终的目标页面,这里通过标签的refresh功能实现:
<meta http-equiv="refresh" content="0;url=https://help.grandbutterfly.com/web/#/1?page_id=1">
对ShowDoc研究不是很深,不过很感谢作者提供了这么方便易用的软件,可能我的方法比较绕远,不过也实现了我所要的功能,如果有更好的方法希望大家也分享一下,谢谢。
原创文章,作者:斑斓网站长,如若转载,请注明出处:https://www.argb.net/showdoc-index-replaced-project-index.html