Kecareについて:ここから始めましょうニャン
ドキュメントを書くことは、私にとって本当に少し難しいです……
もしどこか理解しにくいところがあれば、まずは私を責めないでください(小声)、Issue / PR を出して修正を手伝ってくれると、私は超感謝しますにゃ!ごめんなさいごめんなさいごめんなさい(お辞儀.gif)
Kecareは、現代的な静的ブログとノートサイトのためのジェネレーターフレームワークです。その最大の目標は「もう一つのHexoを作ること」ではなく、コンテンツシステムをテーマ/フレームワークから切り離し、あなたのブログ機能を「プラグ可能なモジュール」にすることですにゃ~
Kecare が Hexo より「先進的」な点:非侵入的だにゃ!
多くの伝統的なブログソリューション(例えばHexo)は、あなたを固定されたエコシステムに引き込みます:
テーマ、ビルド、プラグイン、ディレクトリ構造など、多くのものがそれと結びついており、技術スタックを変更したい場合は一からやり直さなければなりません。
一方、Kecareの核心的な強みは、**非侵襲性(Non-intrusive)**にあります。
一言で言うと:
もしあなたがフロントエンド開発者なら、既存のアプリケーションに直接ブログシステムを「追加」でき、元のプロジェクトがどの技術スタックを使っているかはほとんど気にする必要はありません。
あなたがする必要があるのは、古いプロジェクトに.kecare/ディレクトリを作成し、約束に従ってコンテンツとルールを書くことだけです。Kecareはあなたが定義したルールに基づいて、ブログ関連のページやデータを生成してくれますにゃ~
あなたの元のプロジェクトは次のようなものでした:
- Vue / Nuxt
- React / Next
- Svelte / SvelteKit
- 従来のサーバーサイドレンダリングフレームワーク(SSR)
- 古いプロジェクトでも(生成結果を統合できればOKです)
Kecareは、移行を強制せず、アーキテクチャを変更せず、ページの書き直しを要求しません。
まるで「外部コンテンツ生産ライン」のように、ブログシステムを最も軽量な方法で取り付けますにゃ~
2つの使用方法:デフォルトテーマ vs カスタムテーマ
Kecareは外部に二つの「使いやすい入門パス」を提供しており、あなたのニーズに合わせて選べます~
1) デフォルトテーマ(すぐに使えるにゃん)
もしあなたがすぐに使えて、見栄えが良く、執筆可能なブログを手に入れたいだけなら、私が提供するデフォルトテーマを直接使用できます。
- 技術スタック:Nuxt + Vue3
- 対象者:素早く書き始めたい、まずはブログを動かしたいあなたにぴったりですにゃ~
- 特徴:Kecareの内部詳細をほとんど理解する必要はなく、ドキュメントに従って
.kecare/の内容を配置し、コマンドを実行するだけでOKです
2) カスタムテーマ(真の「非侵入的」能力にゃん)
もし「技術スタックに依存しない」自由度をより重視するなら、Kecareのカスタムテーマ路線があなたにぴったりですよ~
あなたは:
- 任意の技術スタック/フレームワーク(Vue/React/Svelte/SSR/レガシープロジェクト)において、
.kecare/ディレクトリを新規作成する - お好みの方法で生成ルールを定義する(例:記事をHTMLに変換する方法、ルートデータを生成する方法、メニューデータを生成する方法など)
- Kecareがプロジェクトで消費可能な成果物(構造化データ、静的ページフラグメント、リソースインデックスなど)を出力するようにする
そして、あなたのプロジェクトはただ一つのことを行うだけです:
Kecareの成果物を接続してレンダリング(または直接公開)することで、一連の「外付けブログシステム」が完成します。
これがKecareの理想的な状態です: ブログ機能は追加的で、移植可能で、テーマに縛られない、にゃん~