/docs

Primary LanguagePHP

介绍

Markdown文档管理系统基于Laravel10.x + Dcatadmin2.2.3-beta 开发 主要解决Markdown的文档层级从属关系以及私密文档部署(密码访问),主要用途为个人备用文档使用。

安装步骤

1.克隆代码

git clone https://github.com/Textloding/docs.git

2.进入目录复制.env配置文件并修改数据库等配置信息

cp .env.example .env

3.安装依赖

composer install

4.创建软链接

php artisan storage:link

5.发布资源

php artisan admin:publish

6.安装后台

php artisan admin:install

7.填充数据库

php artisan db:seed

#首次安装执行上面单独一条命令即可
#如果只需要填充菜单则执行如下命令
php artisan db:seed --class=AdminTablesSeeder
#如果只需要文档则执行如下命令
php artisan db:seed --class=DocumentsSeeder

8.生成appkey

php artisan key:generate

9.设置运行目录伪静态 10.运行项目

前台入口:http://你的域名
后台入口:http://你的域名/admin 
账号:admin
密码:admin

可使用的快捷命令

#按顺序导出现有documents、versions、chapters、articles四个表的数据生成DocumentsSeeder种子文件
php artisan export:documents-seed

前台展示

pkyKQWq.md.png

暗夜模式(目前只主页更改)

pkyKNTJ.md.png

验证密码页

pkyKr6K.md.png

文档展示页

pkyK51P.md.png

文章详情页

pkyKLkj.md.png

后台展示

文档管理

pkyKvpq.md.png

版本管理(公开开关暂不可用)

pkyM9nU.md.png

章节管理

pkyMG9I.md.png

文章管理

pkyMG9I.md.png

文章编辑

pkyMG9I.md.png

待解决已知问题

1.BUG问题

  • Dcatadmin内置的Markdown编辑器会因为文档过长造成保存后无法再次编辑文章的问题 2.体验优化问题

3.逻辑问题

  • 后台有空目录(目录下没有文章)前台不展示 4.Dcatadmin文档问题
  • 版本日志更新图片没有本地化
  • 文章具体内容内部链接跳转仍是learnku站点

待实现功能问题

1.版本管理开放开关按钮问题