
CZON - AIネイティブ Markdown コンテンツエンジン
AI時代において、ウェブサイトのコンテンツクリエイターとして、私たちはよりインテリジェントなコンテンツ作成エンジンを手にすることができます。
コンテンツへの回帰:妨害を最小化し、執筆に集中
ドキュメントをその本質に戻し、執筆を静寂に帰します。
第一に、私は図書館司書になりたくありません。時々何かを書き留めたいと思うことがありますが、そのタイトルがまだ決まっていなかったり、特別な構成ができあがっていなかったりすることがあります。LLMが自動的にタイトルを生成し、要約を作成し、分類し、ナビゲーションなどの整理作業を行ってくれることを望んでいます。
第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定のビルドツールや、複雑なドキュメント設定、複雑な構造をいじくり回すのは好きではありません。Docusaurus、VuePress、Astroといったツールの設定ファイルやプロジェクト構造を見るたびに、私は頭が痛くなります。現在、CZONはすべての設定を .czon ディレクトリに隠し、隅に掃き出すことを選択しました。ユーザーは執筆内容に集中するだけでよく、他のことはすべてCZONが処理します。他のディレクトリはすべてあなたの執筆スペースであり、Markdownファイルを自由に整理することができます。
母国語への回帰:母国語で執筆し、滑らかに多言語バージョンを構築
人生は短いので、翻訳するのが面倒です。人は母国語を使用するとき、自身の思考の深みを最も発揮できます。しかし同時に、世界とつながりを保つことも必要であり、多言語でのコミュニケーションを諦めたくはありません。そこで私は、母国語で執筆しながら、より多くの人に自分のコンテンツを見てもらえるツールを望んでいます。現在のi18nは自分で翻訳するだけでなく、コンテンツの更新も自分で管理しなければならず、非常に面倒です。私はLLMを使って翻訳を手伝ってもらうことを選択し、多くの時間を節約し、ワンクリックで複数の言語への翻訳を完了できるようにしました。
基本機能
- 🌍 自動多言語翻訳:AIを使用した増分翻訳により、ユーザーは母国語でMarkdownを記述できますが、ユーザーは多言語対応となります。
- 💭 自動要約抽出:AIを使用して原文の内容分析と抽出を行います。
- 🏷️ 自動タグ分類:AIを使用してコンテンツのタグ付けと分類の抽出・管理を行います。
- 🧭 インテリジェント分類ナビゲーション:AIを使用してサイトマップとナビゲーションを生成します。ソースファイルの位置に依存しません。
静的サイト生成 (SSG)
CZONはSSGソリューションを内蔵しており、Markdownを含む任意のgitフォルダを静的HTMLサイトに構築することができます。
⚠️ ご注意ください:CZONは専門的な静的サイトジェネレーター(SSG)ではなく、コンテンツ作成と管理に特化したAI駆動のMarkdownコンテンツエンジンです。
✅ CZONは、コンテンツ作成と公開のプロセスを簡素化し、ユーザーが複雑な設定やツールに悩まされることなく、執筆そのものに集中できるようにすることを目的としています。
❌ CZONは複雑なテーマカスタマイズやプラグインエコシステムを提供せず、AIを通じてコンテンツの品質とアクセシビリティを向上させることに専念します。
🔔 しかし、CZONは依然として静的サイトを生成することができます。必要に応じて、CZONをプリプロセッサーとして使用し、他のSSGソリューションと統合して、個性的で美しいサイトを生成することが可能です。
クイックスタート
前提条件:
- Node.js がインストールされていること(バージョン18以上を推奨、npxコマンドが必要)
- OpenAI API Key を取得済み、または OpenAI 互換の API Key を所持していること
- Git がインストールされていること(GitからMarkdownファイルをリストアップし、.gitignoreルールでフィルタリングされたファイルを無視するために使用)
まず、gitで管理されているフォルダ内で作業します:
環境変数を設定します
export OPENAI_API_KEY="sk-xxxxxx" # 必須:ご自身のOpenAI API Keyに置き換えてください
export OPENAI_BASE_URL="https://api.openai.com/v1" # オプション、デフォルトはOpenAI公式APIを使用
export OPENAI_MODEL="gpt-3.5-turbo" # オプション、デフォルトは gpt-3.5-turbo モデルを使用
サイトを構築し、多言語翻訳をサポートします。現在のディレクトリをソースディレクトリとして使用し、.czon/dist ディレクトリに出力します。
--langパラメータを複数回使用して、生成する言語バージョンを指定できます(例:--lang zh-Hans --lang en-US)。- ソース言語の設定は不要です。CZONが自動的に検出します。
npx czon@latest build --lang zh-Hans --lang en-US
その他のパラメータやヘルプを表示する:
npx czon@latest