二次开发
<h4>技术栈说明</h4>
<p>前端:Vue + ElementUI
后端:为了兼容低版本的php运行环境(兼容至5.3),同时兼容旧版showdoc的历史包袱,使用的是保守的ThinkPHP3.2.3框架
数据库:showdoc自带文件型数据库(/Sqlite/showdoc.db.php),不需要用户手动安装数据库</p>
<h4>开发前准备</h4>
<p>开发机器需要先安装好PHP环境(php5.3以上)和NodeJS环境(例如node v16.20)
下载代码并放置到PHP环境下的www目录
先在浏览器通过地址访问,以便完成showdoc的初始化安装(如已安装过则忽略)
在命令行里进入showdoc的web_src目录,执行npm install 以安装依赖。(若无npm,你则先要安装NodeJS环境,例如node v16.20)</p>
<h4>前端开发</h4>
<p>执行npm run dev 以启用调式模式,通过访问 localhost:8080 便可以实时看到改动的效果。请使用代理以便请求后端API的时候代理到PHP服务端。设置代理可以用自己顺手的代理工具,或者参考[ 这里 ](<a href="https://github.com/star7th/showdoc/issues/1334">https://github.com/star7th/showdoc/issues/1334</a> " 这里 ")
需要执行npm run build 才会最终打包生效。打包后的静态文件会在/web目录下</p>
<p>主要涉及到的目录和文件:</p>
<pre><code>web_src/src/router #页面路由。可以根据url定位到组件
web_src/src/components #页面组件基本都放在这里
web_src/static #静态资源目录
web_src/src/assets/lang #前端语言包</code></pre>
<h4>后端开发</h4>
<p>主要涉及到的目录和文件</p>
<pre><code>server/Application/Api/ #应用目录,基本所有后台api都放在这里
server/Application/Runtime/Logs #如果有错误日志,会直接打印出浏览器或者打印到这里
Public/Uploads #上传的图片放置在此处
server/Application/Api/Lang #后端语言包</code></pre>
<h4>其它说明</h4>
<p>二次开发后请尊重开源项目,保留版权标识和链接
如开发了好用的功能,不妨贡献到官方github代码仓库以分享给大家用
showdoc往后升级可能会覆盖你原有的二次开发。如果想兼容,最好提交到官方仓库成为官方功能。</p>