登录  /  注册

php之markdown文档管理工具的实现代码

小云云
发布: 2018-02-01 14:14:44
原创
2231人浏览过

本文主要和大家分享php之markdown文档管理工具的实现代码,希望能帮助到大家。

主要目标:

1.可以多人编辑

2.可以在浏览器中查看

3.有一个可以折叠的目录

4.支持多级目录

5.支持markdown

6.快, 方便

工作后一直在从事PHP开发, 从以前的大包大揽到现在的退居服务端写接口, 当中接触过几个的接口文档管理工具或系统, 简单描述下:

  1. showdoc, 功能全面而且简洁, 有用户,权限管理功能, 支持markdown, 支持导出word, 有多种文档模板, 目录支持两级折叠

  2. confluence, 功能强大(权限管理, 邮件提醒, 全文搜索, 插件管理等), 重, 收费的一个文档管理系统

  3. swagger, 需要在代码中写大量的注释去配合

  4. readmine, 功能丰富类似confluence, 它的文档是以txt保存的, 可以追溯变更, 可以全文搜索, 但是写文档有点痛苦, 适合任务/bug跟踪管理等

  5. gitbook, nodejs安装, 支持markdown, 支持npm插件, 左侧的可折叠的目录树就需要装插件, 也可以装搜索插件, 目录是单独的markdown文件, 我使用的时候感觉从md到HTML编译太慢(600+的文档, 要编译25分钟多, 如果有增量编译或提高编译速度的插件还请各位赐教

解决方法:

  1. 结合git就可以实现, 正好也可以利用git的权限管理功能

  2. 需要将markdown编译成HTML文件部署到内网

  3. 因为要在浏览器中查看, 这里最终选择了接入简单, 界面清爽, 无依赖的dtree.js (不依赖jQuery)

  4. 这个功能用了树的后根序遍历算法实现了对多级文件的读取(没有用递归, 担心写着写着把自己绕进去), 正好dtree.js 也支持多级目录折叠

  5. 这里我最终选择了segmentfault官方出的PHP编译工具类(因为他们已经参考优化了很多类似的PHP类,感谢~)

  6. 快的话, 编译600多个文件, PHP用时2s左右,可以接受, 而且支持增量编译; 方便的话, 主要体现在目录是自动生成的, 不需要单独在编写目录

其中遇到的问题:

增量编译

刚开始判断一个md文件是否需要编译成HTML, 是拿md文件的创建时间和最后修改时间做对比进行判断的,
但是后来发现, 一些复制来的, 重命名的文件用这个方法就不起作用.
最后使用了一个中间文件, 去记录本次编译的文件的时间, 再跟 max(创建时间, 最后修改时间)对比判断是否需要编译

删除多余文件

后续使用过程中发现, 有些md文档被删除了, 但是没有自动删除最终编译后的文件,
因此, 在编译时会对md文件和最后的HTML文件坐一个差集, 删掉那些多余的HTML文件

整合dtree.js

首先, dtree.js需要一定要求的json数据才能显示目录和进行展开和折叠的交互
还有, dtree.js字体比较小, 他的图片,样式,脚本文件都是相对路径, 我这里对路径做了相应修改, 使之改为基于当前域名的绝对路径, 这样部署到不同的域名下是不用修改dtree.js代码的层级目录的

组装, 美化HTML

组装是事先写好HTML的头部, 底部, 侧边栏等的HTML代码, 然后把这些内容拼接到编译后的内容前后, 最后再放到相应的文件夹中去
美化, 这个主要是因为segmentfault官方出的编译工具并没有对HTML元素(例如, table, code)添加样式, 我这里找到github的相关css样式进行了美化

支持多级目录

这个也是耗费了我大量脑细胞写出来的, 大学的时候写动态哈夫曼编码的时候写过一遍树的遍历了,
本以为驾轻就熟, 谁知道折腾到夜里3点多才最终写好, 这个功能也算是核心组件之一了吧。

相关推荐:

Vuejs使用 vue-markdown 来渲染评论方法

VSCode中预览markdown和修改预览样式

markdown编辑器的简单介绍

以上就是php之markdown文档管理工具的实现代码的详细内容,更多请关注php中文网其它相关文章!

智能AI问答
PHP中文网智能助手能迅速回答你的编程问题,提供实时的代码和解决方案,帮助你解决各种难题。不仅如此,它还能提供编程资源和学习指导,帮助你快速提升编程技能。无论你是初学者还是专业人士,AI智能助手都能成为你的可靠助手,助力你在编程领域取得更大的成就。
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
作者最新文章
最新问题
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2024 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号