掃描目錄,分析文件結構和統計信息,給任意文件添加備註,導出帶註釋的樹形文本和其它多種數據格式,大大方便書寫技術文檔。css
若是你須要它,你會很愛它。若是你不須要,可能永遠不會須要。html
開發這個軟件的初衷是爲了方便我書寫個人 項目文檔,其中有一部份內容根據用戶的反饋來看,須要詳細展現項目的重要目錄分別的做用。vue
我找了一下發現能實現導出這類樹形結構文字的項目大體有兩種,一類是網絡上分享的腳本,一類是能夠讀取開源倉庫信息的在線工具。git
個人大體需求是,1 掃描目錄 2 編輯註釋 3 導出美觀的結構圖 4 能夠隱藏我但願忽略的文件。現有的方案顯然都不方便,因此我忙裏偷閒製做了這個軟件。github
macOS | windows | Linuxvue-cli
releasesjson
vue-cli3 生成的基礎項目,使用 vue-cli-plugin-electron-builder 將其轉化爲可使用 electron 打包的桌面項目。windows
全部演示基於下述的目錄結構:bash
├─.DS_Store
├─.browserslistrc
├─.gitignore
├─README.md
├─babel.config.js
├─package.json
├─postcss.config.js
├─public
│ ├─favicon.ico
│ └─index.html
├─src
│ ├─App.vue
│ ├─assets
│ │ └─sys
│ │ └─logo
│ │ └─w200.png
│ ├─components
│ │ └─HelloWorld.vue
│ ├─layout
│ │ └─headerAside
│ │ ├─components
│ │ │ ├─aside
│ │ │ │ ├─index.vue
│ │ │ │ └─style.scss
│ │ │ └─header
│ │ │ ├─index.vue
│ │ │ └─style.scss
│ │ └─index.vue
│ └─main.js
└─yarn.lock
複製代碼
導出的結果:babel
├─README.md --------------- // 介紹
├─babel.config.js
├─package.json
├─postcss.config.js
├─public ------------------ // 公共資源
│ ├─favicon.ico
│ └─index.html
├─src
│ ├─App.vue --------------- // 根組件
│ ├─assets
│ │ └─sys
│ │ └─logo
│ │ └─w200.png
│ ├─components
│ │ └─HelloWorld.vue
│ ├─layout
│ │ └─headerAside
│ │ ├─components
│ │ │ ├─aside
│ │ │ │ ├─index.vue
│ │ │ │ └─style.scss
│ │ │ └─header
│ │ │ ├─index.vue
│ │ │ └─style.scss
│ │ └─index.vue
│ └─main.js
└─yarn.lock
複製代碼
不會導出被摺疊和隱藏的文件或目錄,而且會根據摺疊以後的狀態從新計算樹形結構。
備註有記憶功能,例如掃描 /a
目錄後添加了註釋,以後掃描了 /b
目錄,當再次掃描 /a
目錄後第一次添加的註釋會自動還原。
目前支持如下導出方式:
支持自定義掃描忽略的文件夾和文件,並能夠指定忽略的文件類型。
爲方便快速設置,選項會自動根據當前的掃描結果改變。
支持設置忽略 .
開頭的文件,由於這些文件在 macOS 和 Linux 上是隱藏的
幾乎全部的導出都支持自定義文件名,並支持多種佔位符,請注意輸入框右上角的提示:
點擊提示以後會彈出這個位置全部可用的佔位符,點擊佔位符能夠快速複製到剪貼板:
佔位符示例:
注:在一些其它的設置位置也支持佔位符,例如設置備註的格式化,腦圖的節點內容等。