
CZON - AI-Native 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