文檔概要

kc-cli 能為你做什么？

kc-cli 作用的文件類型：目前只支持.md后綴的文件類型。下面是 kc-cli 能為你做的：

  • 批量創建SUMMARY.md里的.md文件（已經存在的會跳過）。
  • 批量把文檔項目下所有的.md文件添加到目錄文件SUAMMARY.md（不會覆蓋原SUAMMARY.md，會生成一個叫"_summary.md"的文件）。
  • 初始化文檔配置（樣式自定義、插件、.gitignore、封面、文檔概要等），如果你已經做了配置，kc-cli 會跳過。
  • 導出為 Docx、HTML文件（這部分功能依賴pandoc進行，kc-cli 進行了簡化處理，如果有特殊需求自己看pandoc的文檔，自行轉換）。需要說明的是：這部分的輸出不會攜帶看云的版權標識，自然的這部分輸出也不會影響到看云，因為這是本地操作，不會反饋到看云。導出的文件統一存放在./KCout/ 下（已經通過.gitignore 文件排除，不會隨 git 推送到看云，不過保險起見推送之前還是先自己確認下！！！）。

>使用 pandoc 進行文件轉換往往會發生很多鬼畜的事情，轉換效果可能也在你的意料之外。這也不怪 pandoc ，因為 Markdown 本身就有很多衍生語法，完美兼容不太容易。