需求分析

• 文檔可以和項(xiàng)目一起進(jìn)行版本管理
• 文檔可以在線訪問(wèn)
• 文檔可以與springboot項(xiàng)目集成，不需要分開(kāi)部署
• MarkDown支持
• 文檔跟隨，打包jar也可以訪問(wèn)

技術(shù)選型

對(duì)于網(wǎng)上已有的方案，大致分為如下幾種

• 將文檔部署在 resource靜態(tài)資源目錄下，用模板渲染訪問(wèn)。[1][1]
• 分離部署，打包 jar后還需要單獨(dú)上傳靜態(tài)資源文檔內(nèi)容并部署。

最終選定的技術(shù)方案如下

工具介紹

Typora

Typora 是一款功能非常強(qiáng)大的 MarkDown編寫工具，采用所見(jiàn)即所得的編輯方式，實(shí)現(xiàn)了即時(shí)預(yù)覽的功能，Latex公式支持，具體請(qǐng)查看官網(wǎng)，目前只有平替，沒(méi)有超越的MarkDown編寫工具，對(duì)于本方案來(lái)講，支持剪切圖片直接保存到相對(duì)路徑中，方便訪問(wèn)。同時(shí)也支持配置圖床，需要使用PicGo搭建服務(wù)。

Docsify

docsify 可以自動(dòng)地將 Markdown 中的標(biāo)題生成目錄，快速搭建一個(gè)小型的文檔網(wǎng)站，整個(gè)頁(yè)面的配色和布局也十分舒適，讓閱讀體驗(yàn)在不知不覺(jué)中提升了好幾個(gè)檔次。

和 Gitbook 不同，docsify 不會(huì)生成靜態(tài)的 HTML 文件，它會(huì)智能地加載和解析 Markdown 文件，這就避免了 HTML 文件對(duì)整個(gè)文檔庫(kù)的“污染”。

還支持豐富的自定義樣式。

Hutool

hutool 是一個(gè)非常好用的開(kāi)發(fā)梭子，這種有大量用戶使用的工具類，絕對(duì)比自己維護(hù)的輪子要穩(wěn)定的多，所以開(kāi)發(fā)選hutool是非常OK的一個(gè)選擇。

我們使用的是hutool工具的一個(gè)子包 - SimpleServer

Oracle JDK提供了一個(gè)簡(jiǎn)單的Http服務(wù)端類，叫做HttpServer，當(dāng)然它是sun的私有包，位于com.sun.net.httpserver下，必須引入rt.jar才能使用，Hutool基于此封裝了SimpleServer，用于在不引入Tomcat、Jetty等容器的情況下，實(shí)現(xiàn)簡(jiǎn)單的Http請(qǐng)求處理。

功能實(shí)現(xiàn)

1. 初始化文檔

在 resources 目錄下，或者項(xiàng)目根目錄下執(zhí)行如下命令，在項(xiàng)目根目錄執(zhí)行，需要對(duì) maven 打包進(jìn)行額外的配置，推薦在 resources目錄下執(zhí)行。

docsify init .docs

docsify init .docs

2. 配置簡(jiǎn)易服務(wù)器

新建DocConfig.java

import cn.hutool.http.HttpUtil;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;
import java.io.File;

@Component
public class DocConfig {
    @Bean
    public void InitDoc(){
        String rootPath = System.getProperty("user.dir");

        HttpUtil.createServer(8888) 
                // 設(shè)置默認(rèn)根目錄 -- resources目錄下新建根據(jù)對(duì)應(yīng)路徑修改，目錄分隔符用 File.separator 保證Win/Linux 兼容
                .setRoot(rootPath+ File.separator+".docs")
                .start();
    }
}

3. 訪問(wèn)

當(dāng)啟動(dòng) springboot 項(xiàng)目時(shí)，訪問(wèn) localhost:8888即可訪問(wèn)對(duì)應(yīng)文檔

到此這篇關(guān)于springboot基于docsify 實(shí)現(xiàn)隨身文檔的文章就介紹到這了,更多相關(guān)docsify 實(shí)現(xiàn)隨身文檔內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論