一种基于Markdown的文档管理方法技术

本发明专利技术公开了一种基于Markdown的文档管理方法，属于项目文档的在线管理技术领域，基于Markdown+pandoc技术，采用脚本发布的方式，将用户编写的.md文档生成html文件并发布到文档开发项目对应的文件目录中；文档开发项目中使用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架进行页面的布局，将网页的内容和页面结构分离，以达到顶部和左侧页面结构共享的目的。本发明专利技术从项目文档的管理出发，提供了一种文档在线化管理的方式，实现文档的规范化编写、生成、发布与展示，提高文档编写的效率。

【技术实现步骤摘要】

本专利技术涉及项目文档的在线管理
，具体地说是一种基于Markdown的文档管理方法。
技术介绍
传统意义上项目文档管理的本地化与用户需求的在线化相冲突，从而导致较低的工作效率及较多的工作量。传统的文档管理方式是将项目相关的文档放在本地的doc文件夹中，用户使用时需要联系开发等相关管理人员，这样一来既浪费时间也增加相关人员的工作量。
技术实现思路
本专利技术的技术任务是针对以上不足之处，提供一种基于Markdown的文档管理方法，来解决项目文档管理的本地化与用户需求的在线化相冲突从而导致的较低的工作效率及较多的工作量的问题。本专利技术解决其技术问题所采用的技术方案是：一种基于Markdown的文档管理方法，包括：基于Markdown+pandoc技术，采用脚本发布的方式，将用户编写的.md文档生成html文件并发布到文档开发项目对应的文件目录中；文档开发项目中使用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架进行页面的布局，将网页的内容和页面结构分离，以达到顶部和左侧页面结构共享的目的；左侧页面结构采用垂直导航的形式来展现各业务模块文档的菜单及菜单项；左侧菜单叶子结点导航至具体文档的html页面，采用cooki一种基于Markdown的文档管理方法缓存的方式记录当前页面，使左侧对应的菜单项为选中状态。sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架技术是将页面结构与内容相分离的互联网风格的页面布署技术，在本项目中将页面结构分成顶部导航和左侧菜单、右侧内容两部分，利用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh的配置文件将两个部分组合起来，形成一个页面。左侧菜单部分利用cooki一种基于Markdown的文档管理方法缓存技术，将请求页面链接的共有属性data-nam一种基于Markdown的文档管理方法保存到页面的缓存中，以记录被请求的菜单项使其处于选中状态。本专利技术的一种基于Markdown的文档管理方法和现有技术相比，具有以下有益效果：提高文档编写的效率、提供给用户与开发者便于交流的接口、灵活的菜单项配置与保存技术、各业务间文档的独立发布易于业务的扩展；提高文档编写的效率，利用Markdown与Pandoc技术，实现标记语言间的格式转换；提供给用户与开发者便于交流的接口，使用户通过在线文档的预览快速定位所需要的内容，减少与开发者间不必要的联系，提高工作效率；灵活的菜单项配置与保存技术，呈现给用户比较友好的用户交互界面；各业务间文档的独立发布易于业务的扩展，减少各模间的发布冲突；本专利从项目文档的管理出发，提供了一种文档在线化管理的方式，实现文档的规范化编写、生成、发布与展示。具体实施方式下面结合具体实施例对本专利技术作进一步说明。一种基于Markdown的文档管理方法，包括：基于Markdown+pandoc技术，采用脚本发布的方式，将用户编写的.md文档生成html文件并发布到文档开发项目对应的文件目录中；文档开发项目中使用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架进行页面的布局，将网页的内容和页面结构分离，以达到顶部和左侧页面结构共享的目的；左侧页面结构采用垂直导航的形式来展现各业务模块文档的菜单及菜单项；左侧菜单叶子结点导航至具体文档的html页面，采用cooki一种基于Markdown的文档管理方法缓存的方式记录当前页面，使左侧对应的菜单项为选中状态。1、文档的编写与生成说明：文档的编写与生成基于markdown和pandoc技术，并在各业务项目中编写文档发布的脚本文档d一种基于Markdown的文档管理方法ploy_to_wiki.xml。Markdown是一种轻量级的标记语言，在使用该语言时，文档的编写者只需要关注文档的内容而不用担心平台与格式的困扰。在本实现方法中，各业务的文档编写者需在本地项目的doc文件夹中建立md子文件夹，里面放置使用markdown语法编写的.md文件及图片文件夹img。为了文档的分享与多平台的使用，需要对MD文件进行格式转化，Pandoc是一个用于从一种标记格式转换为另一种的Hask一种基于Markdown的文档管理方法ll库，它的功能是在多种常见的标记语言进行相互转换。由此，文档编写者在本地需要安装pandoc.一种基于Markdown的文档管理方法x一种基于Markdown的文档管理方法程序并编写d一种基于Markdown的文档管理方法ploy_to_wiki.xml脚本文件，将编写完成的.md文件转换成.html文件并发布至文档开发项目对应的文件夹中。2、文档展示项目的架构布署说明：文档开发项目中主要是存放与展示各业务项目发布过来的.html文档。文档的展示主要使用前端sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架技术进行布署配置，形成友好的界面交互。sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架技术是将页面结构与内容相分离的互联网风格的页面布署技术。在本项目中将页面结构分成顶部导航和左侧菜单、右侧内容两部分，利用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh的配置文件将两个部分组合起来，形成一个页面。左侧菜单部分利用cooki一种基于Markdown的文档管理方法缓存技术，将请求页面链接的共有属性data-nam一种基于Markdown的文档管理方法保存到页面的缓存中，以记录被请求的菜单项使其处于选中状态。各业务项目的文档编写者需要在左侧菜单页面中配置相应的菜单项。通过上面具体实施方式，所述
的技术人员可容易的实现本专利技术。但是应当理解，本专利技术并不限于上述的具体实施方式。在公开的实施方式的基础上，所述
的技术人员可任意组合不同的技术特征，从而实现不同的技术方案。除说明书所述的技术特征外，均为本专业技术人员的已知技术。本文档来自技高网...

【技术保护点】
一种基于Markdown的文档管理方法，其特征在于包括：基于Markdown+pandoc技术，采用脚本发布的方式，将用户编写的.md文档生成html文件并发布到文档开发项目对应的文件目录中；文档开发项目中使用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架进行页面的布局，将网页的内容和页面结构分离，以达到顶部和左侧页面结构共享；左侧页面结构采用垂直导航的形式来展现各业务模块文档的菜单及菜单项；左侧菜单叶子结点导航至具体文档的html页面，采用cooki一种基于Markdown的文档管理方法缓存的方式记录当前页面，使左侧对应的菜单项为选中状态。

【技术特征摘要】
1.一种基于Markdown的文档管理方法，其特征在于包括：基于Markdown+pandoc技术，采用脚本发布的方式，将用户编写的.md文档生成html文件并发布到文档开发项目对应的文件目录中；文档开发项目中使用sit一种基于Markdown的文档管理方法m一种基于Markdown的文档管理方法sh框架进行页面的布局，将网页的内容和页面结构分离，以达到顶部和左侧页面结构共享；左侧页面结构采用垂直导航的形式来展现各业务模块文档的菜单及菜单项；左侧菜单叶子结点导航至具体文档的html页面，采用cooki一种基于Markdown的文档管理方法缓存的方式记录当前页面，使左侧对应的菜单项为选中状态。2.根据权利要求1所述的一种基于Markdown的文...

【专利技术属性】
技术研发人员：彭文净，吴玉雁，
申请(专利权)人：浪潮软件股份有限公司，
类型：发明
国别省市：山东;37