「ReStory」在 Markdown 中自由書寫 React 元件 (Beta)

Foveluy發表於2019-02-20

介紹

先睹為快

「ReStory」在 Markdown 中自由書寫 React 元件 (Beta)

我們在開發一個小小的 React 元件庫,但是我們遇到了一個大難題,那就是為我們的元件庫書寫一個合理的文件。

作為元件文件,我們非常希望我們的元件用例程式碼能夠展現出來,是的我們在書寫文件的時候,能夠有直觀的互動體驗。

為了達到這一點,我開發一款文件構建工具 ReStory。如果熟悉 Vuepress 的同學一定不陌生,這可以說是 Vuepress 的 React 版本。

ReStory 的能力

  • 能夠直接在 Markdown 文件中書寫 React 元件,任意的 React 元件
  • 一鍵構建服務端渲染和客戶端渲染版本,能夠很好的完成 SEO 的任務
  • 為技術文件而優化的 Markdown 擴充,能夠讓你更好的完成元件文件庫的書寫
  • ReStory 構建在 Ant Design 之上,因此,我們直接在全域性使用 Antd,就像例子中一樣!
  • 更多能力等你 PR

快速開始

開始使用 ReStory 非常的簡單,就像數 1、2、3、4一樣。

# 安裝 ReStory,你可能需要一些許可權
(sudo) npm config set unsafe-perm true && npm i -g restory


# 構建一個 md 檔案
echo `# Hello ReStory` > README.md


# 輸入全域性命令,注意命令的最後有一個小點~
restory dev .


# 當你書寫完成以後構建,輸入全域性命令,注意命令的最後有一個小點~
restory build .
複製程式碼

相關文章