[發(fā)明專利]文檔格式轉(zhuǎn)換方法、裝置、設(shè)備及可讀存儲介質(zhì)

在審

• 申請?zhí)枺?/td>: 202010045628.9
• 申請日: 2020-01-16
• 公開（公告）號: CN111290996A
• 公開（公告）日: 2020-06-16
• 發(fā)明（設(shè)計）人: 江鵬凱
• 申請（專利權(quán)）人: 平安醫(yī)療健康管理股份有限公司
• 主分類號: G06F16/11
• 分類號: G06F16/11;G06F9/445;G06F40/117
• 代理公司: 北京中強智尚知識產(chǎn)權(quán)代理有限公司 11448
• 代理人: 黃耀威

本發(fā)明公開了一種文檔格式轉(zhuǎn)換方法、裝置、設(shè)備及可讀存儲介質(zhì)，涉及互聯(lián)網(wǎng)技術(shù)領(lǐng)域，可以通過運行格式轉(zhuǎn)換文件，對目標文檔的內(nèi)容進行標記，生成目標文檔的Markdown文件，進而對Markdown文件進行格式轉(zhuǎn)換，生成指定轉(zhuǎn)換格式的指定文檔，使得直接輸出Word格式或者PDF格式的文檔，無需再執(zhí)行其他的格式轉(zhuǎn)換操作，提高了生成的文檔的兼容性，降低了團隊之間的溝通成本。所述方法包括：運行格式轉(zhuǎn)換文件，在格式轉(zhuǎn)換文件對應(yīng)的文檔調(diào)取路徑中獲取目標文檔；基于格式轉(zhuǎn)換文件，對目標文檔的內(nèi)容進行標記，生成目標文檔的Markdown文件；確定用戶的指定轉(zhuǎn)換格式，對Markdown文件進行格式轉(zhuǎn)換，生成指定轉(zhuǎn)換格式的指定文檔。

技術(shù)領(lǐng)域

本發(fā)明涉及互聯(lián)網(wǎng)技術(shù)領(lǐng)域，特別是涉及一種文檔格式轉(zhuǎn)換方法、裝置、設(shè)備及可讀存儲介質(zhì)。

背景技術(shù)

在目前的互聯(lián)網(wǎng)技術(shù)中，Swagger(文檔書寫框架)是開發(fā)最常用的API(Application Programming Interface，應(yīng)用程序編程接口)文檔編寫框架，可用于前后端分離，測試mock(虛擬)等等很多打通開發(fā)流程的功能。通過編寫Swagger描述代碼，就可以自動生成接口文檔和客戶端服務(wù)端代碼，做到調(diào)用端代碼、服務(wù)端代碼以及接口文檔的一致性。

相關(guān)技術(shù)中，Swagger在生成文檔時，需要使用Swagger基于框架生成一個網(wǎng)頁，用當前域名+Swagger-ui.html作為地址，在網(wǎng)頁中列出當前項目中所有的控制層的接口，也即生成HTML(Hyper Text Markup Language，超文本標記語言)格式的文檔。

在實現(xiàn)本發(fā)明的過程中，發(fā)明人發(fā)現(xiàn)相關(guān)技術(shù)至少存在以下問題：

HTML格式的文檔中提供的接口入?yún)⒑统鰠⑹荍SON(Java Script ObjectNotation，直譯式腳本語言對象簡譜)格式的，而且很混亂，無法直接拿來使用，還需要進一步的進行格式的轉(zhuǎn)換才可以保證文檔正常流通，導致生成的文檔兼容性較低，增加了團隊之間的溝通成本。

發(fā)明內(nèi)容

有鑒于此，本發(fā)明提供了一種文檔格式轉(zhuǎn)換方法、裝置、設(shè)備及可讀存儲介質(zhì)，主要目的在于解決目前生成的文檔兼容性較低，增加了團隊之間的溝通成本的問題。

依據(jù)本發(fā)明第一方面，提供了一種文檔格式轉(zhuǎn)換方法，該方法包括：

運行格式轉(zhuǎn)換文件，在所述格式轉(zhuǎn)換文件對應(yīng)的文檔調(diào)取路徑中獲取目標文檔，所述格式轉(zhuǎn)換文件至少包括對所述目標文檔的內(nèi)容進行標記的配置參數(shù)；

基于所述格式轉(zhuǎn)換文件，對所述目標文檔的內(nèi)容進行標記，生成所述目標文檔的Markdown文件；

確定用戶的指定轉(zhuǎn)換格式，對所述Markdown文件進行格式轉(zhuǎn)換，生成所述指定轉(zhuǎn)換格式的指定文檔。

在另一個實施例中，所述運行格式轉(zhuǎn)換文件，在所述格式轉(zhuǎn)換文件對應(yīng)的文檔調(diào)取路徑中獲取目標文檔之前，所述方法還包括：

獲取當前項目的配置文件，在所述配置文件中設(shè)置用于對文檔中內(nèi)容進行標記的所述配置參數(shù)，生成初始文件，所述配置參數(shù)至少為Swagger的參數(shù)；

在所述初始文件中添加所述配置參數(shù)的運行代碼，生成所述格式轉(zhuǎn)換文件；

確定所述當前項目對應(yīng)的所述文檔調(diào)取路徑，將所述文檔調(diào)取路徑與所述格式轉(zhuǎn)換文件進行關(guān)聯(lián)。

在另一個實施例中，所述運行格式轉(zhuǎn)換文件，在所述格式轉(zhuǎn)換文件對應(yīng)的文檔調(diào)取路徑中獲取目標文檔，包括：

在數(shù)據(jù)倉庫中引入啟動插件，基于所述啟動插件對所述格式轉(zhuǎn)換文件的運行代碼進行調(diào)用，運行所述格式轉(zhuǎn)換文件的配置參數(shù)；

獲取所述格式轉(zhuǎn)換文件關(guān)聯(lián)的所述文檔調(diào)取路徑，在所述文檔調(diào)取路徑指示的位置提取所述目標文檔。