Document
リポジトリ構成
root と sample の役割分担、主要ディレクトリの意味をまとめます。
この repository は「ライブラリ本体」と「利用例」を分けています。
大枠
.
├─ bin/
├─ src/
├─ sample/
├─ test/
└─ .github/workflows/
各ディレクトリ
src/
ライブラリ本体です。
src/core/: build ロジックsrc/theme-default/: デフォルトテーマsrc/index.ts: export の入口
bin/
CLI の入口です。mdocbuilder build がここから始まります。
sample/
ライブラリを実際に install して使う例です。
sample/package.jsonsample/mdocbuilder.config.mjssample/docs/sample/docs-theme.css
test/
node:test ベースの integration test です。
.github/workflows/
CI, GitHub Pages deploy, npm release の workflow です。
なぜ sample を分けたか
- ライブラリ本体と利用側の責務を分けるため
npm installして使う形をそのまま見せるため- Pages deploy を sample 側の build に合わせるため