MarkdownPad安装以及绘制 UML 图
要在本地編輯和查看markdown 文件,我選擇了安裝MarkdownPad 2。
從官網(wǎng)下載了MarkdownPad 2,安裝后打開md文件,出現(xiàn)了This view has crashed的渲染錯誤
如下:
同時會給出一個彈屏,可以看到更詳細(xì)的信息。
在其提供的FAQ 文檔http://markdownpad.com/faq.html#livepreview-directx中給出了解決該問題的辦法
在頁面中搜索上述錯誤This view has crashed
上面說我們需要下載 一個 Awesomium 1.6.6 SDK , 我點擊鏈接無法打開,所以直接從網(wǎng)上找了一個,我上傳到資源里了, 下載安裝后再打開md文件渲染就正常了
如果安裝Awesomium 1.6.6 SDK后還是有問題,可以按照文檔上的建議下載安裝 Microsoft’s DirectX End-User Runtimes
同事創(chuàng)建的md文件中使用了PlantUML來畫UML時序圖(他是通過VsCode在md中集成PlantUML的,參考:VSCode 中使用 PlantUML 插件生成 UML),但是在我的MarkdownPad 2里無法正常展示,查閱了一下資料發(fā)現(xiàn)如果我們想在markdown文件里使用PlantUML圖,有兩種方式:
1.把圖片地址集成到 Markdown 里面
集成方式又可以分為三種
1) 在線編寫代碼生成 UML 圖片.然后再把圖片地址集成到 Markdown 里面
可以通過http://www.plantuml.com/plantuml/uml/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000 在線編寫代碼,生成圖片,如下:
點擊下方的submit按鈕就可以生成下面的預(yù)覽圖和對應(yīng)的圖片url
2)對url進(jìn)行編碼后,把圖片地址集成到 Markdown 里面
編碼網(wǎng)站
Bob -> Helen: hello編碼后的字符串如下:
Bob%20-%3E%20Helen%3A%20hello%0A
拼接上http://g.gravizo.com/svg?后就可以在markdown里面使用了
3)不編碼使用<>將網(wǎng)址括起來,把圖片地址集成到 Markdown 里面
注意<>中的url連接不能有回車符號,但可以有空格
2),3)方法的缺點在于對于比較復(fù)雜的代碼并不合適,相對比較適合于類圖的引用,對于復(fù)雜的時序圖一般無法很好的展示想要的UML圖;而1)對于任何使用PlantUML 代碼描繪的UML圖都能正常展示
2.使用Gravizo 繪圖引擎
只需要用 Url 包含 PlantUML 代碼放到一個 img 標(biāo)簽中,就可以在線實時的繪制出我們需要的 UML 圖。如下 :
<img src='https://g.gravizo.com/svg? abstract class AbstractList; interface List; List <|.. AbstractList; '/>當(dāng)然這個也需要集成的 Markdown 里面支持 Gravizo 才能顯示出來,我的Markdown Pad不支持Gravizo 就不能使用上述辦法了
對PlantUML感興趣的,可以看下如下文章21分鐘入門UML 或者官網(wǎng)了解下PlantUML的語法。相比較其他的UML畫圖工具,PlantUML的語法還是比較簡單的,而且在調(diào)整UML圖的時候也不需要我們一點點去修改線條什么的。
參考資料:
Markdown 繪制 UML 圖 – PlantUML + Gravizo
markdown+gravizo畫UML類圖
總結(jié)
以上是生活随笔為你收集整理的MarkdownPad安装以及绘制 UML 图的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: JS组件系列——表格组件神器:boots
- 下一篇: 浅谈权限管理的设计与实现