目录
解决方法:
其中遇到的问题:
增量编译
删除多余文件
整合dtree.js
组装, 美化HTML
支持多级目录
首页 后端开发 php教程 php之markdown文档管理工具的实现代码

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

Feb 01, 2018 pm 02:14 PM
markdown php 管理工具

本文主要和大家分享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中文网其他相关文章!

本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

AI Hentai Generator

AI Hentai Generator

免费生成ai无尽的。

热门文章

R.E.P.O.能量晶体解释及其做什么(黄色晶体)
2 周前 By 尊渡假赌尊渡假赌尊渡假赌
仓库:如何复兴队友
4 周前 By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island冒险:如何获得巨型种子
3 周前 By 尊渡假赌尊渡假赌尊渡假赌

热工具

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版

SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6

Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

CakePHP 项目配置 CakePHP 项目配置 Sep 10, 2024 pm 05:25 PM

在本章中,我们将了解CakePHP中的环境变量、常规配置、数据库配置和电子邮件配置。

适用于 Ubuntu 和 Debian 的 PHP 8.4 安装和升级指南 适用于 Ubuntu 和 Debian 的 PHP 8.4 安装和升级指南 Dec 24, 2024 pm 04:42 PM

PHP 8.4 带来了多项新功能、安全性改进和性能改进,同时弃用和删除了大量功能。 本指南介绍了如何在 Ubuntu、Debian 或其衍生版本上安装 PHP 8.4 或升级到 PHP 8.4

CakePHP 日期和时间 CakePHP 日期和时间 Sep 10, 2024 pm 05:27 PM

为了在 cakephp4 中处理日期和时间,我们将使用可用的 FrozenTime 类。

CakePHP 文件上传 CakePHP 文件上传 Sep 10, 2024 pm 05:27 PM

为了进行文件上传,我们将使用表单助手。这是文件上传的示例。

CakePHP 路由 CakePHP 路由 Sep 10, 2024 pm 05:25 PM

在本章中,我们将学习以下与路由相关的主题?

讨论 CakePHP 讨论 CakePHP Sep 10, 2024 pm 05:28 PM

CakePHP 是 PHP 的开源框架。它的目的是使应用程序的开发、部署和维护变得更加容易。 CakePHP 基于类似 MVC 的架构,功能强大且易于掌握。模型、视图和控制器 gu

如何设置 Visual Studio Code (VS Code) 进行 PHP 开发 如何设置 Visual Studio Code (VS Code) 进行 PHP 开发 Dec 20, 2024 am 11:31 AM

Visual Studio Code,也称为 VS Code,是一个免费的源代码编辑器 - 或集成开发环境 (IDE) - 可用于所有主要操作系统。 VS Code 拥有针对多种编程语言的大量扩展,可以轻松编写

CakePHP 创建验证器 CakePHP 创建验证器 Sep 10, 2024 pm 05:26 PM

可以通过在控制器中添加以下两行来创建验证器。

See all articles