dskd は記事原稿を markdown で管理し、HTML を静的にビルドするブログ向け SSG です。
『小さなブログなら小さな環境で。』
dskd は小さな開発環境を追い求めています。省ける処理は省き、シンプルで小さなビルドタスクになるようにしました。
npm ci
npm startpython3 でローカルサーバーが立ち上がるので手動で localhost:3000 にアクセスしてください。
dskd.config.js に入出力のパスやウェブサイトのメタ情報を記述します。
pug テンプレートから参照されるキーは CONFIGS {} に含めてください。
プリプロセッサーやトランスパイラーは利用しないハードコアスタイルです。
画像と CSS は src/ ディレクトリから dist/ へコピーされるだけなので、必要があれば事前に加工してください。
JavaScript はテンプレートか md ファイル内に直接記述してください。
pug を利用しています。
記事のメタ情報やブログの設定情報、年別リストやタグ別リストの情報が格納された巨大なオブジェクトを内部で受け取り、テンプレートで引き当てて HTML をビルドしています。
npm run build を実行するとプロジェクトルートに dist/ ディレクトリが生成されます。
これをドキュメントルートとしてウェブサーバーでホスティングすればウェブサイトとして閲覧可能です。
dskd では Netlify を使ってデプロイ、ホスティングしています。
ビルドは以下のモジュールに依存しています。
テスト実行は以下のモジュールに依存しています。
git コミット時に prettier を実行するため husky を利用しています。