/Adoc

📄🖊轻松的的 API MD文档编写工具

Primary LanguagePHP

Adoc

Just Another markdown doc editor

PHP 7.2 + Laravel 5.8 + React-Bootstrap

Features

  1. UI使用直角主题,以及不会腻的黑白色
  2. 编辑快捷键添加 ctrl/cmd + shift + s 保存并返回
  3. 添加了文档活动记录,暂无其他用途,只是个历史查看谁改动了哪些文档
  4. github 风格文档历史对比(react-diff-viewer)
  5. 添加文档附件功能
  6. 编辑、展示和导出都使用 editor.md,(showdoc编辑和展示是两个不同的程序)
  7. 文档菜单无限极分类(编辑父级同样)
  8. 文档菜单滑动到顶部固定
  9. 文档搜索
  10. 编辑器/显示 使用等宽字体,避免空格排版、数字/符号显示不明显问题
  11. JSON工具生成MD表格为字段增加了 padEnd 空格填充,使之尽量都在一列
  12. 文档左侧列表拖动排序(react-beautiful-dnd),湿滑纵享,强迫症福利
  13. 文档点赞,文档评论

💚github

github

安装

git clone https://github.com/yybawang/Adoc.git
cd Adoc
composer install
php artisan app:install

// 访问 APP_URL 测试

升级

  • 更新代码和数据库迁移
git pull
composer install
php artisan migrate
  • 项目功能
    • 项目新增
    • 项目配置
    • 项目权限分配,使用 gate
    • 项目删除
    • 项目所有权转移
    • 项目置顶,列表排前显示,替代排序功能(只会影响当前用户,非全局排序)
    • 项目tag标签
    • 列表可选使用 tag 分组展示
  • 文档功能
    • 文档增删改查
    • 文档自定义模版
    • 文档修改历史,对比、还原
    • 文档模版
    • markdown 编辑器图片上传,上传到 laravel 配置的 filesystem 配置中,默认 public
    • 文档编辑时可能已被修改过,提示先备份再编辑
    • 文档搜索,头部右上角,暂只支持搜索当前展示项目下文档
    • 文档列表拖动排序
    • 文档附件
    • JSON工具,json 转MD表格,json 美化
    • 文档 github 风格选择 emoji 反应
    • 文档评论,三天内可删除
    • 新建文档如果未填写标题,默认为 Y-m-d,用于在线记事本使用
  • 编辑器快捷键优化
    • Ctrl/Cmd + s 保存(停留当前页), Ctrl/Cmd + Shift + s 保存并返回到列表
    • Ctrl + d 插入当前时间
    • Cmd + d 复制当前行到下一行

示例 示例 示例 示例 示例