czon 0.1.1 → 0.1.3

package/.zen/src/uk-UA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Мінімалістичний Markdown + AI генератор статичних сайтів'
-'summary': 'ZEN — це генератор статичних сайтів з інтеграцією AI, створений для спрощення процесу написання документації та побудови сайтів. Він дозволяє користувачам зосередитися на написанні контенту рідною мовою у форматі Markdown, автоматично обробляючи генерацію заголовків, навігацію за категоріями та інкрементальний переклад, підтримуючи багатомовні версії без складних налаштувань. Інструмент базується на Node.js та OpenAI API, дозволяючи швидко будувати сайти через командний рядок, ідеально підходить для авторів, які цінують ефективність та простоту.'
-'tags':
-  - 'Генератор статичних сайтів'
-  - 'Markdown'
-  - 'AI'
-  - 'Мінімалізм'
-  - 'Багатомовний переклад'
-  - 'Node.js'
-  - 'OpenAI'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Мінімалістичний Markdown + AI генератор статичних сайтів
-
-[> Демо сайту](https://zccz14.github.io/ZEN/)
-
-## Основні функції
-
-1. 📃 **Генерація статичних сайтів**: Перетворює будь-яку папку з файлами Markdown, яка керується через git, на статичний HTML-сайт.
-2. 🧭 **Інтелектуальна навігація за категоріями**: Використовує AI для аналізу контенту, генерує карту сайту та навігацію, незалежно від розташування вихідних файлів.
-3. 🌍 **Автоматичний інкрементальний переклад**: Використовує AI для інкрементального перекладу, дозволяючи користувачам писати на рідній мові у форматі Markdown, але з можливістю створення багатомовного контенту.
-
-Чому я створив ще один генератор статичних сайтів для Markdown? Я переосмислив, як інструменти для документації можуть краще служити авторам в епоху AI:
-
-- Повернення до контенту: Мінімізація відволікань, фокус на написанні
-
-  Повернути документацію до її сутності, а написанню — спокою.
-
-  По-перше, я не хочу бути бібліотекарем. Іноді я хочу щось записати, але ще не визначився з заголовком або структурою. Я хочу, щоб LLM автоматично генерував заголовки, робив резюме, класифікував та організовував навігацію.
-
-  По-друге, мій робочий простір має бути чистим. Я не хочу складних інструментів зі складною конфігурацією, не люблю заплутані структури. Кожного разу, коли я бачу файли конфігурації та структуру проектів у Docusaurus, VuePress чи Astro, у мене болить голова. Тепер ZEN приховує всю конфігурацію в каталозі `.zen`, залишаючи користувачам можливість зосередитися лише на написанні контенту. Всі інші каталоги — це ваш робочий простір, де ви можете вільно організовувати свої файли Markdown.
-
-- Повернення до рідної мови: Пишіть рідною мовою, легко створюйте багатомовні версії
-
-  Життя коротке, мені ліньки перекладати. Людина найкраще розкриває глибину своїх думок, коли пише рідною мовою. Але водночас важливо залишатися на зв'язку зі світом, і я не хочу відмовлятися від багатомовного спілкування. Тому мені потрібен інструмент, який дозволить мені писати рідною мовою, але також зробить мій контент доступним для більшої аудиторії. Сучасні рішення для i18n вимагають не лише самостійного перекладу, але й підтримки оновлень контенту, що займає багато часу. Я вирішив використовувати LLM для перекладу, що значно економить мій час і дозволяє створювати багатомовні версії в один клік.
-
-## Швидкий старт
-
-Передумови:
-
-- Встановлений [Node.js](https://nodejs.org/) (рекомендована версія 18 або вище, потрібна команда npx)
-- Отриманий [OpenAI API Key](https://platform.openai.com/account/api-keys) або сумісний з OPENAI API Key
-- Встановлений Git (для отримання списку файлів Markdown з Git, ігноруючи файли, відфільтровані за правилами .gitignore)
-
-Спочатку працюйте в папці, яка вже керується через git:
-
-Налаштуйте змінні середовища
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Обов'язково: замініть на ваш OpenAI API Key
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Необов'язково, за замовчуванням використовується офіційний API OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Необов'язково, за замовчуванням використовується модель gpt-3.5-turbo
-```
-
-Побудуйте сайт з підтримкою багатомовного перекладу. Використовуйте поточний каталог як вихідний, результат буде збережено в каталозі `.zen/dist`.
-
-- Можна вказати необхідні мовні версії, використовуючи параметр `--lang` кілька разів (наприклад, `--lang zh-Hans --lang en-US`).
-- Можна вказати базовий URL-префікс сайту за допомогою параметра `--base-url` (наприклад, назва репозиторію на GitHub Pages).
-- Вихідну мову налаштовувати не потрібно, ZEN визначить її автоматично.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Переглянути більше параметрів або отримати довідку**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Мінімалістичний генератор статичних сайтів Markdown + AI'
-'summary': 'ZEN — це генератор статичних сайтів з функціями AI, розроблений для документів Markdown. Він дозволяє користувачам перетворювати Git-папки з файлами Markdown на статичні HTML-сайти без складних налаштувань, усі конфігурації приховані в каталозі .zen. Основні функції включають інтелектуальну навігацію за категоріями (використовуючи AI для аналізу вмісту та створення карти сайту), автоматичний інкрементний переклад (підтримка багатомовних версій, дозволяє користувачам писати рідною мовою, а AI обробляє переклад) та мінімалістичний досвід письма. Швидкий старт вимагає встановлення Node.js, отримання OpenAI API Key та Git, побудова сайту через командний рядок з підтримкою вказання мови та базової URL-адреси.'
-'tags':
-  - 'Генератор статичних сайтів'
-  - 'Markdown'
-  - 'AI'
-  - 'Багатомовний переклад'
-  - 'Мінімалізм'
-  - 'Інструмент для документів'
-  - 'Git'
-'inferred_lang': 'uk-UA'
----
-
-# ZEN - Мінімалістичний генератор статичних сайтів Markdown + AI
-
-[> Демо сайту](https://zen.zccz14.com/)
-
-## Основні функції
-
-1. 📃 **Генерація статичних сайтів**: Перетворює будь-яку Git-папку з файлами Markdown на статичний HTML-сайт.
-2. 🧭 **Інтелектуальна навігація за категоріями**: Використовує AI для аналізу вмісту, створення карти сайту та навігації, незалежно від розташування вихідних файлів.
-3. 🌍 **Автоматичний інкрементний переклад**: Використовує AI для інкрементного перекладу, дозволяючи користувачам писати Markdown рідною мовою, але з підтримкою багатомовності.
-
-Чому я створив ще один генератор статичних сайтів для Markdown? Я переосмислив, як інструменти для документів можуть краще служити письменникам в епоху AI:
-
-- Повернення до змісту: Мінімалізувати відволікання, зосередитись на письмі
-
-  Повернути документам їхню сутність, а письму — спокій.
-
-  По-перше, я не хочу бути бібліотекарем. Іноді я хочу щось записати, але ще не визначився з заголовком або структурою. Я хочу, щоб LLM автоматично генерував заголовки, робив резюме, класифікував та організовував навігацію.
-
-  По-друге, мій робочий простір має бути чистим. Я не хочу складних інструментів зборки, заплутаних конфігурацій документів або складної структури. Кожного разу, коли я бачу конфігураційні файли та структуру проектів у Docusaurus, VuePress чи Astro, у мене болить голова. Тепер ZEN ховає всі налаштування в каталозі .zen, залишаючи користувачам можливість зосередитись лише на написанні контенту, а решту обробляє ZEN. Всі інші каталоги — це ваш робочий простір, де ви можете вільно організовувати свої файли Markdown.
-
-- Повернення до рідної мови: Пишіть рідною мовою, легко створюйте багатомовні версії
-
-  Життя коротке, мені ліньки перекладати. Коли людина використовує рідну мову, вона може найкраще висловити глибину своїх думок. Але водночас важливо залишатись на зв'язку зі світом, і я не хочу відмовлятись від багатомовного спілкування. Тому мені потрібен інструмент, який дозволить мені писати рідною мовою, але також зробить мій контент доступним для більшої аудиторії. Сучасні рішення i18n вимагають самостійного перекладу та підтримки оновлень, що займає багато часу. Я використовую LLM для перекладу, що економить мій час і дозволяє створювати багатомовні версії в один клік.
-
-## Швидкий старт
-
-Передумови:
-
-- Встановлений [Node.js](https://nodejs.org/) (рекомендована версія 18 або вище, потрібна команда npx)
-- Отриманий [OpenAI API Key](https://platform.openai.com/account/api-keys) або сумісний з OPENAI API Key
-- Встановлений Git (для отримання списку файлів Markdown з Git, ігноруючи файли, відфільтровані за правилами .gitignore)
-
-Спочатку працюйте в папці, яка вже керується Git:
-
-Налаштуйте змінні середовища:
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Обов'язково: замініть на ваш OpenAI API Key
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опціонально, за замовчуванням використовується офіційний API OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Опціонально, за замовчуванням використовується модель gpt-3.5-turbo
-```
-
-Побудуйте сайт з підтримкою багатомовного перекладу. Використовуйте поточний каталог як вихідний, результат буде збережено в каталозі `.zen/dist`.
-
-- Можна вказати мовні версії, використовуючи параметр `--lang` кілька разів (наприклад, `--lang uk-UA --lang en-US`).
-- Можна вказати базовий префікс URL-адреси сайту за допомогою параметра `--base-url` (наприклад, назва репозиторію на GitHub Pages).
-- Вихідну мову налаштовувати не потрібно, ZEN визначить її автоматично.
-
-```bash
-npx zengen@latest build --lang uk-UA --lang en-US
-```
-
-**Переглянути більше параметрів або отримати довідку**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/uk-UA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -1,30 +0,0 @@
----
-'title': 'Прийоми використання оголошення дати в документах ZEN'
-'summary': 'Цей документ описує прийоми прямого оголошення дати в основному тексті за допомогою інструменту ZEN, порівнюючи з традиційним способом оголошення дати через YAML Frontmatter у Markdown. Підкреслюються функції автоматичного розпізнавання та інтелектуальної обробки ZEN, що покращують користувацький досвід. Підходить для типів контенту, які потребують часової шкали, таких як щоденники, блоги тощо.'
-'tags':
-  - 'ZEN'
-  - 'оголошення дати'
-  - 'Markdown'
-  - 'AI обробка'
-  - 'часова шкала'
-  - 'користувацький досвід'
-  - 'управління документами'
-'inferred_date': '2026-01-08'
-'inferred_lang': 'uk-UA'
----
-
-# Прийоми використання
-
-## Оголошення дати в основному тексті
-
-У основному тексті можна використовувати оголошення дати на кшталт "Сьогодні 8 січня 2026 року" (формат і стиль вільні), і ZEN автоматично розпізнає та обробить його.
-
-Традиційні документи Markdown оголошують дату через YAML Frontmatter, що вимагає запам'ятовування відповідних полів, інакше дата може бути неправильно розпізнана.
-
-ZEN підтримує пряме оголошення дати в основному тексті, що дозволяє уникнути проблеми з забуванням заповнення полів Frontmatter.
-
-AI автоматично витягне та визначить інформацію про дату з основного тексту та обробить її як дату створення документа.
-
-Цей спосіб є більш гнучким та розумним, покращуючи користувацький досвід.
-
-До речі, документи з датами можуть генерувати перегляд у вигляді часової шкали, що спрощує перегляд та управління. Особливо підходить для типів контенту, які потребують часової шкали, таких як щоденники, блоги тощо.

package/.zen/src/vi-VN/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -1,121 +0,0 @@
----
-'title': 'Tài liệu Kiểm tra Biểu đồ Mermaid'
-'summary': 'Tài liệu này là một tập tin kiểm tra nhằm xác minh chức năng hiển thị biểu đồ Mermaid trong ZEN. Nó bao gồm các ví dụ về nhiều loại biểu đồ Mermaid như lưu đồ, biểu đồ tuần tự, biểu đồ Gantt, biểu đồ lớp, biểu đồ trạng thái và biểu đồ tròn, cùng với một bài kiểm tra cú pháp lỗi để kiểm tra việc hiển thị thông báo lỗi. Tài liệu được thiết kế để minh họa trạng thái hoạt động bình thường của tích hợp Mermaid trong ZEN.'
-'tags':
-  - 'Mermaid'
-  - 'Kiểm tra biểu đồ'
-  - 'ZEN'
-  - 'Lưu đồ'
-  - 'Biểu đồ tuần tự'
-  - 'Biểu đồ Gantt'
-  - 'Biểu đồ lớp'
-  - 'Biểu đồ trạng thái'
-'inferred_date': '2024-01-01'
-'inferred_lang': 'vi-VN'
----
-
-# Kiểm tra Biểu đồ Mermaid
-
-Đây là một tập tin kiểm tra để xác minh chức năng hiển thị biểu đồ Mermaid trong ZEN.
-
-## Ví dụ về Lưu đồ
-
-```mermaid
-graph TD
-    A[Bắt đầu] --> B{Có tiếp tục không?}
-    B -->|Có| C[Thực hiện thao tác]
-    B -->|Không| D[Kết thúc]
-    C --> E[Kiểm tra kết quả]
-    E --> F{Có thành công không?}
-    F -->|Có| G[Hoàn thành]
-    F -->|Không| H[Thử lại]
-    H --> C
-    G --> D
-```
-
-## Ví dụ về Biểu đồ Tuần tự
-
-```mermaid
-sequenceDiagram
-    participant Người dùng
-    participant Hệ thống
-    participant Cơ sở dữ liệu
-
-    Người dùng->>Hệ thống: Gửi yêu cầu
-    Hệ thống->>Cơ sở dữ liệu: Truy vấn dữ liệu
-    Cơ sở dữ liệu-->>Hệ thống: Trả về kết quả
-    Hệ thống-->>Người dùng: Hiển thị kết quả
-```
-
-## Ví dụ về Biểu đồ Gantt
-
-```mermaid
-gantt
-    title Lịch trình Dự án
-    dateFormat  YYYY-MM-DD
-    section Thiết kế
-    Phân tích yêu cầu     :done,    des1, 2024-01-01, 7d
-    Thiết kế nguyên mẫu   :active,  des2, 2024-01-08, 5d
-    Thiết kế chi tiết     :         des3, after des2, 5d
-    section Phát triển
-    Phát triển giao diện  :         dev1, after des3, 10d
-    Phát triển backend    :         dev2, after des3, 15d
-    section Kiểm thử
-    Kiểm thử đơn vị       :         test1, after dev1, 5d
-    Kiểm thử tích hợp     :         test2, after dev2, 5d
-```
-
-## Ví dụ về Biểu đồ Lớp
-
-```mermaid
-classDiagram
-    class Animal {
-        +String name
-        +int age
-        +void eat()
-        +void sleep()
-    }
-    class Dog {
-        +void bark()
-    }
-    class Cat {
-        +void meow()
-    }
-
-    Animal <|-- Dog
-    Animal <|-- Cat
-```
-
-## Ví dụ về Biểu đồ Trạng thái
-
-```mermaid
-stateDiagram-v2
-    [*] --> Trạng thái chờ
-    Trạng thái chờ --> Đang xử lý : Bắt đầu xử lý
-    Đang xử lý --> Thành công : Xử lý thành công
-    Đang xử lý --> Lỗi : Xử lý thất bại
-    Thành công --> [*]
-    Lỗi --> [*]
-```
-
-## Ví dụ về Biểu đồ Tròn
-
-```mermaid
-pie title Tỷ lệ sử dụng Trình duyệt
-    "Chrome" : 65.2
-    "Firefox" : 15.3
-    "Safari" : 12.5
-    "Edge" : 5.2
-    "Khác" : 1.8
-```
-
-## Kiểm tra Cú pháp Lỗi (Nên hiển thị thông báo lỗi)
-
-```mermaid
-graph TD
-    A --> B
-    // Thiếu định nghĩa mũi tên ở đây
-    C --> D
-```
-
-Tập tin kiểm tra này bao gồm nhiều loại biểu đồ Mermaid khác nhau, được sử dụng để xác minh tích hợp Mermaid trong ZEN có hoạt động bình thường hay không.

package/.zen/src/vi-VN/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -1,78 +0,0 @@
----
-'title': 'Kiểm tra hiển thị công thức KaTeX'
-'summary': 'Tài liệu này là một ví dụ dùng để kiểm tra hiệu ứng hiển thị công thức KaTeX, bao gồm nhiều công thức toán học nội dòng và khối như E=mc^2, tích phân, đạo hàm, chuỗi, hàm phân đoạn, bảng, ma trận, v.v., nhằm xác minh việc hiển thị công thức chính xác.'
-'tags':
-  - 'KaTeX'
-  - 'Kiểm tra công thức'
-  - 'Công thức toán học'
-  - 'LaTeX'
-  - 'Hiệu ứng hiển thị'
-  - 'Ví dụ tài liệu'
-'inferred_lang': 'vi-VN'
----
-
-# Kiểm tra hiển thị công thức KaTeX
-
-Đây là một kiểm tra công thức nội dòng: $ E = mc^2 $.
-
-Đây là một kiểm tra công thức khối:
-
-$$
-\int_a^b f(x) \, dx = F(b) - F(a)
-$$
-
-Đây là một kiểm tra công thức khối khác:
-
-$$
-\frac{d}{dx}e^x = e^x
-$$
-
-Đây là một kiểm tra công thức phức tạp:
-
-$$
-\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
-$$
-
-Kiểm tra công thức với cases:
-
-$$
-f(x) =
-\begin{cases}
-x^2 & \text{nếu } x \geq 0 \\
--x & \text{nếu } x < 0
-\end{cases}
-$$
-
-Công thức bảng:
-
-$$
-\begin{array}{c|c|c}
-a & b & c \\
-\hline
-1 & 2 & 3 \\
-4 & 5 & 6 \\
-\end{array}
-$$
-
-Công thức ma trận:
-
-$$
-\begin{pmatrix}
-1 & 2 \\
-3 & 4
-\end{pmatrix}
-$$
-
-Kiểm tra công thức chứa text:
-
-$$
-E = mc^2 \quad \text{trong đó } m \text{ là khối lượng và } c \text{ là tốc độ ánh sáng}
-$$
-
-Công thức Kelly tổng quát:
-
-$$
-f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
-$$
-
-Vui lòng đảm bảo tất cả các công thức trên hiển thị chính xác.

package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -1,70 +0,0 @@
----
-'title': 'ZEN - Trình tạo trang tĩnh Markdown + AI theo phong cách tối giản'
-'summary': 'ZEN là trình tạo trang tĩnh kết hợp AI, tập trung vào việc đơn giản hóa quá trình viết và xây dựng tài liệu. Nó cho phép người dùng tạo trang HTML tĩnh từ thư mục được quản lý bằng git bằng Markdown, không cần cấu hình phức tạp, tất cả cài đặt được ẩn trong thư mục .zen. Tính năng chính bao gồm điều hướng phân loại thông minh (tạo sơ đồ trang web thông qua phân tích nội dung bằng AI), dịch tự động tăng dần (hỗ trợ phiên bản đa ngôn ngữ, người dùng có thể viết bằng ngôn ngữ mẹ đẻ, AI xử lý dịch thuật), và trải nghiệm viết tối thiểu sự phiền nhiễu. Công cụ phụ thuộc vào Node.js, OpenAI API Key và Git, được xây dựng nhanh qua dòng lệnh, hỗ trợ tham số ngôn ngữ chỉ định như zh-Hans và en-US.'
-'tags':
-  - 'Trình tạo trang tĩnh'
-  - 'Markdown'
-  - 'AI'
-  - 'Dịch đa ngôn ngữ'
-  - 'Chủ nghĩa tối giản'
-  - 'Công cụ tài liệu'
-  - 'ZEN'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Trình tạo trang tĩnh Markdown + AI theo phong cách tối giản
-
-[> Bản demo Trang web](https://zen.zccz14.com/)
-
-## Chức năng cơ bản
-
-1. 📃 **Tạo trang tĩnh**: Biến bất kỳ thư mục git chứa Markdown nào thành một trang HTML tĩnh.
-2. 🧭 **Điều hướng phân loại thông minh**: Sử dụng AI để phân tích nội dung, tạo sơ đồ trang web và điều hướng, không nhạy cảm với vị trí tệp nguồn.
-3. 🌍 **Dịch tự động tăng dần**: Sử dụng AI để dịch tăng dần, cho phép người dùng viết Markdown bằng ngôn ngữ mẹ đẻ, nhưng người dùng có thể đa ngôn ngữ.
-
-Tại sao lại tạo thêm một trình tạo trang tĩnh Markdown? Tôi đã suy nghĩ lại về cách công cụ tài liệu có thể phục vụ người viết tốt hơn trong thời đại AI:
-
-- Trở về với nội dung: Tối thiểu sự phiền nhiễu, tập trung vào việc viết
-
-  Đưa tài liệu trở lại bản chất, đưa việc viết trở lại sự tĩnh lặng.
-
-  Thứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết một số nội dung, nhưng có thể tôi chưa nghĩ ra tiêu đề cho nó, chưa hình thành tổ chức cụ thể. Tôi hy vọng LLM sẽ tự động giúp tôi tạo tiêu đề, tóm tắt, phân loại, điều hướng và các công việc sắp xếp khác.
-
-  Thứ hai, thư phòng của tôi phải được dọn dẹp sạch sẽ. Tôi không muốn các công cụ xây dựng cấu hình phức tạp, vặn vẹo cấu hình tài liệu phức tạp, không thích cấu trúc phức tạp. Mỗi lần nhìn thấy tệp cấu hình và cấu trúc dự án của các công cụ như Docusaurus, VuePress, Astro, tôi lại đau đầu. Bây giờ, ZEN chọn cách ẩn tất cả cấu hình vào thư mục .zen, quét vào góc, người dùng chỉ cần tập trung vào viết nội dung, phần còn lại để ZEN xử lý. Các thư mục khác là không gian viết của bạn, bạn có thể tổ chức tệp Markdown của mình tùy ý.
-
-- Trở về với ngôn ngữ mẹ đẻ: Viết bằng ngôn ngữ mẹ đẻ, xây dựng phiên bản đa ngôn ngữ mượt mà
-
-  Cuộc đời ngắn ngủi, tôi lười dịch. Khi sử dụng ngôn ngữ mẹ đẻ, con người mới có thể phát huy tối đa độ sâu suy nghĩ của mình. Nhưng đồng thời việc giữ kết nối với thế giới là cần thiết, tôi không muốn từ bỏ giao tiếp đa ngôn ngữ. Vì vậy, tôi hy vọng có một công cụ cho phép tôi viết bằng ngôn ngữ mẹ đẻ, đồng thời lại để nhiều người hơn thấy được nội dung của tôi. Hiện tại, i18n không chỉ cần tự dịch mà còn phải tự duy trì cập nhật nội dung, quá phiền phức. Tôi chọn sử dụng LLM để giúp tôi dịch, tiết kiệm rất nhiều thời gian và có thể hoàn thành dịch đa ngôn ngữ chỉ với một cú nhấp chuột.
-
-## Bắt đầu nhanh
-
-Điều kiện tiên quyết:
-
-- Đã cài đặt [Node.js](https://nodejs.org/) (khuyến nghị phiên bản 18 trở lên, cần có lệnh npx)
-- Đã lấy [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích OPENAI
-- Đã cài đặt Git (để liệt kê tệp Markdown từ Git, bỏ qua các tệp được lọc bởi quy tắc .gitignore)
-
-Đầu tiên, làm việc trong một thư mục đã được quản lý bởi git:
-
-Cấu hình biến môi trường
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Bắt buộc: Vui lòng thay thế bằng OpenAI API Key của bạn
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định sử dụng API chính thức của OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Tùy chọn, mặc định sử dụng mô hình gpt-3.5-turbo
-```
-
-Xây dựng trang web, hỗ trợ dịch đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, xuất ra thư mục `.zen/dist`.
-
-- Có thể chỉ định phiên bản ngôn ngữ cần tạo bằng cách sử dụng nhiều lần tham số `--lang` (ví dụ: `--lang zh-Hans --lang en-US`).
-- Không cần cấu hình ngôn ngữ nguồn, ZEN sẽ tự động phát hiện.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Xem thêm tham số hoặc trợ giúp**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/vi-VN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản'
-'summary': 'ZEN là trình tạo trang tĩnh tích hợp AI, nhằm đơn giản hóa quá trình viết tài liệu và xây dựng trang web. Nó cho phép người dùng tập trung viết nội dung Markdown bằng ngôn ngữ mẹ đẻ, tự động xử lý việc tạo tiêu đề, điều hướng phân loại và dịch thuật tăng dần, hỗ trợ nhiều phiên bản ngôn ngữ mà không cần cấu hình phức tạp. Công cụ dựa trên Node.js và OpenAI API, xây dựng trang web nhanh chóng qua dòng lệnh, phù hợp cho những người viết theo đuổi hiệu quả và sự đơn giản.'
-'tags':
-  - 'Trình tạo trang tĩnh'
-  - 'Markdown'
-  - 'AI'
-  - 'Chủ nghĩa tối giản'
-  - 'Dịch đa ngôn ngữ'
-  - 'Node.js'
-  - 'OpenAI'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
-
-[> Bản demo Trang web](https://zccz14.github.io/ZEN/)
-
-## Tính năng cơ bản
-
-1. 📃 **Tạo trang tĩnh**: Biến bất kỳ thư mục git chứa Markdown nào thành một trang web HTML tĩnh.
-2. 🧭 **Điều hướng phân loại thông minh**: Sử dụng AI để phân tích nội dung, tạo sơ đồ trang và điều hướng, không phụ thuộc vào vị trí tệp nguồn.
-3. 🌍 **Dịch tăng dần tự động**: Sử dụng AI để dịch tăng dần, cho phép người dùng viết Markdown bằng ngôn ngữ mẹ đẻ nhưng vẫn có thể hỗ trợ đa ngôn ngữ.
-
-Tại sao lại tạo ra một trình tạo trang tĩnh Markdown nữa? Tôi đã suy nghĩ lại về cách các công cụ tài liệu có thể phục vụ người viết tốt hơn trong thời đại AI:
-
-- Trở về với nội dung: Giảm thiểu sự phiền nhiễu, tập trung vào việc viết
-
-  Đưa tài liệu trở lại bản chất, đưa việc viết trở về sự tĩnh lặng.
-
-  Thứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết ra một số nội dung, nhưng có thể tôi chưa nghĩ ra tiêu đề cho nó, chưa hình thành cấu trúc tổ chức cụ thể. Tôi hy vọng LLM sẽ tự động giúp tôi tạo tiêu đề, tóm tắt, phân loại, điều hướng và các công việc sắp xếp khác.
-
-  Thứ hai, thư phòng của tôi phải được dọn dẹp sạch sẽ. Tôi không muốn các công cụ xây dựng cấu hình phức tạp, mất công với cấu hình tài liệu phức tạp, không thích cấu trúc rườm rà. Mỗi lần nhìn thấy các tệp cấu hình và cấu trúc dự án của các công cụ như Docusaurus, VuePress, Astro, tôi lại đau đầu. Giờ đây, ZEN chọn cách ẩn tất cả cấu hình vào thư mục `.zen`, quét vào góc, người dùng chỉ cần tập trung vào việc viết nội dung, phần còn lại để ZEN xử lý. Các thư mục khác là không gian viết của bạn, bạn có thể tổ chức các tệp Markdown của mình một cách tùy ý.
-
-- Trở về với ngôn ngữ mẹ đẻ: Viết bằng tiếng mẹ đẻ, xây dựng phiên bản đa ngôn ngữ mượt mà
-
-  Cuộc đời ngắn ngủi, tôi lười dịch. Con người chỉ có thể phát huy tối đa chiều sâu tư duy khi sử dụng ngôn ngữ mẹ đẻ. Nhưng đồng thời việc kết nối với thế giới là cần thiết, tôi không muốn từ bỏ giao tiếp đa ngôn ngữ. Vì vậy, tôi hy vọng có một công cụ cho phép tôi viết bằng ngôn ngữ mẹ đẻ, đồng thời lại có thể để nhiều người hơn xem được nội dung của tôi. Hiện tại, i18n không chỉ yêu cầu tự dịch mà còn phải tự duy trì cập nhật nội dung, quá phiền phức. Tôi chọn sử dụng LLM để giúp tôi dịch, tiết kiệm rất nhiều thời gian và có thể hoàn thành dịch đa ngôn ngữ chỉ bằng một cú nhấp chuột.
-
-## Bắt đầu nhanh
-
-Điều kiện tiên quyết:
-
-- Đã cài đặt [Node.js](https://nodejs.org/) (khuyến nghị phiên bản 18 trở lên, cần có lệnh npx)
-- Đã có [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích với OPENAI
-- Đã cài đặt Git (để liệt kê các tệp Markdown từ Git, bỏ qua các tệp bị lọc bởi quy tắc .gitignore)
-
-Đầu tiên, làm việc trong một thư mục đã được quản lý bởi git:
-
-Cấu hình biến môi trường
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Bắt buộc: Vui lòng thay thế bằng OpenAI API Key của bạn
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định sử dụng API chính thức của OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Tùy chọn, mặc định sử dụng mô hình gpt-3.5-turbo
-```
-
-Xây dựng trang web, hỗ trợ dịch đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, xuất ra thư mục `.zen/dist`.
-
-- Có thể chỉ định các phiên bản ngôn ngữ cần tạo bằng cách sử dụng nhiều lần tham số `--lang` (ví dụ: `--lang zh-Hans --lang en-US`).
-- Có thể chỉ định tiền tố URL cơ sở của trang web bằng tham số `--base-url` (ví dụ: tên kho lưu trữ trên GitHub Pages).
-- Không cần cấu hình ngôn ngữ nguồn, ZEN sẽ tự động phát hiện.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Xem thêm tham số hoặc trợ giúp**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản'
-'summary': 'ZEN là trình tạo trang tĩnh tích hợp AI, được thiết kế dành riêng cho tài liệu Markdown. Nó cho phép người dùng chuyển đổi thư mục Git chứa file Markdown thành trang HTML tĩnh mà không cần cấu hình phức tạp, tất cả cài đặt được ẩn trong thư mục .zen. Chức năng chính bao gồm điều hướng phân loại thông minh (sử dụng AI phân tích nội dung để tạo sơ đồ trang), dịch tự động tăng dần (hỗ trợ phiên bản đa ngôn ngữ, người dùng có thể viết bằng ngôn ngữ mẹ đẻ, AI xử lý dịch thuật), và trải nghiệm viết tối thiểu gây gián đoạn. Hướng dẫn bắt đầu nhanh yêu cầu cài đặt Node.js, lấy OpenAI API Key và Git, xây dựng trang qua dòng lệnh, hỗ trợ chỉ định ngôn ngữ và URL cơ sở.'
-'tags':
-  - 'Trình tạo trang tĩnh'
-  - 'Markdown'
-  - 'AI'
-  - 'Dịch đa ngôn ngữ'
-  - 'Chủ nghĩa tối giản'
-  - 'Công cụ tài liệu'
-  - 'Git'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
-
-[> Xem Demo Trang Web](https://zen.zccz14.com/)
-
-## Chức năng cơ bản
-
-1. 📃 **Tạo trang tĩnh**: Biến bất kỳ thư mục git chứa Markdown nào thành một trang HTML tĩnh.
-2. 🧭 **Điều hướng phân loại thông minh**: Sử dụng AI phân tích nội dung, tạo sơ đồ trang và điều hướng, không phụ thuộc vào vị trí file nguồn.
-3. 🌍 **Dịch tự động tăng dần**: Sử dụng AI để dịch tăng dần, cho phép người dùng viết Markdown bằng ngôn ngữ mẹ đẻ, nhưng người dùng có thể đa ngôn ngữ.
-
-Tại sao lại tạo thêm một trình tạo trang tĩnh Markdown nữa? Tôi đã suy nghĩ lại về cách công cụ tài liệu có thể phục vụ người viết tốt hơn trong thời đại AI:
-
-- Trở về với nội dung: Tối thiểu hóa sự gián đoạn, tập trung vào việc viết
-
-  Đưa tài liệu trở lại bản chất, đưa việc viết trở lại sự tĩnh lặng.
-
-  Thứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết một số nội dung, nhưng có thể tôi chưa nghĩ ra tiêu đề cho nó, chưa hình thành cấu trúc tổ chức cụ thể. Tôi hy vọng LLM sẽ tự động giúp tôi tạo tiêu đề, tóm tắt, phân loại, điều hướng và các công việc sắp xếp khác.
-
-  Thứ hai, thư phòng của tôi phải được dọn dẹp sạch sẽ. Tôi không muốn các công cụ xây dựng cấu hình phức tạp, mất công với cấu hình tài liệu phức tạp, không thích cấu trúc rườm rà. Mỗi lần nhìn thấy file cấu hình và cấu trúc dự án của các công cụ như Docusaurus, VuePress, Astro, tôi lại đau đầu. Giờ đây, ZEN chọn cách ẩn tất cả cấu hình vào thư mục .zen, quét vào góc, người dùng chỉ cần tập trung vào nội dung viết, phần còn lại để ZEN xử lý. Các thư mục khác là không gian viết của bạn, bạn có thể tổ chức file Markdown tùy ý.
-
-- Trở về với tiếng mẹ đẻ: Viết bằng tiếng mẹ đẻ, xây dựng phiên bản đa ngôn ngữ mượt mà
-
-  Đời người ngắn ngủi, tôi lười dịch. Khi sử dụng tiếng mẹ đẻ, con người mới có thể phát huy tối đa chiều sâu tư duy của mình. Nhưng đồng thời việc kết nối với thế giới là cần thiết, tôi không muốn từ bỏ giao tiếp đa ngôn ngữ. Vì vậy, tôi hy vọng có một công cụ cho phép tôi viết bằng tiếng mẹ đẻ, đồng thời lại để nhiều người hơn thấy được nội dung của tôi. Hiện tại, i18n không chỉ yêu cầu tự dịch mà còn phải tự duy trì cập nhật nội dung, quá phiền phức. Tôi chọn sử dụng LLM để giúp tôi dịch, tiết kiệm rất nhiều thời gian và có thể hoàn thành dịch đa ngôn ngữ chỉ với một cú nhấp chuột.
-
-## Bắt đầu nhanh
-
-Điều kiện tiên quyết:
-
-- Đã cài đặt [Node.js](https://nodejs.org/) (khuyến nghị phiên bản 18 trở lên, cần có lệnh npx)
-- Đã lấy [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích OPENAI
-- Đã cài đặt Git (dùng để liệt kê file Markdown từ Git, bỏ qua các file bị lọc bởi quy tắc .gitignore)
-
-Đầu tiên, làm việc trong một thư mục đã được quản lý bởi git:
-
-Cấu hình biến môi trường
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Bắt buộc: Vui lòng thay thế bằng OpenAI API Key của bạn
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định sử dụng API chính thức của OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Tùy chọn, mặc định sử dụng mô hình gpt-3.5-turbo
-```
-
-Xây dựng trang, hỗ trợ dịch đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, xuất ra thư mục `.zen/dist`.
-
-- Có thể chỉ định phiên bản ngôn ngữ cần tạo bằng cách sử dụng nhiều lần tham số `--lang` (ví dụ: `--lang zh-Hans --lang en-US`).
-- Có thể chỉ định tiền tố URL cơ sở của trang bằng tham số `--base-url` (ví dụ: tên kho lưu trữ trên GitHub Pages).
-- Không cần cấu hình ngôn ngữ nguồn, ZEN sẽ tự động phát hiện.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Xem thêm tham số hoặc trợ giúp**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/vi-VN/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -1,30 +0,0 @@
----
-'title': 'Kỹ thuật sử dụng khai báo ngày tháng trong tài liệu ZEN'
-'summary': 'Tài liệu này giới thiệu kỹ thuật sử dụng khai báo ngày tháng trực tiếp trong nội dung chính của công cụ ZEN, so sánh với cách khai báo ngày tháng truyền thống trong Markdown thông qua YAML Frontmatter, nhấn mạnh khả năng tự động nhận diện và xử lý thông minh của ZEN, nâng cao trải nghiệm người dùng, và phù hợp với các loại nội dung cần dòng thời gian như nhật ký, blog.'
-'tags':
-  - 'ZEN'
-  - 'Khai báo ngày tháng'
-  - 'Markdown'
-  - 'Xử lý AI'
-  - 'Dòng thời gian'
-  - 'Trải nghiệm người dùng'
-  - 'Quản lý tài liệu'
-'inferred_date': '2026-01-08'
-'inferred_lang': 'zh-Hans'
----
-
-# Kỹ thuật sử dụng
-
-## Khai báo ngày tháng trong nội dung chính
-
-Trong nội dung chính, bạn có thể sử dụng khai báo ngày tháng như "Hôm nay là ngày 8 tháng 1 năm 2026" (định dạng tự do), ZEN sẽ tự động nhận diện và xử lý.
-
-Tài liệu Markdown truyền thống khai báo ngày tháng thông qua YAML Frontmatter, yêu cầu ghi nhớ các trường tương ứng, nếu không ngày tháng sẽ không được nhận diện chính xác.
-
-ZEN hỗ trợ khai báo ngày tháng trực tiếp trong nội dung chính, tránh được vấn đề quên điền các trường Frontmatter.
-
-AI sẽ tự động trích xuất và suy luận thông tin ngày tháng trong nội dung chính, sau đó xử lý chúng như ngày tạo tài liệu.
-
-Phương pháp này linh hoạt và thông minh hơn, nâng cao trải nghiệm người dùng.
-
-Nhân tiện, các tài liệu có ngày tháng có thể tạo ra chế độ xem dòng thời gian, thuận tiện cho việc duyệt và quản lý. Đặc biệt phù hợp với các loại nội dung cần dòng thời gian như nhật ký, blog.